答案:该错误由proc_open函数被禁用引起,需在php.ini中移除disable_functions里的proc_open相关函数并重启服务;若无法修改配置,可联系主机商或改用VPS,也可通过手动下载项目、禁用脚本等方式绕过问题。

这个错误提示“The Process class relies on proc_open”通常出现在使用 Composer 时,PHP 的 proc_open 函数被禁用或系统环境不支持进程创建。Composer 内部依赖 Symfony Process 组件来执行外部命令,而该组件需要 proc_open 函数正常工作。
检查并启用 proc_open 函数
在 php.ini 配置文件中,某些主机出于安全考虑会将 proc_open 加入禁用函数列表(disable_functions)。你需要确认这一点:
- 打开你的
php.ini文件(可通过php --ini查看加载的配置文件路径) - 查找
disable_functions配置项 - 如果里面包含
proc_open,proc_close,proc_get_status等,请将它们删除 - 保存文件并重启 Web 服务器或 PHP-FPM
修改后运行以下命令测试是否生效:
php -r "var_dump(function_exists('proc_open'));"如果返回 bool(true),说明函数已启用。
共享主机或无法修改 php.ini 怎么办?
如果你使用的是虚拟主机或无法修改 php.ini,可以尝试以下方法:
- 联系主机服务商,询问是否可以开启
proc_open - 考虑更换到支持完整 PHP 功能的 VPS 或开发环境
- 部分托管平台提供自定义
php.ini或.user.ini,可尝试在项目根目录添加配置覆盖
替代方案:避免使用需要 proc_open 的命令
某些 Composer 命令(如 create-project、运行脚本钩子等)必须使用进程功能。但你可以:
- 手动下载并解压项目代替
composer create-project - 使用不涉及外部进程的简单命令,如
composer install --no-scripts - 确保
composer.json中没有自定义脚本触发进程调用
本地开发环境建议
在本地使用如 XAMPP、WAMP、Laravel Homestead 或 Docker 环境时,确保:
- 未手动禁用
proc_open - 操作系统权限允许创建新进程(Windows 一般无问题,Linux 注意用户权限)
- 使用官方 PHP 版本而非某些精简打包版本
基本上就这些。只要确保 proc_open 可用,这个错误就能解决。如果是生产环境受限,建议调整部署方式或升级主机环境。










