composer的COMPOSER_PROCESS_TIMEOUT环境变量怎么设置_教你配置COMPOSER_PROCESS

composer的COMPOSER_PROCESS_TIMEOUT环境变量怎么设置_教你配置COMPOSER_PROCESS_TIMEOUT延长执行时间

穿越時空

发布： 2025-10-24 23:12:02

原创

262人浏览过

COMPOSER_PROCESS_TIMEOUT用于设置Composer执行外部命令的最大等待时间，默认300秒；可通过环境变量或composer.json的config字段调整，推荐根据网络情况适当延长以避免超时中断。

composer的composer_process_timeout环境变量怎么设置_教你配置composer_process_timeout延长执行时间

Composer 在安装或更新依赖时，如果遇到网络较慢或项目较大，可能会因为超时导致命令中断。这时可以通过设置 COMPOSER_PROCESS_TIMEOUT 环境变量来延长 Composer 允许单个进程运行的最长时间。

什么是 COMPOSER_PROCESS_TIMEOUT

该环境变量用于定义 Composer 执行外部命令（如 git clone、npm install 等）时等待响应的最大秒数。默认值通常是 300 秒（5 分钟）。当操作超过这个时间，Composer 会抛出类似 [Symfony\Component\Process\ProcessTimedOutException] 的错误。

如何设置 COMPOSER_PROCESS_TIMEOUT

有多种方式可以设置该变量，选择适合你开发环境的方式即可：

方式一：临时设置（推荐用于调试）

在执行 composer 命令前，直接在终端中设置环境变量：

Linux / macOS：

COMPOSER_PROCESS_TIMEOUT=600 composer install

这将本次执行的超时时间设为 10 分钟（600 秒）。

Windows（命令提示符）：

set COMPOSER_PROCESS_TIMEOUT=600 && composer install

Windows（PowerShell）：

$env:COMPOSER_PROCESS_TIMEOUT=600; composer install

方式二：永久设置环境变量

如果你经常遇到超时问题，建议将该变量写入系统环境变量中。

美间AI

美间AI：让设计更简单

查看详情

Linux / macOS：编辑 ~/.bashrc 或 ~/.zshrc

添加一行：

export COMPOSER_PROCESS_TIMEOUT=600

保存后执行：source ~/.bashrc 使其生效。

Windows：

通过“系统属性 → 高级 → 环境变量”添加：

变量名：COMPOSER_PROCESS_TIMEOUT
变量值：600

方式三：在 composer.json 中配置

虽然不能直接在 composer.json 中设置 PROCESS_TIMEOUT，但你可以通过 config 节点设置 http 超时等参数，与之配合使用：

"config": {
    "process-timeout": 600,
    "http-basic": {
        "gitlab.example.com": {
            "username": "xx",
            "password": "xx"
        }
    }
}

登录后复制

注意：process-timeout 是 config 下的有效字段，作用类似于环境变量，优先级低于环境变量。