diff --git a/_posts/编程/PHP/composer.md b/_posts/编程/PHP/composer.md new file mode 100644 index 0000000..323ec0a --- /dev/null +++ b/_posts/编程/PHP/composer.md @@ -0,0 +1,88 @@ +--- +title: ✍PHP的composer相关用法说明 +date: 2023-10-06 +tags: PHP +--- + +本篇文章记录php的composer组件包一些用法! + +## 引用本地未发布的包 +要引用本地未发布的包,只需要在composer.json中`repositories`仓库为为本地项目地址即可,如下所示: +```json +{ + "repositories": [ + { + "type": "path", + "url": "/path/to/local/package" + } + ], + "require": { + "your-package": "dev-master" + } +} +``` + +然后执行`composer install` 或 `composer require ` + +## 排除特定文件或目录不被自动加载 + +在composer.json中配置`exclude-from-classmap`即可,如下所示: +```json +{ + "autoload": { + "psr-4": { + "App\\": "src/" + }, + "exclude-from-classmap": [ + "src/Helper/Deprecated.php", + "src/UnusedDirectory/" + ] + } +} +``` + + +## composer 版本号约定规则 + +Composer中,版本号遵循语义化版本(Semantic Versioning)的约定规则。语义化版本由三个数字组成:MAJOR.MINOR.PATCH。以下是每个部分的含义: + +1. MAJOR:主要版本号。当您进行不兼容的API更改时,应该增加主要版本号。这表示可能会引入破坏性更改,可能需要重新编写依赖于该软件包的代码。 +2. MINOR:次要版本号。当您添加向后兼容的功能时,应该增加次要版本号。这表示没有破坏性更改,只是增加了新功能。 +3. PATCH:补丁版本号。当您进行向后兼容的错误修复或其他维护性更改时,应该增加补丁版本号。这表示没有破坏性更改或新功能,只是修复了一些错误。 + + +此外,版本号还可以包含预发布标识符和构建元数据。预发布标识符用于标识非稳定版本,例如`alpha`、`beta`、`rc`等。构建元数据用于标识特定构建的额外信息。 + +**以下是一些版本号示例:** + +1. 1.0.0:稳定的版本1.0.0。 +2. 2.1.3:稳定的版本2.1.3。 +3. 3.0.0-alpha3:预发布版本3.0.0的第3个alpha版本。 +4. 1.2.0-beta2+20130313144700:预发布版本1.2.0的第2个beta版本,并带有构建元数据。 +5. ^1.0:允许任何1.x版本,但不包括2.0及更高版本。 +6. ~1.2.3:允许任何1.2.x版本,但不包括1.3及更高版本。 +7. \>=1.0,<2.0:允许1.x版本,但不包括2.0及更高版本。 +8. 6.1|7.1 允许6.1或7.1 版本 +9. 1.1.* 1.1.X 所有版本 + + +## composer 新增自定义脚本 + +在composer.json中配置`scripts`即可,如下所示: + +```json +{ + "scripts": { + "scripts-name": "echo 'This is a post-installation script.'" + } +} +``` +`scripts-name` 是脚本命令名称,执行命令如:`composer post-install-cmd` 即执行`echo 'This is a post-installation script.'`shell命令。 + +除了自定义脚本命令之外,composer包含`post-install-cmd` 和 `pre-update-cmd` 等相关内置命令。 + +1. `post-install-cmd` 用于在安装依赖后执行自定义操作。当运行composer install命令时,Composer会在安装依赖包之后自动运行post-install-cmd脚本。 +2. `pre-update-cmd` 用于在更新依赖包之前执行自定义操作。当运行composer update命令时,Composer会在更新依赖包之前自动运行pre-update-cmd脚本。 + + +更多的composer 一些使用说明,请移步[composer中文文档](https://docs.phpcomposer.com/)。 \ No newline at end of file