PHP-Build 技术文档

本文档将详细介绍如何安装、使用以及通过 API 调用 PHP-Build，以帮助用户更好地理解和运用这一工具。

1. 安装指南

作为 phpenv 插件

使用 [phpenv] 安装器

这是标准的安装方法：将 phpenv 安装在 $HOME/.phpenv 目录（默认 $PHPENV_ROOT 值）。

curl -L https://raw.githubusercontent.com/phpenv/phpenv-installer/master/bin/phpenv-installer \
    | bash

手动安装 phpenv

找到你的 phpenv 目录：

% ls $HOME/.phpenv

将 Git 仓库克隆到 phpenv 插件目录：

% git clone https://github.com/php-build/php-build.git $HOME/.phpenv/plugins/php-build

现在你可以作为 phpenv 插件使用 php-build，如下：

% phpenv install <definition>

构建的版本将安装到 $HOME/.phpenv/versions/<definition>。

作为独立 php-build

克隆 Git 仓库：

% git clone https://github.com/php-build/php-build.git

然后进入提取/克隆的目录并运行：

% ./install.sh

这会将 php-build 安装到默认的前缀 /usr/local。

要将 php-build 安装到 /usr/local 之外的位置，请设置 PREFIX 环境变量：

% PREFIX=$HOME/local ./install.sh

如果你没有权限写入前缀，那么你必须以超级用户身份运行 install.sh，可以通过 su -c 或 sudo 来执行。

2. 项目的使用说明

php-build 是一个用于构建 PHP 版本的工具，可以让你在同一系统上并行使用多个 PHP 版本。

使用 phpenv 插件时，可以通过以下命令安装指定版本的 PHP：

% phpenv install <definition>

使用独立 php-build 时，可以通过以下命令安装指定版本的 PHP：

% ./php-build <definition> <install_path>

其中 <definition> 是 PHP 版本的描述，例如 "7.4.3"，<install_path> 是安装路径。

3. 项目 API 使用文档

目前 php-build 没有公开的 API 接口。

4. 项目安装方式

请参考上文“安装指南”部分的说明进行安装。无论是作为 phpenv 插件还是作为独立工具，安装过程都已详细描述。