composer.json是PHP项目依赖管理核心，定义元信息、依赖与自动加载。1、name设包唯一标识如vendor/name；2、description简述功能；3、version定版本号，遵循语义化规范；4、keywords助搜索发现；5、homepage指项目主页；6、license声明许可类型。require列必需依赖及版本约束，^支持兼容更新，~限修订版升级。
如果您正在开发PHP项目并使用Composer进行依赖管理，那么理解composer.json文件的结构和配置项是确保项目正常运行的关键。该文件定义了项目的元信息、依赖关系以及自动加载规则等核心内容。
本文运行环境：MacBook Pro，macOS Sonoma
一、包基本信息配置
composer.json中的基础字段用于描述当前包的名称、版本、描述等元数据，这些信息在发布包到Packagist时尤为重要。
1、name 字段定义了包的唯一标识，格式为 vendor/name，例如 "monolog/monolog"。
2、description 字段提供对包功能的简短说明，建议不超过一行文本。
3、version 字段指定当前包的版本号，通常遵循语义化版本规范（如 1.0.0），但若未设置则以VCS标签为准。
4、keywords 是一个字符串数组，用于帮助用户在搜索时发现该包，例如 ["log", "logging"]。
5、homepage 可选字段，指向项目主页URL。
6、license 指定许可证类型，常见值包括 MIT、Apache-2.0、GPL-2.0 等，支持数组形式声明多个许可证。
二、依赖关系管理
依赖配置决定了项目所依赖的外部库及其版本范围，Composer会根据这些规则解析并安装对应版本。
1、require 字段列出项目运行所必需的依赖包及其版本约束，例如 {"php": "^8.1", "guzzlehttp/guzzle": "^7.4"}。
2、版本约束支持多种写法：^ 表示兼容性更新（如 ^1.2.3 允许 1.2.3 到 2.0.0 之前的版本），~ 表示仅允许修订版本增加（如 ~1.2.3 等价于 >=1.2.3
3、require-dev 定义开发阶段所需的依赖，如测试框架或代码分析工具，不会随生产环境安装。
三、自动加载机制配置
autoload字段定义了如何将类文件映射到命名空间，使PHP能够正确加载自定义类而无需手动include。
1、使用 psr-4 规范配置命名空间前缀到目录的映射，例如 {"App\\": "src/"} 表示 App 命名空间下的类位于 src 目录中。
2、psr-0 是旧版PSR标准，现已不推荐使用，但仍支持传统PEAR风格的命名空间映射。
3、classmap 用于生成类映射表，适用于非PSR标准的老旧代码库，Composer会扫描指定目录下所有PHP文件并记录类名。
4、files 列出需全局包含的PHP文件，常用于函数库的加载，例如 helpers.php。
四、脚本事件绑定
scripts字段允许在Composer执行特定操作时触发自定义脚本，增强自动化能力。
1、常见的事件包括 post-install-cmd 和 post-update-cmd，可在依赖安装或更新后执行清理或生成操作。
2、脚本可以是PHP回调函数（如 "MyScript::run"）或系统命令（如 "php artisan optimize"）。
3、通过定义 pre 和 post 类事件，可控制脚本在主操作前后执行，实现完整的生命周期钩子。
五、仓库与镜像配置
repositories字段用于指定依赖包的来源，Composer默认从Packagist获取包，但可通过此字段扩展或替换源。
1、支持的类型包括 vcs（Git、SVN等版本控制系统）、composer（自建Composer服务器）和 package（直接定义单个包）。
2、私有库可通过添加VCS仓库地址让Composer识别并安装，例如指向内部Git服务器上的项目。
3、国内用户常配置阿里云或华为云的Composer镜像以提升下载速度，使用命令 composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 即可设置。
