三步即可在全新PHP环境跑起Composer项目:装PHP(建议8.1+并启用curl/openssl)、装Composer(macOS/Linux用curl安装,Windows用Setup.exe)、建项目(composer init初始化,可选composer require添加依赖)。

直接在全新PHP环境中装好Composer,再创建一个基础项目,其实三步就能跑起来:装PHP、装Composer、建项目。关键是确认PHP版本够新(建议8.1+),路径配置别出错,后面就顺了。
确认PHP已安装并可用
Composer依赖PHP运行,先检查PHP是否就绪:
- 终端输入 php -v,看到版本号(如 PHP 8.2.12)说明已安装
- 如果提示“command not found”,需先安装PHP(macOS用Homebrew:brew install php;Windows推荐官方VC版本,记得勾选“Add PHP to PATH”)
- 顺手验证扩展:运行 php -m | grep curl 和 php -m | grep openssl,确保 curl 和 openssl 已启用(Composer下载包和验证签名必需)
下载并全局安装Composer
不用下载.phar手动运行,推荐安装为系统命令:
-
macOS / Linux:执行
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer - Windows:下载 Composer-Setup.exe,双击安装,勾选“Add to PATH”,一路下一步
- 安装后运行 composer --version,看到类似 Composer version 2.7.7 即成功
初始化第一个Composer项目
新建目录,用 composer init 交互式创建 composer.json:
立即学习“PHP免费学习笔记(深入)”;
- 终端执行:
mkdir my-first-app && cd my-first-app
composer init - 按提示填:项目名(如 my-first-app)、描述、作者、最低PHP版本(建议 ^8.1)、是否为私有包(选 no)
- 最后问“Would you like to define your dependencies?” → 输入 no(先空项目,后面再加包)
- 生成的 composer.json 至少包含 name、type、license 和 require(为空对象)
(可选)添加一个依赖并验证运行
试试加个常用工具包,比如 monolog/monolog 日志库:
- 执行:composer require monolog/monolog
- Composer自动写入 composer.json 的 require 并下载到 vendor/ 目录
- 新建 index.php 测试自动加载:
require __DIR__ . '/vendor/autoload.php';
$log = new Monolog\Logger('test');
$log->pushHandler(new Monolog\Handler\StreamHandler(__DIR__ . '/app.log'));
$log->info('Hello from Composer!');
运行 php index.php,不出错且生成 app.log 就说明一切通了
基本上就这些。不复杂但容易忽略的是PHP扩展和PATH配置——其他步骤基本敲命令就行。











