Composer:依赖管理与自动加载
composer.json 的结构、require 与 require-dev 的区别、版本约束符号、lock 文件为什么必须提交、国内镜像配置。
Composer 是 PHP 的事实标准依赖管理工具。它解决两个问题:装第三方库,以及按 PSR-4 规则自动加载类。
初始化
composer init --name=app/demo --type=project
composer require monolog/monolog
composer require --dev phpunit/phpunitrequire 是生产依赖,require-dev 只在开发时需要(测试、调试工具)。部署时用 composer install --no-dev 跳过开发依赖,能省不少体积。
版本约束
- ^1.2:允许 1.2 到 2.0 之前的版本(不改变主版本)。
- ~1.2.3:只允许 1.2.x 的补丁更新。
- 1.2.*:1.2 下的任意补丁。
- dev-main:直接跟分支,生产环境别用。
composer.lock 记录当前实际安装的精确版本,必须提交到仓库。这样所有环境和线上装的是同一套版本,不会出现「本地好的线上报错」。
自动加载配置
{
"autoload": {
"psr-4": { "App\\": "src/" },
"files": ["src/helpers.php"]
}
}psr-4 按命名空间映射目录。files 用于加载函数库(函数没法自动加载)。改完配置执行 composer dump-autoload 重新生成映射。
生产环境可以加 -o 生成 classmap,加载更快:composer dump-autoload -o。
国内网络
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/换镜像只影响下载地址,不影响包内容。如果公司有私有仓库,用 repositories 配置。
安全提醒:composer install 会执行插件的脚本。装来源不明的包之前,先看它的 composer.json 里有没有 scripts,必要时用 --no-scripts。