Composer不负责编译C扩展,需手动安装;首先检查composer.json中require部分确认依赖ext-somecextension,若缺失则报错;通过git或PECL获取源码,执行phpize、configure、make、make install编译安装;将生成的so文件放入PHP扩展目录,并在php.ini中添加extension=somecextension.so;重启服务后用php -m验证加载;开发时可临时使用--ignore-platform-req跳过检查,但运行时仍需实际安装扩展。

在使用 Composer 安装 PHP 包时,如果某个依赖需要 C 扩展(例如 ext-somecextension),而该扩展没有预编译版本,就需要手动编译。Composer 本身不负责编译 C 扩展,但它会检查扩展是否存在。你需要在系统层面处理扩展的编译和安装。
确认扩展是否为必需
查看 composer.json 中的 require 部分,例如:
"require": {"php": "^8.1",
"ext-somecextension": "*"
}
这表示项目依赖名为 somecextension 的 PHP 扩展。如果该扩展未启用,Composer 会报错:
PHP extension "somecextension" is missing.获取并编译 C 扩展源码
大多数需要编译的扩展托管在 GitHub 或 PECL 上。以从源码编译为例:
立即学习“PHP免费学习笔记(深入)”;
- 克隆或下载扩展源码
- 进入目录执行 phpize、configure、make、make install
示例流程:
git clone https://github.com/user/somecextension.gitcd somecextension
phpize
./configure
make
sudo make install
成功后,扩展的 so 文件会被复制到 PHP 扩展目录(可通过 php -i | grep extension_dir 查看)。
启用扩展
编辑 php.ini 文件,添加:
extension=somecextension.so保存后重启 Web 服务器或 PHP-FPM。验证是否加载成功:
php -m | grep somecextension如果看到扩展名输出,说明已启用。
跳过扩展检查(仅开发调试)
如果你只是想继续安装其他 PHP 纯代码依赖,可以临时忽略扩展缺失:
composer install --ignore-platform-req=ext-somecextension注意:这只是跳过检查,并不代表功能可用。运行时仍会因缺少扩展而报错。
基本上就这些。Composer 不参与编译过程,你得自己搞定扩展的构建和启用。确保开发与生产环境一致,避免部署时出问题。











