Composer装依赖核心是三步:确认环境(PHP≥7.4、扩展启用、Composer可用)、声明需求(init/require/install)、执行安装(自动加载+PSR-4配置);关键在装得准、用得稳。

PHP平台用Composer装依赖,核心是三步:确认环境、声明需求、执行安装。重点不是“能不能装”,而是“装得准不准、用得稳不稳”。
确保PHP和Composer都已就绪
先在终端运行:
- php -v —— 确认PHP版本 ≥ 7.4(推荐8.1+),且openssl、json、mbstring等扩展已启用
-
composer --version —— 若提示 command not found,需先安装Composer(Windows用Setup.exe;macOS/Linux用官方install脚本或
curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer) - 国内用户建议立即配置阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,避免下载超时
在项目里声明你要的依赖
进入你的PHP项目根目录(如/var/www/my-site),然后选择一种方式声明依赖:
- 用交互式命令生成基础配置:
composer init,按提示填项目名、描述、最低PHP版本等,最后选n跳过初始依赖 - 直接安装并自动写入配置:
composer require guzzlehttp/guzzle:7.9.2(精确版本)、composer require monolog/monolog:^3.0(兼容范围)、composer require --dev phpunit/phpunit:^10.5(仅开发环境) - 手动编辑
composer.json后批量安装:composer install(只按lock文件还原,适合部署)
让类能自动加载使用
安装完成后,vendor目录和vendor/autoload.php就生成好了。在你的入口文件(如index.php或public/index.php)顶部加上:
立即学习“PHP免费学习笔记(深入)”;
require_once __DIR__ . '/../vendor/autoload.php';
之后就能直接使用new GuzzleHttpClient()或new MonologLogger('app'),无需include或require任何类文件。
如需加载自己写的类(比如src/Helper/Utils.php),在composer.json中加一段:
"autoload": { "psr-4": { "App\": "src/" } },再运行composer dump-autoload -o即可生效。
常见问题快速应对
-
装了却报“Class not found”:检查是否漏掉
require vendor/autoload.php;或运行composer dump-autoload重建映射 -
想换旧版本但装不上:先
composer remove vendor/package-name,再composer require vendor/package-name:1.2.3 -
团队协作时依赖不一致:提交
composer.lock到Git;生产环境统一用composer install而非require或update -
内存不足报错:临时加大限制:
COMPOSER_MEMORY_LIMIT=-1 composer require ...



















