composer如何安装一个本地路径的包

在使用 Composer 安装本地路径的包时，可以通过配置 path 类型的仓库来实现。这种方式适合开发中的私有包或尚未发布到 Packagist 的本地组件。

1. 配置本地路径仓库

在项目的 composer.json 文件中添加一个类型为 path 的仓库，指向本地包所在的目录：

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

其中：

• ../my-local-package/ 是本地包的相对或绝对路径。
• my-vendor/my-local-package 必须与本地包的 name 字段一致（即其 composer.json 中定义的包名）。

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

被引用的本地包必须包含一个有效的 composer.json 文件，例如：

建站之星网站建设系统是一种全新的互联网应用模式，它一改过去传统的企业建站方式，不需企业编写任何程序或网页，无需学习任何相关语言，也不需第三方代写或管理网站，只需应用系统所提供的各种强大丰富的功能模块，即可轻松生成企业个性化的精美网站。 SiteStar v2.3本地软件体验包说明：为方便客户能够第一时间体验智能建站软件的强大功能，我们特别提供了本地软件体验包，您只需下载下来并安装在您的计算机上（和

{
    "name": "my-vendor/my-local-package",
    "version": "1.0.0",
    "autoload": {
        "psr-4": {
            "MyVendor\MyLocalPackage\": "src/"
        }
    }
}

3. 安装包

运行以下命令安装包：

composer require my-vendor/my-local-package

Composer 会从指定的本地路径软链接（symlink）或复制文件到 vendor 目录。

注意：如果系统支持符号链接，Composer 默认会创建 symlink；否则会复制文件。可通过以下方式强制使用 symlink：

<pre class="brush:php;toolbar:false;">"repositories": [
    {
        "type": "path",
        "url": "../my-local-package/",
        "options": {
            "symlink": true
        }
    }
]

4. 开发调试建议

• 使用相对路径便于团队协作。
• 确保本地包路径在所有开发环境中都有效。
• 开发完成后，可将包发布到私有仓库或 Packagist，并移除 path 配置。