Linux Composer安装步骤全解析

Linux 上安装 Composer 的标准流程

一 准备环境

• 确认已安装 PHP CLI，建议版本 ≥ 7.2（Composer 2 要求），并可用命令行调用：php -v。
• 安装常用依赖与网络工具：
  • Debian/Ubuntu：sudo apt update & & sudo apt install -y php-cli php-curl php-mbstring php-zip unzip curl
  • CentOS/RHEL/Fedora：sudo dnf/yum install -y php-cli php-curl php-mbstring php-zip unzip curl
• 说明：Composer 是 PHP 依赖管理工具，需要 PHP 才能运行；缺少组件会在安装或安装依赖时失败。

二 安装方式

• 方式一 官方脚本并校验完整性（推荐）
  1. 下载安装器并校验 SHA-384（示例为当前常见值，实际以官网页面为准）：
     curl -sS https://getcomposer.org/installer -o composer-setup.php
     HASH=“$(curl -sS https://composer.github.io/installer.sig)”
     php -r “if (hash_file(‘SHA384’, ‘composer-setup.php’) === ‘$HASH’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘composer-setup.php’); } echo PHP_EOL; ”
  2. 安装为全局命令（/usr/local/bin 通常在 PATH 中）：
     sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
  3. 清理：rm -f composer-setup.php
• 方式二 快速管道安装（省略校验，适合可信网络）
  curl -sS https://getcomposer.org/installer | php
  sudo mv composer.phar /usr/local/bin/composer
  sudo chmod +x /usr/local/bin/composer
• 方式三 直接下载 PHAR 并赋权（备选）
  wget https://dl.laravel-china.org/composer.phar -O /usr/local/bin/composer
  chmod a+x /usr/local/bin/composer
• 验证：composer --version 应输出版本号（如：Composer version 2.x.x）。

三 国内镜像加速

• 全局配置（推荐）：
  composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 仅当前项目：
  composer config repo.packagist composer https://mirrors.aliyun.com/composer/
• 取消镜像：
  composer config -g --unset repos.packagist
• 说明：镜像可显著提升在中国大陆的包下载速度，遇到镜像异常可随时恢复默认源。

四 常用管理与多 PHP 版本

• 更新 Composer：composer self-update（或 composer self-update --2 指定大版本）
• 指定 PHP 版本运行（多版本共存场景）：
  • 创建别名脚本 /usr/local/bin/composer82：
    #!/bin/bash
    /data/php82/bin/php /usr/local/bin/composer “$@”
    chmod +x /usr/local/bin/composer82
  • 之后可用 composer82 调用对应 PHP 的 Composer。

五 常见问题与排查

• 报错 “/usr/bin/env: php: No such file or directory”：未找到 php 可执行文件，建立软链或确保 php 在 PATH，例如：sudo ln -s /usr/local/php/bin/php /usr/local/bin/php
• 安装依赖时被系统杀死（Killed）：内存不足，临时增加 swap 后再安装
• 提示缺少扩展（如 fileinfo）：安装对应 PHP 扩展后重试（如 Debian/Ubuntu：sudo apt install php-fileinfo；CentOS：sudo dnf/yum install php-fileinfo）
• 证书或下载失败：
  • 证书问题可临时使用 wget --no-check-certificate（不推荐长期使用）
  • Failed to open stream: HTTP request failed! 时，检查 php.ini 的 allow_url_fopen 与 user_agent 配置
• “zlib stream 解码失败”或 “语法错误（newline）”：安装脚本权限不足或下载文件损坏，执行 chmod a+x composer-setup.php 并重新下载。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！