写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 教程/ 工程化/ Composer:依赖管理与自动加载
工程化 Composer依赖管理自动加载

Composer:依赖管理与自动加载

composer.json 的结构、require 与 require-dev 的区别、版本约束符号、lock 文件为什么必须提交、国内镜像配置。

Composer 是 PHP 的事实标准依赖管理工具。它解决两个问题:装第三方库,以及按 PSR-4 规则自动加载类。

初始化

BASH
composer init --name=app/demo --type=project
composer require monolog/monolog
composer require --dev phpunit/phpunit

require 是生产依赖,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 记录当前实际安装的精确版本,必须提交到仓库。这样所有环境和线上装的是同一套版本,不会出现「本地好的线上报错」。

自动加载配置

JSON
{
  "autoload": {
    "psr-4": { "App\\": "src/" },
    "files": ["src/helpers.php"]
  }
}

psr-4 按命名空间映射目录。files 用于加载函数库(函数没法自动加载)。改完配置执行 composer dump-autoload 重新生成映射。

生产环境可以加 -o 生成 classmap,加载更快:composer dump-autoload -o。

国内网络

BASH
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

换镜像只影响下载地址,不影响包内容。如果公司有私有仓库,用 repositories 配置。

安全提醒:composer install 会执行插件的脚本。装来源不明的包之前,先看它的 composer.json 里有没有 scripts,必要时用 --no-scripts。

文中提到的函数

接着读