PHPComposer怎么用_依赖管理工具安装配置【指南】-php教程-PHP中文网

composer不是装完就能直接用的工具，需先确认php cli可用且版本合规（≥7.4），再将composer加入系统path，接着在项目根目录运行composer init生成合法composer.json，最后才可安全执行require、install等命令。

phpcomposer怎么用_依赖管理工具安装配置【指南】

composer 不是装完就能直接用的工具，它依赖 PHP 环境、正确路径配置和合理的项目初始化流程。没配好 PHP CLI 或跳过 composer.json 初始化，后续所有 require、install 都会失败或行为异常。

ApiPost接口调试与文档生成工具

ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键

下载

确认 PHP CLI 可用且版本合规

composer 本质是 PHP 脚本，必须由 PHP 命令行解释器驱动。很多“command not found”错误其实根源在 PHP 本身。

运行 php -v 必须输出版本号（PHP ≥ 7.4 推荐，composer v2 已不支持 PHP
Windows 用户常见问题：XAMPP/WAMP 的 php.exe 没加进系统 PATH，导致终端识别不到 php，也就无法执行 composer
macOS/Linux 用户若用 Homebrew 安装 PHP，注意 which php 返回路径是否在 PATH 中；有时新版 Homebrew 会把 php 放在 /opt/homebrew/bin/php，需确认 shell 配置已加载
缺少必要扩展也会报错，比如 json、mbstring、openssl、curl —— php -m | grep -E "json|mbstring|openssl" 可快速检查

全局安装后必须验证 `composer` 命令可调用

下载 composer.phar 只是第一步，不把它放进系统路径，就只能在当前目录用 php composer.phar，效率极低。

Linux/macOS：执行 sudo mv composer.phar /usr/local/bin/composer 后，运行 composer --version。若提示 command not found，说明 /usr/local/bin 不在 PATH 中（macOS Sonoma+ 或某些 zsh 配置下常见），需手动添加
Windows：推荐用官方 Composer-Setup.exe，它会自动检测 php.exe 并写入 PATH；若手动部署，需将 composer.phar 所在目录加入 PATH，并创建 composer.bat 文件（内容：@php "%~dp0composer.phar" %*），否则 CMD/PowerShell 无法识别 composer 命令
验证失败时别急着重装，先运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），确认路径已生效

`composer init` 是起点，不是可选步骤

没有 composer.json，composer require 会拒绝执行（v2 默认行为），也不会生成 vendor/autoload.php。

进入空项目目录后，必须先运行 composer init，按提示填完基本信息（项目名、描述、作者等），“Define your dependencies” 这步建议输 no —— 后续用 require 更可控
手动创建 composer.json 极易出错：require 字段拼错成 requires、末尾多逗号、引号不闭合，都会导致 composer install 报 “Your requirements could not be resolved”
正确做法：初始化后立即运行 composer validate，它会检查语法合法性；再用 cat composer.json | jq .（需装 jq）看结构是否合理

`composer require` 和 `composer install` 别混用场景

这两个命令解决的是完全不同的问题，误用会导致依赖不一致、CI 失败或线上环境崩溃。

composer require guzzlehttp/guzzle：开发时添加新包，自动写入 composer.json + 更新 composer.lock，这是唯一推荐的添加依赖方式
composer install：只读 composer.lock，精确还原所有包版本，必须用于生产部署和 CI 流水线；如果项目没有 lock 文件，它会退化为 update 行为，带来不确定性
composer update：主动升级依赖树，应谨慎使用；加 --dry-run 先预览变更，加 --with-dependencies 控制范围，避免意外升级间接依赖
生产环境部署必须加 --no-dev，否则 phpunit、php-cs-fixer 等开发依赖会被一起装上，增大攻击面和部署体积

国内用户不配镜像源，composer install 十有八九卡在 “Loading from cache” 或超时。全局配一次阿里云源：composer config -g repo.packagist composer @#@#@#@#@#@#@#@#@#@0，比每个项目单独配更可靠。这个操作容易被忽略，但实际影响远大于版本号写法细节。