使用Composer自动加载本地包(无需每次更改都到Packagist网站)。
有很多方法可以做到这一点,我将介绍其中的两种:
在所有情况下,我们都有两个主要方面:
- 本地包(我们不想发布到Packagist以便在我们的项目Composer中自动加载其代码)。
- 主项目(需要使用本地包代码的代码库,可以是另一个包或任何项目)。
方法1:(直接命名空间)
打开主项目的composer.json
文件,并使用任何方法(PSR-4、PSR-0等)自动加载本地包命名空间。
例如:
如果在本地包的composer.json中我们有:
"autoload": {
"psr-4": {
“Local\\Pack\\": "library"
}
},
"autoload-dev": {
"psr-4": {
"Local\\Pack\\Tests\\": "tests"
}
},
那么在主项目的composer.json文件中,我们应该有:
"autoload": {
"psr-4": {
"Mahmoudz\\Project\\": "src",
"Local\\Pack\\": "../path/to/local/pack/library” << referencing the other local package
}
},
"autoload-dev": {
"psr-4": {
"Mahmoudz\\Project\\Tests\\": "tests"
}
},
优点:
- 您不会触及供应商目录(通过错误运行composer update不会覆盖您的本地更改)
- 您不需要将您的包放在packagist上就可以使用它
- 您只需在一个地方工作(本地包),更改将自动加载到主项目中
缺点:
- 您无法在生产环境上发布composer.json文件(在发布之前需要进行编辑以要求真正的包)
方法2:(本地仓库)
从本地仓库下载本地包。
本地包:
1. 在包中初始化git(即使您不想使用它-无需提交任何内容)
2. 添加composer.json文件。 在文件中确保具有以下内容:
"name": "vendor-name/package-name",
"autoload": { … // use whichever method you prefer, but make sure it’s being loaded correctly
"minimum-stability": "dev"
composer dump-autoload
主项目:
1. 编辑您的composer.json文件,并包含以下内容:
"repositories": [
{
"type": "vcs",
"url": "/full/path/to/the/local/package/package-name"
}
],
"require": {
"vendor-name/package-name": "dev-master"
},
- composer update vendor-name/package-name
- 现在检查一下你的 vendor 目录,你应该能看到 vendor-name/package-name
注意:每当您更改本地软件包(而不是供应商)时,您需要进行 git 提交,然后才能 composer update 主项目,这将使主项目的供应商目录获得存储库的最新副本。
优点:
- 您不会触及供应商目录(由于错误运行 composer update 不会覆盖您的本地更改)
- 您无需将软件包放在 packagist 上即可使用它
缺点:
- 您必须继续提交更改(在本地软件包中),然后在主项目中运行 composer update
- 您不能在生产环境中发布 composer.json(发布之前需要编辑以要求真实软件包)
composer.json
文件有一个require: { "vendor/package": "dev-master" }
。我尝试使用require: { "vendor/package": "1.2.0" }
,但似乎Composer不够智能,无法读取我本地Git存储库中的本地标签(尚未推送到origin)。我觉得这很令人沮丧。 - cartbeforehorse