Composer本质是PHP脚本,需下载composer.phar后设可执行权限、加入PATH、配置国内镜像(如阿里云)、并确保PHP≥7.2.5且启用openssl/zip/zlib/mbstring扩展。

Composer 不需要“下载安装包”再双击安装——它本质是一个 PHP 脚本,直接通过命令行安装到系统路径即可;手动下载 composer.phar 后不设可执行权限、不加全局 alias、不配国内镜像,90% 的人会在第一次 composer install 时卡住或报错。
用 curl 或 php 命令直接安装 composer.phar
官方推荐方式是运行一条命令把 composer.phar 下载到本地,而不是去 GitHub 手动点下载。Windows 用户若没装 curl,改用 php 命令也一样可靠:
-
curl -sS https://getcomposer.org/installer | php(Linux/macOS) -
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"然后php composer-setup.php(Windows 兼容性更强)
执行完你会得到一个 composer.phar 文件——它不是“安装完成”,只是拿到了可执行脚本。下一步必须把它放到系统能识别的位置,否则每次都要写 php composer.phar install。
让 composer 命令全局可用的两种方式
你希望在任意目录敲 composer --version 都能响应,就得把 composer.phar 放进环境变量路径,或创建 shell alias:
- Linux/macOS:运行
sudo mv composer.phar /usr/local/bin/composer,然后chmod +x /usr/local/bin/composer - Windows:把
composer.phar移到C:\ProgramData\ComposerSetup\bin\这类已加入PATH的目录,或用doskey设置别名(不推荐) - 验证是否生效:
composer --version应输出版本号,而不是 “command not found”
跳过这步就等于没装完——很多教程只教到生成 composer.phar 就结束,导致用户后续所有命令都得带 php 前缀,极易出错。
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
必须立刻配置国内镜像,否则 composer install 极大概率超时失败
默认源 packagist.org 在国内直连极不稳定,composer install 卡在 “Loading composer repositories with package information” 是最常见现象。镜像不是可选项,是必选项:
- 全局启用阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 临时切换(仅当前项目):
composer config repo.packagist composer https://packagist.phpcomposer.com(注意该镜像已停用,别用) - 验证是否生效:
composer config -g repo.packagist应返回镜像 URL,而非原始地址
有些用户装完发现 composer create-project laravel/laravel 卡死十分钟,重启重装十次,其实就差这一条配置命令。
PHP 版本和扩展要求常被忽略,导致 composer 报错退出
composer 自身对 PHP 有硬性依赖,不是“只要装了 PHP 就能跑”。常见报错如 Your requirements could not be resolved 或直接提示 ext-zip not loaded,往往不是项目问题,而是环境没达标:
- 最低 PHP 版本:Composer 2.x 要求 PHP >= 7.2.5;Laravel 10+ 项目则需 PHP >= 8.1
- 必须启用的扩展:
openssl(HTTPS 请求)、zlib(解压包)、zip(解包依赖)、mbstring(多字节字符串处理) - 检查方式:
php -m | grep -E 'openssl|zip|zlib|mbstring';缺失则需修改php.ini并重启 Web 服务或 CLI
特别是 WAMP/XAMPP 用户,GUI 界面里看到的 PHP 版本 ≠ CLI 使用的版本,php -v 和 php --ini 必须亲自敲一遍确认。

















