Composer 快速安装指南:Linux 下完成下载、安装与全局配置

阿麦
阿麦
发布时间:2026-08-25| 36人浏览过
原创

前言

Composer 是 PHP 项目里最常见的依赖管理工具,但第一次安装时,很多人会卡在脚本下载、安装产物和全局命令这几步。本文按 Linux 环境顺着走一遍,并用版本检查来判断每一步是否已经正确完成。

Composer 是 PHP 生态里最常用的依赖管理工具,安装过程并不复杂,但初次操作时,常见疑问往往集中在下载地址、安装产物和全局命令如何生效。下面按 Linux 环境把流程拆开说明,你可以据此快速完成安装,并用版本命令确认是否已经可用。

先确认 Composer 的运行条件

Composer 需要 PHP 5.3.2+ 以上版本,并且是跨平台工具,可用于 Windows、Linux、macOS 等系统。

本文以 Linux 为例说明安装过程。Windows 下安装通常更直接,如需对应平台的完整说明,可查阅官方文档中的 Installation - Linux / Unix / macOS。

下载安装脚本并完成安装

第一步是下载 Composer 安装文件。可以直接执行下面的命令:

用纸张便签梳理 Composer 在 Linux 下的安装顺序,突出下载安装脚本、生成文件和版本校验。
Composer 安装流程速览把下载、安装和初次验证放在一张暖色专栏图里,适合快速理解命令执行顺序。
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

如果因为网络原因下载较慢,或者命令执行后没有成功拿到安装文件,也可以使用这个地址:

php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"

下载完成后,当前目录下会得到一个 composer-setup.php 文件。接下来执行安装:

php composer-setup.php

安装成功后,当前目录会生成 composer.phar。这就是 Composer 的可执行归档文件。生成完成后,composer-setup.php 这个安装脚本通常就可以删除了。

为了确认安装结果,可以先直接查看版本:

php ./composer.phar --version

如果命令能正常输出版本信息,说明 Composer 已经安装成功,只是此时仍需要通过 php ./composer.phar 的方式调用。

加入环境变量,改成全局可用

如果希望在任意目录下直接运行 composer,就需要把它放到系统环境变量 PATH 包含的路径中。常见做法是移动到 /usr/local/bin:

展示 Composer 从本地文件调用切换到全局命令调用的关系图,突出 PATH 目录与版本验证。
从本地调用到全局生效这张图专门解释为什么移动到 /usr/local/bin 后,就能在任意目录直接使用。
mv composer.phar /usr/local/bin/composer

完成这一步后,就可以直接在命令行中使用 composer 命令,而不必再写完整的 php ./composer.phar。

最后再执行一次版本检查:

composer -V

如果这里能够正常显示版本号,就说明 Composer 已经完成全局安装,后续无论是在项目目录里安装依赖,还是查看包信息,都可以直接调用。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。