PHP 初学者指南:Composer 依赖管理与自动加载

Backend2026-09-26TryQuickToolBox

你正在开始一个新的 PHP 项目,需要一个用于日志记录或 HTTP 请求的库。你复制粘贴了一些代码,但很快就变得混乱。如何正确管理外部库?Composer 通过为你处理依赖和自动加载来解决这个问题。在本指南中,你将学习如何从零开始使用 Composer。

什么是 Composer?

Composer 是 PHP 的依赖管理器。它允许你声明项目所依赖的库并为你管理它们。它不像 apt 或 yum 那样的包管理器;它按项目工作,将依赖安装到 vendor 目录中。

安装 Composer

首先,在终端中运行 composer --version 检查 Composer 是否已安装。如果没有,请从 getcomposer.org 下载并安装。在 Windows 上,使用 Composer-Setup.exe 安装程序。在 macOS/Linux 上,运行安装脚本。

创建 composer.json 文件

每个 Composer 项目都有一个 composer.json 文件来描述依赖。你可以手动创建或运行:

composer init

这个交互式命令会询问包名、描述、作者和依赖。现在,你可以跳过添加依赖,稍后编辑文件。

添加依赖

要添加一个库,使用 composer require。例如,添加流行的 monolog/monolog 日志库:

composer require monolog/monolog

Composer 将下载该库及其依赖到 vendor 目录,并更新 composer.json 和 composer.lock。

理解版本约束

Composer 使用语义化版本。常见约束: