最稳妥方式是直接运行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，必须严格满足：键名单数repo.packagist、显式传入composer作为type值、URL以/结尾且为HTTPS；否则静默回退官方源。
composer config -g repo.packagist 命令必须用对
直接运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 是最稳妥的切换方式。别手写 config.json 或编辑 /usr/local/bin/composer——那是个可执行文件，不是配置文件，改了会破坏二进制结构。
常见错误是把命令写成 composer config -g repos.packagist（多了一个 s），结果配置不生效，composer install 仍走官方源卡住。验证是否成功只需一行：composer config -g repo.packagist，输出应为 https://mirrors.aliyun.com/composer/。
- 阿里云镜像地址已稳定运行多年，同步延迟通常在 2–5 分钟内
- 如果项目依赖 dev 分支或未收录包，临时切回官方源：运行
composer config -g --unset repos.packagist - 不要用
https://packagist.phpcomposer.com（该镜像已于 2023 年停服，现在访问会 404）
非 root 用户执行 composer install 失败？先查 ~/.composer 权限
部署时常用 deploy 用户跑 composer install，但常报 Permission denied 或 Could not write to /home/deploy/.composer/cache。这不是镜像问题，是目录归属不对。
CentOS 默认不会自动创建 ~/.composer，首次运行 composer 命令时由当前用户创建，但若之前用 sudo composer 初始化过，该目录就归 root 了。解决方法只有一条：chown -R deploy:deploy /home/deploy/.composer（把 deploy 换成你实际用的用户名）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
~/.composer必须由目标用户完全拥有，组权限不能缺失 - 如果用了宝塔或 cPanel，PHP 禁用了
putenv，需在 PHP 配置里删掉这个函数，否则composer install会直接中断 - 别给
/home/deploy/.composer加 777 权限——Composer 会拒绝读写，报 “cache directory is not writable”
为什么换了镜像还是超时？检查 PHP 的 OpenSSL 和 DNS 配置
即使 composer config -g repo.packagist 显示正确，composer install 仍卡在 Downloading... 或报 Connection timed out，大概率是底层网络或 PHP 扩展问题。
Composer 依赖 PHP 的 curl 和 openssl 扩展发起 HTTPS 请求。CentOS 7 自带 OpenSSL 1.0.2k，而新版 Composer 要求 TLS 1.2+ 握手能力，旧版 OpenSSL 可能无法完成与阿里云镜像的协商。
- 运行
php -r "print_r(openssl_get_cipher_methods());"，若报错或无输出，说明openssl扩展没启用 - 用
nslookup mirrors.aliyun.com测试 DNS 是否通；某些内网服务器默认用运营商 DNS，解析慢或失败 - 临时绕过证书校验（仅调试）：
export COMPOSER_DISABLE_TLS=1，但生产环境绝不能留着
PATH 和 /usr/local/bin/composer 权限是隐形门槛
很多部署脚本里写 composer install，却提示 command not found。根本原因不是镜像没配，而是 /usr/local/bin/composer 文件权限或 PATH 不对。
CentOS 默认 PATH 包含 /usr/local/bin，但如果你用的是最小化安装或自定义 shell（比如 zsh），可能没加载系统 profile。更常见的是文件权限：手动下载的 composer.phar 移过去后忘了加执行位。
- 确认权限：
ls -l /usr/local/bin/composer输出中要有x（如-rwxr-xr-x），否则补sudo chmod +x /usr/local/bin/composer - 检查 PATH：
echo $PATH | grep '/usr/local/bin'，没输出就说明当前 shell 没包含它 - 非交互式 shell（如 systemd service、crontab）不会自动 source /etc/profile，得显式指定 PATH 或用绝对路径：
/usr/local/bin/composer install
composer install 停在同一个地方反复重试。 
