17370845950

Composer 是独立 PHP 脚本工具，需手动下载 composer.phar 并设为全局命令；包管理器安装易致版本滞后或缺失；Windows 下须确保 PHP 在 PATH 且启用 openssl、zlib、json、mbstring 扩展；安装后应验证仓库地址并配置有效镜像。

Composer 不是 PHP 自带的，也不能用 php -m 查看或用 pecl install 安装——它是个独立的 PHP 脚本工具，必须单独下载并设为全局可用。

直接下载 composer.phar 并设为系统命令

最稳妥的方式是跳过包管理器，手动获取官方发布的 PHAR 文件：

• 执行 curl -sS https://getcomposer.org/installer | php 下载 composer.phar 到当前目录
• 把它移到系统路径下：例如 sudo mv composer.phar /usr/local/bin/composer
• 验证：运行 composer --version，应输出类似 Composer version 2.7.7
• 注意 Windows 用户请改用 PowerShell 或 CMD 运行 php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，再校验 hash（官网有提供），最后重命名为 composer.phar 并配合 php composer.phar 使用

Linux/macOS 下用包管理器安装的隐患

虽然 apt install composer（Ubuntu/Debian）或 brew install composer（macOS）看起来方便，但实际问题不少：

• Ubuntu 官方源里的版本通常严重滞后（比如仍是 Composer 1.x），而 PHP 8.2+ 项目普遍需要 Composer 2.5+
• Homebrew 的 composer 默认不带 --snapshot 或自动更新机制，升级得手动 brew upgrade composer
• 某些发行版（如 CentOS Stream）甚至不提供 composer 包，yum search composer 返回空
• 一旦用包管理器装了，后续手动替换 /usr/bin/composer 可能被系统更新覆盖

Windows 上 PATH 和 PHP 环境的硬性依赖

在 Windows 上，composer 命令能跑起来的前提不是“装了 Composer”，而是“能调到 PHP 解释器”：

• 确保 php.exe 所在目录已加入系统 PATH（例如 C:\php），否则运行 composer 会报错：'php' is not recognized as an internal or external command
• Composer 要求 PHP 启用 openssl、zlib、json、mbstring 这几个扩展，缺一不可；检查用 php -m | findstr "openssl zlib json mbstring"
• 不要双击 composer.phar 图形界面打开——它必须在命令行中执行，且需带参数，比如 php composer.phar install

验证安装后立即做的一件事

装完别急着 composer create-project，先确认默认仓库是否可用：

composer config -g repo.packagist.org.url https://packagist.org

国内用户如果遇到超时或慢，可临时切镜像：

composer config -g repo.packagist.org.url https://packagist.phpcomposer.com

但注意：该镜像已于 2025 年停更，现在推荐用阿里云或腾讯云镜像，例如：

composer config -g repo.packagist.org.url https://mirrors.aliyun.com/composer/

镜像配置错误会导致 composer require 卡在 “Loading composer repositories”，却没有任何报错提示——这是最常被忽略的静默失败点。