Composer怎么安装并管理PHP依赖包【说明】-php教程-PHP中文网

composer安装失败主因是环境依赖缺失，如php版本低于7.4、缺少curl/wget；依赖冲突需用composer prohibits排查；install还原lock文件，update重解析依赖；私有包须配置repositories、认证及稳定性标记。

composer怎么安装并管理php依赖包【说明】

Windows 上双击 Composer-Setup.exe 卡住，或 macOS/Linux 执行安装脚本后提示 curl: command not found，基本是环境缺依赖。不是 Composer 本身有问题，而是它依赖系统级工具链。

确保已安装 PHP（运行 php -v 能输出版本号，且版本 ≥ 7.4）
Linux/macOS 必须有 curl 或 wget；macOS 若用 Homebrew 安装过 PHP，通常自带 curl，但可能没加到 $PATH
Windows 用户如果用 XAMPP/MAMP，要确认控制台启动的是系统 PATH 下的 PHP，而不是套件自带的、未暴露在命令行中的那个
跳过图形安装器，直接用命令行安装更可控：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，再校验哈希（官网会提供最新 SHA384），最后 php composer-setup.php --install-dir=/usr/local/bin --filename=composer

最常遇到的是 Your requirements could not be resolved —— 这不是网络问题，是依赖冲突。Composer 不是“下载工具”，它是带约束求解器的依赖管理器，会严格检查 PHP 版本、扩展、其他已装包的版本范围。

先看错误里提到的冲突包名，比如 guzzlehttp/guzzle，再运行 composer show guzzlehttp/guzzle 查当前是否已装、装了哪个版本
检查 composer.json 里的 "require" 段有没有写死不兼容的版本，例如 "php": "^8.0" 但本地是 PHP 7.4
临时放宽约束可加 --with-all-dependencies，但别长期这么用；更稳妥的是用 composer prohibits guzzlehttp/guzzle:7.5 查谁在阻止升级
有些包（如 laravel/framework）强制要求特定 ext-* 扩展，报错里若出现 The requested PHP extension ext-intl * is missing，就得去 php.ini 开对应扩展

项目协作中混用这两个命令是线上事故高发点。composer install 读 composer.lock 精确还原依赖树；composer update 忽略 lock 文件，按 composer.json 重新解析并升级到满足约束的最新版。

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

下载

CI/CD 流水线、生产部署必须用 composer install（且确保 composer.lock 已提交 Git）
本地开发想试新版本功能，才用 composer update vendor/package-name 精准更新单个包；全量 update 容易引入 BC Break
如果删了 vendor 又没 composer.lock，install 会退化成 update 行为 —— 所以永远别把 composer.lock 加进 .gitignore
PHP 版本升级后，必须跑一次 composer update --lock 更新 lock 文件里的 PHP 兼容性标记，否则旧 lock 可能拒绝安装新版依赖

公司内部 SDK 或封装的组件，不能直接 require packagist.org 上的公开包，得告诉 Composer 去哪找源。不是改 repositories 就完事，认证和稳定性标记漏一个就拉不下来。

Git 仓库方式最常用：在 composer.json 里加 "repositories": [{"type": "vcs", "url": "https://gitlab.example.com/myorg/sdk"}]
如果仓库需要 token 认证，得提前执行 composer config gitlab-token.gitlab.example.com your_personal_token，否则 clone 时 401
私有包的 composer.json 里必须设 "minimum-stability": "stable" 或显式标 "version": "1.2.3"，否则 Composer 默认只认 stable 包，dev 分支或无 version 字段的会直接忽略
别用 path 类型仓库做长期方案——它绕过版本约束，本地改了代码，别人 install 时不会同步，协作时极易出错