必须用 composer require 安装 php 扩展包，因它仅写入 composer.json、下载包到 vendor/、更新 composer.lock，不重解析依赖，安全可控；而 composer update 会触发全局依赖重算，易引发线上问题。
composer require 是安装 PHP 扩展包的唯一推荐方式，不是 composer install，也不是先改 composer.json 再 composer update——后者极大概率会连带升级其他包，引发线上行为突变。
为什么必须用 composer require？
它只做三件事：写入 composer.json、下载包到 vendor/、更新 composer.lock。不触发全局依赖重解析，不碰已锁版本，安全可控。
而 composer update（尤其不带参数时）会重新计算整个依赖图，哪怕你只想加一个日志库，也可能把 laravel/framework 从 10.42 升到 10.43——这个小版本里可能悄悄改了队列重试逻辑，线上就出问题。
执行前必须确认的 3 个前提
- 当前路径是项目根目录：运行
ls -la | grep composer.json（Linux/macOS）或dir composer.json（Windows），确保能看到composer.json和artisan（Laravel）或index.php（ThinkPHP）等标志性文件 - Composer 已全局可用：终端输入
composer --version能返回有效版本号；若报“command not found”，说明 PATH 没配好，需重装或手动加路径 - PHP 环境满足要求：执行
php -v确认 CLI 版本 ≥7.2.5，且php -m | grep -E "openssl|json|phar"不报缺模块；否则composer require会直接失败，错误信息里常含Could not parse version constraint
安装后类找不到？不是没装上，是没注册
Laravel 8 及更早版本中，composer require laravel/socialite 成功后，Socialite::redirect() 仍会报 Class 'Socialite' not found——因为 Laravel 默认不自动发现服务提供者。
必须手动操作：
- 在
config/app.php的'providers'数组里加一行：Laravel\Socialite\SocialiteServiceProvider::class - 在同文件的
'aliases'数组里加：'Socialite' => Laravel\Socialite\Facades\Socialite::class - 运行
php artisan vendor:publish --provider="Laravel\Socialite\SocialiteServiceProvider"发布配置
Laravel 9+ 默认启用 auto-discovery，但如果你在 composer.json 里写了 "dont-discover": ["*"]，那所有包都得手配——这个字段容易被忽略，一加就是全局关闭。
版本写错一个字符，就会卡死在命令行
新手常复制文档里的 composer require phpmailer/phpmailer:dev-main，结果装完发现发不了邮件，因为 dev-main 是开发分支，不稳定且无语义化版本约束。
正确做法是：
- 查包的官方文档或 Packagist 页面，找稳定版号，比如
^6.9或~6.8.0 - 安装时去掉
v前缀：写composer require phpmailer/phpmailer:6.9.1，别写:v6.9.1，否则报Could not parse version constraint - 如果本地 PHP 是 7.4，但包要求 PHP 8.1+，别急着降级包；可在项目
composer.json的"config": {"platform": {"php": "8.1.0"}}里声明目标环境，让 Composer 按上线环境解析依赖
最常被跳过的一步是：装完包没运行 composer dump-autoload，导致新类自动加载失效——尤其当你手动改过命名空间或加了自定义 psr-4 映射时，这步不能省。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
