错误源于 PHP 禁用 proc_open() 函数,而 Composer 必须调用该函数;修复方法是修改 php.ini 中 disable_functions 行,移除 proc_open 并重启 PHP 服务,再验证 function_exists('proc_open') 返回 true。

这个错误是因为 PHP 禁用了 proc_open() 函数,而 Composer 在执行依赖安装、脚本运行、Git 操作等过程中必须调用该函数。修复的关键是启用它,而不是绕过或降级 Composer。
检查当前禁用的函数列表
打开你的 php.ini 文件(可通过 php --ini 或 phpinfo() 确认路径),查找 disable_functions 这一行:
注意:有些环境(如共享主机、Docker 镜像、宝塔面板)会默认禁用 proc_open、exec、shell_exec 等函数以增强安全,但 Composer 无法在完全禁用 proc_open 的情况下正常工作。
修改 php.ini 启用 proc_open()
在 php.ini 中找到并编辑 disable_functions 行:
立即学习“PHP免费学习笔记(深入)”;
- 如果该行包含
proc_open,直接将其删除(保留其他函数也可) - 如果整行是
disable_functions = proc_open,exec,shell_exec,passthru,改为:disable_functions = exec,shell_exec,passthru(去掉proc_open) - 如果该行为空或注释掉(如
;disable_functions =),可直接设为:disable_functions =(留空表示不禁用任何函数)
重启 PHP 服务并验证
修改后必须重启对应的服务才能生效:
- PHP-FPM 环境:运行
sudo systemctl restart php-fpm(或对应版本,如php8.2-fpm) - Apache + mod_php:重启 Apache:
sudo systemctl restart apache2 - CLI 模式(本地开发):无需重启,但需确认你修改的是 CLI 对应的
php.ini(运行php --ini查看)
验证是否生效:php -r "var_dump(function_exists('proc_open'));" → 应输出 bool(true)
其他注意事项
某些云平台(如部分国内虚拟主机、阿里云轻量应用服务器的默认镜像)或安全插件(如某些 WordPress 安全插件)也会通过其他方式限制系统调用。若修改 php.ini 后仍报错,请检查:
- 是否有多份
php.ini(CLI 和 Web SAPI 可能不同) - 是否启用了 Suhosin、Hardened PHP 等扩展(它们可能额外限制函数)
- 是否使用了容器或沙盒环境(如某些 Serverless 平台根本不允许进程派生)
如果是生产环境且安全策略严格,建议与运维协同评估风险,而非强行启用 —— 因为 proc_open 确实涉及系统执行能力,但 Composer 的正常使用并不引入额外攻击面。











