Merge pull request #858 from crazywhalecc/fix/imagick

imagick needs static libstdc++ on gcc-toolset (successor of devtoolse) too

.editorconfig

@@ -10,6 +10,7 @@ trim_trailing_whitespace = true
 
 [*.md]
 trim_trailing_whitespace = false
+indent_size = 2
 
 [*.{yml,yaml, vue}]
 indent_size = 2

.github/ISSUE_TEMPLATE/bug_report.md

@@ -3,6 +3,15 @@ name: Bug report
 about: Build PHP or library failed, download failed, doesn't seem to work...
 title: ''
 labels: bug
-assignees: crazywhalecc
+body:
-
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: |
+        Please tell us what you do, what you get and what you expected.
+        Provide with some step-by-step instructions to reproduce the issue.
+        If possible, attach a screenshot or log files in ./log directory.
+    validations:
+      required: true
 ---

.github/ISSUE_TEMPLATE/feature_request.md

@@ -3,6 +3,6 @@ name: Feature request
 about: Suggest an idea for this project
 title: ''
 labels: new feature
-assignees: ''
+assignees: crazywhalecc
 
 ---

.github/workflows/ext-matrix-tests.yml

@@ -82,7 +82,7 @@ jobs:
           - zlib
           - zstd
         php-version:
-          - "git"
+          - "8.5"
         operating-system:
           - "ubuntu-latest"
           #- "macos-13"

.github/workflows/release-build.yml

@@ -3,6 +3,10 @@ name: Build SPC Binary
 on:
   push:
     branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+    paths:
+      - '.github/workflows/release-build.yml'
   release:
     types:
       - published
@@ -10,7 +14,7 @@ on:
 
 env:
   PHP_VERSION: 8.4
-  MICRO_VERSION: 8.4.10
+  MICRO_VERSION: 8.4.11
 
 jobs:
   build-release-artifacts:
@@ -117,7 +121,8 @@ jobs:
           files: dist/${{ matrix.operating-system.filename }}
 
       - name: "Deploy to self-hosted OSS"
-        if: github.repository == 'crazywhalecc/static-php-cli'
+        # only run this step if the repository is static-php-cli and the branch is main
+        if: github.repository == 'crazywhalecc/static-php-cli' && github.ref == 'refs/heads/main'
         uses: static-php/upload-s3-action@v1.0.0
         with:
           aws_key_id: ${{ secrets.AWS_KEY_ID }}
@@ -132,3 +137,39 @@ jobs:
         with:
           path: spc${{ env.SUFFIX }}
           name: spc-${{ matrix.operating-system.name }}${{ env.SUFFIX }}
+  test-spc:
+    name: "Test SPC Binary for ${{ matrix.operating-system.name }}"
+    runs-on: ${{ matrix.operating-system.os }}
+    needs: [build-release-artifacts]
+    strategy:
+      matrix:
+        operating-system:
+          - name: "linux-x86_64"
+            os: "ubuntu-latest"
+          - name: "macos-x86_64"
+            os: "macos-13"
+          - name: "linux-aarch64"
+            os: "ubuntu-24.04-arm"
+          - name: "macos-aarch64"
+            os: "macos-latest"
+          - name: "windows-x64"
+            os: "windows-latest"
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v4
+
+      - name: "Download Artifact"
+        uses: actions/download-artifact@v4
+        env:
+          SUFFIX: ${{ matrix.operating-system.name == 'windows-x64' && '.exe' || '' }}
+        with:
+          name: spc-${{ matrix.operating-system.name }}${{ env.SUFFIX }}
+
+      - name: "Chmod"
+        if: matrix.operating-system.name != 'windows-x64'
+        run: chmod +x spc
+
+      - name: "Run SPC Tests"
+        env:
+          SUFFIX: ${{ matrix.operating-system.name == 'windows-x64' && '.exe' || '' }}
+        run: ./spc${{ env.SUFFIX }} dev:extensions

.github/workflows/tests.yml

@@ -206,6 +206,13 @@ jobs:
         if: ${{ !startsWith(matrix.os, 'windows-') }}
         run: php src/globals/test-extensions.php build_embed_cmd ${{ matrix.os }} ${{ matrix.php }}
 
+      - name: "Upload logs"
+        if: ${{ always() && hashFiles('log/**') != '' }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-logs-${{ matrix.os }}-${{ matrix.php }}
+          path: log
+
 #      - name: Setup tmate session
 #        if: ${{ failure() }}
 #        uses: mxschmitt/action-tmate@v3

.gitignore

@@ -48,6 +48,12 @@ packlib_files.txt
 package-lock.json
 pnpm-lock.yaml
 
-# craft.log
+# craft
-craft.log
 craft.yml
+
+# SPC logs
+log/
+
+# spc.phar
+spc.phar
+spc.exe

composer.json

@@ -16,7 +16,7 @@
         "symfony/console": "^5.4 || ^6 || ^7",
         "symfony/process": "^7.2",
         "symfony/yaml": "^7.2",
-        "zhamao/logger": "^1.0"
+        "zhamao/logger": "^1.1.3"
     },
     "require-dev": {
         "captainhook/captainhook-phar": "^5.23",

composer.lock

@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "dbefe1ee5c584f6f0cc64c26fb83451c",
+    "content-hash": "f81132977eb1310f5ccb27c8de76c8d2",
     "packages": [
         {
             "name": "illuminate/collections",
@@ -1211,16 +1211,16 @@
         },
         {
             "name": "zhamao/logger",
-            "version": "1.1.2",
+            "version": "1.1.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/zhamao-robot/zhamao-logger.git",
-                "reference": "1d7427abd8b1b3387ed7d9244953049356db3e62"
+                "reference": "2551b3e1dbbb1db81794d5c3a666c66804a9dca9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/zhamao-robot/zhamao-logger/zipball/1d7427abd8b1b3387ed7d9244953049356db3e62",
+                "url": "https://api.github.com/repos/zhamao-robot/zhamao-logger/zipball/2551b3e1dbbb1db81794d5c3a666c66804a9dca9",
-                "reference": "1d7427abd8b1b3387ed7d9244953049356db3e62",
+                "reference": "2551b3e1dbbb1db81794d5c3a666c66804a9dca9",
                 "shasum": ""
             },
             "require": {
@@ -1274,9 +1274,9 @@
             "description": "Another Console Logger for CLI Applications",
             "support": {
                 "issues": "https://github.com/zhamao-robot/zhamao-logger/issues",
-                "source": "https://github.com/zhamao-robot/zhamao-logger/tree/1.1.2"
+                "source": "https://github.com/zhamao-robot/zhamao-logger/tree/1.1.3"
             },
-            "time": "2025-04-24T02:02:28+00:00"
+            "time": "2025-08-02T13:44:27+00:00"
         }
     ],
     "packages-dev": [
@@ -3489,16 +3489,16 @@
         },
         {
             "name": "myclabs/deep-copy",
-            "version": "1.13.3",
+            "version": "1.13.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/myclabs/DeepCopy.git",
-                "reference": "faed855a7b5f4d4637717c2b3863e277116beb36"
+                "reference": "07d290f0c47959fd5eed98c95ee5602db07e0b6a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/faed855a7b5f4d4637717c2b3863e277116beb36",
+                "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/07d290f0c47959fd5eed98c95ee5602db07e0b6a",
-                "reference": "faed855a7b5f4d4637717c2b3863e277116beb36",
+                "reference": "07d290f0c47959fd5eed98c95ee5602db07e0b6a",
                 "shasum": ""
             },
             "require": {
@@ -3537,7 +3537,7 @@
             ],
             "support": {
                 "issues": "https://github.com/myclabs/DeepCopy/issues",
-                "source": "https://github.com/myclabs/DeepCopy/tree/1.13.3"
+                "source": "https://github.com/myclabs/DeepCopy/tree/1.13.4"
             },
             "funding": [
                 {
@@ -3545,7 +3545,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-07-05T12:25:42+00:00"
+            "time": "2025-08-01T08:46:24+00:00"
         },
         {
             "name": "nikic/iter",

config/ext.json

@@ -694,7 +694,8 @@
         "arg-type": "custom",
         "ext-suggests": [
             "session",
-            "igbinary"
+            "igbinary",
+            "msgpack"
         ],
         "lib-suggests-unix": [
             "zstd",

docs/en/guide/manual-build.md

@@ -172,7 +172,7 @@ If the build is successful, you will see the `buildroot/bin` directory in the cu
 If the build fails, you can use the `--debug` parameter to view detailed error information, 
 or use the `--with-clean` to clear the old compilation results and recompile.
 
-If the build still fails to use the above method, please submit an issue and attach your `craft.yml` and `craft.log`.
+If the build still fails to use the above method, please submit an issue and attach your `craft.yml` and `./log` archive.
 
 ## Step-by-step build command
 

docs/zh/guide/manual-build.md

@@ -149,7 +149,7 @@ bin/spc craft --debug
 
 如果中途构建出错，你可以使用 `--debug` 参数查看详细的错误信息，或者使用 `--with-clean` 参数清除旧的编译结果，重新编译。
 
-如使用以上方式仍构建失败，请提交一个 issue，附上你的 `craft.yml`、`craft.log`。
+如使用以上方式仍构建失败，请提交一个 issue，附上你的 `craft.yml` 文件、`log/` 目录的压缩包。
 
 ## 分步构建命令
 

phpstan.neon

@@ -8,6 +8,7 @@ parameters:
     - '#class Fiber#'
     - '#Attribute class JetBrains\\PhpStorm\\ArrayShape does not exist#'
     - '#Function Swoole\\Coroutine\\run not found.#'
+    - '#Static call to instance method ZM\\Logger\\ConsoleColor#'
   dynamicConstantNames:
     - PHP_OS_FAMILY
   excludePaths:

src/SPC/ConsoleApplication.php

@@ -34,7 +34,7 @@ use Symfony\Component\Console\Application;
  */
 final class ConsoleApplication extends Application
 {
-    public const VERSION = '2.7.0';
+    public const string VERSION = '2.7.2';
 
     public function __construct()
     {

src/SPC/builder/BuilderBase.php

@@ -4,18 +4,15 @@ declare(strict_types=1);
 
 namespace SPC\builder;
 
-use PharIo\FileSystem\File;
+use SPC\exception\BuildFailureException;
-use SPC\exception\ExceptionHandler;
-use SPC\exception\FileSystemException;
 use SPC\exception\InterruptException;
-use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 use SPC\store\FileSystem;
 use SPC\store\LockFile;
 use SPC\store\SourceManager;
 use SPC\store\SourcePatcher;
-use SPC\util\CustomExt;
+use SPC\util\AttributeMapper;
 
 abstract class BuilderBase
 {
@@ -46,20 +43,14 @@ abstract class BuilderBase
     /**
      * Convert libraries to class
      *
-     * @param  array<string>       $sorted_libraries Libraries to build (if not empty, must sort first)
+     * @param array<string> $sorted_libraries Libraries to build (if not empty, must sort first)
-     * @throws FileSystemException
+     *
-     * @throws RuntimeException
-     * @throws WrongUsageException
      * @internal
      */
     abstract public function proveLibs(array $sorted_libraries);
 
     /**
      * Set-Up libraries
-     *
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
      */
     public function setupLibs(): void
     {
@@ -70,12 +61,11 @@ abstract class BuilderBase
             match ($status) {
                 LIB_STATUS_OK => logger()->info('lib [' . $lib::NAME . '] setup success, took ' . round(microtime(true) - $starttime, 2) . ' s'),
                 LIB_STATUS_ALREADY => logger()->notice('lib [' . $lib::NAME . '] already built'),
-                LIB_STATUS_BUILD_FAILED => logger()->error('lib [' . $lib::NAME . '] build failed'),
                 LIB_STATUS_INSTALL_FAILED => logger()->error('lib [' . $lib::NAME . '] install failed'),
                 default => logger()->warning('lib [' . $lib::NAME . '] build status unknown'),
             };
             if (in_array($status, [LIB_STATUS_BUILD_FAILED, LIB_STATUS_INSTALL_FAILED])) {
-                throw new RuntimeException('Library [' . $lib::NAME . '] setup failed.');
+                throw new BuildFailureException('Library [' . $lib::NAME . '] setup failed.');
             }
         }
     }
@@ -139,9 +129,6 @@ abstract class BuilderBase
 
     /**
      * Check if there is a cpp extensions or libraries.
-     *
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function hasCpp(): bool
     {
@@ -174,15 +161,10 @@ abstract class BuilderBase
     /**
      * Verify the list of "ext" extensions for validity and declare an Extension object to check the dependencies of the extensions.
      *
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws \ReflectionException
-     * @throws \Throwable|WrongUsageException
      * @internal
      */
     public function proveExts(array $static_extensions, array $shared_extensions = [], bool $skip_check_deps = false, bool $skip_extract = false): void
     {
-        CustomExt::loadCustomExt();
         // judge ext
         foreach ($static_extensions as $ext) {
             // if extension does not support static build, throw exception
@@ -213,7 +195,7 @@ abstract class BuilderBase
         }
 
         foreach ([...$static_extensions, ...$shared_extensions] as $extension) {
-            $class = CustomExt::getExtClass($extension);
+            $class = AttributeMapper::getExtensionClassByName($extension) ?? Extension::class;
             /** @var Extension $ext */
             $ext = new $class($extension, $this);
             if (in_array($extension, $static_extensions)) {
@@ -248,9 +230,7 @@ abstract class BuilderBase
     abstract public function testPHP(int $build_target = BUILD_TARGET_NONE);
 
     /**
-     * @throws WrongUsageException
+     * Build shared extensions.
-     * @throws RuntimeException
-     * @throws FileSystemException
      */
     public function buildSharedExts(): void
     {
@@ -273,9 +253,8 @@ abstract class BuilderBase
                 }
                 $ext->buildShared();
             }
-        } catch (RuntimeException $e) {
+        } finally {
             FileSystem::replaceFileLineContainsString(BUILD_BIN_PATH . '/php-config', 'extension_dir=', $extension_dir_line);
-            throw $e;
         }
         FileSystem::replaceFileLineContainsString(BUILD_BIN_PATH . '/php-config', 'extension_dir=', $extension_dir_line);
         FileSystem::replaceFileStr(BUILD_LIB_PATH . '/php/build/phpize.m4', '# test "[$]$1" = "no" && $1=yes', 'test "[$]$1" = "no" && $1=yes');
@@ -284,9 +263,6 @@ abstract class BuilderBase
     /**
      * Generate extension enable arguments for configure.
      * e.g. --enable-mbstring
-     *
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function makeStaticExtensionArgs(): string
     {
@@ -321,9 +297,6 @@ abstract class BuilderBase
 
     /**
      * Get PHP Version ID from php-src/main/php_version.h
-     *
-     * @throws RuntimeException
-     * @throws WrongUsageException
      */
     public function getPHPVersionID(): int
     {
@@ -336,7 +309,7 @@ abstract class BuilderBase
             return intval($match[1]);
         }
 
-        throw new RuntimeException('PHP version file format is malformed, please remove it and download again');
+        throw new WrongUsageException('PHP version file format is malformed, please remove "./source/php-src" dir and download/extract again');
     }
 
     public function getPHPVersion(bool $exception_on_failure = true): string
@@ -354,7 +327,7 @@ abstract class BuilderBase
         if (!$exception_on_failure) {
             return 'unknown';
         }
-        throw new RuntimeException('PHP version file format is malformed, please remove it and download again');
+        throw new WrongUsageException('PHP version file format is malformed, please remove it and download again');
     }
 
     /**
@@ -501,7 +474,7 @@ abstract class BuilderBase
         foreach ($patches as $patch) {
             try {
                 if (!file_exists($patch)) {
-                    throw new RuntimeException("Additional patch script file {$patch} not found!");
+                    throw new WrongUsageException("Additional patch script file {$patch} not found!");
                 }
                 logger()->debug('Running additional patch script: ' . $patch);
                 require $patch;
@@ -514,11 +487,6 @@ abstract class BuilderBase
                 exit($e->getCode());
             } catch (\Throwable $e) {
                 logger()->critical('Patch script ' . $patch . ' failed to run.');
-                if ($this->getOption('debug')) {
-                    ExceptionHandler::getInstance()->handle($e);
-                } else {
-                    logger()->critical('Please check with --debug option to see more details.');
-                }
                 throw $e;
             }
         }

src/SPC/builder/BuilderProvider.php

@@ -8,8 +8,7 @@ use SPC\builder\freebsd\BSDBuilder;
 use SPC\builder\linux\LinuxBuilder;
 use SPC\builder\macos\MacOSBuilder;
 use SPC\builder\windows\WindowsBuilder;
-use SPC\exception\FileSystemException;
+use SPC\exception\ExceptionHandler;
-use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use Symfony\Component\Console\Input\InputInterface;
 
@@ -20,11 +19,6 @@ class BuilderProvider
 {
     private static ?BuilderBase $builder = null;
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     public static function makeBuilderByInput(InputInterface $input): BuilderBase
     {
         ini_set('memory_limit', '4G');
@@ -36,12 +30,13 @@ class BuilderProvider
             'BSD' => new BSDBuilder($input->getOptions()),
             default => throw new WrongUsageException('Current OS "' . PHP_OS_FAMILY . '" is not supported yet'),
         };
+
+        // bind the builder to ExceptionHandler
+        ExceptionHandler::bindBuilder(self::$builder);
+
         return self::$builder;
     }
 
-    /**
-     * @throws WrongUsageException
-     */
     public static function getBuilder(): BuilderBase
     {
         if (self::$builder === null) {

src/SPC/builder/Extension.php

@@ -4,8 +4,9 @@ declare(strict_types=1);
 
 namespace SPC\builder;
 
-use SPC\exception\FileSystemException;
+use SPC\exception\EnvironmentException;
-use SPC\exception\RuntimeException;
+use SPC\exception\SPCException;
+use SPC\exception\ValidationException;
 use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 use SPC\store\FileSystem;
@@ -24,21 +25,16 @@ class Extension
 
     protected string $source_dir;
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     public function __construct(protected string $name, protected BuilderBase $builder)
     {
         $ext_type = Config::getExt($this->name, 'type');
         $unix_only = Config::getExt($this->name, 'unix-only', false);
         $windows_only = Config::getExt($this->name, 'windows-only', false);
         if (PHP_OS_FAMILY !== 'Windows' && $windows_only) {
-            throw new RuntimeException("{$ext_type} extension {$name} is not supported on Linux and macOS platform");
+            throw new EnvironmentException("{$ext_type} extension {$name} is not supported on Linux and macOS platform");
         }
         if (PHP_OS_FAMILY === 'Windows' && $unix_only) {
-            throw new RuntimeException("{$ext_type} extension {$name} is not supported on Windows platform");
+            throw new EnvironmentException("{$ext_type} extension {$name} is not supported on Windows platform");
         }
         // set source_dir for builtin
         if ($ext_type === 'builtin') {
@@ -46,7 +42,7 @@ class Extension
         } elseif ($ext_type === 'external') {
             $source = Config::getExt($this->name, 'source');
             if ($source === null) {
-                throw new RuntimeException("{$ext_type} extension {$name} source not found");
+                throw new ValidationException("{$ext_type} extension {$name} source not found", validation_module: "Extension [{$name}] loader");
             }
             $source_path = Config::getSource($source)['path'] ?? null;
             $source_path = $source_path === null ? SOURCE_PATH . '/' . $source : SOURCE_PATH . '/' . $source_path;
@@ -63,9 +59,6 @@ class Extension
 
     /**
      * 获取开启该扩展的 PHP 编译添加的参数
-     *
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function getConfigureArg(bool $shared = false): string
     {
@@ -80,9 +73,6 @@ class Extension
 
     /**
      * 根据 ext 的 arg-type 获取对应开启的参数，一般都是 --enable-xxx 和 --with-xxx
-     *
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function getEnableArg(bool $shared = false): string
     {
@@ -112,10 +102,6 @@ class Extension
 
     /**
      * 检查下依赖就行了，作用是导入依赖给 Extension 对象，今后可以对库依赖进行选择性处理
-     *
-     * @throws RuntimeException
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function checkDependency(): static
     {
@@ -259,8 +245,6 @@ class Extension
      *                i.e.; pdo_pgsql would return:
      *
      * `-d "extension=pgsql" -d "extension=pdo_pgsql"`
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function getSharedExtensionLoadString(): string
     {
@@ -300,20 +284,16 @@ class Extension
         return $ret;
     }
 
-    /**
-     * @throws RuntimeException
-     */
     public function runCliCheckUnix(): void
     {
         // Run compile check if build target is cli
         // If you need to run some check, overwrite this or add your assert in src/globals/ext-tests/{extension_name}.php
-        // If check failed, throw RuntimeException
         $sharedExtensions = $this->getSharedExtensionLoadString();
         [$ret, $out] = shell()->execWithResult(BUILD_BIN_PATH . '/php -n' . $sharedExtensions . ' --ri "' . $this->getDistName() . '"');
         if ($ret !== 0) {
-            throw new RuntimeException(
+            throw new ValidationException(
-                'extension ' . $this->getName() . ' failed runtime check: php-cli returned ' . $ret . "\n" .
+                "extension {$this->getName()} failed compile check: php-cli returned {$ret}",
-                join("\n", $out)
+                validation_module: 'Extension ' . $this->getName() . ' sanity check'
             );
         }
 
@@ -327,23 +307,21 @@ class Extension
 
             [$ret, $out] = shell()->execWithResult(BUILD_BIN_PATH . '/php -n' . $sharedExtensions . ' -r "' . trim($test) . '"');
             if ($ret !== 0) {
-                var_dump($out);
+                throw new ValidationException(
-                throw new RuntimeException('extension ' . $this->getName() . ' failed sanity check');
+                    "extension {$this->getName()} failed sanity check. Code: {$ret}, output: " . implode("\n", $out),
+                    validation_module: 'Extension ' . $this->getName() . ' function check'
+                );
             }
         }
     }
 
-    /**
-     * @throws RuntimeException
-     */
     public function runCliCheckWindows(): void
     {
         // Run compile check if build target is cli
         // If you need to run some check, overwrite this or add your assert in src/globals/ext-tests/{extension_name}.php
-        // If check failed, throw RuntimeException
         [$ret] = cmd()->execWithResult(BUILD_ROOT_PATH . '/bin/php.exe -n --ri "' . $this->getDistName() . '"', false);
         if ($ret !== 0) {
-            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: php-cli returned ' . $ret);
+            throw new ValidationException("extension {$this->getName()} failed compile check: php-cli returned {$ret}", validation_module: "Extension {$this->getName()} sanity check");
         }
 
         if (file_exists(FileSystem::convertPath(ROOT_DIR . '/src/globals/ext-tests/' . $this->getName() . '.php'))) {
@@ -356,7 +334,10 @@ class Extension
 
             [$ret] = cmd()->execWithResult(BUILD_ROOT_PATH . '/bin/php.exe -n -r "' . trim($test) . '"');
             if ($ret !== 0) {
-                throw new RuntimeException('extension ' . $this->getName() . ' failed sanity check');
+                throw new ValidationException(
+                    "extension {$this->getName()} failed function check",
+                    validation_module: "Extension {$this->getName()} function check"
+                );
             }
         }
     }
@@ -368,50 +349,46 @@ class Extension
 
     /**
      * Build shared extension
-     *
-     * @throws WrongUsageException
-     * @throws RuntimeException
      */
     public function buildShared(): void
     {
-        if (Config::getExt($this->getName(), 'type') === 'builtin' || Config::getExt($this->getName(), 'build-with-php') === true) {
+        try {
+            if (Config::getExt($this->getName(), 'type') === 'builtin' || Config::getExt($this->getName(), 'build-with-php') === true) {
+                if (file_exists(BUILD_MODULES_PATH . '/' . $this->getName() . '.so')) {
+                    logger()->info('Shared extension [' . $this->getName() . '] was already built by php-src/configure (' . $this->getName() . '.so)');
+                    return;
+                }
+                if (Config::getExt($this->getName(), 'build-with-php') === true) {
+                    logger()->warning('Shared extension [' . $this->getName() . '] did not build with php-src/configure (' . $this->getName() . '.so)');
+                    logger()->warning('Try deleting your build and source folders and running `spc build`` again.');
+                    return;
+                }
+            }
             if (file_exists(BUILD_MODULES_PATH . '/' . $this->getName() . '.so')) {
-                logger()->info('Shared extension [' . $this->getName() . '] was already built by php-src/configure (' . $this->getName() . '.so)');
+                logger()->info('Shared extension [' . $this->getName() . '] was already built, skipping (' . $this->getName() . '.so)');
-                return;
             }
-            if (Config::getExt($this->getName(), 'build-with-php') === true) {
+            logger()->info('Building extension [' . $this->getName() . '] as shared extension (' . $this->getName() . '.so)');
-                logger()->warning('Shared extension [' . $this->getName() . '] did not build with php-src/configure (' . $this->getName() . '.so)');
+            foreach ($this->dependencies as $dependency) {
-                logger()->warning('Try deleting your build and source folders and running `spc build`` again.');
+                if (!$dependency instanceof Extension) {
-                return;
+                    continue;
+                }
+                if (!$dependency->isBuildStatic()) {
+                    logger()->info('extension ' . $this->getName() . ' requires extension ' . $dependency->getName());
+                    $dependency->buildShared();
+                }
             }
+            match (PHP_OS_FAMILY) {
+                'Darwin', 'Linux' => $this->buildUnixShared(),
+                default => throw new WrongUsageException(PHP_OS_FAMILY . ' build shared extensions is not supported yet'),
+            };
+        } catch (SPCException $e) {
+            $e->bindExtensionInfo(['extension_name' => $this->getName()]);
+            throw $e;
         }
-        if (file_exists(BUILD_MODULES_PATH . '/' . $this->getName() . '.so')) {
-            logger()->info('Shared extension [' . $this->getName() . '] was already built, skipping (' . $this->getName() . '.so)');
-        }
-        logger()->info('Building extension [' . $this->getName() . '] as shared extension (' . $this->getName() . '.so)');
-        foreach ($this->dependencies as $dependency) {
-            if (!$dependency instanceof Extension) {
-                continue;
-            }
-            if (!$dependency->isBuildStatic()) {
-                logger()->info('extension ' . $this->getName() . ' requires extension ' . $dependency->getName());
-                $dependency->buildShared();
-            }
-        }
-        match (PHP_OS_FAMILY) {
-            'Darwin', 'Linux' => $this->buildUnixShared(),
-            default => throw new WrongUsageException(PHP_OS_FAMILY . ' build shared extensions is not supported yet'),
-        };
     }
 
     /**
      * Build shared extension for Unix
-     *
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     * @throws \ReflectionException
-     * @throws \Throwable
      */
     public function buildUnixShared(): void
     {
@@ -506,15 +483,12 @@ class Extension
         return $this->build_static;
     }
 
-    /**
-     * @throws RuntimeException
-     */
     protected function addLibraryDependency(string $name, bool $optional = false): void
     {
         $depLib = $this->builder->getLib($name);
         if (!$depLib) {
             if (!$optional) {
-                throw new RuntimeException("extension {$this->name} requires library {$name}");
+                throw new WrongUsageException("extension {$this->name} requires library {$name}");
             }
             logger()->info("enabling {$this->name} without library {$name}");
         } else {
@@ -522,15 +496,12 @@ class Extension
         }
     }
 
-    /**
-     * @throws RuntimeException
-     */
     protected function addExtensionDependency(string $name, bool $optional = false): void
     {
         $depExt = $this->builder->getExt($name);
         if (!$depExt) {
             if (!$optional) {
-                throw new RuntimeException("{$this->name} requires extension {$name}");
+                throw new WrongUsageException("{$this->name} requires extension {$name} which is not included");
             }
             logger()->info("enabling {$this->name} without extension {$name}");
         } else {

src/SPC/builder/LibraryBase.php

@@ -4,8 +4,8 @@ declare(strict_types=1);
 
 namespace SPC\builder;
 
-use SPC\exception\FileSystemException;
+use SPC\exception\SPCException;
-use SPC\exception\RuntimeException;
+use SPC\exception\SPCInternalException;
 use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 use SPC\store\Downloader;
@@ -27,23 +27,17 @@ abstract class LibraryBase
 
     protected bool $patched = false;
 
-    /**
-     * @throws RuntimeException
-     */
     public function __construct(?string $source_dir = null)
     {
         if (static::NAME === 'unknown') {
-            throw new RuntimeException('no unknown!!!!!');
+            throw new SPCInternalException('Please set the NAME constant in ' . static::class);
         }
-        $this->source_dir = $source_dir ?? (SOURCE_PATH . '/' . Config::getLib(static::NAME, 'source'));
+        $this->source_dir = $source_dir ?? (SOURCE_PATH . DIRECTORY_SEPARATOR . Config::getLib(static::NAME, 'source'));
     }
 
     /**
      * Try to install or build this library.
-     * @param  bool                $force If true, force install or build
+     * @param bool $force If true, force install or build
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
      */
     public function setup(bool $force = false): int
     {
@@ -107,10 +101,6 @@ abstract class LibraryBase
 
     /**
      * Calculate dependencies for current library.
-     *
-     * @throws RuntimeException
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function calcDependency(): void
     {
@@ -131,9 +121,6 @@ abstract class LibraryBase
 
     /**
      * Get config static libs.
-     *
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function getStaticLibs(): array
     {
@@ -142,9 +129,6 @@ abstract class LibraryBase
 
     /**
      * Get config headers.
-     *
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function getHeaders(): array
     {
@@ -153,19 +137,12 @@ abstract class LibraryBase
 
     /**
      * Get binary files.
-     *
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function getBinaryFiles(): array
     {
         return Config::getLib(static::NAME, 'bin', []);
     }
 
-    /**
-     * @throws WrongUsageException
-     * @throws FileSystemException
-     */
     public function tryInstall(array $lock, bool $force_install = false): int
     {
         $install_file = $lock['filename'];
@@ -177,7 +154,7 @@ abstract class LibraryBase
                 FileSystem::extractPackage($install_file, $lock['source_type'], DOWNLOAD_PATH . '/' . $install_file, BUILD_ROOT_PATH);
                 $this->install();
                 return LIB_STATUS_OK;
-            } catch (FileSystemException|RuntimeException $e) {
+            } catch (SPCException $e) {
                 logger()->error('Failed to extract pre-built library [' . static::NAME . ']: ' . $e->getMessage());
                 return LIB_STATUS_INSTALL_FAILED;
             }
@@ -194,10 +171,6 @@ abstract class LibraryBase
      * BUILD_STATUS_OK if build success
      * BUILD_STATUS_ALREADY if already built
      * BUILD_STATUS_FAILED if build failed
-     *
-     * @throws RuntimeException
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function tryBuild(bool $force_build = false): int
     {
@@ -319,8 +292,6 @@ abstract class LibraryBase
 
     /**
      * Build this library.
-     *
-     * @throws RuntimeException
      */
     abstract protected function build();
 
@@ -333,7 +304,7 @@ abstract class LibraryBase
         }
         $replace_items = json_decode(file_get_contents($replace_item_file), true);
         if (!is_array($replace_items)) {
-            throw new RuntimeException('Invalid placeholder file: ' . $replace_item_file);
+            throw new SPCInternalException("Invalid placeholder file: {$replace_item_file}");
         }
         $placeholders = get_pack_replace();
         // replace placeholders in BUILD_ROOT_PATH
@@ -351,8 +322,6 @@ abstract class LibraryBase
 
     /**
      * Add lib dependency
-     *
-     * @throws RuntimeException
      */
     protected function addLibraryDependency(string $name, bool $optional = false): void
     {
@@ -362,7 +331,7 @@ abstract class LibraryBase
             return;
         }
         if (!$optional) {
-            throw new RuntimeException(static::NAME . " requires library {$name}");
+            throw new WrongUsageException(static::NAME . " requires library {$name} but it is not included");
         }
         logger()->debug('enabling ' . static::NAME . " without {$name}");
     }

src/SPC/builder/extension/bz2.php

@@ -6,18 +6,12 @@ namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
 use SPC\builder\macos\MacOSBuilder;
-use SPC\exception\FileSystemException;
-use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('bz2')]
 class bz2 extends Extension
 {
-    /**
-     * @throws FileSystemException
-     * @throws WrongUsageException
-     */
     public function patchBeforeConfigure(): bool
     {
         $frameworks = $this->builder instanceof MacOSBuilder ? ' ' . $this->builder->getFrameworks(true) . ' ' : '';

src/SPC/builder/extension/curl.php

@@ -8,17 +8,13 @@ use SPC\builder\Extension;
 use SPC\builder\linux\LinuxBuilder;
 use SPC\builder\macos\MacOSBuilder;
 use SPC\builder\windows\WindowsBuilder;
-use SPC\exception\FileSystemException;
+use SPC\exception\PatchException;
-use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('curl')]
 class curl extends Extension
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeBuildconf(): bool
     {
         logger()->info('patching before-configure for curl checks');
@@ -46,10 +42,6 @@ class curl extends Extension
         return true;
     }
 
-    /**
-     * @throws FileSystemException
-     * @throws WrongUsageException
-     */
     public function patchBeforeConfigure(): bool
     {
         $frameworks = $this->builder instanceof MacOSBuilder ? ' ' . $this->builder->getFrameworks(true) . ' ' : '';
@@ -105,7 +97,7 @@ class curl extends Extension
         );
 
         if ($patched === null) {
-            throw new \RuntimeException('Failed to patch config.m4 due to a regex error');
+            throw new PatchException('shared extension curl patcher', 'Failed to patch config.m4 due to a regex error');
         }
 
         FileSystem::writeFile($file, $patched);

src/SPC/builder/extension/dom.php

@@ -5,16 +5,12 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('dom')]
 class dom extends Extension
 {
-    /**
-     * @throws RuntimeException
-     */
     public function getUnixConfigureArg(bool $shared = false): string
     {
         $arg = '--enable-dom' . ($shared ? '=shared' : '');

src/SPC/builder/extension/ev.php

@@ -5,16 +5,12 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('ev')]
 class ev extends Extension
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeBuildconf(): bool
     {
         /*

src/SPC/builder/extension/event.php

@@ -6,7 +6,6 @@ namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
 use SPC\builder\macos\MacOSBuilder;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
@@ -27,18 +26,12 @@ class event extends Extension
         return $arg;
     }
 
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeConfigure(): bool
     {
         FileSystem::replaceFileRegex(SOURCE_PATH . '/php-src/configure', '/-levent_openssl/', $this->getLibFilesString());
         return true;
     }
 
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeMake(): bool
     {
         $patched = parent::patchBeforeMake();

src/SPC/builder/extension/gettext.php

@@ -6,17 +6,12 @@ namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
 use SPC\builder\macos\MacOSBuilder;
-use SPC\exception\FileSystemException;
-use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('gettext')]
 class gettext extends Extension
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeBuildconf(): bool
     {
         if ($this->builder instanceof MacOSBuilder) {
@@ -25,10 +20,6 @@ class gettext extends Extension
         return true;
     }
 
-    /**
-     * @throws WrongUsageException
-     * @throws FileSystemException
-     */
     public function patchBeforeConfigure(): bool
     {
         if ($this->builder instanceof MacOSBuilder) {

src/SPC/builder/extension/glfw.php

@@ -5,16 +5,12 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('glfw')]
 class glfw extends Extension
 {
-    /**
-     * @throws RuntimeException
-     */
     public function patchBeforeBuildconf(): bool
     {
         if (file_exists(SOURCE_PATH . '/php-src/ext/glfw')) {

src/SPC/builder/extension/grpc.php

@@ -6,6 +6,7 @@ namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
 use SPC\builder\windows\WindowsBuilder;
+use SPC\exception\ValidationException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 use SPC\util\GlobalEnvManager;
@@ -18,7 +19,7 @@ class grpc extends Extension
     public function patchBeforeBuildconf(): bool
     {
         if ($this->builder instanceof WindowsBuilder) {
-            throw new \RuntimeException('grpc extension does not support windows yet');
+            throw new ValidationException('grpc extension does not support windows yet');
         }
         if (file_exists(SOURCE_PATH . '/php-src/ext/grpc')) {
             return false;
@@ -27,7 +28,7 @@ class grpc extends Extension
         if (is_dir($this->source_dir . '/src/php/ext/grpc')) {
             shell()->exec('ln -s ' . $this->source_dir . '/src/php/ext/grpc ' . SOURCE_PATH . '/php-src/ext/grpc');
         } else {
-            throw new \RuntimeException('Cannot find grpc source code');
+            throw new ValidationException('Cannot find grpc source code in ' . $this->source_dir . '/src/php/ext/grpc');
         }
         if (SPCTarget::getTargetOS() === 'Darwin') {
             FileSystem::replaceFileRegex(

src/SPC/builder/extension/imagick.php

@@ -19,7 +19,7 @@ class imagick extends Extension
     protected function splitLibsIntoStaticAndShared(string $allLibs): array
     {
         [$static, $shared] = parent::splitLibsIntoStaticAndShared($allLibs);
-        if (str_contains(getenv('PATH'), 'rh/devtoolset-10')) {
+        if (str_contains(getenv('PATH'), 'rh/devtoolset') || str_contains(getenv('PATH'), 'rh/gcc-toolset')) {
             $static .= ' -l:libstdc++.a';
             $shared = str_replace('-lstdc++', '', $shared);
         }

src/SPC/builder/extension/imap.php

@@ -24,9 +24,6 @@ class imap extends Extension
         return false;
     }
 
-    /**
-     * @throws WrongUsageException
-     */
     public function validate(): void
     {
         if ($this->builder->getOption('enable-zts')) {

src/SPC/builder/extension/mbregex.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
+use SPC\exception\ValidationException;
 use SPC\util\CustomExt;
 
 #[CustomExt('mbregex')]
@@ -16,11 +16,6 @@ class mbregex extends Extension
         return 'mbstring';
     }
 
-    public function getConfigureArg(bool $shared = false): string
-    {
-        return '';
-    }
-
     /**
      * mbregex is not an extension, we need to overwrite the default check.
      */
@@ -29,7 +24,7 @@ class mbregex extends Extension
         $sharedext = $this->builder->getExt('mbstring')->isBuildShared() ? '-d "extension_dir=' . BUILD_MODULES_PATH . '" -d "extension=mbstring"' : '';
         [$ret] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php -n' . $sharedext . ' --ri "mbstring" | grep regex', false);
         if ($ret !== 0) {
-            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: compiled php-cli mbstring extension does not contain regex !');
+            throw new ValidationException("Extension {$this->getName()} failed compile check: compiled php-cli mbstring extension does not contain regex !");
         }
     }
 
@@ -37,11 +32,11 @@ class mbregex extends Extension
     {
         [$ret, $out] = cmd()->execWithResult(BUILD_ROOT_PATH . '/bin/php -n  --ri "mbstring"', false);
         if ($ret !== 0) {
-            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: compiled php-cli does not contain mbstring !');
+            throw new ValidationException("extension {$this->getName()} failed compile check: compiled php-cli does not contain mbstring !");
         }
         $out = implode("\n", $out);
         if (!str_contains($out, 'regex')) {
-            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: compiled php-cli mbstring extension does not contain regex !');
+            throw new ValidationException("extension {$this->getName()} failed compile check: compiled php-cli mbstring extension does not contain regex !");
         }
     }
 }

src/SPC/builder/extension/memcache.php

@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
@@ -17,9 +16,6 @@ class memcache extends Extension
         return '--enable-memcache' . ($shared ? '=shared' : '') . ' --with-zlib-dir=' . BUILD_ROOT_PATH;
     }
 
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeBuildconf(): bool
     {
         FileSystem::replaceFileStr(

src/SPC/builder/extension/opcache.php

@@ -5,7 +5,6 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use SPC\store\SourcePatcher;
 use SPC\util\CustomExt;
@@ -13,10 +12,6 @@ use SPC\util\CustomExt;
 #[CustomExt('opcache')]
 class opcache extends Extension
 {
-    /**
-     * @throws WrongUsageException
-     * @throws RuntimeException
-     */
     public function validate(): void
     {
         if ($this->builder->getPHPVersionID() < 80000 && getenv('SPC_SKIP_PHP_VERSION_CHECK') !== 'yes') {

src/SPC/builder/extension/opentelemetry.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
+use SPC\exception\ValidationException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 use SPC\util\GlobalEnvManager;
@@ -15,7 +16,7 @@ class opentelemetry extends Extension
     public function validate(): void
     {
         if ($this->builder->getPHPVersionID() < 80000 && getenv('SPC_SKIP_PHP_VERSION_CHECK') !== 'yes') {
-            throw new \RuntimeException('The opentelemetry extension requires PHP 8.0 or later');
+            throw new ValidationException('The opentelemetry extension requires PHP 8.0 or later');
         }
     }
 

src/SPC/builder/extension/password_argon2.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
+use SPC\exception\ValidationException;
 use SPC\util\CustomExt;
 
 #[CustomExt('password-argon2')]
@@ -20,7 +20,7 @@ class password_argon2 extends Extension
     {
         [$ret] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php -n -r "assert(defined(\'PASSWORD_ARGON2I\'));"');
         if ($ret !== 0) {
-            throw new RuntimeException('extension ' . $this->getName() . ' failed sanity check');
+            throw new ValidationException('extension ' . $this->getName() . ' failed sanity check', validation_module: 'password_argon2 function check');
         }
     }
 

src/SPC/builder/extension/pdo_sqlite.php

@@ -5,16 +5,12 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('pdo_sqlite')]
 class pdo_sqlite extends Extension
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeConfigure(): bool
     {
         FileSystem::replaceFileRegex(

src/SPC/builder/extension/pgsql.php

@@ -5,20 +5,12 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('pgsql')]
 class pgsql extends Extension
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     public function patchBeforeConfigure(): bool
     {
         FileSystem::replaceFileRegex(
@@ -29,10 +21,6 @@ class pgsql extends Extension
         return true;
     }
 
-    /**
-     * @throws WrongUsageException
-     * @throws RuntimeException
-     */
     public function getUnixConfigureArg(bool $shared = false): string
     {
         if ($this->builder->getPHPVersionID() >= 80400) {
@@ -46,10 +34,6 @@ class pgsql extends Extension
         return '--with-pgsql=' . ($shared ? 'shared,' : '') . BUILD_ROOT_PATH;
     }
 
-    /**
-     * @throws WrongUsageException
-     * @throws RuntimeException
-     */
     public function getWindowsConfigureArg(bool $shared = false): string
     {
         if ($this->builder->getPHPVersionID() >= 80400) {

src/SPC/builder/extension/protobuf.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
+use SPC\exception\ValidationException;
 use SPC\util\CustomExt;
 
 #[CustomExt('protobuf')]
@@ -13,12 +14,12 @@ class protobuf extends Extension
     public function validate(): void
     {
         if ($this->builder->getPHPVersionID() < 80000 && getenv('SPC_SKIP_PHP_VERSION_CHECK') !== 'yes') {
-            throw new \RuntimeException('The latest protobuf extension requires PHP 8.0 or later');
+            throw new ValidationException('The latest protobuf extension requires PHP 8.0 or later');
         }
         $grpc = $this->builder->getExt('grpc');
         // protobuf conflicts with grpc
         if ($grpc?->isBuildStatic()) {
-            throw new \RuntimeException('protobuf conflicts with grpc, please remove grpc or protobuf extension');
+            throw new ValidationException('protobuf conflicts with grpc, please remove grpc or protobuf extension');
         }
     }
 }

src/SPC/builder/extension/rar.php

@@ -6,16 +6,12 @@ namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
 use SPC\builder\macos\MacOSBuilder;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('rar')]
 class rar extends Extension
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeBuildconf(): bool
     {
         // workaround for newer Xcode clang (>= 15.0)

src/SPC/builder/extension/readline.php

@@ -5,16 +5,12 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('readline')]
 class readline extends Extension
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeConfigure(): bool
     {
         FileSystem::replaceFileRegex(

src/SPC/builder/extension/redis.php

@@ -16,9 +16,11 @@ class redis extends Extension
         if ($this->isBuildStatic()) {
             $arg .= $this->builder->getExt('session')?->isBuildStatic() ? ' --enable-redis-session' : ' --disable-redis-session';
             $arg .= $this->builder->getExt('igbinary')?->isBuildStatic() ? ' --enable-redis-igbinary' : ' --disable-redis-igbinary';
+            $arg .= $this->builder->getExt('msgpack')?->isBuildStatic() ? ' --enable-redis-msgpack' : ' --disable-redis-msgpack';
         } else {
             $arg .= $this->builder->getExt('session') ? ' --enable-redis-session' : ' --disable-redis-session';
             $arg .= $this->builder->getExt('igbinary') ? ' --enable-redis-igbinary' : ' --disable-redis-igbinary';
+            $arg .= $this->builder->getExt('msgpack') ? ' --enable-redis-msgpack' : ' --disable-redis-msgpack';
         }
         if ($this->builder->getLib('zstd')) {
             $arg .= ' --enable-redis-zstd --with-libzstd="' . BUILD_ROOT_PATH . '"';

src/SPC/builder/extension/snappy.php

@@ -6,16 +6,12 @@ namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
 use SPC\builder\macos\MacOSBuilder;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('snappy')]
 class snappy extends Extension
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeConfigure(): bool
     {
         FileSystem::replaceFileRegex(

src/SPC/builder/extension/ssh2.php

@@ -5,16 +5,12 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
 #[CustomExt('ssh2')]
 class ssh2 extends Extension
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeConfigure(): bool
     {
         FileSystem::replaceFileRegex(

src/SPC/builder/extension/swoole_hook_mysql.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
+use SPC\exception\ValidationException;
 use SPC\util\CustomExt;
 
 #[CustomExt('swoole-hook-mysql')]
@@ -32,10 +32,10 @@ class swoole_hook_mysql extends Extension
         [$ret, $out] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php -n' . $this->getSharedExtensionLoadString() . ' --ri "swoole"', false);
         $out = implode('', $out);
         if ($ret !== 0) {
-            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: php-cli returned ' . $ret);
+            throw new ValidationException("extension {$this->getName()} failed compile check: php-cli returned {$ret}", validation_module: 'extension swoole_hook_mysql sanity check');
         }
         if (!str_contains($out, 'mysqlnd')) {
-            throw new RuntimeException('swoole mysql hook is not enabled correctly.');
+            throw new ValidationException('swoole mysql hook is not enabled correctly.', validation_module: 'Extension swoole mysql hook avilability check');
         }
     }
 }

src/SPC/builder/extension/swoole_hook_pgsql.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
+use SPC\exception\ValidationException;
 use SPC\exception\WrongUsageException;
 use SPC\util\CustomExt;
 
@@ -41,10 +41,16 @@ class swoole_hook_pgsql extends Extension
         [$ret, $out] = shell()->execWithResult(BUILD_BIN_PATH . '/php -n' . $sharedExtensions . ' --ri "' . $this->getDistName() . '"');
         $out = implode('', $out);
         if ($ret !== 0) {
-            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: php-cli returned ' . $ret);
+            throw new ValidationException(
+                "extension {$this->getName()} failed sanity check: php-cli returned {$ret}",
+                validation_module: 'Extension swoole-hook-pgsql sanity check'
+            );
         }
         if (!str_contains($out, 'coroutine_pgsql')) {
-            throw new RuntimeException('swoole pgsql hook is not enabled correctly.');
+            throw new ValidationException(
+                'swoole pgsql hook is not enabled correctly.',
+                validation_module: 'Extension swoole pgsql hook availability check'
+            );
         }
     }
 }

src/SPC/builder/extension/swoole_hook_sqlite.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
+use SPC\exception\ValidationException;
 use SPC\exception\WrongUsageException;
 use SPC\util\CustomExt;
 
@@ -41,10 +41,10 @@ class swoole_hook_sqlite extends Extension
         [$ret, $out] = shell()->execWithResult(BUILD_BIN_PATH . '/php -n' . $sharedExtensions . ' --ri "' . $this->getDistName() . '"');
         $out = implode('', $out);
         if ($ret !== 0) {
-            throw new RuntimeException('extension ' . $this->getName() . ' failed compile check: php-cli returned ' . $ret);
+            throw new ValidationException("extension {$this->getName()} failed compile check: php-cli returned {$ret}", validation_module: "Extension {$this->getName()} sanity check");
         }
         if (!str_contains($out, 'coroutine_sqlite')) {
-            throw new RuntimeException('swoole sqlite hook is not enabled correctly.');
+            throw new ValidationException('swoole sqlite hook is not enabled correctly.', validation_module: 'Extension swoole sqlite hook availability check');
         }
     }
 }

src/SPC/builder/extension/swow.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
+use SPC\exception\ValidationException;
 use SPC\util\CustomExt;
 
 #[CustomExt('swow')]
@@ -14,7 +14,7 @@ class swow extends Extension
     public function validate(): void
     {
         if ($this->builder->getPHPVersionID() < 80000 && getenv('SPC_SKIP_PHP_VERSION_CHECK') !== 'yes') {
-            throw new RuntimeException('The latest swow extension requires PHP 8.0 or later');
+            throw new ValidationException('The latest swow extension requires PHP 8.0 or later');
         }
     }
 
@@ -26,9 +26,6 @@ class swow extends Extension
         return $arg;
     }
 
-    /**
-     * @throws RuntimeException
-     */
     public function patchBeforeBuildconf(): bool
     {
         if ($this->builder->getPHPVersionID() >= 80000 && !is_link(SOURCE_PATH . '/php-src/ext/swow')) {

src/SPC/builder/extension/uv.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
+use SPC\exception\ValidationException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
@@ -14,7 +15,7 @@ class uv extends Extension
     public function validate(): void
     {
         if ($this->builder->getPHPVersionID() < 80000 && getenv('SPC_SKIP_PHP_VERSION_CHECK') !== 'yes') {
-            throw new \RuntimeException('The latest uv extension requires PHP 8.0 or later');
+            throw new ValidationException('The latest uv extension requires PHP 8.0 or later');
         }
     }
 

src/SPC/builder/extension/xml.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
-use SPC\exception\RuntimeException;
+use SPC\exception\SPCInternalException;
 use SPC\store\FileSystem;
 use SPC\util\CustomExt;
 
@@ -16,9 +16,6 @@ use SPC\util\CustomExt;
 #[CustomExt('simplexml')]
 class xml extends Extension
 {
-    /**
-     * @throws RuntimeException
-     */
     public function getUnixConfigureArg(bool $shared = false): string
     {
         $arg = match ($this->name) {
@@ -27,7 +24,7 @@ class xml extends Extension
             'xmlreader' => '--enable-xmlreader',
             'xmlwriter' => '--enable-xmlwriter',
             'simplexml' => '--enable-simplexml',
-            default => throw new RuntimeException('Not accept non-xml extension'),
+            default => throw new SPCInternalException('Not accept non-xml extension'),
         };
         $arg .= ($shared ? '=shared' : '') . ' --with-libxml="' . BUILD_ROOT_PATH . '"';
         return $arg;
@@ -47,7 +44,7 @@ class xml extends Extension
             'xmlreader' => '--enable-xmlreader',
             'xmlwriter' => '--enable-xmlwriter',
             'simplexml' => '--with-simplexml',
-            default => throw new RuntimeException('Not accept non-xml extension'),
+            default => throw new SPCInternalException('Not accept non-xml extension'),
         };
         $arg .= ' --with-libxml';
         return $arg;

src/SPC/builder/freebsd/BSDBuilder.php

@@ -5,8 +5,6 @@ declare(strict_types=1);
 namespace SPC\builder\freebsd;
 
 use SPC\builder\unix\UnixBuilderBase;
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\store\SourcePatcher;
@@ -16,11 +14,6 @@ class BSDBuilder extends UnixBuilderBase
     /** @var bool Micro patch phar flag */
     private bool $phar_patched = false;
 
-    /**
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     * @throws FileSystemException
-     */
     public function __construct(array $options = [])
     {
         $this->options = $options;
@@ -56,10 +49,7 @@ class BSDBuilder extends UnixBuilderBase
     /**
      * Just start to build statically linked php binary
      *
-     * @param  int                 $build_target build target
+     * @param int $build_target build target
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
      */
     public function buildPHP(int $build_target = BUILD_TARGET_NONE): void
     {
@@ -148,9 +138,6 @@ class BSDBuilder extends UnixBuilderBase
 
     /**
      * Build cli sapi
-     *
-     * @throws RuntimeException
-     * @throws FileSystemException
      */
     protected function buildCli(): void
     {
@@ -170,10 +157,6 @@ class BSDBuilder extends UnixBuilderBase
 
     /**
      * Build phpmicro sapi
-     *
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
      */
     protected function buildMicro(): void
     {
@@ -209,9 +192,6 @@ class BSDBuilder extends UnixBuilderBase
 
     /**
      * Build fpm sapi
-     *
-     * @throws RuntimeException
-     * @throws FileSystemException
      */
     protected function buildFpm(): void
     {
@@ -230,8 +210,6 @@ class BSDBuilder extends UnixBuilderBase
 
     /**
      * Build embed sapi
-     *
-     * @throws RuntimeException
      */
     protected function buildEmbed(): void
     {

src/SPC/builder/freebsd/SystemUtil.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\freebsd;
 
 use SPC\builder\traits\UnixSystemUtilTrait;
-use SPC\exception\RuntimeException;
+use SPC\exception\EnvironmentException;
 use SPC\exception\WrongUsageException;
 
 class SystemUtil
@@ -15,14 +15,15 @@ class SystemUtil
 
     /**
      * Get Logic CPU Count for macOS
-     *
-     * @throws RuntimeException
      */
     public static function getCpuCount(): int
     {
         [$ret, $output] = shell()->execWithResult('sysctl -n hw.ncpu');
         if ($ret !== 0) {
-            throw new RuntimeException('Failed to get cpu count');
+            throw new EnvironmentException(
+                'Failed to get cpu count from FreeBSD sysctl',
+                'Please ensure you are running this command on a FreeBSD system and have the sysctl command available.'
+            );
         }
 
         return (int) $output[0];
@@ -31,9 +32,8 @@ class SystemUtil
     /**
      * Get Target Arch CFlags
      *
-     * @param  string              $arch Arch Name
+     * @param  string $arch Arch Name
-     * @return string              return Arch CFlags string
+     * @return string return Arch CFlags string
-     * @throws WrongUsageException
      */
     public static function getArchCFlags(string $arch): string
     {

src/SPC/builder/freebsd/library/openssl.php

@@ -22,19 +22,11 @@ declare(strict_types=1);
 namespace SPC\builder\freebsd\library;
 
 use SPC\builder\macos\library\MacOSLibraryBase;
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 
 class openssl extends BSDLibraryBase
 {
     public const NAME = 'openssl';
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         [$lib,,$destdir] = SEPARATED_PATH;

src/SPC/builder/linux/LinuxBuilder.php

@@ -5,8 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\linux;
 
 use SPC\builder\unix\UnixBuilderBase;
-use SPC\exception\FileSystemException;
+use SPC\exception\PatchException;
-use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\store\SourcePatcher;
@@ -19,10 +18,6 @@ class LinuxBuilder extends UnixBuilderBase
     /** @var bool Micro patch phar flag */
     private bool $phar_patched = false;
 
-    /**
-     * @throws FileSystemException
-     * @throws WrongUsageException
-     */
     public function __construct(array $options = [])
     {
         $this->options = $options;
@@ -45,10 +40,7 @@ class LinuxBuilder extends UnixBuilderBase
     /**
      * Build PHP from source.
      *
-     * @param  int                 $build_target Build target, use `BUILD_TARGET_*` constants
+     * @param int $build_target Build target, use `BUILD_TARGET_*` constants
-     * @throws RuntimeException
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function buildPHP(int $build_target = BUILD_TARGET_NONE): void
     {
@@ -168,9 +160,6 @@ class LinuxBuilder extends UnixBuilderBase
 
     /**
      * Build cli sapi
-     *
-     * @throws RuntimeException
-     * @throws FileSystemException
      */
     protected function buildCli(): void
     {
@@ -193,10 +182,6 @@ class LinuxBuilder extends UnixBuilderBase
 
     /**
      * Build phpmicro sapi
-     *
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
      */
     protected function buildMicro(): void
     {
@@ -231,9 +216,6 @@ class LinuxBuilder extends UnixBuilderBase
 
     /**
      * Build fpm sapi
-     *
-     * @throws FileSystemException
-     * @throws RuntimeException
      */
     protected function buildFpm(): void
     {
@@ -255,8 +237,6 @@ class LinuxBuilder extends UnixBuilderBase
 
     /**
      * Build embed sapi
-     *
-     * @throws RuntimeException
      */
     protected function buildEmbed(): void
     {
@@ -346,12 +326,6 @@ class LinuxBuilder extends UnixBuilderBase
 
     /**
      * Return extra variables for php make command.
-     *
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     * @throws \ReflectionException
-     * @throws \Throwable
      */
     private function getMakeExtraVars(): array
     {
@@ -370,8 +344,6 @@ class LinuxBuilder extends UnixBuilderBase
      * Strip micro.sfx for Linux.
      * The micro.sfx does not support UPX directly, but we can remove UPX-info segment to adapt.
      * This will also make micro.sfx with upx-packed more like a malware fore antivirus :(
-     *
-     * @throws RuntimeException
      */
     private function processMicroUPX(): void
     {
@@ -386,7 +358,7 @@ class LinuxBuilder extends UnixBuilderBase
                 $out[1] = explode(' ', $out[1]);
                 $offset = $out[1][0];
                 if ($ret !== 0 || !str_starts_with($offset, '0x')) {
-                    throw new RuntimeException('Cannot find offset in readelf output');
+                    throw new PatchException('phpmicro UPX patcher', 'Cannot find offset in readelf output');
                 }
                 $offset = hexdec($offset);
                 // remove upx extra wastes

src/SPC/builder/linux/library/imap.php

@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\linux\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\SPCTarget;
 
@@ -13,9 +11,6 @@ class imap extends LinuxLibraryBase
 {
     public const NAME = 'imap';
 
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeBuild(): bool
     {
         $cc = getenv('CC') ?: 'gcc';
@@ -44,9 +39,6 @@ class imap extends LinuxLibraryBase
         return false;
     }
 
-    /**
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         if ($this->builder->getLib('openssl')) {

src/SPC/builder/linux/library/libffi.php

@@ -4,18 +4,12 @@ declare(strict_types=1);
 
 namespace SPC\builder\linux\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 class libffi extends LinuxLibraryBase
 {
     public const NAME = 'libffi';
 
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     public function build(): void
     {
         UnixAutoconfExecutor::create($this)

src/SPC/builder/linux/library/libpng.php

@@ -21,20 +21,12 @@ declare(strict_types=1);
 
 namespace SPC\builder\linux\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 class libpng extends LinuxLibraryBase
 {
     public const NAME = 'libpng';
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     public function build(): void
     {
         UnixAutoconfExecutor::create($this)

src/SPC/builder/linux/library/openssl.php

@@ -21,9 +21,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\linux\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 
 class openssl extends LinuxLibraryBase
@@ -32,11 +29,6 @@ class openssl extends LinuxLibraryBase
 
     public const NAME = 'openssl';
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     public function build(): void
     {
         $extra = '';

src/SPC/builder/macos/MacOSBuilder.php

@@ -6,8 +6,6 @@ namespace SPC\builder\macos;
 
 use SPC\builder\macos\library\MacOSLibraryBase;
 use SPC\builder\unix\UnixBuilderBase;
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\store\SourcePatcher;
@@ -19,11 +17,6 @@ class MacOSBuilder extends UnixBuilderBase
     /** @var bool Micro patch phar flag */
     private bool $phar_patched = false;
 
-    /**
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     * @throws FileSystemException
-     */
     public function __construct(array $options = [])
     {
         $this->options = $options;
@@ -48,9 +41,7 @@ class MacOSBuilder extends UnixBuilderBase
     /**
      * Get dynamically linked macOS frameworks
      *
-     * @param  bool                $asString If true, return as string
+     * @param bool $asString If true, return as string
-     * @throws FileSystemException
-     * @throws WrongUsageException
      */
     public function getFrameworks(bool $asString = false): array|string
     {
@@ -83,10 +74,7 @@ class MacOSBuilder extends UnixBuilderBase
     /**
      * Just start to build statically linked php binary
      *
-     * @param  int                 $build_target build target
+     * @param int $build_target build target
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
      */
     public function buildPHP(int $build_target = BUILD_TARGET_NONE): void
     {
@@ -190,9 +178,6 @@ class MacOSBuilder extends UnixBuilderBase
 
     /**
      * Build cli sapi
-     *
-     * @throws RuntimeException
-     * @throws FileSystemException
      */
     protected function buildCli(): void
     {
@@ -209,10 +194,6 @@ class MacOSBuilder extends UnixBuilderBase
 
     /**
      * Build phpmicro sapi
-     *
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
      */
     protected function buildMicro(): void
     {
@@ -248,9 +229,6 @@ class MacOSBuilder extends UnixBuilderBase
 
     /**
      * Build fpm sapi
-     *
-     * @throws RuntimeException
-     * @throws FileSystemException
      */
     protected function buildFpm(): void
     {
@@ -266,8 +244,6 @@ class MacOSBuilder extends UnixBuilderBase
 
     /**
      * Build embed sapi
-     *
-     * @throws RuntimeException
      */
     protected function buildEmbed(): void
     {

src/SPC/builder/macos/SystemUtil.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace SPC\builder\macos;
 
 use SPC\builder\traits\UnixSystemUtilTrait;
-use SPC\exception\RuntimeException;
+use SPC\exception\EnvironmentException;
 use SPC\exception\WrongUsageException;
 
 class SystemUtil
@@ -15,25 +15,25 @@ class SystemUtil
 
     /**
      * Get Logic CPU Count for macOS
-     *
-     * @throws RuntimeException
      */
     public static function getCpuCount(): int
     {
-        [$ret, $output] = shell()->execWithResult('sysctl -n hw.ncpu', false);
+        $cpu = exec('sysctl -n hw.ncpu', $output, $ret);
         if ($ret !== 0) {
-            throw new RuntimeException('Failed to get cpu count');
+            throw new EnvironmentException(
+                'Failed to get cpu count from macOS sysctl',
+                'Please ensure you are running this command on a macOS system and have the sysctl command available.'
+            );
         }
 
-        return (int) $output[0];
+        return (int) $cpu;
     }
 
     /**
      * Get Target Arch CFlags
      *
-     * @param  string              $arch Arch Name
+     * @param  string $arch Arch Name
-     * @return string              return Arch CFlags string
+     * @return string return Arch CFlags string
-     * @throws WrongUsageException
      */
     public static function getArchCFlags(string $arch): string
     {

src/SPC/builder/macos/library/MacOSLibraryBase.php

@@ -8,8 +8,6 @@ use SPC\builder\BuilderBase;
 use SPC\builder\LibraryBase;
 use SPC\builder\macos\MacOSBuilder;
 use SPC\builder\traits\UnixLibraryTrait;
-use SPC\exception\FileSystemException;
-use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 
 abstract class MacOSLibraryBase extends LibraryBase
@@ -28,10 +26,6 @@ abstract class MacOSLibraryBase extends LibraryBase
         return $this->builder;
     }
 
-    /**
-     * @throws WrongUsageException
-     * @throws FileSystemException
-     */
     public function getFrameworks(): array
     {
         return Config::getLib(static::NAME, 'frameworks', []);

src/SPC/builder/macos/library/curl.php

@@ -21,7 +21,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 
 class curl extends MacOSLibraryBase
@@ -30,9 +29,6 @@ class curl extends MacOSLibraryBase
 
     public const NAME = 'curl';
 
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeBuild(): bool
     {
         FileSystem::replaceFileRegex(

src/SPC/builder/macos/library/glfw.php

@@ -4,18 +4,12 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 class glfw extends MacOSLibraryBase
 {
     public const NAME = 'glfw';
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/macos/library/imap.php

@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\store\SourcePatcher;
 
@@ -13,10 +11,6 @@ class imap extends MacOSLibraryBase
 {
     public const NAME = 'imap';
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     public function patchBeforeBuild(): bool
     {
         $cc = getenv('CC') ?: 'clang';
@@ -37,9 +31,6 @@ class imap extends MacOSLibraryBase
         return true;
     }
 
-    /**
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         if ($this->builder->getLib('openssl')) {

src/SPC/builder/macos/library/libffi.php

@@ -4,18 +4,12 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 class libffi extends MacOSLibraryBase
 {
     public const NAME = 'libffi';
 
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         $arch = getenv('SPC_ARCH');

src/SPC/builder/macos/library/libpng.php

@@ -21,20 +21,12 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 class libpng extends MacOSLibraryBase
 {
     public const NAME = 'libpng';
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         $arch = arch2gnu(php_uname('m'));

src/SPC/builder/macos/library/openssl.php

@@ -21,9 +21,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 
 class openssl extends MacOSLibraryBase
@@ -32,11 +29,6 @@ class openssl extends MacOSLibraryBase
 
     public const NAME = 'openssl';
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         // lib:zlib

src/SPC/builder/traits/UnixLibraryTrait.php

@@ -4,20 +4,13 @@ declare(strict_types=1);
 
 namespace SPC\builder\traits;
 
-use SPC\exception\FileSystemException;
+use SPC\exception\PatchException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 use SPC\store\FileSystem;
 use SPC\util\SPCConfigUtil;
 
 trait UnixLibraryTrait
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     * @throws WrongUsageException
-     */
     public function getStaticLibFiles(bool $include_self = true): string
     {
         $libs = $include_self ? [$this] : [];
@@ -28,11 +21,11 @@ trait UnixLibraryTrait
     }
 
     /**
-     * Patch pkgconfig file prefix
+     * Patch pkgconfig file prefix, exec_prefix, libdir, includedir for correct build.
      *
-     * @param  array               $files file list
+     * @param array      $files          File list to patch, if empty, will use pkg-configs from config (e.g. ['zlib.pc', 'openssl.pc'])
-     * @throws FileSystemException
+     * @param int        $patch_option   Patch options
-     * @throws RuntimeException
+     * @param null|array $custom_replace Custom replace rules, if provided, will be used to replace in the format [regex, replacement]
      */
     public function patchPkgconfPrefix(array $files = [], int $patch_option = PKGCONF_PATCH_ALL, ?array $custom_replace = null): void
     {
@@ -43,7 +36,7 @@ trait UnixLibraryTrait
         foreach ($files as $name) {
             $realpath = realpath(BUILD_ROOT_PATH . '/lib/pkgconfig/' . $name);
             if ($realpath === false) {
-                throw new RuntimeException('Cannot find library [' . static::NAME . '] pkgconfig file [' . $name . '] !');
+                throw new PatchException('pkg-config prefix patcher', 'Cannot find library [' . static::NAME . '] pkgconfig file [' . $name . '] in ' . BUILD_LIB_PATH . '/pkgconfig/ !');
             }
             logger()->debug('Patching ' . $realpath);
             // replace prefix
@@ -70,7 +63,7 @@ trait UnixLibraryTrait
             $realpath = realpath(BUILD_LIB_PATH . '/' . $name);
             if ($realpath === false) {
                 if ($throwOnMissing) {
-                    throw new RuntimeException('Cannot find library [' . static::NAME . '] la file [' . $name . '] !');
+                    throw new PatchException('la dependency patcher', 'Cannot find library [' . static::NAME . '] la file [' . $name . '] !');
                 }
                 logger()->warning('Cannot find library [' . static::NAME . '] la file [' . $name . '] !');
                 continue;

src/SPC/builder/traits/openssl.php

@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 namespace SPC\builder\traits;
 
-use SPC\exception\RuntimeException;
+use SPC\exception\SPCException;
 use SPC\store\FileSystem;
 use SPC\util\PkgConfigUtil;
 
@@ -24,7 +24,7 @@ trait openssl
         if (PHP_OS_FAMILY !== 'Windows') {
             try {
                 return PkgConfigUtil::getModuleVersion('openssl');
-            } catch (RuntimeException) {
+            } catch (SPCException) {
             }
         }
         // get openssl version from header openssl/opensslv.h

src/SPC/builder/unix/UnixBuilderBase.php

@@ -5,8 +5,8 @@ declare(strict_types=1);
 namespace SPC\builder\unix;
 
 use SPC\builder\BuilderBase;
-use SPC\exception\FileSystemException;
+use SPC\exception\SPCInternalException;
-use SPC\exception\RuntimeException;
+use SPC\exception\ValidationException;
 use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 use SPC\store\CurlHook;
@@ -56,7 +56,14 @@ abstract class UnixBuilderBase extends BuilderBase
             }
             // if some libs are not supported (but in config "lib.json", throw exception)
             if (!isset($support_lib_list[$library])) {
-                throw new WrongUsageException('library [' . $library . '] is in the lib.json list but not supported to compile, but in the future I will support it!');
+                $os = match (PHP_OS_FAMILY) {
+                    'Linux' => 'Linux',
+                    'Darwin' => 'macOS',
+                    'Windows' => 'Windows',
+                    'BSD' => 'FreeBSD',
+                    default => PHP_OS_FAMILY,
+                };
+                throw new WrongUsageException("library [{$library}] is in the lib.json list but not supported to build on {$os}.");
             }
             $lib = new ($support_lib_list[$library])($this);
             $this->addLib($lib);
@@ -70,9 +77,7 @@ abstract class UnixBuilderBase extends BuilderBase
     }
 
     /**
-     * Sanity check after build complete
+     * Sanity check after build complete.
-     *
-     * @throws RuntimeException
      */
     protected function sanityCheck(int $build_target): void
     {
@@ -82,7 +87,7 @@ abstract class UnixBuilderBase extends BuilderBase
             [$ret, $output] = shell()->execWithResult(BUILD_BIN_PATH . '/php -n -r "echo \"hello\";"');
             $raw_output = implode('', $output);
             if ($ret !== 0 || trim($raw_output) !== 'hello') {
-                throw new RuntimeException("cli failed sanity check: ret[{$ret}]. out[{$raw_output}]");
+                throw new ValidationException("cli failed sanity check. code: {$ret}, output: {$raw_output}", validation_module: 'php-cli sanity check');
             }
 
             foreach ($this->getExts() as $ext) {
@@ -105,7 +110,10 @@ abstract class UnixBuilderBase extends BuilderBase
                 foreach ($task['conditions'] as $condition => $closure) {
                     if (!$closure($ret, $out)) {
                         $raw_out = trim(implode('', $out));
-                        throw new RuntimeException("micro failed sanity check: {$task_name}, condition [{$condition}], ret[{$ret}], out[{$raw_out}]");
+                        throw new ValidationException(
+                            "failure info: {$condition}, code: {$ret}, output: {$raw_out}",
+                            validation_module: "phpmicro sanity check item [{$task_name}]"
+                        );
                     }
                 }
             }
@@ -144,11 +152,17 @@ abstract class UnixBuilderBase extends BuilderBase
             }
             [$ret, $out] = shell()->cd($sample_file_path)->execWithResult(getenv('CC') . ' -o embed embed.c ' . $lens);
             if ($ret !== 0) {
-                throw new RuntimeException('embed failed sanity check: build failed. Error message: ' . implode("\n", $out));
+                throw new ValidationException(
+                    'embed failed sanity check: build failed. Error message: ' . implode("\n", $out),
+                    validation_module: 'static libphp.a sanity check'
+                );
             }
             [$ret, $output] = shell()->cd($sample_file_path)->execWithResult($ext_path . './embed');
             if ($ret !== 0 || trim(implode('', $output)) !== 'hello') {
-                throw new RuntimeException('embed failed sanity check: run failed. Error message: ' . implode("\n", $output));
+                throw new ValidationException(
+                    'embed failed sanity check: run failed. Error message: ' . implode("\n", $output),
+                    validation_module: 'static libphp.a sanity check'
+                );
             }
         }
 
@@ -157,24 +171,28 @@ abstract class UnixBuilderBase extends BuilderBase
             logger()->info('running frankenphp sanity check');
             $frankenphp = BUILD_BIN_PATH . '/frankenphp';
             if (!file_exists($frankenphp)) {
-                throw new RuntimeException('FrankenPHP binary not found: ' . $frankenphp);
+                throw new ValidationException(
+                    "FrankenPHP binary not found: {$frankenphp}",
+                    validation_module: 'FrankenPHP sanity check'
+                );
             }
             $prefix = PHP_OS_FAMILY === 'Darwin' ? 'DYLD_' : 'LD_';
             [$ret, $output] = shell()
                 ->setEnv(["{$prefix}LIBRARY_PATH" => BUILD_LIB_PATH])
                 ->execWithResult("{$frankenphp} version");
             if ($ret !== 0 || !str_contains(implode('', $output), 'FrankenPHP')) {
-                throw new RuntimeException('FrankenPHP failed sanity check: ret[' . $ret . ']. out[' . implode('', $output) . ']');
+                throw new ValidationException(
+                    'FrankenPHP failed sanity check: ret[' . $ret . ']. out[' . implode('', $output) . ']',
+                    validation_module: 'FrankenPHP sanity check'
+                );
             }
         }
     }
 
     /**
-     * 将编译好的二进制文件发布到 buildroot
+     * Deploy the binary file to the build bin path.
      *
-     * @param  int                 $type 发布类型
+     * @param int $type Type integer, one of BUILD_TARGET_CLI, BUILD_TARGET_MICRO, BUILD_TARGET_FPM
-     * @throws RuntimeException
-     * @throws FileSystemException
      */
     protected function deployBinary(int $type): bool
     {
@@ -182,7 +200,7 @@ abstract class UnixBuilderBase extends BuilderBase
             BUILD_TARGET_CLI => SOURCE_PATH . '/php-src/sapi/cli/php',
             BUILD_TARGET_MICRO => SOURCE_PATH . '/php-src/sapi/micro/micro.sfx',
             BUILD_TARGET_FPM => SOURCE_PATH . '/php-src/sapi/fpm/php-fpm',
-            default => throw new RuntimeException('Deployment does not accept type ' . $type),
+            default => throw new SPCInternalException("Deployment does not accept type {$type}"),
         };
         logger()->info('Deploying ' . $this->getBuildTypeName($type) . ' file');
         FileSystem::createDir(BUILD_BIN_PATH);
@@ -192,18 +210,15 @@ abstract class UnixBuilderBase extends BuilderBase
 
     /**
      * Run php clean
-     *
-     * @throws RuntimeException
      */
     protected function cleanMake(): void
     {
-        logger()->info('cleaning up');
+        logger()->info('cleaning up php-src build files');
         shell()->cd(SOURCE_PATH . '/php-src')->exec('make clean');
     }
 
     /**
      * Patch phpize and php-config if needed
-     * @throws FileSystemException
      */
     protected function patchPhpScripts(): void
     {
@@ -231,10 +246,6 @@ abstract class UnixBuilderBase extends BuilderBase
         }
     }
 
-    /**
-     * @throws WrongUsageException
-     * @throws RuntimeException
-     */
     protected function buildFrankenphp(): void
     {
         $nobrotli = $this->getLib('brotli') === null ? ',nobrotli' : '';

src/SPC/builder/unix/library/attr.php

@@ -4,14 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait attr
 {
-    /**
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)

src/SPC/builder/unix/library/brotli.php

@@ -4,17 +4,11 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait brotli
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/curl.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait curl
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         shell()->cd($this->source_dir)->exec('sed -i.save s@\${CMAKE_C_IMPLICIT_LINK_LIBRARIES}@@ ./CMakeLists.txt');

src/SPC/builder/unix/library/fastlz.php

@@ -4,6 +4,8 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\BuildFailureException;
+
 trait fastlz
 {
     protected function build(): void
@@ -13,10 +15,10 @@ trait fastlz
             ->exec((getenv('AR') ?: 'ar') . ' rcs libfastlz.a fastlz.o');
 
         if (!copy($this->source_dir . '/fastlz.h', BUILD_INCLUDE_PATH . '/fastlz.h')) {
-            throw new \RuntimeException('Failed to copy fastlz.h');
+            throw new BuildFailureException('Failed to copy fastlz.h, file does not exist');
         }
         if (!copy($this->source_dir . '/libfastlz.a', BUILD_LIB_PATH . '/libfastlz.a')) {
-            throw new \RuntimeException('Failed to copy libfastlz.a');
+            throw new BuildFailureException('Failed to copy libfastlz.a, file does not exist');
         }
     }
 }

src/SPC/builder/unix/library/freetype.php

@@ -4,19 +4,11 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait freetype
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         $cmake = UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/gmp.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait gmp
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)->configure()->make();

src/SPC/builder/unix/library/imagemagick.php

@@ -4,20 +4,12 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixAutoconfExecutor;
 use SPC\util\SPCTarget;
 
 trait imagemagick
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         $ac = UnixAutoconfExecutor::create($this)

src/SPC/builder/unix/library/jbig.php

@@ -4,24 +4,16 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
 trait jbig
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeBuild(): bool
     {
         FileSystem::replaceFileStr($this->source_dir . '/Makefile', 'CFLAGS = -O2 -W -Wno-unused-result', 'CFLAGS = -O2 -W -Wno-unused-result -fPIC');
         return true;
     }
 
-    /**
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         shell()->cd($this->source_dir)->initializeEnv($this)

src/SPC/builder/unix/library/lerc.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait lerc
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libacl.php

@@ -4,16 +4,11 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait libacl
 {
-    /**
-     * @throws FileSystemException
-     */
     public function patchBeforeMake(): bool
     {
         $file_path = SOURCE_PATH . '/php-src/Makefile';
@@ -25,9 +20,6 @@ trait libacl
         return true;
     }
 
-    /**
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)

src/SPC/builder/unix/library/libavif.php

@@ -4,18 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libavif
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libcares.php

@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixAutoconfExecutor;
 
@@ -20,9 +19,6 @@ trait libcares
         return false;
     }
 
-    /**
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)->configure('--disable-tests')->make();

src/SPC/builder/unix/library/libde265.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libde265
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libevent.php

@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixCMakeExecutor;
 
@@ -34,10 +32,6 @@ trait libevent
         }
     }
 
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         $cmake = UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libheif.php

@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixCMakeExecutor;
 
@@ -24,10 +22,6 @@ trait libheif
         return false;
     }
 
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libjpeg.php

@@ -4,18 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libjpeg
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/librabbitmq.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait librabbitmq
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)->addConfigureArgs('-DBUILD_STATIC_LIBS=ON')->build();

src/SPC/builder/unix/library/librdkafka.php

@@ -4,8 +4,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixAutoconfExecutor;
 
@@ -26,10 +24,6 @@ trait librdkafka
         return true;
     }
 
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)

src/SPC/builder/unix/library/libssh2.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libssh2
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libtiff.php

@@ -4,18 +4,12 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixAutoconfExecutor;
 use SPC\util\SPCTarget;
 
 trait libtiff
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         $libcpp = SPCTarget::getTargetOS() === 'Linux' ? '-lstdc++' : '-lc++';

src/SPC/builder/unix/library/libuuid.php

@@ -4,15 +4,11 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libuuid
 {
-    /**
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)->toStep(2)->build();

src/SPC/builder/unix/library/libuv.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libuv
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libwebp.php

@@ -4,18 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libwebp
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libxml2.php

@@ -5,15 +5,11 @@ declare(strict_types=1);
 namespace SPC\builder\unix\library;
 
 use SPC\builder\linux\library\LinuxLibraryBase;
-use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libxml2
 {
-    /**
-     * @throws FileSystemException
-     */
     public function build(): void
     {
         $cmake = UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/libxslt.php

@@ -6,18 +6,10 @@ namespace SPC\builder\unix\library;
 
 use SPC\builder\linux\library\LinuxLibraryBase;
 use SPC\builder\macos\library\MacOSLibraryBase;
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait libxslt
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         $static_libs = $this instanceof LinuxLibraryBase ? $this->getStaticLibFiles(include_self: false) : '';

src/SPC/builder/unix/library/libzip.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixCMakeExecutor;
 
 trait libzip
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         UnixCMakeExecutor::create($this)

src/SPC/builder/unix/library/nghttp2.php

@@ -4,18 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait nghttp2
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)

src/SPC/builder/unix/library/nghttp3.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait nghttp3
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)->configure('--enable-lib-only')->make();

src/SPC/builder/unix/library/ngtcp2.php

@@ -6,18 +6,10 @@ namespace SPC\builder\unix\library;
 
 use SPC\builder\linux\library\LinuxLibraryBase;
 use SPC\builder\macos\library\MacOSLibraryBase;
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait ngtcp2
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)

src/SPC/builder/unix/library/onig.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait onig
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)->configure()->make();

src/SPC/builder/unix/library/postgresql.php

@@ -5,17 +5,13 @@ declare(strict_types=1);
 namespace SPC\builder\unix\library;
 
 use SPC\builder\linux\library\LinuxLibraryBase;
+use SPC\exception\BuildFailureException;
 use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\SPCTarget;
 
 trait postgresql
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         $builddir = BUILD_ROOT_PATH;
@@ -64,7 +60,7 @@ trait postgresql
             $envs .= " LIBS=\"{$libs}{$libcpp}\" ";
         }
         if ($error_exec_cnt > 0) {
-            throw new RuntimeException('Failed to get pkg-config information!');
+            throw new BuildFailureException('Failed to get pkg-config information!');
         }
 
         FileSystem::resetDir($this->source_dir . '/build');
@@ -78,7 +74,7 @@ trait postgresql
                 ->exec('sed -i.backup "278 s/^/# /"  ../src/Makefile.shlib')
                 ->exec('sed -i.backup "402 s/^/# /"  ../src/Makefile.shlib');
         } else {
-            throw new RuntimeException('Unsupported version for postgresql: ' . $version . ' !');
+            throw new BuildFailureException('Unsupported version for postgresql: ' . $version . ' !');
         }
 
         // configure

src/SPC/builder/unix/library/qdbm.php

@@ -5,17 +5,11 @@ declare(strict_types=1);
 namespace SPC\builder\unix\library;
 
 use SPC\builder\macos\library\MacOSLibraryBase;
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait qdbm
 {
-    /**
-     * @throws FileSystemException
-     * @throws RuntimeException
-     */
     protected function build(): void
     {
         $ac = UnixAutoconfExecutor::create($this)->configure();

src/SPC/builder/unix/library/readline.php

@@ -4,16 +4,10 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
 use SPC\util\executor\UnixAutoconfExecutor;
 
 trait readline
 {
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     */
     protected function build(): void
     {
         UnixAutoconfExecutor::create($this)