static-php-cli

https://github.com/crazywhalecc/static-php-cli
Admin
static-php-cli is a powerful tool designed for building static, standalone PHP runtime with popular...
Tokens:48,699
Snippets:524
Trust Score:9.5
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Setup Runtime for Linux / macOS

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Use the setup script to install a self-contained runtime environment.

```bash
bin/setup-runtime
```

--------------------------------

### Setup Runtime for Windows

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Use the setup script to install a self-contained runtime environment on Windows.

```powershell
.\bin\setup-runtime.ps1
.\bin\setup-runtime.ps1 add-path   # add runtime/ to PATH
```

--------------------------------

### Clone and Install from Source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Clone the repository and install dependencies using Composer.

```bash
git clone https://github.com/crazywhalecc/static-php-cli.git --branch v3
cd static-php-cli
composer install
```

--------------------------------

### Install development dependencies

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/contributing/index.md

Install the required PHP dependencies and verify the CLI installation from the repository root.

```bash
composer install
bin/spc --version
```

--------------------------------

### Example php-extension configuration for ext-lz4

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/package-model.md

A practical example of an extension configuration using git source and platform-specific build arguments.

```yaml
ext-lz4:
  type: php-extension
  artifact:
    source:
      type: git
      url: 'https://github.com/kjdev/php-ext-lz4.git'
      rev: master
      extract: php-src/ext/lz4
    metadata:
      license-files: [LICENSE]
      license: MIT
  depends:
    - liblz4
  php-extension:
    arg-type@unix: '--enable-lz4@shared_suffix@ --with-lz4-includedir=@build_root_path@'
    arg-type@windows: '--enable-lz4'
```

--------------------------------

### Build documentation

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/contributing/index.md

Install Node.js dependencies and build the VitePress documentation.

```bash
npm install
npm run docs:build
```

--------------------------------

### Install Helper Package

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Installs a specified helper package, such as UPX or a toolchain. This command is aliased to 'i' and 'install-package' for convenience.

```bash
spc install-pkg upx
```

--------------------------------

### Verify StaticPHP Setup

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/index.md

Verify that the StaticPHP setup is successful by checking its version.

```bash
bin/spc --version
```

--------------------------------

### Build a Single Library

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Example of building a single library package, such as OpenSSL.

```bash
spc build:libs openssl
```

--------------------------------

### phpmicro Example

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/index.md

Demonstrates how to combine a phpmicro executable with a PHP archive to create a single-file application.

```bash
micro.sfx + your-app.phar = your-app   # one file, zero dependencies
```

--------------------------------

### Openssl Library Configuration Example

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/package-model.md

An example configuration for the openssl library, demonstrating artifact source, dependencies, and platform-specific static library definitions.

```yaml
openssl:
  type: library
  artifact:
    source:
      type: ghrel
      repo: openssl/openssl
      match: openssl.+\.tar\.gz
      prefer-stable: true
    binary: hosted
    metadata:
      license-files: [LICENSE.txt]
      license: OpenSSL
  depends:
    - zlib
  depends@windows:
    - zlib
    - jom
  headers:
    - openssl
  static-libs@unix:
    - libssl.a
    - libcrypto.a
  static-libs@windows:
    - libssl.lib
    - libcrypto.lib
```

--------------------------------

### Install PHP Dependencies

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/index.md

Install the necessary PHP dependencies for StaticPHP development using Composer.

```bash
composer install
```

--------------------------------

### Build Multiple Libraries

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Example of building multiple library packages, such as OpenSSL, cURL, and zlib, by providing a comma-separated list.

```bash
spc build:libs "openssl,curl,zlib"
```

--------------------------------

### Build PHP with Suggested Packages

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Resolves and installs suggested packages automatically alongside the PHP build.

```bash
spc build:php --with-suggests
```

--------------------------------

### Build PHP CLI with a Specific Version

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

This example shows how to build the PHP CLI with specific extensions, targeting a particular PHP version for the download.

```bash
spc build:php "bcmath,openssl" --build-cli --dl-with-php=8.3
```

--------------------------------

### Configure pie artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Examples of downloading PHP extensions from Packagist using the PIE specification, including a custom extraction path example.

```yaml
# xdebug downloaded from Packagist
artifact:
  source:
    type: pie
    repo: xdebug/xdebug

# php-spx with a custom extraction path
artifact:
  source:
    type: pie
    repo: noisebynorthwest/php-spx
    extract: php-src/ext/spx
```

--------------------------------

### Install and Run via PHAR

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Download the PHAR archive and execute it using PHP or directly if marked as executable.

```bash
curl -#fSL https://dl.static-php.dev/v3/spc-bin/nightly/spc.phar -o spc.phar
chmod +x spc.phar && ./spc.phar --version
# or run it through PHP explicitly
php spc.phar --version
```

--------------------------------

### php-fpm.conf configuration

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Example configuration file for the php-fpm process manager.

```ini
[global]
pid = /var/run/php-fpm.pid
error_log = /var/log/php-fpm.log

[www]
listen = 127.0.0.1:9000
pm = dynamic
pm.max_children = 5
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
```

--------------------------------

### Install as Composer Dependency

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Add StaticPHP to an existing project via Composer.

```bash
composer require crazywhalecc/static-php-cli
```

--------------------------------

### Build PHP with Additional Packages

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Installs specified additional packages along with the PHP build.

```bash
spc build:php --with-packages=<list>
```

--------------------------------

### Configure local artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of using a pre-existing local directory as an artifact source.

```yaml
artifact:
  source:
    type: local
    dirname: /path/to/local/source
```

--------------------------------

### Configure license-files metadata

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Examples of defining license file paths, including relative paths from the source root and references to built-in framework license files using the @/ prefix.

```yaml
# Common case: read from the source directory
metadata:
  license-files: [LICENSE]

# Multiple license files
metadata:
  license-files: [LICENSE, COPYING.LESSER]

# License file inside a subdirectory
metadata:
  license-files: [gettext-runtime/intl/COPYING.LIB]

# Use a built-in license file when the source package does not include one
metadata:
  license-files: ['@/bzip2.txt']
```

--------------------------------

### Package and artifact definition example

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/package-model.md

An example of a library package definition referencing an external source archive via the artifact field.

```yaml
example-library-package:
  type: library
  artifact:
    source:
      type: url
      url: 'https://example.com/example-library.tar.gz'
```

--------------------------------

### Auto-fix Build Environment

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Attempt to automatically install missing build tools.

```bash
./spc doctor --auto-fix
```

--------------------------------

### Configure Git artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of cloning a repository from a specific branch.

```yaml
# php-glfw cloned from the master branch
artifact:
  source:
    type: git
    url: 'https://github.com/mario-deluna/php-glfw'
    rev: master
```

--------------------------------

### Configure php-release artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of configuring the official PHP source download with a primary domain and a mirror.

```yaml
# php-src with primary and mirror sources
artifact:
  source:
    type: php-release
    domain: 'https://www.php.net'
  source-mirror:
    type: php-release
    domain: 'https://phpmirror.static-php.dev'
```

--------------------------------

### Build PHP with UPX Packing

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Compresses the output binary using UPX. Ensure UPX is installed first (`spc install-pkg upx`). This option is available on Linux and Windows.

```bash
spc build:php --with-upx-pack
```

--------------------------------

### Run a One-Shot Static PHP Build

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Execute the `spc craft` command to automatically download dependencies, compile libraries, and build the PHP binary. This is the recommended approach for everyday use and quick starts.

```bash
spc craft
```

--------------------------------

### Build PHP CLI with Debug Symbols

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

This example builds the PHP CLI SAPI with extensions and retains debug symbols by skipping the stripping process.

```bash
spc build:php "bcmath,openssl" --build-cli --no-strip
```

--------------------------------

### Configure pecl artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of downloading a PHP extension from PECL using the package name.

```yaml
# APCu downloaded from PECL
artifact:
  source:
    type: pecl
    name: APCu
```

--------------------------------

### Configure URL artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of defining an artifact source using a fixed URL.

```yaml
# sqlite downloaded from a fixed URL
artifact:
  source:
    type: url
    url: 'https://www.sqlite.org/2024/sqlite-autoconf-3450200.tar.gz'
```

--------------------------------

### Configure GitHub Release artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of downloading an asset from a GitHub release using a regex match.

```yaml
# openssl downloaded from GitHub Release Assets
artifact:
  source:
    type: ghrel
    repo: openssl/openssl
    match: openssl.+\.tar\.gz
    prefer-stable: true
```

--------------------------------

### Nginx configuration for php-fpm

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Example Nginx server block configuration to handle PHP files via FastCGI.

```nginx
server {
    listen 80;
    root /var/www/html;
    index index.php;

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
```

--------------------------------

### Configure source-root for krb5

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of using the source-root field to point to the 'src/' subdirectory after extracting the krb5 archive.

```yaml
# krb5's actual source root is in the src/ subdirectory after extraction
source:
  type: url
  url: 'https://web.mit.edu/kerberos/dist/krb5/1.22/krb5-1.22.2.tar.gz'
  source-root: src
```

--------------------------------

### Usage of frankenphp binary

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Common commands for checking the version, starting the development server, or running with a Caddyfile configuration.

```bash
# Check version
./buildroot/bin/frankenphp version

# Run in PHP development server mode
./buildroot/bin/frankenphp php-server

# Run with a Caddyfile
./buildroot/bin/frankenphp run --config /path/to/Caddyfile
```

--------------------------------

### Define a tool package in YAML

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/package-model.md

Example configuration for a tool package named nasm, specifying binary artifacts and provided executables.

```yaml
nasm:
  type: tool
  artifact:
    binary:
      windows-x86_64:
        type: url
        url: 'https://example.com/nasm-win64.zip'
        extract:
          nasm.exe: '{pkg_root_path}/bin/nasm.exe'
          ndisasm.exe: '{pkg_root_path}/bin/ndisasm.exe'
  tool:
    provides: [nasm.exe, ndisasm.exe]
    binary-subdir: bin
    min-version: '2.16'
```

--------------------------------

### Configure bitbuckettag artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of downloading a source tarball from the latest tag of a Bitbucket repository.

```yaml
artifact:
  source:
    type: bitbuckettag
    repo: snappy-m-o/php-snappy
```

--------------------------------

### Define license metadata

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of specifying an SPDX license identifier within the metadata field.

```yaml
metadata:
  license: MIT
```

--------------------------------

### Complete Registry Declaration Example

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/registry.md

This YAML snippet shows all available fields for configuring a StaticPHP registry. It includes settings for name, autoload, package, artifact, doctor, and command configurations.

```yaml
# [Required] Unique registry name; loading a registry with a duplicate name is automatically skipped
name: my-registry

# [Optional] Composer autoload file path, used when an external registry has its own dependencies
autoload: vendor/autoload.php

# Package (library / php-extension / target) related configuration
package:
  # YAML configuration file directory or specific file paths for packages, can be an array
  config:
    - config/pkg/lib/
    - config/pkg/target/
    - config/pkg/ext/
  # PSR-4 namespace → directory path mapping for package build classes; the loader scans all PHP classes in the directory
  psr-4:
    Package: src/Package
  # You can also load specific classes as needed, supporting array format or {"ClassName": "file path"} mapping
  # classes:
  #   - Package\Library\MyLib
  #   MyLib: src/Package/Library/MyLib.php

# Artifact (build artifact) related configuration
artifact:
  # YAML configuration file directory or specific file paths for artifacts
  config:
    - config/artifact/
  # PSR-4 namespace → directory path mapping for custom artifact download/extract classes
  psr-4:
    Package\Artifact: src/Package/Artifact
  # classes: ... (same format as package.classes)

# Doctor environment check configuration
doctor:
  # PSR-4 namespace → directory path mapping for Doctor check item classes
  psr-4:
    StaticPHP\Doctor\Item: src/StaticPHP/Doctor/Item
  # classes: ... (same format as package.classes)

# Additional CLI command configuration
command:
  # PSR-4 namespace → directory path mapping for custom command classes
  psr-4:
    Package\Command: src/Package/Command
  # classes: ... (same format as package.classes)

```

--------------------------------

### Run Doctor via CLI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/doctor-module.md

Commands to execute the Doctor module for both pre-built binary and source installations.

```bash
# Pre-built binary
./spc doctor

# Source installation
bin/spc doctor
```

--------------------------------

### Configure shorthand URL artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of using a bare string URL which is automatically expanded into a type: url object.

```yaml
artifact:
  source: 'https://www.sqlite.org/2024/sqlite-autoconf-3450200.tar.gz'
```

--------------------------------

### Configure GitHub Tarball artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Example of downloading the auto-generated source tarball from a GitHub release.

```yaml
# librdkafka downloaded via GitHub Release tarball
artifact:
  source:
    type: ghtar
    repo: confluentinc/librdkafka
```

--------------------------------

### Reset Build Artifacts and Rebuild

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Wipe compiled artifacts from the `buildroot/` and `source/` directories to start a fresh build without re-downloading. This is useful when a build fails or you need to ensure a clean state.

```bash
spc reset
# Then rebuild
spc build:php "bcmath,openssl" --build-cli
```

--------------------------------

### Build static PHP with shared extensions on macOS

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/faq/index.md

On macOS, you can build statically compiled PHP binaries that support dynamically linked extensions. This example shows how to build a shared extension like `xdebug.so`.

```bash
spc build:php "bcmath,zlib" --build-shared=xdebug --build-cli
```

--------------------------------

### Minimal Artifact Object

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

A basic example of an artifact object pointing to a source archive using the ghrel type.

```yaml
&:
  source:
    type: ghrel
    repo: curl/curl
    match: curl.+\.tar\.xz
    prefer-stable: true
```

--------------------------------

### Configure environment variables in config/env.custom.ini

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/env-vars.md

Example of using a custom configuration file to override global and platform-specific environment variables without modifying the default env.ini.

```ini
; This is an example of `config/env.custom.ini` file,
; we modify the `SPC_CONCURRENCY` and linux default CFLAGS passing to libs and PHP
[global]
SPC_CONCURRENCY=4

[linux]
SPC_DEFAULT_CFLAGS="-O3"
```

--------------------------------

### Configure filelist artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Examples of using the filelist type to scrape versioned archives from HTML indexes like GNU FTP or OpenSSL.

```yaml
# ncurses: scrape latest version from the GNU FTP index
artifact:
  source:
    type: filelist
    url: 'https://ftp.gnu.org/pub/gnu/ncurses/'
    regex: '/href="(?<file>ncurses-(?<version>[^""]+)\.tar\.gz)"/'

# openssl: mirror source using filelist
artifact:
  source-mirror:
    type: filelist
    url: 'https://www.openssl.org/source/'
    regex: '/href="(?<file>openssl-(?<version>[^""]+)\.tar\.gz)"/'
```

--------------------------------

### Configure GitHub Tag Tarball artifact source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/artifact-model.md

Examples of downloading source tarballs from GitHub tags with regex filtering and query parameters.

```yaml
# brotli: only match v1.x tags
artifact:
  source:
    type: ghtagtar
    repo: google/brotli
    match: 'v1\.\d.*'

# libpng: match v1.6.x tags, with pagination
artifact:
  source:
    type: ghtagtar
    repo: pnggroup/libpng
    match: v1\.6\.\d+
    query: '?per_page=150'
```

--------------------------------

### Build command workflow comparison

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/migrate-from-v2.md

Comparison between the two-step process in v2 and the streamlined single-step process in v3 for building extensions.

```bash
# v2 — two steps required
spc download --for-extensions=curl,gd
spc build curl,gd --build-cli

# v3 — one step is enough
spc build:php-cli curl,gd
```

--------------------------------

### Debug Build Process with Verbose Logging

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Use verbose flags (`-v`, `-vv`, `-vvv`) to get detailed logs during the PHP build process. This helps in diagnosing build failures and understanding internal operations.

```bash
spc build:php "bcmath,openssl" --build-cli -vv
```

--------------------------------

### Build Libraries with Suggested Packages

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Build a library package and include its suggested packages by using the `--with-suggests` option.

```bash
spc build:libs openssl --with-suggests
```

--------------------------------

### Migrate build command options from v2 to v3

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/migrate-from-v2.md

Comparison of build command syntax between v2 and v3, showing the transition from library-specific flags to the unified --with-packages and --with-suggests options.

```bash
# v2
spc build curl,gd --build-cli --with-libs="openssl" -L -E

# v3
spc build curl,gd --build-cli --with-packages="openssl" --with-suggests
```

--------------------------------

### Validate documentation structure and build site

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/contributing/index.md

Use these commands to verify that the English and Chinese documentation file trees match and to build the documentation site.

```bash
diff <(find docs/en -name '*.md' | sed 's|docs/en/||' | sort) \
     <(find docs/zh -name '*.md' | sed 's|docs/zh/||' | sort)
npm run docs:build
```

--------------------------------

### Packaging applications with micro:combine

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Commands to bundle PHP scripts or phar files into standalone executables.

```bash
# Bundle a PHP script
echo "<?php echo 'Hello, World!' . PHP_EOL;" > hello.php
spc micro:combine hello.php --output=hello
./hello

# Bundle a phar
spc micro:combine your-app.phar --output=your-app
./your-app
```

--------------------------------

### Download Pre-built Binary for Windows x86_64

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Download the static PHP binary for Windows x86_64 architecture.

```powershell
curl.exe -#fSL https://dl.static-php.dev/v3/spc-bin/nightly/spc-windows-x86_64.exe -o spc.exe
```

--------------------------------

### Build PHP from Source

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Use this command to compile PHP and extensions from source. Specify the required comma-separated list of extensions to compile statically.

```bash
spc build:php <extensions> [options]
```

--------------------------------

### Build micro.sfx as Win32 GUI App

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Builds the `micro.sfx` binary as a Win32 GUI application instead of a console application. This option is only applicable on Windows.

```bash
spc build:php --enable-micro-win32
```

--------------------------------

### Build static PHP with FFI and load Xdebug extension

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/faq/index.md

This command builds a static PHP binary dynamically linked against glibc, supporting FFI extensions. It allows loading the `xdebug.so` extension for the same PHP version and thread-safe type. No Docker or extra cross-compilation toolchain is required.

```bash
SPC_TARGET=native-native-gnu.2.17 spc build:php "ffi,xml" --build-cli -vvv
```

```bash
buildroot/bin/php -d "zend_extension=/path/to/php{PHP_VER}-{ts/nts}/xdebug.so" --ri xdebug
```

--------------------------------

### Build micro.sfx

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Builds the `micro.sfx` executable, a self-contained PHP binary.

```bash
spc build:php --build-micro
```

--------------------------------

### Download Pre-built Binary for Linux arm64

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Download the static PHP binary for Linux arm64 architecture.

```shell
curl -#fSL https://dl.static-php.dev/v3/spc-bin/nightly/spc-linux-aarch64 -o spc
```

--------------------------------

### Make Binary Executable

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Mark the downloaded binary as executable on Linux and macOS before running.

```bash
chmod +x spc && ./spc --version
```

--------------------------------

### Download Pre-built Binary for Linux x86_64

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Download the static PHP binary for Linux x86_64 architecture.

```shell
curl -#fSL https://dl.static-php.dev/v3/spc-bin/nightly/spc-linux-x86_64 -o spc
```

--------------------------------

### Download Dependencies Preferring Pre-built Binaries

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Utilize pre-built binaries where available to skip compilation for those dependencies, speeding up the build process.

```bash
spc download --for-extensions="bcmath,openssl,curl" --prefer-binary
```

--------------------------------

### Run build command

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/README.md

Execute the craft command to build static PHP. Use the -vvv flag to see the full console log.

```bash
./spc craft

# Output full console log
./spc craft -vvv
```

--------------------------------

### Build Library Packages

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Build one or more library packages from source. Specify the libraries as a comma-separated list. All download options are available with the `--dl-` prefix.

```bash
spc build:libs <libraries> [options]
```

--------------------------------

### Combine with Custom Micro.sfx

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Uses a custom path to the micro.sfx stub instead of the default one. This is helpful when you need to use a specific version or a modified stub.

```bash
spc micro:combine app.php --with-micro=/path/to/micro.sfx
```

--------------------------------

### Create craft.yml configuration

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/README.md

Define the PHP version, extensions, and SAPI targets in a craft.yml file.

```yml
# PHP version support: 8.1, 8.2, 8.3, 8.4, 8.5, 8.6 (pre-release)
php-version: 8.5
# Put your extension list here
extensions: "apcu,bcmath,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,gd,iconv,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,readline,redis,session,simplexml,sockets,sodium,sqlite3,tokenizer,xml,xmlreader,xmlwriter,xsl,zip,zlib"
sapi:
  - cli
  - micro
download-options:
  parallel: 10
```

--------------------------------

### Download Pre-built Binary for macOS arm64

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Download the static PHP binary for macOS arm64 architecture.

```shell
curl -#fSL https://dl.static-php.dev/v3/spc-bin/nightly/spc-macos-aarch64 -o spc
```

--------------------------------

### Specify custom micro.sfx path

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Command to use a specific micro.sfx file when combining an application.

```bash
spc micro:combine your-app.phar --output=your-app --with-micro=/path/to/your/micro.sfx
```

--------------------------------

### Download Pre-built Binary for macOS x86_64

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Download the static PHP binary for macOS x86_64 architecture.

```shell
curl -#fSL https://dl.static-php.dev/v3/spc-bin/nightly/spc-macos-x86_64 -o spc
```

--------------------------------

### Reset Build Environment

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Cleans build directories. By default, removes 'buildroot/' and 'source/'. Use options to include 'pkgroot/' and 'downloads/'. The '--yes' flag skips confirmation.

```bash
spc reset [options]
```

```bash
# Clean build directories (will prompt for confirmation)
spc reset
```

```bash
# Also clear the download cache
spc reset --with-download
```

```bash
# Full clean without prompting
spc reset --with-pkgroot --with-download --yes
```

--------------------------------

### Build PHP with Custom Config Path

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Specifies a custom directory for PHP to look for the `php.ini` configuration file.

```bash
spc build:php --with-config-file-path=<path>
```

--------------------------------

### Build Micro SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Command to build the PHP Micro SAPI with specified extensions.

```bash
spc build:php "bcmath,phar,openssl,curl" --build-micro
```

--------------------------------

### Run Full Build Pipeline with craft.yml

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Execute the full build pipeline by running the 'craft' command. It reads configuration from a 'craft.yml' file. If no path is provided, it defaults to the current working directory.

```bash
spc craft [path/to/craft.yml]
```

--------------------------------

### Download Dependencies for Extensions

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Download only the necessary artifacts for specified extensions. This is recommended for efficient builds. Requires PHP version 8.5.

```bash
spc download --for-extensions="bcmath,posix,phar,zlib,openssl,curl,fileinfo,tokenizer" --with-php=8.5
```

```bash
spc download "curl,openssl" --with-php=8.5
```

--------------------------------

### Build PHP CLI with Extensions and Download Options

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

This command builds the PHP CLI SAPI with specified extensions, using a particular PHP version and preferring binary downloads for dependencies. It also sets the number of parallel downloads.

```bash
spc build:php "bcmath,openssl,curl" --build-cli --dl-with-php=8.3 --dl-prefer-binary --dl-parallel=4
```

--------------------------------

### Configure micro.sfx to Report CLI SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Forces the `micro.sfx` binary to report its SAPI as `cli` instead of `micro`.

```bash
spc build:php --with-micro-fake-cli
```

--------------------------------

### Injecting INI settings into Micro SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Methods for injecting runtime INI configuration during the packaging process.

```bash
# Inject via command-line options (-I is shorthand for --with-ini-set)
spc micro:combine your-app.phar --output=your-app -I "memory_limit=512M" -I "curl.cainfo=/etc/ssl/certs/ca-certificates.crt"

# Inject from an ini file (-N is shorthand for --with-ini-file)
spc micro:combine your-app.phar --output=your-app -N /path/to/custom.ini
```

--------------------------------

### Build PHP CLI and Micro SAPI Together

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

This command builds both the CLI and Micro SAPIs simultaneously, along with specified extensions.

```bash
spc build:php "bcmath,phar,openssl,curl" --build-cli --build-micro
```

--------------------------------

### Build FPM SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Command to build the PHP FPM SAPI with specified extensions.

```bash
spc build:php "bcmath,openssl,curl,pdo_mysql" --build-fpm
```

--------------------------------

### Build PHP with glibc support for dynamic loading

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Set the SPC_TARGET environment variable to native-native-gnu.2.17 to build a partially static binary on Linux that supports dynamic extension loading.

```bash
SPC_TARGET=native-native-gnu.2.17 spc build:php "bcmath,openssl" --build-cli
```

--------------------------------

### Run configuration and code style checks

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/AGENTS.md

Execute these commands to validate configuration files and ensure code style compliance before submitting changes.

```bash
bin/spc dev:lint-config
composer cs-fix
```

--------------------------------

### Build Micro SAPI with fake CLI SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Build command to make the Micro SAPI report as the CLI SAPI.

```bash
spc build:php "bcmath,phar" --build-micro --with-micro-fake-cli
```

--------------------------------

### Add Runtime to PATH

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Add the runtime directory to your system PATH for easier access.

```bash
export PATH="/path/to/static-php-cli/runtime:$PATH"
# Add this to ~/.bashrc or ~/.zshrc to make it permanent
```

--------------------------------

### Smoke-test the Static PHP CLI Binary

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

After a successful build, verify the generated CLI binary by checking its version and loaded modules. The binaries are located in the `buildroot/bin/` directory.

```bash
./buildroot/bin/php -v
./buildroot/bin/php -m
```

--------------------------------

### Download specific artifacts

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Download a precise list of artifacts, such as PHP source and OpenSSL.

```bash
spc download "php-src,openssl"
```

--------------------------------

### Verify Build Environment

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Run the doctor command to check for required build tools.

```bash
# Using the spc binary
./spc doctor
# From source
bin/spc doctor
```

--------------------------------

### Download spc binary

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/README.md

Download the appropriate spc binary for your operating system and architecture.

```bash
# For Linux x86_64
curl -fsSL -o spc https://dl.static-php.dev/v3/spc-bin/nightly/spc-linux-x86_64
# For Linux aarch64
curl -fsSL -o spc https://dl.static-php.dev/v3/spc-bin/nightly/spc-linux-aarch64
# macOS x86_64 (Intel)
curl -fsSL -o spc https://dl.static-php.dev/v3/spc-bin/nightly/spc-macos-x86_64
# macOS aarch64 (Apple)
curl -fsSL -o spc https://dl.static-php.dev/v3/spc-bin/nightly/spc-macos-aarch64
# Windows (x86_64, win10 build 17063 or later, please install VS2022 first)
curl.exe -fsSL -o spc.exe https://dl.static-php.dev/v3/spc-bin/nightly/spc-windows-x64.exe
```

--------------------------------

### Usage of php-fpm binary

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Common commands for interacting with the built php-fpm binary.

```bash
# Check version
./buildroot/bin/php-fpm -v

# Start with a specific config file
./buildroot/bin/php-fpm -c /path/to/php.ini -y /path/to/php-fpm.conf

# Test config file
./buildroot/bin/php-fpm -t
```

--------------------------------

### Build PHP with CLI SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Builds the PHP Command Line Interface (CLI) SAPI. This is the default SAPI if none are specified.

```bash
spc build:php --build-cli
```

--------------------------------

### Set custom environment variables via shell

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/env-vars.md

Demonstrates how to set environment variables using the export command or by prefixing them directly to the spc build command.

```shell
# export first
export SPC_CONCURRENCY=4
spc build:php "mbstring,pcntl" --build-cli

# or direct use
SPC_CONCURRENCY=4 spc build:php "mbstring,pcntl" --build-cli
```

--------------------------------

### Build PHP with Hardcoded INI Setting

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Bakes a specific INI setting directly into the binary at compile time. This option can be repeated for multiple settings.

```bash
spc build:php --with-hardcoded-ini=<k=v>
```

```bash
spc build:php -I <k=v>
```

--------------------------------

### Build GD with Graphics Libraries

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/extension-notes.md

Use the --with-libs flag to include specific graphics libraries like freetype, libjpeg, libavif, and libwebp when building the GD extension.

```bash
bin/spc build gd --with-libs=freetype,libjpeg,libavif,libwebp --build-cli
```

--------------------------------

### Build Specific PHP SAPIs

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Use these commands to build specific PHP Server API implementations like CLI, FPM, Micro, Embed, CGI, or FrankenPHP. Specify required extensions as a comma-separated string.

```bash
spc build:php-cli "bcmath,openssl,curl"
spc build:php-micro "bcmath,phar,openssl"
spc build:php-fpm "bcmath,openssl,curl,pdo_mysql"
spc build:php-embed "bcmath,openssl"
spc build:frankenphp "bcmath,openssl,curl" --enable-zts
```

--------------------------------

### Run a Verbose Static PHP Build

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Use the `-v` flag with `spc craft` to increase the verbosity of the build output, providing more detail on the pipeline stages. Higher verbosity levels (`-vv`, `-vvv`) offer even more information.

```bash
spc craft -v
```

--------------------------------

### Full php-extension configuration schema

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/package-model.md

A comprehensive template showing all available fields and configuration options for a php-extension package.

```yaml
ext-{ext-name}:          # Package name must start with ext- prefix
  type: php-extension

  # ── Common Fields ────────────────────────────────────────────────────────
  description: '..'       # Optional, human-readable package description
  lang: c                 # Optional, implementation language of the extension (c / c++ etc.)
  frameworks: []          # Optional, list of related macOS framework dependencies

  artifact: '{artifact-name}'  # Optional; when a string, references the named Artifact definition;
                               # when an object, it is an inline Artifact
                               # (built-in extensions don't need this field)

  # depends / suggests / tools support @windows / @unix / @linux / @macos suffixes
  depends: []             # Optional, hard dependency list (library names as-is, PHP extensions need ext- prefix)
  depends@unix: []        # Optional, hard dependencies only effective on Unix platforms
  depends@windows: []     # Optional, hard dependencies only effective on Windows platforms
  suggests: []            # Optional, optional dependency list (same format as depends)
  suggests@unix: []
  tools: []               # Optional, host-side build tool dependencies; resolved separately
  tools@windows: []       # Optional, platform-specific tool dependencies

  # ── php-extension Specific Fields (nested under php-extension: object) ────
  php-extension:
    # arg-type determines the form of arguments passed to ./configure, supports platform suffixes
    # Supported platform suffixes: @unix (Linux + macOS), @linux, @macos, @windows
    # Priority (using Linux as example): arg-type@linux > arg-type@unix > arg-type (no suffix)
    # Built-in keywords:
    #   enable      → --enable-{extname} (default value, used when not configured)
    #   enable-path → --enable-{extname}={buildroot}
    #   with        → --with-{extname}
    #   with-path   → --with-{extname}={buildroot}
    #   custom/none → Pass no arguments (handled by the #[CustomPhpConfigureArg] method in the PHP class)
    # You can also write the full argument string directly, supporting the following placeholders:
    #   @build_root_path@      → BUILD_ROOT_PATH (absolute path of buildroot)
    #   @shared_suffix@        → Expands to =shared in shared builds, empty in static builds
    #   @shared_path_suffix@   → Expands to =shared,{buildroot} in shared builds,
    #                            expands to ={buildroot} in static builds
    arg-type: enable
    arg-type@unix: '--enable-my-extension@shared_suffix@'
    arg-type@windows: with-path

    zend-extension: false   # Optional, true indicates this is a Zend extension (e.g., opcache, xdebug)
    build-shared: true      # Optional, whether building as a shared extension (.so) is allowed, default true
    build-static: true      # Optional, whether inline static building (compiled into PHP) is allowed, default true
    build-with-php: true    # Optional, true means the extension is built together via the PHP source tree
                            # (used for built-in extensions)

    # display-name affects the php --ri argument in smoke tests and the license export display name
    # If not set, defaults to the extension name (the part after ext-); if set to empty string, skips --ri check
    display-name: 'My Extension'

    # os restricts the extension to be available only on specified platforms;
    # platforms not in the list will be rejected for building
    # Allowed values: Linux, Darwin, Windows
    os: [Linux, Darwin]
```

--------------------------------

### Build PHP Extensions as Shared Libraries

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Compiles specified extensions as shared `.so` or `.dll` files instead of statically linking them.

```bash
spc build:php --build-shared=<list>
```

```bash
spc build:php -D <list>
```

--------------------------------

### Verify binary linkage

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/performance.md

Use these commands to inspect the linkage and program interpreter of a built PHP binary to confirm its configuration.

```bash
file buildroot/bin/php
readelf -l buildroot/bin/php | grep 'Requesting program interpreter'
```

--------------------------------

### CLI SAPI Usage

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Common commands for checking version, listing extensions, running scripts, and entering interactive mode.

```bash
# Check version and loaded extensions
./buildroot/bin/php -v
./buildroot/bin/php -m

# Run a script
./buildroot/bin/php your-script.php

# Interactive mode
./buildroot/bin/php -a
```

--------------------------------

### Configure Compiler and Linker Flags

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Outputs compiler and linker flags for linking against the PHP embed static library. Specify extensions to include. Options control the output of include paths, linker flags, and library details.

```bash
spc spc-config [extensions] [options]
```

```bash
# Output full compiler + linker flags
spc spc-config "bcmath,openssl,curl"
```

```bash
# Output include paths only
spc spc-config "bcmath,openssl" --includes
```

```bash
# Output linker flags only
spc spc-config "bcmath,openssl" --libs
```

```bash
# Use absolute library paths
spc spc-config "bcmath,openssl" --libs --absolute-libs
```

--------------------------------

### Run validation and quality checks

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/contributing/index.md

Execute these commands to lint configurations, fix code style, run tests, and perform static analysis on the project.

```bash
bin/spc dev:lint-config
composer cs-fix
composer test
composer analyse
```

--------------------------------

### Build PHP with CGI SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Builds the PHP-CGI SAPI, suitable for environments that use the Common Gateway Interface.

```bash
spc build:php --build-cgi
```

--------------------------------

### Build PHP with Custom Config Scan Directory

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Specifies a custom directory for PHP to scan for additional `.ini` files.

```bash
spc build:php --with-config-file-scan-dir=<path>
```

--------------------------------

### Combine PHP Script into Executable

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Merges a PHP script with the micro.sfx stub to create a standalone executable. The default output name is 'my-app'.

```bash
spc micro:combine app.php
```

--------------------------------

### Build PHP CLI and Bake INI Settings

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

This command builds the PHP CLI SAPI with specified extensions and embeds custom INI settings directly into the binary.

```bash
spc build:php "bcmath,pcntl" --build-cli -I "memory_limit=4G" -I "disable_functions=system"
```

--------------------------------

### Optimize downloads with parallelism and retries

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Accelerate the download process by configuring parallel downloads and specifying the number of retries for failed downloads.

```bash
spc download --for-extensions="bcmath,openssl,curl" --parallel 8 --retry=3
```

--------------------------------

### Configure ISA baseline for Linux builds

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/develop/performance.md

Use the config/env.custom.ini file to set the ISA baseline to x86-64-v3, enabling AVX2 instructions. Note that this reduces binary portability to CPUs that do not support this instruction set.

```ini
[linux]
SPC_DEFAULT_CFLAGS="-fPIC -O3 -pipe -fno-plt -fno-semantic-interposition -fstack-clash-protection -fno-omit-frame-pointer -mno-omit-leaf-frame-pointer -ffunction-sections -fdata-sections -march=x86-64-v3"
SPC_DEFAULT_CXXFLAGS="${SPC_DEFAULT_CFLAGS}"
```

--------------------------------

### Static PHP usage

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/README.md

Verify the php-cli binary or combine a PHP script into a standalone phpmicro executable.

```bash
# php-cli
buildroot/bin/php -v

# phpmicro
echo '<?php echo "Hello world!\n";' > a.php
./spc micro:combine a.php -O my-app
./my-app
```

--------------------------------

### Download artifacts for extensions

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Use this command to download specific artifacts required by your chosen PHP extensions. You can specify the PHP version and force re-downloads if necessary.

```bash
spc download --for-extensions="bcmath,openssl,curl" --with-php=8.5
```

```bash
spc download --for-extensions="bcmath,openssl,curl" --ignore-cache="php-src" --with-php=8.3
```

```bash
spc download --for-extensions="bcmath" --custom-url "php-src:https://downloads.php.net/~user/php-8.5.0alpha1.tar.xz"
```

--------------------------------

### Enter Development Shell

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

The `dev:shell` command provides an interactive shell with StaticPHP's build environment pre-loaded. This is useful for compiling small programs or inspecting the build environment.

```bash
spc dev:shell
```

--------------------------------

### Combine with INI File

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Injects INI settings from a specified file into the standalone executable. This is useful for managing multiple configuration options efficiently.

```bash
spc micro:combine app.php --with-ini-file=custom.ini
```

--------------------------------

### Run PHP with Xdebug Shared Extension

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/extension-notes.md

After compiling Xdebug as a shared extension, use the -d flag to load the zend_extension via the path to the compiled .so file.

```bash
./php -d 'zend_extension=/path/to/xdebug.so' your-code.php
```

--------------------------------

### Run Environment Diagnostics

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Use the `doctor` command to diagnose if the current environment can compile PHP normally. Options include automatic fixing of detected issues.

```bash
spc doctor [--auto-fix[=never]]
```

--------------------------------

### Build Multiple PHP SAPIs

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Compile multiple PHP Server API (SAPI) modules, including CLI and micro.sfx, in a single command.

```bash
spc build:php "bcmath,phar,zlib,openssl,curl" --build-cli --build-micro
```

--------------------------------

### Generate Dependency Data

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/deps-map.md

Run this command in source mode to generate the dependency data for the package list.

```bash
bin/spc dev:gen-deps-data
```

--------------------------------

### 使用 ghrel 类型下载 GitHub Release Assets

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/zh/develop/artifact-model.md

通过 GitHub Release Assets API 下载文件，需要指定 repo 和匹配文件名的正则。

```yaml
# openssl 从 GitHub Release Assets 下载
artifact:
  source:
    type: ghrel
    repo: openssl/openssl
    match: openssl.+\.tar\.gz
    prefer-stable: true
```

--------------------------------

### Embed Custom Icon into micro.sfx

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Embeds a custom `.ico` icon file into the `micro.sfx` binary. This option is only applicable on Windows.

```bash
spc build:php --with-micro-logo=<path>
```

--------------------------------

### Download Dependencies with Increased Parallelism and Retries

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Optimize download speed and reliability for slow network connections by increasing parallelism and retry attempts.

```bash
spc download --for-extensions="bcmath,openssl,curl" --parallel 10 --retry=3
```

--------------------------------

### 使用 git 类型克隆

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/zh/develop/artifact-model.md

通过指定 git 类型克隆仓库源码，支持通过 rev 指定分支、Tag 或 commit。

```yaml
# php-glfw 使用 git 克隆 master 分支
artifact:
  source:
    type: git
    url: 'https://github.com/mario-deluna/php-glfw'
    rev: master
```

--------------------------------

### Build PHP with FPM SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Builds the PHP-FPM SAPI, which is used for web server integration. This option is available on Linux and macOS.

```bash
spc build:php --build-fpm
```

--------------------------------

### Run PHP code tests and analysis

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/AGENTS.md

Use these commands for broader PHP code changes to verify functionality and code quality.

```bash
composer test
composer analyse
```

--------------------------------

### Build Libraries Skipping Download

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Build library packages while skipping the download step, using existing cached files by specifying the `--no-download` option.

```bash
spc build:libs openssl --no-download
```

--------------------------------

### Dump PHP Extensions

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Analyzes a Composer project to list required PHP extensions. Specify a path to the project root if it's not the current directory.

```bash
spc dump-extensions [path] [options]
```

```bash
# Analyse the current directory
spc dump-extensions
```

```bash
# Analyse a specific directory
spc dump-extensions /path/to/project
```

```bash
# Exclude dev dependencies
spc dump-extensions --no-dev
```

```bash
# Fall back to a default list when no extensions are found
spc dump-extensions --no-ext-output="bcmath,openssl"
```

--------------------------------

### Build embed SAPI

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/sapi-reference.md

Command to compile PHP into a static library for linking into C/C++ programs.

```bash
spc build:php "bcmath,openssl" --build-embed
```

--------------------------------

### Call Runtime Directly

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/installation.md

Execute PHP and Composer directly from the runtime directory without modifying PATH.

```bash
runtime/php bin/spc --help
runtime/php runtime/composer install
```

--------------------------------

### Package a Micro App

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Combine a PHP script into a self-contained executable. This is useful for creating small, standalone PHP applications.

```bash
echo "<?php echo 'Hello, World!' . PHP_EOL;"> hello.php
spc micro:combine hello.php --output=hello
./hello
```

--------------------------------

### Inject INI Settings from a File

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/first-build.md

Inject INI settings from a configuration file when packaging a PHAR archive. This is useful for managing complex configurations.

```bash
# Inject INI from a file
spc micro:combine your-app.phar --output=your-app -N /path/to/custom.ini
```

--------------------------------

### Build PHP Skipping Download

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Skips the download step and uses existing cached files for the build process.

```bash
spc build:php --no-download
```

--------------------------------

### Opting out of automatic downloads

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/migrate-from-v2.md

Use the --no-download flag to skip automatic dependency downloads, which is useful for CI environments with pre-cached sources.

```bash
spc build:php-cli curl,gd --no-download
```

--------------------------------

### Build FrankenPHP Binary

Source: https://github.com/crazywhalecc/static-php-cli/blob/v3/docs/en/guide/cli-reference.md

Builds the FrankenPHP binary, a modern PHP application server. Requires thread-safe mode to be enabled.

```bash
spc build:php --build-frankenphp
```
Tokens:
Raw