Composer仅在开发部署阶段管理依赖，纯PHP项目需手动引入vendor/autoload.php；有composer.json即可用composer install安装，require DIR . '/vendor/autoload.php'确保路径准确。
Composer 不是 PHP 的运行时依赖，它只在开发和部署阶段管理代码包；纯 PHP 项目完全可以使用 Composer，但必须手动加载 autoload，且不能依赖框架自动集成的生命周期钩子。
如何让纯 PHP 项目识别 composer.json 并安装依赖
只要项目根目录下有 composer.json，就能用 composer install 安装依赖。不需要任何框架或特殊结构，也不需要 Web 服务器支持。
- 确保已全局安装 Composer（运行
composer --version可验证） - 初始化：在项目根目录执行
composer init交互生成composer.json，或直接手写（至少包含{ "require": {} }） - 安装依赖后，Composer 会生成
vendor/autoload.php—— 这是唯一必须手动引入的文件 - 注意：如果项目已有
vendor/目录但没autoload.php，说明未成功运行过composer install或中途失败
如何在纯 PHP 脚本中正确加载 Composer 自动加载器
必须在所有依赖类使用前，显式 require vendor/autoload.php，且路径要准确。常见错误是相对路径失效、工作目录不一致导致加载失败。
- 推荐写法：
require __DIR__ . '/vendor/autoload.php';（用__DIR__锚定当前脚本所在目录） - 避免写
require 'vendor/autoload.php'—— 当前工作目录（如从命令行 cd 到别处再运行）会导致路径解析失败 - 如果项目入口不止一个（如 CLI 脚本 + Web 入口），每个入口都得单独加这行，不能“默认生效”
- 不要试图用
set_include_path()替代 require —— Composer 的 autoload 是 PSR-4/PSR-0 规范实现，不是靠 include_path 查找
为什么 require_once 之后仍报 Class not found
绝大多数情况不是 Composer 没装好，而是命名空间、类名或文件路径不符合 PSR-4 映射规则，导致 autoload 无法定位文件。
- 检查
composer.json中的autoload配置是否匹配实际目录结构，例如："autoload": { "psr-4": { "App\": "src/" } }要求AppFooBar类必须位于src/Foo/Bar.php - 修改 autoload 配置后，必须运行
composer dump-autoload（或composer install）才能更新vendor/composer/autoload_psr4.php - CLI 执行脚本时，若提示
Class 'X' not found，可用composer show --installed确认包是否真被安装；再用grep -r "class Bar" vendor/快速验证类是否存在 - 第三方包若含自定义 autoloader（如某些老库用
files数组），也要确认其是否被dump-autoload收录
能否跳过 vendor/autoload.php 直接 require 依赖文件
技术上可以，但违背 Composer 设计初衷，且极易出错——尤其是依赖存在嵌套 require、版本冲突或条件加载逻辑时。
- 例如
monolog/monolog内部有多个if (class_exists(...))分支，直接 require 单个文件会跳过这些兼容性判断 - Composer 的 autoload 机制会按依赖图顺序注册加载器，并处理循环引用、延迟加载等边界情况，手写 require 很难覆盖
- 唯一合理绕过场景：极简脚本（如单文件工具），且只用一个无依赖的函数库（如
symfony/polyfill的某个bootstrap.php），此时应明确知道你在放弃自动维护能力
真正容易被忽略的是：Composer 的 autoload 是「静态注册」行为，一旦 vendor/autoload.php 被 require，后续 new 一个类就触发对应文件加载；但如果你在 require 前已定义了同名类（比如测试时手动写了个假类），PHP 会报 Fatal error: Cannot declare class —— 这类冲突不会在 composer install 阶段暴露，只在运行时炸。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
