hyperf/docs/zh-hk/quick-start/important.md

編程須知

這裏收集各種通過 Hyperf 編程前應該知曉的知識點或內容點。

不能通過全局變量獲取屬性參數

在 PHP-FPM 下可以通過全局變量獲取到請求的參數，服務器的參數等，在 Hyperf 和 Swoole 內，都 無法 通過 $_GET/$_POST/$_REQUEST/$_SESSION/$_COOKIE/$_SERVER等$_開頭的變量獲取到任何屬性參數。

通過容器獲取的類都是單例

通過依賴注入容器獲取的都是進程內持久化的，是多個協程共享的，所以不能包含任何的請求唯一的數據或協程唯一的數據，這類型的數據都通過協程上下文去處理，具體請仔細閲讀 依賴注入 和 協程 章節。

項目部署

官方的 Dockerfile 已經完成了以下操作。

線上代碼部署時，請務必開啓 scan_cacheable。

開啓此配置後，首次掃描時會生成代理類和註解緩存，再次啓動時，則可以直接使用緩存，極大優化內存使用率和啓動速度。因為跳過了掃描階段，所以會依賴 Composer Class Map，故我們必須要執行 --optimize-autoloader 優化索引。

綜上，線上更新代碼，重啓項目前，需要執行以下命令

# 優化 Composer 索引
composer dump-autoload -o
# 生成代理類和註解緩存
php bin/hyperf.php

避免在魔術方法中切換協程

__call __callStatic 除外

儘量避免在 __get __set 和 __isset 中切換協程，因為可能會出現不符合預期的情況

<?php

require_once 'vendor/autoload.php';
Swoole\Coroutine::set(['hook_flags' => SWOOLE_HOOK_ALL]);

class Foo
{
    public function __get(string $name)
    {
        sleep(1);
        return $name;
    }

    public function __set(string $name, mixed $value)
    {
        sleep(1);
        var_dump($name, $value);
    }

    public function __isset(string $name): bool
    {
        sleep(1);
        var_dump($name);
        return true;
    }
}

$foo = new Foo();
go(static function () use ($foo) {
    var_dump(isset($foo->xxx));
});

go(static function () use ($foo) {
    var_dump(isset($foo->xxx));
});

\Swoole\Event::wait();

當我們執行上述代碼時，會返回以下結果

bool(false)
string(3) "xxx"
bool(true)