COMPOSER_PROCESS_TIMEOUT是Composer设置子进程最长等待时间的环境变量，默认300秒。当执行install、update等命令因网络慢、依赖多或脚本复杂导致耗时过长时，若超过该时限，Composer会终止进程并报错。通过设置COMPOSER_PROCESS_TIMEOUT=600等值可延长超时时间，解决ProcessTimedOutException错误，适用于大型项目或低速网络环境。
当使用 Composer 执行某些命令（如 install、update 或运行自定义脚本）时，如果进程长时间无响应或执行时间过长，Composer 可能会中断操作并报错。这通常是由于网络延迟、包依赖复杂、脚本卡住等原因导致的。为了解决这类问题，Composer 提供了 COMPOSER_PROCESS_TIMEOUT 环境变量来控制进程等待的最大时间。
什么是 COMPOSER_PROCESS_TIMEOUT？
COMPOSER_PROCESS_TIMEOUT 是 Composer 用来设置子进程（例如执行脚本、git 克隆、下载包等）最大等待时间的环境变量，单位是秒。一旦某个进程的执行时间超过这个值，Composer 就会认为该进程“卡住”并主动终止它，防止无限等待。
默认情况下，Composer 的超时时间是 300 秒（5 分钟）。对于大多数项目来说足够，但在大型项目或网络较慢的环境中，可能需要延长这个时间。
如何设置 COMPOSER_PROCESS_TIMEOUT？
你可以在运行 Composer 命令前临时设置该变量，也可以在系统或用户环境变量中永久配置。
1. 临时设置（推荐用于调试）
在命令行中直接指定：
- Linux / macOS：
COMPOSER_PROCESS_TIMEOUT=600 composer install
- Windows（CMD）：
set COMPOSER_PROCESS_TIMEOUT=600 && composer install
- Windows（PowerShell）：
$env:COMPOSER_PROCESS_TIMEOUT=600; composer install
2. 永久设置
将该变量添加到系统的环境变量中，这样每次运行 Composer 都会生效。
- Linux/macOS：在 ~/.bashrc 或 ~/.zshrc 中添加：
export COMPOSER_PROCESS_TIMEOUT=600
- Windows：通过“系统属性 → 高级 → 环境变量”添加。
常见使用场景
以下情况建议调大超时时间：
- 项目依赖特别多，composer install 耗时较长
- 服务器位于网络较差区域，下载包速度慢
- 自定义脚本（如 post-install-cmd）执行复杂任务（如生成代码、构建前端资源）
- 使用 Git 仓库作为包源，克隆过程缓慢
如果你看到类似错误信息：
[Symfony\Component\Process\Exception\ProcessTimedOutException] The process "xxx" exceeded the timeout of 300 seconds.
这就是典型的超时问题，调整 COMPOSER_PROCESS_TIMEOUT 即可解决。
基本上就这些。合理设置超时时间，可以避免 Composer 因“执行太久”而误杀正常进程，提升稳定性。
