PHP Hyperf 3.0 釋出！新功能速覽

<?php
declare(strict_types=1);

namespace App\Controller;

use Hyperf\HttpServer\Contract\RequestInterface;
use Hyperf\HttpServer\Annotation\Controller;
use Hyperf\HttpServer\Annotation\RequestMapping;

#[Controller]
class IndexController
{
    // Hyperf 會自動為此方法生成一個 /index/index 的路由，允許通過 GET 或 POST 方式請求
    #[RequestMapping(path: "index", methods: "get,post")]
    public function index(RequestInterface $request)
    {
        // 從請求中獲得 id 引數
        $id = $request->input('id', 1);
        return (string)$id;
    }
}

<?php
namespace App\Controller;

use DtmClient\TCC;
use DtmClient\TransContext;
use Hyperf\Di\Annotation\Inject;
use Hyperf\HttpServer\Annotation\Controller;
use Hyperf\HttpServer\Annotation\GetMapping;
use Throwable;

#[Controller(prefix: '/tcc')]
class TccController
{

    protected string $serviceUri = 'http://127.0.0.1:9501';

    #[Inject]
    protected TCC $tcc;

    #[GetMapping(path: 'successCase')]
    public function successCase()
    {
        try {
            $this->tcc->globalTransaction(function (TCC $tcc) {
                // 建立子事務 A 的呼叫資料
                $tcc->callBranch(
                    // 呼叫 Try 方法的引數
                    ['amount' => 30],
                    // Try 方法的 URL
                    $this->serviceUri . '/tcc/transA/try',
                    // Confirm 方法的 URL
                    $this->serviceUri . '/tcc/transA/confirm',
                    // Cancel 方法的 URL
                    $this->serviceUri . '/tcc/transA/cancel'
                );
                // 建立子事務 B 的呼叫資料，以此類推
                $tcc->callBranch(
                    ['amount' => 30],
                    $this->serviceUri . '/tcc/transB/try',
                    $this->serviceUri . '/tcc/transB/confirm',
                    $this->serviceUri . '/tcc/transB/cancel'
                );
            });
        } catch (Throwable $e) {
            var_dump($e->getMessage(), $e->getTraceAsString());
        }
        // 通過 TransContext::getGid() 獲得 全域性事務ID 並返回
        return TransContext::getGid();
    }

}

composer create-project hyperf/swow-skeleton:dev-master

// 執行超過 1ms 就讓出控制權
\Swow\WatchDog::run(1 * 1000 * 1000);

// 執行超過 1ms 就讓出 10ms，排程失敗並超過 5ms 時視為系統呼叫阻塞
\Swow\WatchDog::run(1 * 1000 * 1000, 5 * 1000 * 1000, 10);

// 可程式化方式，函數會在程式阻塞 100ms 後觸發
$alertCountMap = new WeakMap();
\Swow\WatchDog::run(quantum: 100 * 1000 * 1000, alerter: static function () use ($alertCountMap): void {
    $coroutine = Coroutine::getCurrent();
    $alertCount = ($alertCountMap[$coroutine] ??= 0) + 1;
    $alertCountMap[$coroutine] = $alertCount;
    echo 'CPU starvation occurred, suspend this coroutine...' . PHP_EOL;
    sleep(0);
    if ($alertCount > 5) {
        echo 'Kill the bad guy' . PHP_EOL;
        $coroutine->kill();
    }
});

// Mac
wget https://github.com/hyperf/box/releases/download/v0.5.5/box_x86_64_macos -O box
sudo mv ./box /usr/local/bin/box
sudo chmod 755 /usr/local/bin/box
// 確保 /usr/local/bin/box 在你的 $PATH 環境中，或者將 `box` 放到你想要的任意 $PATH 路徑中


// Linux x86_64
wget https://github.com/hyperf/box/releases/download/v0.5.5/box_x86_64_linux -O box
sudo mv ./box /usr/local/bin/box
sudo chmod 755 /usr/local/bin/box
// 確保 /usr/local/bin/box 在你的 $PATH 環境中，或者將 `box` 放到你想要的任意 $PATH 路徑中


// Windows
curl -o box.exe https://github.com/hyperf/box/releases/download/v0.5.5/box_x64_windows.exe
// 將 `box.exe` 放到你想要的任意 Path 環境變數路徑中，同時 Windows 版本在執行時需要在命令列中使用 `box.exe` 而不是 `box`

// 通過 box 安裝 PHP 8.1，此安裝不會影響系統原來自身安裝的 PHP
box get [email protected]
// 通過 box 安裝 composer
box get composer
// 通過 box composer 建立 hyperf 應用，可指定 dev-master 分支以防止 packagist 代理資料落後的問題
box composer create-project hyperf/swow-skeleton:dev-master
// 通過 box 啟動 hyperf
box hyperf start

// 設定為 Swow Kernel [預設]
box config set kernel swow

// 設定為 Swoole Kernel (不支援 Windows)
box config set kernel swoole

box get pkg@version從遠端安裝包，pkg是包名，version是包的版本，box get pkg表示安裝最新版本的 pkg，例如, 執行 box get [email protected] 安裝 PHP 8.1, 執行 box get composer 安裝最新的 composer bin
box build-prepare 為 build 和 build-self 命令做好相關環境的準備
box build-self 構建 box bin 本身
box build <path> 將 Hyperf 應用程式構建成二進位制檔案
box self-update 將 box bin 更新至最新版本
box config set-php-version <version>設定 box 的當前 PHP 版本，可用值：8.0 | 8.1
box config get-php-version <version>獲取 box 的當前設定的 PHP 版本
box reverse-proxy -u <upsteamHost:upstreamPort> 啟動一個反向代理 HTTP 伺服器，用於將 HTTP 請求轉發到指定的多個上游伺服器
box php <argument> 通過當前 box 的 PHP 版本執行任何 PHP 命令
box composer <argument>通過當前 box 的 PHP 版本執行任何 Composer 命令
box php-cs-fixer <argument> 通過當前 box 的 PHP 版本執行任何 php-cs-fixer 命令
box cs-fix <argument> 通過當前 box 的 PHP 版本執行 php-cs-fixer fix 命令
box phpstan <argument> 通過當前 box 的 PHP 版本執行任何 phpstan 命令
box pint <argument> 通過當前 box 的 PHP 版本執行任何 pint 命令