Suggestions

src/SPC/toolchain/ClangNativeToolchain.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\toolchain;
+
+use SPC\builder\freebsd\SystemUtil as FreeBSDSystemUtil;
+use SPC\builder\linux\SystemUtil as LinuxSystemUtil;
+use SPC\builder\macos\SystemUtil as MacOSSystemUtil;
+use SPC\exception\WrongUsageException;
+use SPC\util\GlobalEnvManager;
+
+class ClangNativeToolchain implements ToolchainInterface
+{
+    public function initEnv(): void
+    {
+        GlobalEnvManager::putenv('SPC_LINUX_DEFAULT_CC=clang');
+        GlobalEnvManager::putenv('SPC_LINUX_DEFAULT_CXX=clang++');
+        GlobalEnvManager::putenv('SPC_LINUX_DEFAULT_AR=ar');
+        GlobalEnvManager::putenv('SPC_LINUX_DEFAULT_LD=ld');
+    }
+
+    public function afterInit(): void
+    {
+        // check clang exists
+        match (PHP_OS_FAMILY) {
+            'Linux' => LinuxSystemUtil::findCommand('clang++') ?? throw new WrongUsageException('Clang++ not found, please install it or manually set CC/CXX to a valid path.'),
+            'Darwin' => MacOSSystemUtil::findCommand('clang++') ?? throw new WrongUsageException('Clang++ not found, please install it or set CC/CXX to a valid path.'),
+            'BSD' => FreeBSDSystemUtil::findCommand('clang++') ?? throw new WrongUsageException('Clang++ not found, please install it or set CC/CXX to a valid path.'),
+            default => throw new WrongUsageException('Clang is not supported on ' . PHP_OS_FAMILY . '.'),
+        };
+    }
+}

src/SPC/toolchain/GccNativeToolchain.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\toolchain;
+
+use SPC\builder\freebsd\SystemUtil as FreeBSDSystemUtil;
+use SPC\builder\linux\SystemUtil as LinuxSystemUtil;
+use SPC\builder\macos\SystemUtil as MacOSSystemUtil;
+use SPC\exception\WrongUsageException;
+use SPC\util\GlobalEnvManager;
+
+class GccNativeToolchain implements ToolchainInterface
+{
+    public function initEnv(): void
+    {
+        GlobalEnvManager::putenv('SPC_LINUX_DEFAULT_CC=gcc');
+        GlobalEnvManager::putenv('SPC_LINUX_DEFAULT_CXX=g++');
+        GlobalEnvManager::putenv('SPC_LINUX_DEFAULT_AR=ar');
+        GlobalEnvManager::putenv('SPC_LINUX_DEFAULT_LD=ld.gold');
+    }
+
+    public function afterInit(): void
+    {
+        // check gcc exists
+        match (PHP_OS_FAMILY) {
+            'Linux' => LinuxSystemUtil::findCommand('g++') ?? throw new WrongUsageException('g++ not found, please install it or set CC/CXX to a valid path.'),
+            'Darwin' => MacOSSystemUtil::findCommand('g++') ?? throw new WrongUsageException('g++ not found, please install it or set CC/CXX to a valid path.'),
+            'BSD' => FreeBSDSystemUtil::findCommand('g++') ?? throw new WrongUsageException('g++ not found, please install it or set CC/CXX to a valid path.'),
+            default => throw new \RuntimeException('GCC is not supported on ' . PHP_OS_FAMILY . '.'),
+        };
+    }
+}

src/SPC/toolchain/MSVCToolchain.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\toolchain;
+
+class MSVCToolchain implements ToolchainInterface
+{
+    public function initEnv(): void {}
+
+    public function afterInit(): void {}
+}

src/SPC/toolchain/MuslToolchain.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\toolchain;
+
+use SPC\exception\WrongUsageException;
+use SPC\util\GlobalEnvManager;
+
+class MuslToolchain implements ToolchainInterface
+{
+    public function initEnv(): void
+    {
+        $arch = getenv('GNU_ARCH');
+        // Set environment variables for musl toolchain
+        GlobalEnvManager::putenv("SPC_LINUX_DEFAULT_CC={$arch}-linux-musl-gcc");
+        GlobalEnvManager::putenv("SPC_LINUX_DEFAULT_CXX={$arch}-linux-musl-g++");
+        GlobalEnvManager::putenv("SPC_LINUX_DEFAULT_AR={$arch}-linux-musl-ar");
+        GlobalEnvManager::putenv("SPC_LINUX_DEFAULT_LD={$arch}-linux-musl-ld");
+        GlobalEnvManager::addPathIfNotExists('/usr/local/musl/bin');
+        GlobalEnvManager::addPathIfNotExists("/usr/local/musl/{$arch}-linux-musl/bin");
+
+        GlobalEnvManager::putenv("SPC_LINUX_DEFAULT_LD_LIBRARY_PATH=/usr/local/musl/lib:/usr/local/musl/{$arch}-linux-musl/lib");
+        GlobalEnvManager::putenv("SPC_LINUX_DEFAULT_LIBRARY_PATH=/usr/local/musl/lib:/usr/local/musl/{$arch}-linux-musl/lib");
+    }
+
+    public function afterInit(): void
+    {
+        $arch = getenv('GNU_ARCH');
+        // append LD_LIBRARY_PATH to $configure = getenv('SPC_CMD_PREFIX_PHP_CONFIGURE');
+        $configure = getenv('SPC_CMD_PREFIX_PHP_CONFIGURE');
+        $ld_library_path = getenv('SPC_LINUX_DEFAULT_LD_LIBRARY_PATH');
+        GlobalEnvManager::putenv("SPC_CMD_PREFIX_PHP_CONFIGURE=LD_LIBRARY_PATH=\"{$ld_library_path}\" {$configure}");
+
+        if (!file_exists("/usr/local/musl/{$arch}-linux-musl/lib/libc.a")) {
+            throw new WrongUsageException('You are building with musl-libc target in glibc distro, but musl-toolchain is not installed, please install musl-toolchain first. (You can use `doctor` command to install it)');
+        }
+    }
+}

src/SPC/toolchain/ToolchainInterface.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\toolchain;
+
+interface ToolchainInterface
+{
+    /**
+     * Initialize the environment for the given target.
+     */
+    public function initEnv(): void;
+
+    /**
+     * Perform actions after the environment has been initialized for the given target.
+     */
+    public function afterInit(): void;
+}

src/SPC/toolchain/ToolchainManager.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\toolchain;
+
+use SPC\builder\linux\SystemUtil;
+use SPC\exception\WrongUsageException;
+use SPC\util\GlobalEnvManager;
+
+class ToolchainManager
+{
+    public const array OS_DEFAULT_TOOLCHAIN = [
+        'Linux' => MuslToolchain::class, // use musl toolchain by default, after zig pr merged, change this to ZigToolchain::class
+        'Windows' => MSVCToolchain::class,
+        'Darwin' => ClangNativeToolchain::class,
+        'BSD' => ClangNativeToolchain::class,
+    ];
+
+    /**
+     * @throws WrongUsageException
+     */
+    public static function initToolchain(): void
+    {
+        $libc = getenv('SPC_LIBC');
+        if ($libc !== false) {
+            // uncomment this when zig pr is merged
+            // logger()->warning('SPC_LIBC is deprecated, please use SPC_TARGET instead.');
+            $toolchain = match ($libc) {
+                'musl' => SystemUtil::isMuslDist() ? GccNativeToolchain::class : MuslToolchain::class,
+                'glibc' => !SystemUtil::isMuslDist() ? GccNativeToolchain::class : throw new WrongUsageException('SPC_TARGET must be musl-static or musl for musl dist.'),
+                default => throw new WrongUsageException('Unsupported SPC_LIBC value: ' . $libc),
+            };
+        } else {
+            $toolchain = self::OS_DEFAULT_TOOLCHAIN[PHP_OS_FAMILY];
+        }
+        $toolchainClass = $toolchain;
+        /* @var ToolchainInterface $toolchainClass */
+        (new $toolchainClass())->initEnv();
+        GlobalEnvManager::putenv("SPC_TOOLCHAIN={$toolchain}");
+    }
+
+    public static function afterInitToolchain(): void
+    {
+        if (!getenv('SPC_TOOLCHAIN')) {
+            throw new WrongUsageException('SPC_TOOLCHAIN not set');
+        }
+        $toolchain = getenv('SPC_TOOLCHAIN');
+        /* @var ToolchainInterface $toolchain */
+        (new $toolchain())->afterInit();
+    }
+}

src/SPC/toolchain/ZigToolchain.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\toolchain;
+
+class ZigToolchain implements ToolchainInterface
+{
+    public function initEnv(): void {}
+
+    public function afterInit(): void {}
+}