Composer怎么在Linux上部署？全局安装与镜像切换【指南】-composer-PHP中文网

答案是：全局配置需严格执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，确保键名单数、type显式、url带https及末尾斜杠，且验证输出为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；宝塔等环境因用户权限差异推荐项目级配置，镜像仅加速下载不解决依赖解析慢问题。

composer怎么在linux上部署？全局安装与镜像切换【指南】

直接用 curl -sS https://getcomposer.org/installer | php 下载，再 mv composer.phar /usr/local/bin/composer 就能全局调用——但光装完不行，不配镜像源，composer install 会卡在 Downloading https://packagist.org/packages.json，甚至超时失败。

怎么装才能真·全局可用

关键不是“能不能运行 composer -v”，而是 PHP 进程（比如 Web 服务用户）能否读到它、调到它。

/usr/local/bin/composer 必须有执行权限：sudo chmod a+x /usr/local/bin/composer
别用 sudo php composer.phar 临时跑——这绕过了全局路径，也绕过了后续所有配置生效逻辑
如果系统里已有旧版 Composer（比如通过包管理器安装的），先 which composer 确认路径，避免冲突
Docker 或 CI 场景下，建议直接用官方安装脚本而非 apt/yum 安装，因为系统包常滞后且不带 selfupdate 权限

为什么 `composer config -g` 配了也不生效

不是命令错了，是写到了错的地方，或者被更高优先级覆盖了。

Browser Setup (No-Root Linux)

在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...

下载

用 whoami 确认当前用户，composer config -g 写入的是该用户的 ~/.composer/config.json；sudo composer config -g 写进的是 /root/.composer/config.json，而 www-data 根本看不到
项目根目录下只要存在 composer.json 且含 "repositories" 字段（哪怕只写了 {} 或 {"packagist.org": false}），全局配置就彻底失效
验证是否真写对位置：运行 composer config -g --global-config，它会输出实际生效的配置文件路径
Composer 2.2+ 支持系统级配置，放 /etc/composer/config.json 才算真正“所有用户都认”，适合 Docker 或批量部署

阿里镜像怎么切才稳

URL 和键名错一个字符，就静默退回到 packagist.org，连错误都不报。

正确命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ ——注意末尾斜杠 / 不可省略
repo.packagist 是固定键名，写成 repos.packagist、packagist.org 或 repo.packagist.org 都无效
别加 /packages.json 后缀，阿里镜像服务已自动路由所有子路径
换源后必须 composer clear-cache，否则旧缓存可能仍触发原始域名请求
验证是否真走镜像：跑 composer update -vvv | grep "Downloading\|mirrors"，看到 mirrors.aliyun.com 才算落地

项目级镜像怎么避免踩坑

局部配置不是“叠加”，是“覆盖”，一不小心就把私有仓库干掉了。

进项目根目录后运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会直接往 composer.json 的 "repositories" 字段写入，原有内容全丢
如果项目本身已有私有仓库配置，别用命令覆盖，改用文本编辑器手动合并："repositories": {"packagist.org": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}
composer.lock 里硬编码了原始 dist URL（比如 github.com），即使镜像配对了，install 仍可能回源下载；这时得 composer update --lock 刷新 lock 文件
CI 脚本里建议显式加 --no-interaction 和 --prefer-dist，避免因交互或源选择逻辑导致非预期行为