使用Composer中文镜像进行本地包开发调试-composer-PHP中文网

composer中文镜像会跳过本地包，因为镜像仅代理远程packagist.org索引、不支持path协议，且repositories按顺序“命中即停”，若镜像先返回404则终止查找，不再尝试后续path仓库；必须将path仓库置顶并显式禁用packagist.org才能生效。

使用composer中文镜像进行本地包开发调试

为什么本地开发时 Composer 中文镜像会跳过你的本地包

因为 Composer 默认只从配置的仓库拉取远程包，path 类型的本地仓库必须显式启用 —— 即使你已配置了清华、阿里等中文镜像，composer install 仍会忽略 repositories 中的 path 条目，除非你关掉镜像或做针对性排除。

常见现象：composer install 报错 Could not find package your/local-package，但 composer show your/local-package 能查到，说明镜像代理拦截了本地仓库请求。

中文镜像（如 https://mirrors.aliyun.com/composer/）本质是远程 proxy，不支持解析本地 path 协议
repositories 的加载顺序很重要：Composer 会按列表顺序查找包，一旦在镜像中 404 就终止，不会 fallback 到后续的 path 仓库
解决核心：让本地包“绕过”镜像，直接走本地文件系统

如何让 path 仓库优先于中文镜像生效

关键不是禁用镜像，而是把本地 path 仓库声明为 packagist.org 的替代，并设为最高优先级。

在项目根目录 composer.json 的 repositories 数组开头插入：

First Principles Decomposer

把任何问题拆解为根本真理，再从原子层面重建解决方案。

下载

{
    "repositories": [
        {
            "type": "path",
            "url": "../your-local-package"
        },
        {
            "type": "composer",
            "url": "https://mirrors.aliyun.com/composer/"
        }
    ]
}

同时必须禁用 Packagist 官方源，否则 Composer 仍会先查官方源（被镜像代理）：

运行 composer config --unset repos.packagist（移除默认 packagist.org）
或在 composer.json 中显式关闭："packagist.org": false（放在 repositories 同级）
确保 your-local-package 的 name 和 version 字段与 require 中一致，例如 "your/local-package": "dev-main"

调试时频繁修改本地包，如何避免反复 dump-autoload

Composer 的自动加载器默认为 PSR-4 生成静态映射，本地包代码变动后，composer dump-autoload 不是必须的 —— 只要目录结构和命名空间没变，PHP 直接读文件即可。

确认本地包 composer.json 中 autoload 使用的是 "psr-4" 或 "classmap"，而非 "files"（后者需重新 dump）
开发中可加 "autoload-dev" 支持测试类，无需每次重装
如果用了符号链接（ln -s），确保目标路径可读，且 Web 服务器用户有权限访问
临时调试可加 --no-cache 参数： composer install --no-cache，防止镜像缓存干扰