blog/_posts/编程/PHP/composer.md

title	date	tags
✍PHP的composer相关用法说明	2023-10-06	PHP

本篇文章记录php的composer组件包一些用法！

引用本地未发布的包

要引用本地未发布的包,只需要在composer.json中repositories仓库为为本地项目地址即可，如下所示：

{
    "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即可，如下所示：

{
    "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即可，如下所示：

{
    "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中文文档。