fix curl 7.4.0 CoreServices framework build bug for mac

README-en.md

@@ -8,11 +8,13 @@ Compile a purely static php-cli binary file with various extensions to make PHP
 
 <img width="600" alt="2023-05-02 15 53 13" src="https://user-images.githubusercontent.com/20330940/235610282-23e58d68-bd35-4092-8465-171cff2d5ba8.png">
 
-You can also use the micro binary file to combine php binary and php source code into one for distribution!
-This feature is provided by [dixyes/phpmicro](https://github.com/dixyes/phpmicro). (micro SAPI)
+You can also use the micro binary file to combine php binary and php source code into one for distribution! (micro SAPI)
 
 <img width="600" alt="2023-05-02 15 52 33" src="https://user-images.githubusercontent.com/20330940/235610318-2ef4e3f1-278b-4ca4-99f4-b38120efc395.png">
 
+> This SAPI feature is from the [Fork](https://github.com/crazywhalecc/phpmicro) of [dixyes/phpmicro](https://github.com/dixyes/phpmicro).
+
+
 [![Version](https://img.shields.io/badge/Version-2.0--rc5-pink.svg?style=flat-square)]()
 [![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)]()
 [![](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/build-linux-x86_64.yml?branch=refactor&label=Linux%20Build&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
@@ -34,6 +36,7 @@ Here is the architecture support status, where `CI` represents support for GitHu
 | macOS   | CI, Local | Local     |
 | Linux   | CI, Local | CI, Local |
 | Windows |           |           |
+| FreeBSD | Local     | Local     |
 
 > macOS-arm64 is not supported for GitHub Actions, if you are going to build on arm, you can build it manually on your own machine.
 

README.md

@@ -4,14 +4,18 @@ Build single static PHP binary, with PHP project together, with popular extensio
 
 **If you are using English, see [English README](README-en.md).**
 
+> 项目别名：standalone-php-compiler
+
 编译纯静态的 PHP Binary 二进制文件，带有各种扩展，让 PHP-cli 应用变得更便携！（cli SAPI）
 
 <img width="600" alt="截屏2023-05-02 15 53 13" src="https://user-images.githubusercontent.com/20330940/235610282-23e58d68-bd35-4092-8465-171cff2d5ba8.png">
 
-同时可以使用 micro 二进制文件，将 PHP 源码和 PHP 二进制构建为一个文件分发！（由 [dixyes/phpmicro](https://github.com/dixyes/phpmicro) 提供支持）（micro SAPI）
+同时可以使用 micro 二进制文件，将 PHP 源码和 PHP 二进制构建为一个文件分发！（micro SAPI）
 
 <img width="600" alt="截屏2023-05-02 15 52 33" src="https://user-images.githubusercontent.com/20330940/235610318-2ef4e3f1-278b-4ca4-99f4-b38120efc395.png">
 
+> 该 SAPI 源自 [dixyes/phpmicro](https://github.com/dixyes/phpmicro) 的 [Fork 仓库](https://github.com/crazywhalecc/phpmicro)。
+
 [![Version](https://img.shields.io/badge/Version-2.0--rc5-pink.svg?style=flat-square)]()
 [![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)]()
 [![](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/build-linux-x86_64.yml?branch=refactor&label=Linux%20Build&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
@@ -33,6 +37,7 @@ Build single static PHP binary, with PHP project together, with popular extensio
 | macOS   | CI, Local | Local     |
 | Linux   | CI, Local | CI, Local |
 | Windows |           |           |
+| FreeBSD | Local     | Local     |
 
 > macOS-arm64 因 GitHub 暂未提供 arm runner，如果要构建 arm 二进制，可以使用手动构建。
 

bin/spc-alpine-docker

@@ -59,6 +59,7 @@ RUN apk update; \
     apk add --no-cache \
         autoconf \
         automake \
+        gettext \
         bash \
         binutils \
         bison \
@@ -89,8 +90,7 @@ RUN apk update; \
         composer \
         pkgconfig \
         wget \
-        xz ; \
-  ln -s /usr/bin/php82 /usr/bin/php
+        xz
 
 WORKDIR /app
 ADD ./src /app/src

config/lib.json

@@ -63,6 +63,7 @@
         ],
         "frameworks": [
             "CoreFoundation",
+            "CoreServices",
             "SystemConfiguration"
         ]
     },

config/source.json

@@ -270,7 +270,7 @@
         "regex": "/href=\"(?<file>libxslt-(?<version>[^\"]+)\\.tar\\.xz)\"/",
         "license": {
             "type": "file",
-            "text": "COPYING"
+            "path": "COPYING"
         }
     },
     "libyaml": {
@@ -323,7 +323,7 @@
         "type": "ghrel",
         "repo": "mongodb/mongo-php-driver",
         "path": "php-src/ext/mongodb",
-        "match": "mongodb.+\\.zip",
+        "match": "mongodb.+\\.tgz",
         "license": {
             "type": "file",
             "path": "LICENSE"

src/SPC/builder/BuilderBase.php

@@ -148,14 +148,12 @@ abstract class BuilderBase
     {
         // judge cpp-extension
         $exts = array_keys($this->getExts());
-        $cpp = false;
         foreach ($exts as $ext) {
             if (Config::getExt($ext, 'cpp-extension', false) === true) {
-                $cpp = true;
-                break;
+                return true;
             }
         }
-        return $cpp;
+        return false;
     }
 
     /**

src/SPC/builder/BuilderProvider.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace SPC\builder;
 
+use SPC\builder\freebsd\BSDBuilder;
 use SPC\builder\linux\LinuxBuilder;
 use SPC\builder\macos\MacOSBuilder;
 use SPC\exception\FileSystemException;
@@ -31,6 +32,7 @@ class BuilderProvider
             // ),
             'Darwin' => new MacOSBuilder($input->getOptions()),
             'Linux' => new LinuxBuilder($input->getOptions()),
+            'BSD' => new BSDBuilder($input->getOptions()),
             default => throw new WrongUsageException('Current OS "' . PHP_OS_FAMILY . '" is not supported yet'),
         };
     }

src/SPC/builder/Extension.php

@@ -46,6 +46,7 @@ class Extension
                 break;
             case 'Darwin':
             case 'Linux':
+            case 'BSD':
                 $arg .= $this->getUnixConfigureArg();
                 break;
         }

src/SPC/builder/LibraryBase.php

@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace SPC\builder;
 
-use SPC\builder\macos\library\MacOSLibraryBase;
 use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
@@ -19,6 +18,8 @@ abstract class LibraryBase
 
     protected array $dependencies = [];
 
+    protected bool $patched = false;
+
     /**
      * @throws RuntimeException
      */
@@ -130,10 +131,15 @@ abstract class LibraryBase
      */
     public function tryBuild(bool $force_build = false): int
     {
+        if (file_exists($this->source_dir . '/.spc.patched')) {
+            $this->patched = true;
+        }
         // force means just build
         if ($force_build) {
             logger()->info('Building required library [' . static::NAME . ']');
-            $this->patchBeforeBuild();
+            if (!$this->patched && $this->patchBeforeBuild()) {
+                file_put_contents($this->source_dir . '/.spc.patched', 'PATCHED!!!');
+            }
             $this->build();
             return BUILD_STATUS_OK;
         }
@@ -153,7 +159,7 @@ abstract class LibraryBase
             }
         }
         // pkg-config is treated specially. If it is pkg-config, check if the pkg-config binary exists
-        if ($this instanceof MacOSLibraryBase && static::NAME === 'pkg-config' && !file_exists(BUILD_ROOT_PATH . '/bin/pkg-config')) {
+        if (static::NAME === 'pkg-config' && !file_exists(BUILD_ROOT_PATH . '/bin/pkg-config')) {
             $this->tryBuild(true);
             return BUILD_STATUS_OK;
         }

src/SPC/builder/freebsd/BSDBuilder.php

@@ -0,0 +1,250 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\traits\UnixBuilderTrait;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
+use SPC\store\SourcePatcher;
+
+class BSDBuilder extends BuilderBase
+{
+    /** Unix compatible builder methods */
+    use UnixBuilderTrait;
+
+    /** @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;
+
+        // ---------- set necessary options ----------
+        // set C Compiler (default: clang)
+        $this->setOptionIfNotExist('cc', 'clang');
+        // set C++ Composer (default: clang++)
+        $this->setOptionIfNotExist('cxx', 'clang++');
+        // set arch (default: current)
+        $this->setOptionIfNotExist('arch', php_uname('m'));
+        $this->setOptionIfNotExist('gnu-arch', arch2gnu($this->getOption('arch')));
+
+        // ---------- set necessary compile environments ----------
+        // concurrency
+        $this->concurrency = SystemUtil::getCpuCount();
+        // cflags
+        $this->arch_c_flags = SystemUtil::getArchCFlags($this->getOption('arch'));
+        $this->arch_cxx_flags = SystemUtil::getArchCFlags($this->getOption('arch'));
+        // cmake toolchain
+        $this->cmake_toolchain_file = SystemUtil::makeCmakeToolchainFile('BSD', $this->getOption('arch'), $this->arch_c_flags);
+        // configure environment
+        $this->configure_env = SystemUtil::makeEnvVarString([
+            'PKG_CONFIG' => BUILD_ROOT_PATH . '/bin/pkg-config',
+            'PKG_CONFIG_PATH' => BUILD_LIB_PATH . '/pkgconfig/',
+            'CC' => $this->getOption('cc'),
+            'CXX' => $this->getOption('cxx'),
+            'CFLAGS' => "{$this->arch_c_flags} -Wimplicit-function-declaration -Os",
+            'LIBS' => '-ldl -lpthread',
+            'PATH' => BUILD_ROOT_PATH . '/bin:' . getenv('PATH'),
+        ]);
+
+        // create pkgconfig and include dir (some libs cannot create them automatically)
+        f_mkdir(BUILD_LIB_PATH . '/pkgconfig', recursive: true);
+        f_mkdir(BUILD_INCLUDE_PATH, recursive: true);
+    }
+
+    /**
+     * Just start to build statically linked php binary
+     *
+     * @param  int                 $build_target build target
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function buildPHP(int $build_target = BUILD_TARGET_NONE): void
+    {
+        // ---------- Update extra-libs ----------
+        $extra_libs = $this->getOption('extra-libs', '');
+        // add libc++, some extensions or libraries need it (C++ cannot be linked statically)
+        $extra_libs .= (empty($extra_libs) ? '' : ' ') . ($this->hasCppExtension() ? '-lc++ ' : '');
+        if (!$this->getOption('bloat', false)) {
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', $this->getAllStaticLibFiles());
+        } else {
+            logger()->info('bloat linking');
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', array_map(fn ($x) => "-Wl,-force_load,{$x}", array_filter($this->getAllStaticLibFiles())));
+        }
+        $this->setOption('extra-libs', $extra_libs);
+
+        SourcePatcher::patchBeforeBuildconf($this);
+
+        shell()->cd(SOURCE_PATH . '/php-src')->exec('./buildconf --force');
+
+        SourcePatcher::patchBeforeConfigure($this);
+
+        $json_74 = $this->getPHPVersionID() < 80000 ? '--enable-json ' : '';
+        $zts = $this->getOption('enable-zts', false) ? '--enable-zts --disable-zend-signals ' : '';
+
+        $enableCli = ($build_target & BUILD_TARGET_CLI) === BUILD_TARGET_CLI;
+        $enableFpm = ($build_target & BUILD_TARGET_FPM) === BUILD_TARGET_FPM;
+        $enableMicro = ($build_target & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO;
+        $enableEmbed = ($build_target & BUILD_TARGET_EMBED) === BUILD_TARGET_EMBED;
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec(
+                './configure ' .
+                '--prefix= ' .
+                '--with-valgrind=no ' .     // Not detect memory leak
+                '--enable-shared=no ' .
+                '--enable-static=yes ' .
+                "CFLAGS='{$this->arch_c_flags} -Werror=unknown-warning-option' " .
+                '--disable-all ' .
+                '--disable-cgi ' .
+                '--disable-phpdbg ' .
+                ($enableCli ? '--enable-cli ' : '--disable-cli ') .
+                ($enableFpm ? '--enable-fpm ' : '--disable-fpm ') .
+                ($enableEmbed ? '--enable-embed=static ' : '--disable-embed ') .
+                ($enableMicro ? '--enable-micro ' : '--disable-micro ') .
+                $json_74 .
+                $zts .
+                $this->makeExtensionArgs() . ' ' .
+                $this->configure_env
+            );
+
+        SourcePatcher::patchBeforeMake($this);
+
+        $this->cleanMake();
+
+        if ($enableCli) {
+            logger()->info('building cli');
+            $this->buildCli();
+        }
+        if ($enableFpm) {
+            logger()->info('building fpm');
+            $this->buildFpm();
+        }
+        if ($enableMicro) {
+            logger()->info('building micro');
+            $this->buildMicro();
+        }
+        if ($enableEmbed) {
+            logger()->info('building embed');
+            if ($enableMicro) {
+                FileSystem::replaceFileStr(SOURCE_PATH . '/php-src/Makefile', 'OVERALL_TARGET =', 'OVERALL_TARGET = libphp.la');
+            }
+            $this->buildEmbed();
+        }
+
+        if (php_uname('m') === $this->getOption('arch')) {
+            $this->sanityCheck($build_target);
+        }
+    }
+
+    /**
+     * Build cli sapi
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildCli(): void
+    {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} /usr/lib/libm.a",
+        ]);
+
+        $shell = shell()->cd(SOURCE_PATH . '/php-src');
+        $shell->exec('sed -ie "s|//lib|/lib|g" Makefile');
+        $shell->exec("make -j{$this->concurrency} {$vars} cli");
+        if (!$this->getOption('no-strip', false)) {
+            $shell->exec('strip sapi/cli/php');
+        }
+        $this->deployBinary(BUILD_TARGET_CLI);
+    }
+
+    /**
+     * Build phpmicro sapi
+     *
+     * @throws FileSystemException|RuntimeException
+     */
+    public function buildMicro(): void
+    {
+        if ($this->getPHPVersionID() < 80000) {
+            throw new RuntimeException('phpmicro only support PHP >= 8.0!');
+        }
+        if ($this->getExt('phar')) {
+            $this->phar_patched = true;
+            SourcePatcher::patchMicro(['phar']);
+        }
+
+        $enable_fake_cli = $this->getOption('with-micro-fake-cli', false) ? ' -DPHP_MICRO_FAKE_CLI' : '';
+        $vars = [
+            // with debug information, optimize for size, remove identifiers, patch fake cli for micro
+            'EXTRA_CFLAGS' => '-g -Os' . $enable_fake_cli,
+            // link resolv library (macOS needs it)
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} /usr/lib/libm.a",
+        ];
+        $vars = SystemUtil::makeEnvVarString($vars);
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec("make -j{$this->concurrency} {$vars} micro");
+
+        if (!$this->getOption('no-strip', false)) {
+            shell()->cd(SOURCE_PATH . '/php-src/sapi/micro')->exec('strip --strip-all micro.sfx');
+        }
+        $this->deployBinary(BUILD_TARGET_MICRO);
+
+        if ($this->phar_patched) {
+            SourcePatcher::patchMicro(['phar'], true);
+        }
+    }
+
+    /**
+     * Build fpm sapi
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildFpm(): void
+    {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} /usr/lib/libm.a", // link resolv library (macOS needs it)
+        ]);
+
+        $shell = shell()->cd(SOURCE_PATH . '/php-src');
+        $shell->exec("make -j{$this->concurrency} {$vars} fpm");
+        if (!$this->getOption('no-strip', false)) {
+            $shell->exec('strip sapi/fpm/php-fpm');
+        }
+        $this->deployBinary(BUILD_TARGET_FPM);
+    }
+
+    public function buildEmbed(): void
+    {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} /usr/lib/libm.a", // link resolv library (macOS needs it)
+        ]);
+
+        shell()
+            ->cd(SOURCE_PATH . '/php-src')
+            ->exec('make INSTALL_ROOT=' . BUILD_ROOT_PATH . " -j{$this->concurrency} {$vars} install")
+            // Workaround for https://github.com/php/php-src/issues/12082
+            ->exec('rm -Rf ' . BUILD_ROOT_PATH . '/lib/php-o')
+            ->exec('mkdir ' . BUILD_ROOT_PATH . '/lib/php-o')
+            ->cd(BUILD_ROOT_PATH . '/lib/php-o')
+            ->exec('ar x ' . BUILD_ROOT_PATH . '/lib/libphp.a')
+            ->exec('rm ' . BUILD_ROOT_PATH . '/lib/libphp.a')
+            ->exec('ar rcs ' . BUILD_ROOT_PATH . '/lib/libphp.a *.o')
+            ->exec('rm -Rf ' . BUILD_ROOT_PATH . '/lib/php-o');
+    }
+}

src/SPC/builder/freebsd/SystemUtil.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd;
+
+use SPC\builder\traits\UnixSystemUtilTrait;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class SystemUtil
+{
+    /** Unix System Util Compatible */
+    use UnixSystemUtilTrait;
+
+    /**
+     * 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');
+        }
+
+        return (int) $output[0];
+    }
+
+    /**
+     * Get Target Arch CFlags
+     *
+     * @param  string              $arch Arch Name
+     * @return string              return Arch CFlags string
+     * @throws WrongUsageException
+     */
+    public static function getArchCFlags(string $arch): string
+    {
+        return match ($arch) {
+            'amd64', 'x86_64' => '--target=x86_64-unknown-freebsd',
+            'arm64','aarch64' => '--target=aarch-unknown-freebsd',
+            default => throw new WrongUsageException('unsupported arch: ' . $arch),
+        };
+    }
+}

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

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\freebsd\BSDBuilder;
+use SPC\builder\LibraryBase;
+use SPC\builder\traits\UnixLibraryTrait;
+
+abstract class BSDLibraryBase extends LibraryBase
+{
+    use UnixLibraryTrait;
+
+    protected array $headers;
+
+    public function __construct(protected BSDBuilder $builder)
+    {
+        parent::__construct();
+    }
+
+    public function getBuilder(): BuilderBase
+    {
+        return $this->builder;
+    }
+}

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

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+class bzip2 extends BSDLibraryBase
+{
+    use \SPC\builder\unix\library\bzip2;
+
+    public const NAME = 'bzip2';
+}

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

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+class curl extends BSDLibraryBase
+{
+    use \SPC\builder\unix\library\curl;
+
+    public const NAME = 'curl';
+
+    public function getStaticLibFiles(string $style = 'autoconf', bool $recursive = true): string
+    {
+        $libs = parent::getStaticLibFiles($style, $recursive);
+        if ($this->builder->getLib('openssl')) {
+            $this->builder->setOption('extra-libs', $this->builder->getOption('extra-libs') . ' /usr/lib/libpthread.a /usr/lib/libdl.a');
+        }
+        return $libs;
+    }
+}

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

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+class onig extends BSDLibraryBase
+{
+    use \SPC\builder\unix\library\onig;
+
+    public const NAME = 'onig';
+}

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

@@ -0,0 +1,63 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\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;
+
+        // lib:zlib
+        $extra = '';
+        $ex_lib = '';
+        $zlib = $this->builder->getLib('zlib');
+        if ($zlib instanceof MacOSLibraryBase) {
+            $extra = 'zlib';
+            $ex_lib = trim($zlib->getStaticLibFiles() . ' ' . $ex_lib);
+        }
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./Configure no-shared {$extra} " .
+                '--prefix=/ ' . // use prefix=/
+                "--libdir={$lib} " .
+                '--openssldir=/etc/ssl ' .
+                'BSD-' . arch2gnu($this->builder->getOption('arch'))
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency} CNF_EX_LIBS=\"{$ex_lib}\"")
+            ->exec("make install_sw DESTDIR={$destdir}");
+        $this->patchPkgconfPrefix(['libssl.pc', 'openssl.pc', 'libcrypto.pc']);
+    }
+}

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

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class pkgconfig extends BSDLibraryBase
+{
+    use \SPC\builder\unix\library\pkgconfig;
+
+    public const NAME = 'pkg-config';
+}

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

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+class zlib extends BSDLibraryBase
+{
+    use \SPC\builder\unix\library\zlib;
+
+    public const NAME = 'zlib';
+}

src/SPC/builder/linux/SystemUtil.php

@@ -20,6 +20,19 @@ class SystemUtil
             'ver' => 'unknown',
         ];
         switch (true) {
+            case file_exists('/etc/centos-release'):
+                $lines = file('/etc/centos-release');
+                goto rh;
+            case file_exists('/etc/redhat-release'):
+                $lines = file('/etc/redhat-release');
+                rh:
+                foreach ($lines as $line) {
+                    if (preg_match('/release\s+(\d*(\.\d+)*)/', $line, $matches)) {
+                        $ret['dist'] = 'redhat';
+                        $ret['ver'] = $matches[1];
+                    }
+                }
+                break;
             case file_exists('/etc/os-release'):
                 $lines = file('/etc/os-release');
                 foreach ($lines as $line) {
@@ -36,19 +49,6 @@ class SystemUtil
                     $ret['dist'] = 'redhat';
                 }
                 break;
-            case file_exists('/etc/centos-release'):
-                $lines = file('/etc/centos-release');
-                goto rh;
-            case file_exists('/etc/redhat-release'):
-                $lines = file('/etc/redhat-release');
-                rh:
-                foreach ($lines as $line) {
-                    if (preg_match('/release\s+(\d+(\.\d+)*)/', $line, $matches)) {
-                        $ret['dist'] = 'redhat';
-                        $ret['ver'] = $matches[1];
-                    }
-                }
-                break;
         }
         return $ret;
     }

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

@@ -8,9 +8,6 @@ use SPC\builder\BuilderBase;
 use SPC\builder\LibraryBase;
 use SPC\builder\linux\LinuxBuilder;
 use SPC\builder\traits\UnixLibraryTrait;
-use SPC\exception\FileSystemException;
-use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 
 abstract class LinuxLibraryBase extends LibraryBase
 {
@@ -37,44 +34,6 @@ abstract class LinuxLibraryBase extends LibraryBase
         return $this->builder;
     }
 
-    /**
-     * @throws RuntimeException
-     * @throws FileSystemException
-     * @throws WrongUsageException
-     */
-    public function tryBuild(bool $force_build = false): int
-    {
-        // 传入 true，表明直接编译
-        if ($force_build) {
-            logger()->info('Building required library [' . static::NAME . ']');
-            $this->patchBeforeBuild();
-            $this->build();
-            return BUILD_STATUS_OK;
-        }
-
-        // 看看这些库是不是存在，如果不存在，则调用编译并返回结果状态
-        foreach ($this->getStaticLibs() as $name) {
-            if (!file_exists(BUILD_LIB_PATH . "/{$name}")) {
-                $this->tryBuild(true);
-                return BUILD_STATUS_OK;
-            }
-        }
-        // 头文件同理
-        foreach ($this->getHeaders() as $name) {
-            if (!file_exists(BUILD_INCLUDE_PATH . "/{$name}")) {
-                $this->tryBuild(true);
-                return BUILD_STATUS_OK;
-            }
-        }
-        // pkg-config 做特殊处理，如果是 pkg-config 就检查有没有 pkg-config 二进制
-        if (static::NAME === 'pkg-config' && !file_exists(BUILD_ROOT_PATH . '/bin/pkg-config')) {
-            $this->tryBuild(true);
-            return BUILD_STATUS_OK;
-        }
-        // 到这里说明所有的文件都存在，就跳过编译
-        return BUILD_STATUS_ALREADY;
-    }
-
     protected function makeFakePkgconfs(): void
     {
         $workspace = BUILD_ROOT_PATH;

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

@@ -44,6 +44,11 @@ class curl extends MacOSLibraryBase
             '/NOT SYSTEMCONFIGURATION_FRAMEWORK/m',
             'FALSE'
         );
+        FileSystem::replaceFileRegex(
+            SOURCE_PATH . '/curl/CMakeLists.txt',
+            '/NOT CORESERVICES_FRAMEWORK/m',
+            'FALSE'
+        );
         return true;
     }
 }

src/SPC/command/BuildCliCommand.php

@@ -7,6 +7,7 @@ namespace SPC\command;
 use SPC\builder\BuilderProvider;
 use SPC\exception\ExceptionHandler;
 use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
 use SPC\store\SourcePatcher;
 use SPC\util\DependencyUtil;
 use SPC\util\LicenseDumper;
@@ -70,6 +71,10 @@ class BuildCliCommand extends BuildCommand
                 logger()->warning('some extensions will be enabled due to dependencies: ' . implode(',', $not_included));
             }
             sleep(2);
+            if ($this->input->getOption('with-clean')) {
+                logger()->info('Cleaning source dir...');
+                FileSystem::removeDir(SOURCE_PATH);
+            }
             // compile libraries
             $builder->buildLibs($libraries);
             // check extensions

src/SPC/command/BuildCommand.php

@@ -28,7 +28,8 @@ abstract class BuildCommand extends BaseCommand
                 break;
         }
 
-        $this->addOption('with-clean', null, null, 'fresh build, `make clean` before `make`');
+        $this->addOption('with-clean', null, null, 'fresh build, remove `source` dir before `make`');
         $this->addOption('bloat', null, null, 'add all libraries into binary');
+        $this->addOption('rebuild', 'r', null, 'Delete old build and rebuild');
     }
 }

src/SPC/command/BuildLibsCommand.php

@@ -20,7 +20,6 @@ class BuildLibsCommand extends BuildCommand
         $this->addArgument('libraries', InputArgument::REQUIRED, 'The libraries will be compiled, comma separated');
         $this->addOption('clean', null, null, 'Clean old download cache and source before fetch');
         $this->addOption('all', 'A', null, 'Build all libs that static-php-cli needed');
-        $this->addOption('rebuild', 'r', null, 'Delete old build and rebuild');
     }
 
     public function initialize(InputInterface $input, OutputInterface $output): void

src/SPC/command/DownloadCommand.php

@@ -28,7 +28,7 @@ class DownloadCommand extends BaseCommand
         $this->addArgument('sources', InputArgument::REQUIRED, 'The sources will be compiled, comma separated');
         $this->addOption('shallow-clone', null, null, 'Clone shallow');
         $this->addOption('with-openssl11', null, null, 'Use openssl 1.1');
-        $this->addOption('with-php', null, InputOption::VALUE_REQUIRED, 'version in major.minor format like 8.1', '8.1');
+        $this->addOption('with-php', null, InputOption::VALUE_REQUIRED, 'version in major.minor format (default 8.2)', '8.2');
         $this->addOption('clean', null, null, 'Clean old download cache and source before fetch');
         $this->addOption('all', 'A', null, 'Fetch all sources that static-php-cli needed');
         $this->addOption('custom-url', 'U', InputOption::VALUE_IS_ARRAY | InputOption::VALUE_REQUIRED, 'Specify custom source download url, e.g "php-src:https://downloads.php.net/~eric/php-8.3.0beta1.tar.gz"');

src/SPC/doctor/item/BSDToolCheckList.php

@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\doctor\item;
+
+use SPC\builder\traits\UnixSystemUtilTrait;
+use SPC\doctor\AsCheckItem;
+use SPC\doctor\AsFixItem;
+use SPC\doctor\CheckResult;
+use SPC\exception\RuntimeException;
+
+class BSDToolCheckList
+{
+    use UnixSystemUtilTrait;
+
+    /** @var string[] FreeBSD */
+    public const REQUIRED_COMMANDS = [
+        'curl',
+        'make',
+        'bison',
+        'flex',
+        'pkg-config',
+        'git',
+        'autoconf',
+        'automake',
+        'tar',
+        'unzip',
+        'xz',
+        'gzip',
+        'bzip2',
+        'cmake',
+    ];
+
+    #[AsCheckItem('if necessary tools are installed', limit_os: 'BSD')]
+    public function checkCliTools(): ?CheckResult
+    {
+        $missing = [];
+        foreach (self::REQUIRED_COMMANDS as $cmd) {
+            if ($this->findCommand($cmd) === null) {
+                $missing[] = $cmd;
+            }
+        }
+        if (!empty($missing)) {
+            return CheckResult::fail('missing system commands: ' . implode(', ', $missing), 'build-tools-bsd', [$missing]);
+        }
+        return CheckResult::ok();
+    }
+
+    #[AsFixItem('build-tools-bsd')]
+    public function fixBuildTools(array $missing): bool
+    {
+        if (get_current_user() !== 'root') {
+            $prefix = 'sudo ';
+            logger()->warning('Current user is not root, using sudo for running command');
+        } else {
+            $prefix = '';
+        }
+        try {
+            shell(true)->exec("ASSUME_ALWAYS_YES=yes {$prefix} pkg install -y " . implode(' ', $missing));
+        } catch (RuntimeException) {
+            return false;
+        }
+        return true;
+    }
+}

src/SPC/doctor/item/OSCheckList.php

@@ -15,7 +15,7 @@ class OSCheckList
     #[AsCheckItem('if current OS are supported', level: 999)]
     public function checkOS(): ?CheckResult
     {
-        if (!in_array(PHP_OS_FAMILY, ['Darwin', 'Linux'])) {
+        if (!in_array(PHP_OS_FAMILY, ['Darwin', 'Linux', 'BSD'])) {
             return CheckResult::fail('Current OS is not supported');
         }
         return CheckResult::ok(PHP_OS_FAMILY . ' ' . php_uname('m') . ', supported');

src/SPC/store/Config.php

@@ -54,6 +54,7 @@ class Config
                 'Windows' => ['-windows', '-win', ''],
                 'Darwin' => ['-macos', '-unix', ''],
                 'Linux' => ['-linux', '-unix', ''],
+                'BSD' => ['-freebsd', '-bsd', '-unix', ''],
                 default => throw new WrongUsageException('OS ' . PHP_OS_FAMILY . ' is not supported'),
             };
             foreach ($m_key as $v) {
@@ -98,6 +99,7 @@ class Config
                 'Windows' => ['-windows', '-win', ''],
                 'Darwin' => ['-macos', '-unix', ''],
                 'Linux' => ['-linux', '-unix', ''],
+                'BSD' => ['-freebsd', '-bsd', '-unix', ''],
                 default => throw new WrongUsageException('OS ' . PHP_OS_FAMILY . ' is not supported'),
             };
             foreach ($m_key as $v) {

src/SPC/store/FileSystem.php

@@ -55,7 +55,7 @@ class FileSystem
     /**
      * @throws FileSystemException
      */
-    public static function replaceFileStr(string $filename, mixed $search = null, mixed $replace = null): bool|int
+    public static function replaceFileStr(string $filename, mixed $search = null, mixed $replace = null): false|int
     {
         return self::replaceFile($filename, REPLACE_FILE_STR, $search, $replace);
     }
@@ -63,7 +63,7 @@ class FileSystem
     /**
      * @throws FileSystemException
      */
-    public static function replaceFileRegex(string $filename, mixed $search = null, mixed $replace = null): bool|int
+    public static function replaceFileRegex(string $filename, mixed $search = null, mixed $replace = null): false|int
     {
         return self::replaceFile($filename, REPLACE_FILE_PREG, $search, $replace);
     }
@@ -71,7 +71,7 @@ class FileSystem
     /**
      * @throws FileSystemException
      */
-    public static function replaceFileUser(string $filename, mixed $callback = null): bool|int
+    public static function replaceFileUser(string $filename, mixed $callback = null): false|int
     {
         return self::replaceFile($filename, REPLACE_FILE_USER, $callback);
     }
@@ -132,6 +132,7 @@ class FileSystem
                 break;
             case 'Linux':
             case 'Darwin':
+            case 'BSD':
                 f_passthru('cp -r "' . $src_path . '" "' . $dst_path . '"');
                 break;
         }
@@ -154,7 +155,7 @@ class FileSystem
         if ($move_path !== null) {
             $move_path = SOURCE_PATH . '/' . $move_path;
         }
-        logger()->info("extracting {$name} source");
+        logger()->info("extracting {$name} source to " . ($move_path ?? SOURCE_PATH . "/{$name}") . ' ...');
         try {
             $target = $move_path ?? (SOURCE_PATH . "/{$name}");
             // Git source, just move
@@ -163,8 +164,7 @@ class FileSystem
                 self::emitSourceExtractHook($name);
                 return;
             }
-
-            if (PHP_OS_FAMILY === 'Darwin' || PHP_OS_FAMILY === 'Linux') {
+            if (in_array(PHP_OS_FAMILY, ['Darwin', 'Linux', 'BSD'])) {
                 if (f_mkdir(directory: $target, recursive: true) !== true) {
                     throw new FileSystemException('create ' . $name . 'source dir failed');
                 }
@@ -256,14 +256,13 @@ class FileSystem
     /**
      * 递归或非递归扫描目录，可返回相对目录的文件列表或绝对目录的文件列表
      *
-     * @param  string      $dir         目录
-     * @param  bool        $recursive   是否递归扫描子目录
-     * @param  bool|string $relative    是否返回相对目录，如果为true则返回相对目录，如果为false则返回绝对目录
-     * @param  bool        $include_dir 非递归模式下，是否包含目录
-     * @return array|false
+     * @param string      $dir         目录
+     * @param bool        $recursive   是否递归扫描子目录
+     * @param bool|string $relative    是否返回相对目录，如果为true则返回相对目录，如果为false则返回绝对目录
+     * @param bool        $include_dir 非递归模式下，是否包含目录
      * @since 2.5
      */
-    public static function scanDirFiles(string $dir, bool $recursive = true, bool|string $relative = false, bool $include_dir = false): bool|array
+    public static function scanDirFiles(string $dir, bool $recursive = true, bool|string $relative = false, bool $include_dir = false): array|false
     {
         $dir = self::convertPath($dir);
         // 不是目录不扫，直接 false 处理
@@ -403,7 +402,7 @@ class FileSystem
      * @param  mixed               ...$args Arguments passed to file_put_contents
      * @throws FileSystemException
      */
-    public static function writeFile(string $path, mixed $content, ...$args): bool|string|int
+    public static function writeFile(string $path, mixed $content, ...$args): bool|int|string
     {
         $dir = pathinfo($path, PATHINFO_DIRNAME);
         if (!is_dir($dir) && !mkdir($dir, 0755, true)) {
@@ -446,7 +445,7 @@ class FileSystem
     /**
      * @throws FileSystemException
      */
-    private static function replaceFile(string $filename, int $replace_type = REPLACE_FILE_STR, mixed $callback_or_search = null, mixed $to_replace = null): bool|int
+    private static function replaceFile(string $filename, int $replace_type = REPLACE_FILE_STR, mixed $callback_or_search = null, mixed $to_replace = null): false|int
     {
         logger()->debug('Replacing file with type[' . $replace_type . ']: ' . $filename);
         $file = self::readFile($filename);

src/SPC/store/SourceExtractor.php

@@ -52,16 +52,19 @@ class SourceExtractor
         // start check
         foreach ($sources_extracted as $source => $item) {
             if (Config::getSource($source) === null) {
-                throw new WrongUsageException("Source [{$source}] not exists, please check name and correct it !");
+                throw new WrongUsageException("Source [{$source}] does not exist, please check the name and correct it !");
             }
             if (!isset($lock[$source])) {
                 throw new WrongUsageException('Source [' . $source . '] not downloaded or not locked, you should download it first !');
             }
 
             // check source dir exist
-            $check = $lock[$source]['move_path'] === null ? SOURCE_PATH . '/' . $source : SOURCE_PATH . '/' . $lock[$source]['move_path'];
+            $check = $lock[$source]['move_path'] === null ? (SOURCE_PATH . '/' . $source) : (SOURCE_PATH . '/' . $lock[$source]['move_path']);
             if (!is_dir($check)) {
+                logger()->debug('Extracting source [' . $source . '] to ' . $check . ' ...');
                 FileSystem::extractSource($source, DOWNLOAD_PATH . '/' . ($lock[$source]['filename'] ?? $lock[$source]['dirname']), $lock[$source]['move_path']);
+            } else {
+                logger()->debug('Source [' . $source . '] already extracted in ' . $check . ', skip !');
             }
         }
     }

src/SPC/store/SourcePatcher.php

@@ -117,6 +117,30 @@ class SourcePatcher
         return true;
     }
 
+    /**
+     * Use existing patch file for patching
+     *
+     * @param  string           $patch_name Patch file name in src/globals/patch/
+     * @param  string           $cwd        Working directory for patch command
+     * @param  bool             $reverse    Reverse patches (default: False)
+     * @throws RuntimeException
+     */
+    public static function patchFile(string $patch_name, string $cwd, bool $reverse = false): bool
+    {
+        if (!file_exists(ROOT_DIR . "/src/globals/patch/{$patch_name}")) {
+            return false;
+        }
+
+        $patch_file = ROOT_DIR . "/src/globals/patch/{$patch_name}";
+        $patch_str = str_replace('/', DIRECTORY_SEPARATOR, $patch_file);
+
+        f_passthru(
+            'cd ' . $cwd . ' && ' .
+            (PHP_OS_FAMILY === 'Windows' ? 'type' : 'cat') . ' ' . $patch_str . ' | patch -p1 ' . ($reverse ? '-R' : '')
+        );
+        return true;
+    }
+
     /**
      * @throws FileSystemException
      */

src/SPC/util/LicenseDumper.php

@@ -102,8 +102,11 @@ class LicenseDumper
     /**
      * @throws RuntimeException
      */
-    private function loadSourceFile(string $source_name, string $in_path, ?string $custom_base_path = null): string
+    private function loadSourceFile(string $source_name, ?string $in_path, ?string $custom_base_path = null): string
     {
+        if (is_null($in_path)) {
+            throw new RuntimeException('source [' . $source_name . '] license file is not set, please check config/source.json');
+        }
         if (!file_exists(SOURCE_PATH . '/' . ($custom_base_path ?? $source_name) . '/' . $in_path)) {
             throw new RuntimeException('source [' . $source_name . '] license file [' . $in_path . '] not exist');
         }

src/globals/functions.php

@@ -60,6 +60,7 @@ function osfamily2dir(): string
         'Windows', 'WINNT', 'Cygwin' => 'windows',
         'Darwin' => 'macos',
         'Linux' => 'linux',
+        'BSD' => 'freebsd',
         default => throw new WrongUsageException('Not support os: ' . PHP_OS_FAMILY),
     };
 }

tests/SPC/doctor/CheckListHandlerTest.php

@@ -16,6 +16,7 @@ final class CheckListHandlerTest extends TestCase
     {
         $list = new CheckListHandler();
 
-        $this->assertCount(6, $list->runChecks());
+        $id = $list->runChecks();
+        $this->assertCount(7, $id);
     }
 }