针对个人博客及小型站点的Composer镜像源配置-composer-PHP中文网

大概率是没配镜像源，composer 直连欧洲 packagist.org 导致解析慢或失败；应配置阿里云镜像（项目级）并删除 vendor/ 和 composer.lock 后重装。

针对个人博客及小型站点的composer镜像源配置

为什么本地开发时 `composer install` 总卡在 “Resolving packages…”

大概率是没配镜像源，Composer 正在连欧洲的 packagist.org，国内直连平均速度仅 0.7 MB/s，超时重试频繁，甚至触发 DNS 污染导致解析失败。个人博客类项目依赖通常不多（比如 monolog/monolog、symfony/console），但没镜像的话，首次 composer install 可能卡 5 分钟以上。

解决方式不是“试试看”，而是直接锁定一个高同步频率的源：

阿里云镜像（推荐）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（项目级，写入当前目录 composer.json 的 repositories 字段）
不建议用 composer config -g 全局设——你本地测试 Laravel，同事用 ThinkPHP，镜像行为可能不一致；项目级配置随代码一起提交，协作更稳
如果项目已存在 vendor/ 且换过镜像，运行前先删掉 vendor/ 和 composer.lock，再 composer install，否则 Composer 仍按 lock 文件里旧源地址去拉取

遇到 `Could not fetch https://packagist.org/packages.json` 错误怎么办

这个错误说明 Composer 仍在尝试访问官方源，常见于两种情况：一是镜像配置写错位置（比如误写成 repo.packagist.org 而非 repo.packagist），二是用了老旧版本 Composer（

快速验证和修复步骤：

运行 composer config --list | grep repo，确认输出中包含 repos.packagist.type: composer 和对应 URL
检查是否误加了尾部斜杠，比如 https://mirrors.aliyun.com/composer// —— 多余斜杠会导致 404
升级 Composer：composer self-update，2.x 版本对国内镜像兼容性更好，且默认启用并行下载
临时绕过镜像调试：加 -vvv 参数跑一次 composer update -vvv，看日志里实际请求的是哪个域名

博客主题或插件依赖私有包时，镜像源还起作用吗

不起作用。Composer 镜像只代理 Packagist 官方索引（即公开包元数据），不代理私有 Git 仓库、Satis 服务或 GitHub private repo。如果你的博客主题用了自建的 my-company/blog-theme 包，它不会走阿里云镜像。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

此时要单独配置私有源，且必须放在镜像配置之后（否则会被覆盖）：

在 composer.json 中添加：

"repositories": [
  { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" },
  { "type": "vcs", "url": "https://github.com/yourname/my-theme" }
]

vcs 类型必须显式声明，不能省略；URL 必须是可克隆的 Git 地址，不能是 GitHub 页面链接
私有 Git 仓库若需认证，得提前配好 SSH key 或用 composer config http-basic.github.com，镜像配置对此无影响

用宝塔面板部署博客时，`composer install` 权限被拒或超时

宝塔默认以 www 用户执行命令，而 composer install 生成的 vendor/ 文件属主可能是 root 或部署用户，导致 PHP 运行时报 “failed to open stream”。

别在宝塔终端里直接敲 composer install，改用以下组合操作：

上传代码前，在本地完成 composer install --no-dev --optimize-autoloader，把 vendor/ 打包上传，跳过服务器端安装
必须服务器安装时：先 chown -R www:www /www/wwwroot/your-blog，再切换用户执行：sudo -u www composer install --no-dev
宝塔计划任务里跑 composer update 极易失败——它默认用 root 环境，但没加载用户级 Composer 配置；应改用 shell 脚本封装，并显式指定 --working-dir 和 --no-interaction