PHP怎样使用Composer_PHP依赖管理工具【Composer】-php教程-PHP中文网

composer需单独安装并配置path，执行composer --version确认；无composer.json无法规范管理依赖；vendor不可手动拷贝或删除，否则导致环境不一致。

php怎样使用composer_php依赖管理工具【composer】

composer 不是 PHP 自带的命令，必须单独安装并配置好环境变量才能用；没 composer.json 就不能管理依赖，硬拷 vendor 或手动删包只会让项目在不同机器上行为不一致。

执行 composer --version，看到类似 Composer version 2.7.7 才算到位。如果报 command not found，不是没装，而是 shell 没读到 PATH：

Linux/macOS：检查 which composer 是否有输出；没有就说明 composer.phar 没放进 /usr/local/bin/，或 shell 配置（如 ~/.zshrc）没重载，试 source ~/.zshrc
Windows：用官方 Composer-Setup.exe 安装后必须重启终端；若用 php composer.phar 方式，得始终写全路径或加 php 前缀
常见连带问题：php -m | grep openssl 看是否启用了 openssl 扩展，缺它会导致下载包时卡在 file could not be downloaded

新手容易被 composer init 的交互式流程“带偏”——它会生成基础结构，但默认不配 autoload，也不设 type，更不会帮你填对命名空间路径。实际开发中，直接手写更稳：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

最小可用 composer.json 至少含 "name"（格式必须是 vendor/name，否则别人 require 你的包会失败）和 "require"
要自动加载自己写的类？立刻加上："autoload": {"psr-4": {"App\": "src/"}}；只有一两个工具函数？用 "files": ["helpers.php"]
别在已有 vendor 的目录下反复跑 composer init，它会覆盖原 composer.json；想重来？先 rm -rf composer.json vendor composer.lock

两者根本目的不同：install 是还原，update 是求解新版本。线上服务器、CI 构建、协作开发，一律用 install；本地开发调版本、加新功能才用 update：

composer install 只看 composer.lock，哪怕 composer.json 里写的是 "monolog/monolog": "^3.0"，只要 lock 文件锁死在 3.5.2，就一定装那个版本——这是环境一致性的唯一保障
composer update monolog/monolog 会重新走一遍依赖解析，可能把 monolog 升到 3.6.0，同时顺带更新它依赖的 psr/log；而 composer update（无参数）会扫所有包，风险更高
composer.lock 必须提交进 Git；vendor/ 绝对不能提交；团队里有人改了 composer.json 后只 commit 没 run install，其他人拉代码后直接 install 就能对齐

这两类错误背后其实是同一个逻辑：Composer 默认只查 packagist.org，且严格按语义化版本做约束求解。拼错名、镜像失效、版本冲突，都会卡在这一步：

Could not find package xxx：先 composer search xxx 确认包名是否准确（比如 guzzlehttp/guzzle 不是 guzzle/guzzle）；国内用户务必配阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Conclusion: don't install xxx v2.0：说明你已有的某个依赖（比如 symfony/console）要求 psr/log ^1.0，但你想装的包只兼容 psr/log ^3.0；此时别硬 update，先 composer why psr/log 查谁在拦路，再决定是降级目标包，还是升级拦路包
临时加一个工具类（比如 CSV 解析），不必走完整 init 流程，直接 composer require league/csv，它会自动创建 composer.json 并写入依赖