Merge branch 'main' of http://gitea.zyimm.com/zyimm/blog

_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 <your-package@dev-master>` 
+
+## 排除特定文件或目录不被自动加载
+
+在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/)。