如何在composer.json中链接本地正在开发的包（path repository）？-composer-PHP中文网

如何在composer.json中链接本地正在开发的包（path repository）？

尼克

发布： 2025-10-11 20:38:01

原创

990人浏览过

配置 path repository 可在本地开发中引用未发布包，通过在主项目 composer.json 中添加 repositories 字段指向本地包路径，如 "../my-local-package/"，并确保该包有完整 composer.json（含 name、type、autoload），使用 "*" 版本号触发优先加载；支持通配符和 "symlink": true 实现软链接以提升效率，Windows 需权限；运行 composer update 后可见 Symlinking 或 Mirrored 提示，表明成功接入，适用于多包协同调试。

如何在composer.json中链接本地正在开发的包（path repository）？

要在 composer.json 中引用本地正在开发的包，可以通过配置 path repository 实现。这种方式适合你在本地同时开发主项目和某个 Composer 包，无需发布到 Packagist 就能实时测试修改。

1. 配置 path 仓库

在你的主项目的 composer.json 文件中添加一个 repositories 字段，类型设为 path，并指定本地包的路径：

{
    "repositories": [
        {
            "type": "path",
            "url": "../my-local-package/"
        }
    ],
    "require": {
        "your-vendor/my-local-package": "*"
    }
}

登录后复制

说明：

../my-local-package/ 是相对于主项目 composer.json 的路径，确保该目录下有有效的 composer.json 文件。
使用 * 表示接受任意版本，Composer 会优先使用本地路径中的包。

2. 支持通配符和符号链接

你可以让 Composer 使用符号链接（symlink），避免复制文件，便于双向修改：

{
    "repositories": [
        {
            "type": "path",
            "url": "../packages/*",
            "options": {
                "symlink": true
            }
        }
    ],
    "require": {
        "your-vendor/package-a": "*",
        "your-vendor/package-b": "*"
    }
}

登录后复制

注意：

设置 "symlink": true 后，Composer 会尝试创建软链接而非拷贝文件，提升开发效率。
Windows 系统需确保有权限创建符号链接。
若不支持 symlink，Composer 自动回退为硬拷贝。

3. 确保本地包有正确的 composer.json

被引用的本地包必须包含完整的 composer.json，至少定义：

多个迹象表明你还是PHP菜鸟

我愿意把本文归入我的“编程糗事”系列。尽管在正规大学课程中，接触到软件工程、企业级软件架构和数据库设计，但我还是时不时地体会到下述事实带给我的“罪恶”感，当然，都是我的主观感受，并且面向Eclipse：　　你是PHP菜鸟，如果你：　　1. 不会利用如phpDoc这样的工具来恰当地注释你的代码　　2. 对优秀的集成开发环境如Zend Studio或Eclipse PDT视而不见　　3

379

查看详情

name：格式为 vendor/name
autoload：如 PSR-4 自动加载规则
type：通常是 library

{
    "name": "your-vendor/my-local-package",
    "type": "library",
    "autoload": {
        "psr-4": {
            "MyPackage\": "src/"
        }
    }
}

登录后复制