協(xié)程

webman是基于workerman開發(fā)的，所以webman可以使用workerman的協(xié)程特性。
協(xié)程支持Swoole Swow和Fiber三種驅(qū)動。

前提條件

PHP >= 8.1
Workerman >= 5.1.0 (composer require workerman/workerman ~v5.1)
webman-framework >= 2.1 (composer require workerman/webman-framework ~v2.1)
安裝了swoole或者swow擴展，或者安裝了composer require revolt/event-loop (Fiber)
協(xié)程默認是關(guān)閉的，需要單獨設(shè)置eventLoop開啟

開啟方法

webman支持為不同的進程開啟不同的驅(qū)動，所以你可以在config/process.php中通過eventLoop配置協(xié)程驅(qū)動：

return [
    'webman' => [
        'handler' => Http::class,
        'listen' => 'http://0.0.0.0:8787',
        'count' => 1,
        'user' => '',
        'group' => '',
        'reusePort' => false,
        'eventLoop' => '', // 默認為空自動選擇Select或者Event，不開啟協(xié)程
        'context' => [],
        'constructor' => [
            'requestClass' => Request::class,
            'logger' => Log::channel('default'),
            'appPath' => app_path(),
            'publicPath' => public_path()
        ]
    ],
    'my-coroutine' => [
        'handler' => Http::class,
        'listen' => 'http://0.0.0.0:8686',
        'count' => 1,
        'user' => '',
        'group' => '',
        'reusePort' => false,
        // 開啟協(xié)程需要設(shè)置為 Workerman\Events\Swoole::class 或者 Workerman\Events\Swow::class 或者 Workerman\Events\Fiber::class
        'eventLoop' => Workerman\Events\Swoole::class,
        'context' => [],
        'constructor' => [
            'requestClass' => Request::class,
            'logger' => Log::channel('default'),
            'appPath' => app_path(),
            'publicPath' => public_path()
        ]
    ]

    // ... 其它配置省略 ...
];

提示
webman可以為不同的進程設(shè)置不同的eventLoop，這意味著你可以選擇性的為特定進程開啟協(xié)程。
例如上面配置中8787端口的服務(wù)沒有開啟協(xié)程，8686端口的服務(wù)開啟了協(xié)程，配合nginx轉(zhuǎn)發(fā)可以實現(xiàn)協(xié)程和非協(xié)程混合部署。

協(xié)程示例

<?php
namespace app\controller;

use support\Response;
use Workerman\Coroutine;
use Workerman\Timer;

class IndexController
{
    public function index(): Response
    {
        Coroutine::create(function(){
            Timer::sleep(1.5);
            echo "hello coroutine\n";
        });
        return response('hello webman');
    }

}

當eventLoop為Swoole Swow Fiber時，webman會為每個請求創(chuàng)建一個協(xié)程來運行，在處理請求時可以繼續(xù)創(chuàng)建新的協(xié)程執(zhí)行業(yè)務(wù)代碼。

協(xié)程限制

當使用Swoole Swow為驅(qū)動時，業(yè)務(wù)遇到阻塞IO協(xié)程會自動切換，能實現(xiàn)同步代碼異步執(zhí)行。
當使用Fiber驅(qū)動時，遇到阻塞IO時，協(xié)程不會發(fā)生切換，進程進入阻塞狀態(tài)。
使用協(xié)程時，不能多個協(xié)程同時對同一個資源進行操作，例如數(shù)據(jù)庫連接，文件操作等，這可能會引起資源競爭，正確的用法是使用連接池或者鎖來保護資源。
使用協(xié)程時，不能將請求相關(guān)的狀態(tài)數(shù)據(jù)存儲在全局變量或者靜態(tài)變量中，這可能會引起全局數(shù)據(jù)污染，正確的用法是使用協(xié)程上下文context來存取它們。

其它注意事項

Swow底層會自動hook php的阻塞函數(shù)，但是因為這種hook影響了PHP的某些默認行為，所以在你沒有使用Swow但卻裝了Swow時可能會產(chǎn)生bug。

所以建議：

如果你的項目沒有使用Swow時，請不要安裝Swow擴展
如果你的項目使用了Swow，請設(shè)置eventLoop為Workerman\Events\Swow::class

協(xié)程上下文

協(xié)程環(huán)境禁止將請求相關(guān)的狀態(tài)信息存儲在全局變量或者靜態(tài)變量中，因為這可能會導(dǎo)致全局變量污染，例如

<?php

namespace app\controller;

use support\Request;
use Workerman\Timer;

class TestController
{
    protected static $name = '';

    public function index(Request $request)
    {
        static::$name = $request->get('name');
        Timer::sleep(5);
        return static::$name;
    }
}

注意
協(xié)程環(huán)境下并非禁止使用全局變量或靜態(tài)變量，而是禁止使用全局變量或靜態(tài)變量存儲請求相關(guān)的狀態(tài)數(shù)據(jù)。
例如全局配置、數(shù)據(jù)庫連接、一些類的單例等需要全局共享的對象數(shù)據(jù)是推薦用全局變量或靜態(tài)變量存儲的。

將進程數(shù)設(shè)置為1，當我們連續(xù)發(fā)起兩個請求時
http://127.0.0.1:8787/test?name=lilei
http://127.0.0.1:8787/test?name=hanmeimei
我們期望兩個請求返回的結(jié)果分別是 lilei 和 hanmeimei，但實際上返回的都是hanmeimei。
這是因為第二個請求將靜態(tài)變量$name覆蓋了，第一個請求睡眠結(jié)束時返回時靜態(tài)變量$name已經(jīng)成為hanmeimei。

正確但方法應(yīng)該是使用context存儲請求狀態(tài)數(shù)據(jù)

<?php

namespace app\controller;

use support\Request;
use support\Context;
use Workerman\Timer;

class TestController
{
    public function index(Request $request)
    {
        Context::set('name', $request->get('name'));
        Timer::sleep(5);
        return Context::get('name');
    }
}

support\Context類用于存儲協(xié)程上下文數(shù)據(jù)，當協(xié)程執(zhí)行完畢后，相應(yīng)的context數(shù)據(jù)會自動刪除。
協(xié)程環(huán)境里，因為每個請求都是單獨的協(xié)程，所以當請求完成時context數(shù)據(jù)會自動銷毀。
非協(xié)程環(huán)境里，context會在請求結(jié)束時會自動銷毀。

局部變量不會造成數(shù)據(jù)污染

<?php

namespace app\controller;

use support\Request;
use support\Context;
use Workerman\Timer;

class TestController
{
    public function index(Request $request)
    {
        $name = $request->get('name');
        Timer::sleep(5);
        return $name;
    }
}

因為$name是局部變量，協(xié)程之間無法互相訪問局部變量，所以使用局部變量是協(xié)程安全的。

Locker 鎖

有時候一些組件或者業(yè)務(wù)沒有考慮到協(xié)程環(huán)境，可能會出現(xiàn)資源競爭或原子性問題，這時候可以使用Workerman\Locker加鎖來實現(xiàn)排隊處理，防止并發(fā)問題。

<?php

namespace app\controller;

use Redis;
use support\Response;
use Workerman\Coroutine\Locker;

class IndexController
{
    public function index(): Response
    {
        static $redis;
        if (!$redis) {
            $redis = new Redis();
            $redis->connect('127.0.0.1', 6379);
        }
        // 如果不加鎖，Swoole下會觸發(fā)類似 "Socket#10 has already been bound to another coroutine#10" 錯誤
        // Swow下可能會觸發(fā)coredump
        // Fiber下因為Redis擴展是同步阻塞IO，所以不會有問題
        Locker::lock('redis');
        $time = $redis->time();
        Locker::unlock('redis');
        return json($time);
    }

}

Parallel 并發(fā)執(zhí)行

當我們需要并發(fā)執(zhí)行多個任務(wù)并獲取結(jié)果時，可以使用Workerman\Parallel來實現(xiàn)。

<?php

namespace app\controller;

use support\Response;
use Workerman\Coroutine\Parallel;

class IndexController
{
    public function index(): Response
    {
        $parallel = new Parallel();
        for ($i=1; $i<5; $i++) {
            $parallel->add(function () use ($i) {
                // Do something
                return $i;
            });
        }
        $results = $parallel->wait();
        return json($results); // Response: [1,2,3,4]
    }

}

Pool 連接池

多個協(xié)程共用同一個連接會導(dǎo)致數(shù)據(jù)混亂，所以需要使用連接池來管理數(shù)據(jù)庫、redis等連接資源。

webman已經(jīng)提供了 webman/database webman/redis webman/cache webman/think-orm webman/think-cache等組件，它們都集成了連接池，支持在協(xié)程和非協(xié)程環(huán)境下使用。

如果你想改造一個沒有連接池的組件，可以使用Workerman\Pool來實現(xiàn)，參考如下代碼。

數(shù)據(jù)庫組件

<?php
namespace app;

use Workerman\Coroutine\Context;
use Workerman\Coroutine;
use Workerman\Coroutine\Pool;

class Db
{
    private static ?Pool $pool = null;

    public static function __callStatic($name, $arguments)
    {
        if (self::$pool === null) {
            self::initializePool();
        }
        // 從協(xié)程上下文中獲取連接，保證同一個協(xié)程使用同一個連接
        $pdo = Context::get('pdo');
        if (!$pdo) {
            // 從連接池中獲取連接
            $pdo = self::$pool->get();
            Context::set('pdo', $pdo);
            // 當協(xié)程結(jié)束時，自動歸還連接
            Coroutine::defer(function () use ($pdo) {
                self::$pool->put($pdo);
            });
        }
        return call_user_func_array([$pdo, $name], $arguments);
    }

    private static function initializePool(): void
    {
        // 創(chuàng)建一個連接池，最大連接數(shù)為10
        self::$pool = new Pool(10);
        // 設(shè)置連接創(chuàng)建器(為了簡潔，省略了配置文件讀取)
        self::$pool->setConnectionCreator(function () {
            return new \PDO('mysql:host=127.0.0.1;dbname=your_database', 'your_username', 'your_password');
        });
        // 設(shè)置連接關(guān)閉器
        self::$pool->setConnectionCloser(function ($pdo) {
            $pdo = null;
        });
        // 設(shè)置心跳檢測器
        self::$pool->setHeartbeatChecker(function ($pdo) {
            $pdo->query('SELECT 1');
        });
    }

}

使用

<?php
namespace app\controller;

use support\Response;
use app\Db;

class IndexController
{
    public function index(): Response
    {
        $value = Db::query('SELECT NOW() as now')->fetchAll();
        return json($value); // [{"now":"2025-02-06 23:41:03","0":"2025-02-06 23:41:03"}]
    }

}

協(xié)程與非協(xié)程混合部署

webman支持協(xié)程和非協(xié)程混合部署，例如非協(xié)程處理普通業(yè)務(wù)，協(xié)程處理慢IO業(yè)務(wù)，通過nginx轉(zhuǎn)發(fā)請求到不同的服務(wù)上。

例如 config/process.php

return [
    'webman' => [
        'handler' => Http::class,
        'listen' => 'http://0.0.0.0:8787',
        'count' => 1,
        'user' => '',
        'group' => '',
        'reusePort' => false,
        'eventLoop' => '', // 默認為空自動選擇Select或者Event，不開啟協(xié)程
        'context' => [],
        'constructor' => [
            'requestClass' => Request::class,
            'logger' => Log::channel('default'),
            'appPath' => app_path(),
            'publicPath' => public_path()
        ]
    ],
    'my-coroutine' => [
        'handler' => Http::class,
        'listen' => 'http://0.0.0.0:8686',
        'count' => 1,
        'user' => '',
        'group' => '',
        'reusePort' => false,
        // 開啟協(xié)程需要設(shè)置為 Workerman\Events\Swoole::class 或者 Workerman\Events\Swow::class 或者 Workerman\Events\Fiber::class
        'eventLoop' => Workerman\Events\Swoole::class,
        'context' => [],
        'constructor' => [
            'requestClass' => Request::class,
            'logger' => Log::channel('default'),
            'appPath' => app_path(),
            'publicPath' => public_path()
        ]
    ],

    // ... 其它配置省略 ...
];

然后通過nginx配置轉(zhuǎn)發(fā)請求到不同的服務(wù)上

upstream webman {
    server 127.0.0.1:8787;
    keepalive 10240;
}

# 新增一個8686 upstream
upstream task {
   server 127.0.0.1:8686;
   keepalive 10240;
}

server {
  server_name webman.com;
  listen 80;
  access_log off;
  root /path/webman/public;

  # 以/tast開頭的請求走8686端口，請按實際情況將/tast更改為你需要的前綴
  location /tast {
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $host;
      proxy_http_version 1.1;
      proxy_set_header Connection "";
      proxy_pass http://task;
  }

  # 其它請求走原8787端口
  location / {
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $host;
      proxy_http_version 1.1;
      proxy_set_header Connection "";
      if (!-f $request_filename){
          proxy_pass http://webman;
      }
  }
}

編輯于2025-03-31 15:29:05 完善本頁 +發(fā)起討論

国产+高潮+在线,国产 av 仑乱内谢,www国产亚洲精品久久,51国产偷自视频区视频,成人午夜精品网站在线观看