如何在 composer 中使用 path 类型的仓库来开发和测试本地包？-composer-PHP中文网

如何在 composer 中使用 path 类型的仓库来开发和测试本地包？

尼克

发布： 2025-11-25 14:23:02

原创

562人浏览过

配置path仓库可实现本地PHP包开发实时测试，通过在主项目composer.json中添加type为path的仓库并指定本地路径，Composer会自动软链接或复制包到vendor目录，要求本地包具备正确命名和autoload配置的composer.json，修改代码后主项目即时生效，适合快速迭代，但仅限开发环境使用，完成开发后应切换至git等远程仓库源。

如何在 composer 中使用 path 类型的仓库来开发和测试本地包？

在开发 PHP 包时，使用 Composer 的 `path` 类型仓库可以让你直接链接本地的包目录，方便边开发边测试，无需频繁发布版本或配置私有仓库。以下是具体操作方法。

配置 path 仓库

在主项目的 composer.json 文件中添加一个类型为 path 的仓库：

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

登录后复制

其中 ../my-local-package 是你本地包的路径，可以是相对路径或绝对路径。Composer 会自动软链接（symlink）该目录到 vendor 中（支持 symlink 的系统如 Linux/macOS），Windows 下可能为复制方式。

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

你的本地包（如 my-local-package）必须包含有效的 composer.json，例如：

{
    "name": "acme/my-package",
    "version": "dev-main",
    "autoload": {
        "psr-4": {
            "Acme\MyPackage\": "src/"
        }
    }
}

登录后复制

只要命名与主项目 require 中的一致，Composer 就能正确识别并加载。