Feature perfect swoole extension config (#297)

* improve swoole static build config * improve swoole static build config * improve swoole static build config * improve swoole static build config * improve swoole static build config * add cares config * update swoole depend config * update swoole depend config * update cares build config * update workflow tests.yaml config * fix setup-runtime * test with clang build * test with clang build * update cares build config * test * test * test * test * test * test * test * test * test * test * test * test * test * test * update cares license * test build * test build * test build * test build * test add enable libpq * test add enable libpq * test add enable libpq * test add enable libpq * test add enable libpq * test add enable libpq * test add enable libpq * test * test * test * test * test * test * test * test * test * test * test * test * test * test * test * test * test * test * test * test * test * update * update * update * update * update * update * update * update * update * compatible old * fix code format * fix code format * add swoole test case * add swoole test case * add phpstan ignore error * add phpstan ignore error * add phpstan ignore error * add phpstan ignore error * add phpstan ignore error * update phpstan.neon * update swoole extension test case * update swoole test case * adjust config order and depends * revert LinuxBuilder * remove swoole.phpt * re-adjust swoole args * update test-extensions and some PHPDoc * revert: debian and alpine clang doctor install * revert: MacOSBuilder * fix: extract hook for archive not working * revert: build tests * use addon mode to swoole database hook * add hook tests * test minimal * test minimal * sort config --------- Co-authored-by: crazywhalecc <jesse2061@outlook.com>
2026-03-17 20:34:51 +08:00 · 2024-01-03 10:31:21 +08:00 · 2024-01-03 10:31:21 +08:00 · 31c71f180b
commit 31c71f180b
parent 5c7552f826
25 changed files with 421 additions and 164 deletions
--- a/bin/setup-runtime
+++ b/bin/setup-runtime
@ -35,7 +35,6 @@ while [ $# -gt 0 ]; do
  case "$1" in
  --mirror)
    mirror="$2"
-    shift
    ;;
  --*)
    echo "Illegal option $1"
@ -47,7 +46,7 @@ done
 case "$mirror" in
 china)
  __PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.2.13-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
-  __COMPOSER_URL__="https://mirrors.aliyun.com/composer/composer.phar"
+  __COMPOSER_URL__="https://mirrors.tencent.com/composer/composer.phar"
  ;;

 esac
--- a/config/ext.json
+++ b/config/ext.json
@ -424,17 +424,50 @@
        "source": "swoole",
        "arg-type": "custom",
        "cpp-extension": true,
+        "unix-only": true,
        "lib-depends": [
-            "openssl"
+            "libcares",
+            "brotli",
+            "nghttp2",
+            "zlib"
        ],
        "ext-depends": [
-            "openssl"
+            "openssl",
+            "curl"
        ],
        "ext-suggests": [
-            "curl",
-            "pgsql"
+            "swoole-hook-pgsql",
+            "swoole-hook-mysql",
+            "swoole-hook-sqlite"
+        ]
+    },
+    "swoole-hook-mysql": {
+        "type": "addon",
+        "arg-type": "custom",
+        "ext-depends": [
+            "mysqlnd",
+            "pdo",
+            "pdo_mysql"
        ],
-        "unix-only": true
+        "ext-suggests": [
+            "mysqli"
+        ]
+    },
+    "swoole-hook-pgsql": {
+        "type": "addon",
+        "arg-type": "custom",
+        "ext-depends": [
+            "pgsql",
+            "pdo"
+        ]
+    },
+    "swoole-hook-sqlite": {
+        "type": "addon",
+        "arg-type": "custom",
+        "ext-depends": [
+            "sqlite3",
+            "pdo"
+        ]
    },
    "swow": {
        "type": "external",
--- a/config/lib.json
+++ b/config/lib.json
@ -175,6 +175,18 @@
            "libavif.a"
        ]
    },
+    "libcares": {
+        "source": "libcares",
+        "static-libs-unix": [
+            "libcares.a"
+        ],
+        "headers-unix": [
+            "ares.h",
+            "ares_dns.h",
+            "ares_nameser.h",
+            "ares_rules.h"
+        ]
+    },
    "libevent": {
        "source": "libevent",
        "static-libs-unix": [
--- a/config/source.json
+++ b/config/source.json
@ -209,6 +209,15 @@
            "path": "LICENSE"
        }
    },
+    "libcares": {
+        "type": "filelist",
+        "url": "https://c-ares.org/download/",
+        "regex": "/href=\"\\/download\\/(?<file>c-ares-(?<version>[^\"]+)\\.tar\\.gz)\"/",
+        "license": {
+            "type": "file",
+            "path": "LICENSE.md"
+        }
+    },
    "libevent": {
        "type": "ghrel",
        "repo": "libevent/libevent",
--- a/phpstan.neon
+++ b/phpstan.neon
@ -8,5 +8,10 @@ parameters:
    - '#Unsafe usage of new static#'
    - '#class Fiber#'
    - '#Attribute class JetBrains\\PhpStorm\\ArrayShape does not exist#'
+    - '#Function Swoole\\Coroutine\\run not found.#'
  dynamicConstantNames:
-    - PHP_OS_FAMILY
+    - PHP_OS_FAMILY
+  excludePaths:
+      analyseAndScan:
+            - ./src/globals/tests/swoole.php
+            - ./src/globals/tests/swoole.phpt
--- a/src/SPC/builder/BuilderBase.php
+++ b/src/SPC/builder/BuilderBase.php
@ -227,7 +227,7 @@ abstract class BuilderBase
        foreach ($this->exts as $ext) {
            $ret[] = trim($ext->getConfigureArg());
        }
-        logger()->info('Using configure: ' . implode(' ', $ret));
+        logger()->debug('Using configure: ' . implode(' ', $ret));
        return implode(' ', $ret);
    }

--- a/src/SPC/builder/extension/swoole.php
+++ b/src/SPC/builder/extension/swoole.php
@ -12,13 +12,31 @@ class swoole extends Extension
 {
    public function getUnixConfigureArg(): string
    {
+        // enable swoole
        $arg = '--enable-swoole';
-        // pgsql hook is buggy for static php
-        $arg .= ' --disable-swoole-pgsql';
-        $arg .= $this->builder->getLib('openssl') ? ' --enable-openssl' : ' --disable-openssl --without-openssl';
-        $arg .= $this->builder->getLib('brotli') ? (' --enable-brotli --with-brotli-dir=' . BUILD_ROOT_PATH) : ' --disable-brotli';
-        // swoole curl hook is buggy for php 8.0
-        $arg .= $this->builder->getExt('curl') && $this->builder->getPHPVersionID() >= 80100 ? ' --enable-swoole-curl' : ' --disable-swoole-curl';
+
+        // commonly-used feature: coroutine-time, thread-context
+        $arg .= ' --enable-swoole-coro-time --enable-thread-context';
+
+        // required feature: curl, openssl (but curl hook is buggy for php 8.0)
+        $arg .= $this->builder->getPHPVersionID() >= 80100 ? ' --enable-swoole-curl' : ' --disable-swoole-curl';
+        $arg .= ' --enable-openssl';
+
+        // additional feature: c-ares, brotli, nghttp2 (can be disabled, but we enable it by default in config to support full network feature)
+        $arg .= $this->builder->getLib('libcares') ? ' --enable-cares' : '';
+        $arg .= $this->builder->getLib('brotli') ? (' --with-brotli-dir=' . BUILD_ROOT_PATH) : '';
+        $arg .= $this->builder->getLib('nghttp2') ? (' --with-nghttp2-dir=' . BUILD_ROOT_PATH) : '';
+
+        // additional feature: swoole-pgsql, it should depend on lib [postgresql], but it will lack of CFLAGS etc.
+        // so this is a tricky way (enable ext [pgsql,pdo] to add postgresql hook and pdo_pgsql support)
+        $arg .= $this->builder->getExt('swoole-hook-pgsql') ? '' : ' --disable-swoole-pgsql';
+
+        // enable this feature , need remove pdo_sqlite
+        // more info : https://wenda.swoole.com/detail/109023
+        $arg .= $this->builder->getExt('swoole-hook-sqlite') ? '' : ' --disable-swoole-sqlite';
+
+        // enable this feature , need stop pdo_*
+        // $arg .= $this->builder->getLib('unixodbc') ? ' --with-swoole-odbc=unixODBC,'  : ' ';
        return $arg;
    }
 }
--- a/src/SPC/builder/extension/swoole_hook_mysql.php
+++ b/src/SPC/builder/extension/swoole_hook_mysql.php
@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\RuntimeException;
+use SPC\util\CustomExt;
+
+#[CustomExt('swoole-hook-mysql')]
+class swoole_hook_mysql extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        // pdo_mysql doesn't need to be disabled
+        // enable swoole-hook-mysql will enable mysqli, pdo, pdo_mysql, we don't need to add any additional options
+        return '';
+    }
+
+    public function runCliCheck(): void
+    {
+        // skip if not enable swoole
+        if ($this->builder->getExt('swoole') === null) {
+            return;
+        }
+        [$ret, $out] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php --ri "swoole"', false);
+        $out = implode('', $out);
+        if ($ret !== 0) {
+            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: php-cli returned ' . $ret);
+        }
+        if (!str_contains($out, 'mysqlnd')) {
+            throw new RuntimeException('swoole mysql hook is not enabled correctly.');
+        }
+    }
+}
--- a/src/SPC/builder/extension/swoole_hook_pgsql.php
+++ b/src/SPC/builder/extension/swoole_hook_pgsql.php
@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\util\CustomExt;
+
+#[CustomExt('swoole-hook-pgsql')]
+class swoole_hook_pgsql extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        // pdo_pgsql need to be disabled
+        if ($this->builder->getExt('pdo_pgsql') !== null) {
+            throw new WrongUsageException('swoole-hook-pgsql provides pdo_pgsql, if you enable pgsql hook for swoole, you must remove pdo_pgsql extension.');
+        }
+        // enable swoole pgsql hook
+        return '--enable-swoole-pgsql';
+    }
+
+    public function runCliCheck(): void
+    {
+        // skip if not enable swoole
+        if ($this->builder->getExt('swoole') === null) {
+            return;
+        }
+        [$ret, $out] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php --ri "swoole"', false);
+        $out = implode('', $out);
+        if ($ret !== 0) {
+            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: php-cli returned ' . $ret);
+        }
+        if (!str_contains($out, 'coroutine_pgsql')) {
+            throw new RuntimeException('swoole pgsql hook is not enabled correctly.');
+        }
+    }
+}
--- a/src/SPC/builder/extension/swoole_hook_sqlite.php
+++ b/src/SPC/builder/extension/swoole_hook_sqlite.php
@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\util\CustomExt;
+
+#[CustomExt('swoole-hook-sqlite')]
+class swoole_hook_sqlite extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        // pdo_pgsql need to be disabled
+        if ($this->builder->getExt('pdo_sqlite') !== null) {
+            throw new WrongUsageException('swoole-hook-sqlite provides pdo_sqlite, if you enable sqlite hook for swoole, you must remove pdo_sqlite extension.');
+        }
+        // enable swoole pgsql hook
+        return '--enable-swoole-sqlite';
+    }
+
+    public function runCliCheck(): void
+    {
+        // skip if not enable swoole
+        if ($this->builder->getExt('swoole') === null) {
+            return;
+        }
+        [$ret, $out] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php --ri "swoole"', false);
+        $out = implode('', $out);
+        if ($ret !== 0) {
+            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: php-cli returned ' . $ret);
+        }
+        if (!str_contains($out, 'coroutine_sqlite')) {
+            throw new RuntimeException('swoole sqlite hook is not enabled correctly.');
+        }
+    }
+}
--- a/src/SPC/builder/linux/LinuxBuilder.php
+++ b/src/SPC/builder/linux/LinuxBuilder.php
@ -138,16 +138,15 @@ class LinuxBuilder extends BuilderBase
        // add libstdc++, some extensions or libraries need it
        $extra_libs .= (empty($extra_libs) ? '' : ' ') . ($this->hasCpp() ? '-lstdc++ ' : '');
        $this->setOption('extra-libs', $extra_libs);
-
        $cflags = $this->arch_c_flags;

        // prepare build php envs
        $envs_build_php = SystemUtil::makeEnvVarString([
            'CFLAGS' => $cflags,
            'CPPFLAGS' => '-I' . BUILD_INCLUDE_PATH,
+            'LDFLAGS' => '-L' . BUILD_LIB_PATH,
            'LIBS' => '-ldl -lpthread',
        ]);
-
        SourcePatcher::patchBeforeBuildconf($this);

        shell()->cd(SOURCE_PATH . '/php-src')->exec('./buildconf --force');
@ -190,8 +189,8 @@ class LinuxBuilder extends BuilderBase
                $json_74 .
                $zts .
                $maxExecutionTimers .
-                $this->makeExtensionArgs() . ' ' .
-                $envs_build_php
+                $this->makeExtensionArgs() .
+                ' ' . $envs_build_php . ' '
            );

        SourcePatcher::patchBeforeMake($this);
@ -323,10 +322,11 @@ class LinuxBuilder extends BuilderBase
        $cflags = isset($input['EXTRA_CFLAGS']) && $input['EXTRA_CFLAGS'] ? " {$input['EXTRA_CFLAGS']}" : '';
        $libs = isset($input['EXTRA_LIBS']) && $input['EXTRA_LIBS'] ? " {$input['EXTRA_LIBS']}" : '';
        $ldflags = isset($input['EXTRA_LDFLAGS_PROGRAM']) && $input['EXTRA_LDFLAGS_PROGRAM'] ? " {$input['EXTRA_LDFLAGS_PROGRAM']}" : '';
+        $tune_c_flags = implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags));
        return [
-            'EXTRA_CFLAGS' => "{$optimization} -fno-ident -fPIE " . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)) . $cflags,
-            'EXTRA_LIBS' => $this->getOption('extra-libs', '') . $libs,
-            'EXTRA_LDFLAGS_PROGRAM' => "{$use_lld} -all-static" . $ldflags,
+            'EXTRA_CFLAGS' => "{$optimization} -fno-ident -fPIE {$tune_c_flags}{$cflags}",
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs', '')} {$libs}",
+            'EXTRA_LDFLAGS_PROGRAM' => "{$use_lld} -all-static{$ldflags}",
        ];
    }
 }
--- a/src/SPC/builder/linux/library/libcares.php
+++ b/src/SPC/builder/linux/library/libcares.php
@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+class libcares extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\libcares;
+
+    public const NAME = 'libcares';
+}
--- a/src/SPC/builder/linux/library/nghttp2.php
+++ b/src/SPC/builder/linux/library/nghttp2.php
@ -1,72 +1,12 @@
 <?php
-/**
- * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
- *
- * lwmbs is licensed under Mulan PSL v2. You can use this
- * software according to the terms and conditions of the
- * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
- *
- * http://license.coscl.org.cn/MulanPSL2
- *
- * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
- * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
- * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
- *
- * See the Mulan PSL v2 for more details.
- */

 declare(strict_types=1);

 namespace SPC\builder\linux\library;

-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
-
 class nghttp2 extends LinuxLibraryBase
 {
+    use \SPC\builder\unix\library\nghttp2;
+
    public const NAME = 'nghttp2';
-
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
-    public function build(): void
-    {
-        $args = $this->builder->makeAutoconfArgs(static::NAME, [
-            'zlib' => null,
-            'openssl' => null,
-            'libxml2' => null,
-            'libev' => null,
-            'libcares' => null,
-            'libngtcp2' => null,
-            'libnghttp3' => null,
-            'libbpf' => null,
-            'libevent-openssl' => null,
-            'jansson' => null,
-            'jemalloc' => null,
-            'systemd' => null,
-            'cunit' => null,
-        ]);
-
-        [,,$destdir] = SEPARATED_PATH;
-
-        shell()->cd($this->source_dir)
-            ->exec(
-                './configure ' .
-                '--enable-static ' .
-                '--disable-shared ' .
-                "--host={$this->builder->getOption('gnu-arch')}-unknown-linux " .
-                '--enable-lib-only ' .
-                '--with-boost=no ' .
-                $args . ' ' .
-                '--prefix='
-            )
-            ->exec('make clean')
-            ->exec("make -j{$this->builder->concurrency}")
-            ->exec("make install DESTDIR={$destdir}");
-        $this->patchPkgconfPrefix(['libnghttp2.pc']);
-    }
 }
--- a/src/SPC/builder/macos/MacOSBuilder.php
+++ b/src/SPC/builder/macos/MacOSBuilder.php
@ -155,6 +155,21 @@ class MacOSBuilder extends BuilderBase
        $enableMicro = ($build_target & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO;
        $enableEmbed = ($build_target & BUILD_TARGET_EMBED) === BUILD_TARGET_EMBED;

+        // prepare build php envs
+        $envs_build_php = SystemUtil::makeEnvVarString([
+            'CFLAGS' => " {$this->arch_c_flags} -Werror=unknown-warning-option ",
+            'CPPFLAGS' => '-I' . BUILD_INCLUDE_PATH,
+            'LDFLAGS' => '-L' . BUILD_LIB_PATH,
+        ]);
+
+        if ($this->getLib('postgresql')) {
+            shell()
+                ->cd(SOURCE_PATH . '/php-src')
+                ->exec(
+                    'sed -i.backup "s/ac_cv_func_explicit_bzero\" = xyes/ac_cv_func_explicit_bzero\" = x_fake_yes/" ./configure'
+                );
+        }
+
        shell()->cd(SOURCE_PATH . '/php-src')
            ->exec(
                './configure ' .
@ -162,8 +177,6 @@ class MacOSBuilder extends BuilderBase
                '--with-valgrind=no ' .     // Not detect memory leak
                '--enable-shared=no ' .
                '--enable-static=yes ' .
-                "CFLAGS='{$this->arch_c_flags} -Werror=unknown-warning-option' " .
-                "CPPFLAGS='-I" . BUILD_INCLUDE_PATH . "' " .
                '--disable-all ' .
                '--disable-cgi ' .
                '--disable-phpdbg ' .
@ -173,7 +186,8 @@ class MacOSBuilder extends BuilderBase
                ($enableMicro ? '--enable-micro ' : '--disable-micro ') .
                $json_74 .
                $zts .
-                $this->makeExtensionArgs()
+                $this->makeExtensionArgs() . ' ' .
+                $envs_build_php
            );

        SourcePatcher::patchBeforeMake($this);
@ -213,10 +227,7 @@ class MacOSBuilder extends BuilderBase
     */
    public function buildCli(): void
    {
-        $vars = SystemUtil::makeEnvVarString([
-            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
-            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} -lresolv", // link resolv library (macOS needs it)
-        ]);
+        $vars = SystemUtil::makeEnvVarString($this->getBuildVars());

        $shell = shell()->cd(SOURCE_PATH . '/php-src');
        $shell->exec("make -j{$this->concurrency} {$vars} cli");
@ -247,9 +258,8 @@ class MacOSBuilder extends BuilderBase
        $vars = [
            // with debug information, optimize for size, remove identifiers, patch fake cli for micro
            'EXTRA_CFLAGS' => '-g -Os -fno-ident' . $enable_fake_cli,
-            // link resolv library (macOS needs it)
-            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} -lresolv",
        ];
+        $vars = $this->getBuildVars($vars);
        if (!$this->getOption('no-strip', false)) {
            $vars['STRIP'] = 'dsymutil -f ';
        }
@ -272,10 +282,7 @@ class MacOSBuilder extends BuilderBase
     */
    public function buildFpm(): void
    {
-        $vars = SystemUtil::makeEnvVarString([
-            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
-            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} -lresolv", // link resolv library (macOS needs it)
-        ]);
+        $vars = SystemUtil::makeEnvVarString($this->getBuildVars());

        $shell = shell()->cd(SOURCE_PATH . '/php-src');
        $shell->exec("make -j{$this->concurrency} {$vars} fpm");
@ -292,10 +299,7 @@ class MacOSBuilder extends BuilderBase
     */
    public function buildEmbed(): void
    {
-        $vars = SystemUtil::makeEnvVarString([
-            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
-            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} -lresolv", // link resolv library (macOS needs it)
-        ]);
+        $vars = SystemUtil::makeEnvVarString($this->getBuildVars());

        shell()
            ->cd(SOURCE_PATH . '/php-src')
@ -309,4 +313,15 @@ class MacOSBuilder extends BuilderBase
            ->exec('ar rcs ' . BUILD_ROOT_PATH . '/lib/libphp.a *.o')
            ->exec('rm -Rf ' . BUILD_ROOT_PATH . '/lib/php-o');
    }
+
+    private function getBuildVars($input = []): array
+    {
+        $optimization = $this->getOption('no-strip', false) ? '-g -O0' : '-g0 -Os';
+        $cflags = isset($input['EXTRA_CFLAGS']) && $input['EXTRA_CFLAGS'] ? " {$input['EXTRA_CFLAGS']}" : '';
+        $libs = isset($input['EXTRA_LIBS']) && $input['EXTRA_LIBS'] ? " {$input['EXTRA_LIBS']}" : '';
+        return [
+            'EXTRA_CFLAGS' => "{$optimization} {$cflags} " . $this->getOption('x-extra-cflags'),
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} -lresolv {$libs} " . $this->getOption('x-extra-libs'),
+        ];
+    }
 }
--- a/src/SPC/builder/macos/library/libcares.php
+++ b/src/SPC/builder/macos/library/libcares.php
@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class libcares extends MacOSLibraryBase
+{
+    use \SPC\builder\unix\library\libcares;
+
+    public const NAME = 'libcares';
+}
--- a/src/SPC/builder/macos/library/nghttp2.php
+++ b/src/SPC/builder/macos/library/nghttp2.php
@ -20,51 +20,9 @@ declare(strict_types=1);

 namespace SPC\builder\macos\library;

-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-
 class nghttp2 extends MacOSLibraryBase
 {
+    use \SPC\builder\unix\library\nghttp2;
+
    public const NAME = 'nghttp2';
-
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
-    protected function build(): void
-    {
-        $args = $this->builder->makeAutoconfArgs(static::NAME, [
-            'zlib' => null,
-            'openssl' => null,
-            'libxml2' => null,
-            'libev' => null,
-            'libcares' => null,
-            'libngtcp2' => null,
-            'libnghttp3' => null,
-            'libbpf' => null,
-            'libevent-openssl' => null,
-            'jansson' => null,
-            'jemalloc' => null,
-            'systemd' => null,
-            'cunit' => null,
-        ]);
-
-        [,,$destdir] = SEPARATED_PATH;
-
-        shell()->cd($this->source_dir)
-            ->exec(
-                './configure ' .
-                '--enable-static ' .
-                '--disable-shared ' .
-                "--host={$this->builder->getOption('gnu-arch')}-apple-darwin " .
-                '--enable-lib-only ' .
-                '--with-boost=no ' .
-                $args . ' ' .
-                '--prefix='
-            )
-            ->exec('make clean')
-            ->exec("make -j{$this->builder->concurrency}")
-            ->exec("make install DESTDIR={$destdir}");
-        $this->patchPkgconfPrefix(['libnghttp2.pc']);
-    }
 }
--- a/src/SPC/builder/unix/library/brotli.php
+++ b/src/SPC/builder/unix/library/brotli.php
@ -28,9 +28,9 @@ trait brotli
            ->exec('make install DESTDIR=' . BUILD_ROOT_PATH);
        $this->patchPkgconfPrefix(['libbrotlicommon.pc', 'libbrotlidec.pc', 'libbrotlienc.pc']);
        shell()->cd(BUILD_ROOT_PATH . '/lib')
-            ->exec('ln -s libbrotlicommon.a libbrotlicommon-static.a')
-            ->exec('ln -s libbrotlidec.a libbrotlidec-static.a')
-            ->exec('ln -s libbrotlienc.a libbrotlienc-static.a');
+            ->exec('ln -sf libbrotlicommon.a libbrotlicommon-static.a')
+            ->exec('ln -sf libbrotlidec.a libbrotlidec-static.a')
+            ->exec('ln -sf libbrotlienc.a libbrotlienc-static.a');
        foreach (FileSystem::scanDirFiles(BUILD_ROOT_PATH . '/lib/', false, true) as $filename) {
            if (str_starts_with($filename, 'libbrotli') && (str_contains($filename, '.so') || str_ends_with($filename, '.dylib'))) {
                unlink(BUILD_ROOT_PATH . '/lib/' . $filename);
--- a/src/SPC/builder/unix/library/libcares.php
+++ b/src/SPC/builder/unix/library/libcares.php
@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\unix\library;
+
+use SPC\exception\RuntimeException;
+
+trait libcares
+{
+    /**
+     * @throws RuntimeException
+     */
+    protected function build(): void
+    {
+        shell()->cd($this->source_dir)
+            ->exec('./configure --prefix=' . BUILD_ROOT_PATH . ' --enable-static --disable-shared --disable-tests')
+            ->exec("make -j {$this->builder->concurrency}")
+            ->exec('make install');
+    }
+}
--- a/src/SPC/builder/unix/library/nghttp2.php
+++ b/src/SPC/builder/unix/library/nghttp2.php
@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\unix\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+trait nghttp2
+{
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    protected function build(): void
+    {
+        $args = $this->builder->makeAutoconfArgs(static::NAME, [
+            'zlib' => null,
+            'openssl' => null,
+            'libxml2' => null,
+            'libev' => null,
+            'libcares' => null,
+            'libngtcp2' => null,
+            'libnghttp3' => null,
+            'libbpf' => null,
+            'libevent-openssl' => null,
+            'jansson' => null,
+            'jemalloc' => null,
+            'systemd' => null,
+            'cunit' => null,
+        ]);
+
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                './configure ' .
+                '--enable-static ' .
+                '--disable-shared ' .
+                '--enable-lib-only ' .
+                '--with-boost=no ' .
+                $args . ' ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+        $this->patchPkgconfPrefix(['libnghttp2.pc']);
+    }
+}
--- a/src/SPC/builder/unix/library/postgresql.php
+++ b/src/SPC/builder/unix/library/postgresql.php
@ -28,9 +28,6 @@ trait postgresql
            'icu' => 'icu-i18n',
        ];

-        f_putenv('PKG_CONFIG=' . BUILD_ROOT_PATH . '/bin/pkg-config');
-        f_putenv('PKG_CONFIG_PATH=' . BUILD_LIB_PATH . '/pkgconfig');
-
        foreach ($optional_packages as $lib => $pkg) {
            if ($this->getBuilder()->getLib($lib)) {
                $packages .= ' ' . $pkg;
--- a/src/SPC/store/FileSystem.php
+++ b/src/SPC/store/FileSystem.php
@ -233,6 +233,7 @@ class FileSystem
                        throw new FileSystemException("unknown archive format: {$filename}");
                }
            }
+            self::emitSourceExtractHook($name);
        } catch (RuntimeException $e) {
            if (PHP_OS_FAMILY === 'Windows') {
                f_passthru('rmdir /s /q ' . SOURCE_PATH . "/{$name}");
--- a/src/SPC/store/SourcePatcher.php
+++ b/src/SPC/store/SourcePatcher.php
@ -16,6 +16,7 @@ class SourcePatcher
        // FileSystem::addSourceExtractHook('swow', [SourcePatcher::class, 'patchSwow']);
        FileSystem::addSourceExtractHook('micro', [SourcePatcher::class, 'patchMicro']);
        FileSystem::addSourceExtractHook('openssl', [SourcePatcher::class, 'patchOpenssl11Darwin']);
+        FileSystem::addSourceExtractHook('swoole', [SourcePatcher::class, 'patchSwoole']);
    }

    /**
@ -159,6 +160,17 @@ class SourcePatcher
        return false;
    }

+    public static function patchSwoole(): bool
+    {
+        // swoole hook needs pdo/pdo.h
+        FileSystem::replaceFileStr(
+            SOURCE_PATH . '/php-src/ext/swoole/config.m4',
+            'PHP_ADD_INCLUDE([$ext_srcdir])',
+            "PHP_ADD_INCLUDE( [\$ext_srcdir] )\n    PHP_ADD_INCLUDE([\$abs_srcdir/ext])"
+        );
+        return true;
+    }
+
    /**
     * @throws FileSystemException
     */
--- a/src/globals/functions.php
+++ b/src/globals/functions.php
@ -3,6 +3,7 @@
 declare(strict_types=1);

 use Psr\Log\LoggerInterface;
+use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use SPC\util\UnixShell;
 use SPC\util\WindowsCmd;
@ -69,7 +70,7 @@ function osfamily2dir(): string
 /**
 * Execute the shell command, and the output will be directly printed in the terminal. If there is an error, an exception will be thrown
 *
- * @throws \SPC\exception\RuntimeException
+ * @throws RuntimeException
 */
 function f_passthru(string $cmd): ?bool
 {
@ -87,7 +88,7 @@ function f_passthru(string $cmd): ?bool
    }
    $ret = passthru($cmd, $code);
    if ($code !== 0) {
-        throw new \SPC\exception\RuntimeException('Command run failed with code[' . $code . ']: ' . $cmd, $code);
+        throw new RuntimeException('Command run failed with code[' . $code . ']: ' . $cmd, $code);
    }
    return $ret;
 }
--- a/src/globals/test-extensions.php
+++ b/src/globals/test-extensions.php
@ -2,24 +2,55 @@

 declare(strict_types=1);

-# Normal test, contains `common` extension.
-$extensions = 'bcmath,bz2,calendar,ctype,curl,dom,exif,fileinfo,filter,ftp,gd,gmp,iconv,xml,mbstring,mbregex,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,redis,session,simplexml,soap,sockets,sqlite3,tokenizer,xmlwriter,xmlreader,zlib,zip';
+/**
+ * This is GitHub Actions automatic test extension args generator.
+ * You can edit $extensions, $with_libs and $base_combination.
+ */

-# Normal test, contains gd extra libraries.
-$additional_libs = 'libwebp,libavif,libjpeg,freetype';
+// --------------------------------- edit area ---------------------------------

-# If you want to test additional extensions, add them below. (comma start)
-$extensions .= ',xhprof';
+// If you want to test your added extensions and libs, add below (comma separated, example `bcmath,openssl`).
+$extensions = 'swoole,swoole-hook-pgsql,swoole-hook-mysql,swoole-hook-sqlite';

-# If you want to test additional features for extensions, add libs below. (comma start like extensions)
-$additional_libs .= '';
+// If you want to test lib-suggests feature with extension, add them below (comma separated, example `libwebp,libavif`).
+$with_libs = '';
+
+// Please change your test base combination. We recommend testing with `common`.
+// You can use `common`, `bulk`, `minimal` or `none`.
+$base_combination = 'minimal';
+
+// -------------------------- code area, do not modify --------------------------
+
+/**
+ * get combination for tests, do not modify it if not necessary.
+ */
+function _getCombination(string $type = 'common'): string
+{
+    return match ($type) {
+        'common' => 'bcmath,bz2,calendar,ctype,curl,dom,exif,fileinfo,filter,ftp,gd,gmp,iconv,xml,mbstring,mbregex,' .
+            'mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,redis,session,simplexml,soap,sockets,' .
+            'sqlite3,tokenizer,xmlwriter,xmlreader,zlib,zip',
+        'bulk' => 'apcu,bcmath,bz2,calendar,ctype,curl,dba,dom,event,exif,fileinfo,filter,ftp,gd,gmp,iconv,imagick,imap,' .
+            'intl,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pcntl,pdo,pdo_mysql,pdo_pgsql,pdo_sqlite,pgsql,phar,' .
+            'posix,protobuf,readline,redis,session,shmop,simplexml,soap,sockets,sodium,sqlite3,swoole,sysvmsg,sysvsem,' .
+            'sysvshm,tokenizer,xml,xmlreader,xmlwriter,xsl,zip,zlib',
+        'minimal' => 'pcntl,posix,mbstring,tokenizer,phar',
+        default => '', // none
+    };
+}

 if (!isset($argv[1])) {
    exit("Please use 'extensions', 'cmd' or 'libs' as output type");
 }
+
+$trim_value = "\r\n \t,";
+
+$final_extensions = trim(trim($extensions, $trim_value) . ',' . _getCombination($base_combination), $trim_value);
+$final_libs = trim($with_libs, $trim_value);
+
 echo match ($argv[1]) {
-    'extensions' => $extensions,
-    'libs' => $additional_libs,
-    'cmd' => $extensions . ' --with-libs=' . $additional_libs,
+    'extensions' => $final_extensions,
+    'libs' => $final_libs,
+    'cmd' => $final_extensions . ($final_libs === '' ? '' : (' --with-libs=' . $final_libs)),
    default => '',
 };
--- a/src/globals/tests/swoole.php
+++ b/src/globals/tests/swoole.php
@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+assert(function_exists('swoole_cpu_num'));
+assert(function_exists('swoole_string'));
+assert(class_exists('Swoole\Coroutine'));
+assert(class_exists('Swoole\Coroutine\Http2\Client'));
+assert(class_exists('Swoole\Coroutine\Redis'));
+assert(class_exists('Swoole\Coroutine\WaitGroup'));
+assert(class_exists('Swoole\Http2\Request'));
+assert(constant('SWOOLE_VERSION'));