compiler/docs/LIBPHP_INSTALLER.md

自动构建 libphp.so

TypePHP 的可执行文件和共享库模式需要 PHP Embed SAPI 提供的 libphp.so。许多 Linux 发行版的 PHP 包只包含 CLI 或 FPM，因此 tpc.php 在找不到 libphp.so 时会询问是否自动构建一份私有 PHP。

该功能只在 Linux 和交互式终端中启用。扩展模式（-m ext）不需要 libphp.so，不会触发安装器；CI 等非交互环境也不会自动下载、安装软件包或执行 sudo。

使用流程

正常执行编译命令即可：

vendor/bin/tpc.php project.yml

缺少 libphp.so 时，安装器会依次询问：

1. 是否自动构建 PHP Embed 库；
2. PHP 版本，默认从 PHP.net 获取最新稳定版 PHP 8.4，也可输入 PHP 8.4/8.5 的具体稳定版本；
3. 安装目录，默认为 ~/.typephp；
4. 是否通过检测到的 apt-get、dnf 或 yum 安装缺失的开发包。

安装器读取当前 php-config --configure-options，保留当前 PHP 的扩展配置，替换安装路径并加入 --enable-embed=shared。PHP 源码只从 PHP.net 下载，并使用官方发布信息中的 SHA-256 校验。

编译完成后主要文件如下：

~/.typephp/bin/php
~/.typephp/bin/php-config
~/.typephp/lib/libphp.so
~/.typephp/lib/php.ini
~/.typephp/lib/loaded-extensions.txt

当前 ini 主文件和扫描目录中的配置会被合并。使用相同 PHP 主次版本时，当前 ini 中加载的共享扩展会复制到新扩展目录；跨主次版本时不会复制二进制扩展，不可用的扩展配置会被注释，避免生成的 PHP 无法启动。

安装成功后，当前 tpc.php 进程会自动将新目录作为 PHP_HOME 并继续原来的编译任务。后续也可以显式指定：

export PHP_HOME="$HOME/.typephp"
vendor/bin/tpc.php project.yml

再次选择同一目录和版本时，安装器会询问是否直接复用已有的 libphp.so，不会重复执行完整构建。

非交互环境

安装器不会在 CI 中自动确认权限操作。请提前准备 libphp.so，然后设置：

PHP_HOME=/path/to/php vendor/bin/tpc.php project.yml