PHP原生项目集成Composer的核心是声明式依赖管理与自动加载,需安装Composer、初始化项目生成composer.json、用composer require安装包并引入vendor/autoload.php,再通过PSR-4配置实现自定义代码自动加载。

在PHP原生项目中集成Composer,核心是把依赖管理从“手动下载+require”变成“声明式定义+自动加载”。不需要框架,只要PHP 7.2+ 和能运行命令行,就能用。
1. 安装Composer(本地或全局)
去 composer.org/download 下载安装脚本:
Linux/macOS 执行:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e21205b207c3ff031906575712edab6f13eb0b361f2085f1f1237b7126d785e826a48dd3bf4544671d09985000178721b12') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
然后把生成的 composer.phar 放到系统PATH里(比如 /usr/local/bin/composer),或直接用 php composer.phar 调用。
Windows 用户推荐下载 Composer-Setup.exe,它会自动配置好环境变量。
2. 初始化项目并生成 composer.json
进入你的PHP项目根目录(比如 /var/www/my-site),运行:
立即学习“PHP免费学习笔记(深入)”;
composer init
它会交互式提问:项目名、描述、作者、依赖类型等。一路回车用默认值也行,关键一步是问你是否要添加依赖(如 monolog/monolog),先选 n,后续再加。
执行完会在当前目录生成 composer.json,内容类似:
{
"name": "my-site/app",
"type": "project",
"authors": [
{
"name": "You",
"email": "you@example.com"
}
],
"require": {}
}
3. 安装和使用一个包(以 monolog 为例)
运行命令安装日志库:
composer require monolog/monolog
Composer 会做三件事:
• 下载 monolog/monolog 及其依赖到 vendor/ 目录
• 更新 composer.json 的 require 字段
• 生成或更新 vendor/autoload.php
接下来,在你任意PHP文件(比如 index.php)顶部加入:
pushHandler(new StreamHandler('app.log', Logger::WARNING));
$logger->warning('Hello from Composer!');
?>
刷新页面,就会生成 app.log 文件,说明成功了。
4. 自动加载自己的代码(PSR-4)
不想把所有类都手动 require?Composer 可以帮你自动加载。假设你项目结构是:
my-site/ ├── src/ │ └── Helper.php ├── index.php └── composer.json
在 Helper.php 中写一个命名空间类:
编辑 composer.json,添加 autoload 配置:
"autoload": {
"psr-4": {
"MySite\\": "src/"
}
}
然后运行:
composer dump-autoload
现在 index.php 就可以直接用:
基本上就这些。Composer 不复杂,但容易忽略两点:一是必须 require vendor/autoload.php 才能用第三方包;二是自己写的类要配 autoload 并运行 dump-autoload 才生效。











