0

0

composer如何配置psr-0加载_composer旧标准兼容【详解】

穿越時空

穿越時空

发布时间:2026-02-06 15:45:34

|

811人浏览过

|

来源于php中文网

原创

PSR-0 已被废弃,Composer 2.0+ 完全移除支持;项目若需加载 PSR-0 风格类(如 Vendor_Name_ClassName → vendor_name/class_name.php),须降级至 Composer 1.x 并在 composer.json 的 autoload 段中配置 psr-0 键,例如 {"autoload": {"psr-0": {"Acme_": "src/"}}},表示 Acme_Foo_Bar 映射为 src/Acme/Foo/Bar.php(下划线转斜杠,首字母大写保留);psr-0 值必须是字符串路径,多路径需用数组(仅 Composer 1.10.1+ 支持),路径须存在且可读,否则运行时报 Class not found;PSR-0 被弃用因其设计歧义(下划线语义不明确),而 PSR-4 通过明确命名空间与目录映射解决该问题;Composer 2.x 移除全部 psr-0 代码,遇到该字段仅警告并跳过;主流框架自 2015 年起全面转向 PSR-4,旧项目迁移推荐调整目录结构与 composer.json 为 psr-4,并将类名改为命名空间形式(如 namespace Acme\Foo; class Bar),若无法修改类名可用 "files

composer如何配置psr-0加载_composer旧标准兼容【详解】

PSR-0 已被废弃,Composer 2.0+ 完全移除支持;若项目仍需加载 PSR-0 风格的类(如 Vendor_Name_ClassName 映射到 vendor_name/class_name.php),必须降级到 Composer 1.x 并手动配置 autoload —— 但这是临时兼容方案,不建议长期使用。

Composer 1.x 中如何声明 PSR-0 自动加载

composer.jsonautoload 段中显式写入 psr-0 键(注意:Composer 2.0+ 解析时会直接报错 Invalid argument supplied for foreach() 或忽略该字段):

{
    "autoload": {
        "psr-0": {
            "Acme_": "src/"
        }
    }
}

上述配置表示:所有以 Acme_ 开头的类名,按 PSR-0 规则拆解为目录路径,例如 Acme_Foo_Barsrc/Acme/Foo/Bar.php(下划线转斜杠,首字母大写保留)。

  • psr-0 值必须是字符串(路径),不能是数组(Composer 1.x 不支持多路径映射同一前缀)
  • 若需多个根路径,要写多个键:"Acme_": ["src/", "legacy/"] —— 仅 Composer 1.10.1+ 支持数组值
  • 路径必须存在且可读,否则 composer dump-autoload 不报错,但运行时抛出 Class not found

为什么 Composer 2.x 不再支持 PSR-0

PSR-0 存在歧义设计:下划线既可能表示命名空间分隔符,也可能只是类名一部分(如 My_Class_v2),导致自动加载器无法可靠推导文件路径。PSR-4 用明确的命名空间 + 目录映射消除了该问题。

Scrumball
Scrumball

AI驱动的网红营销平台

下载
  • Composer 2.0 移除了全部 psr-0 相关代码,composer install 时遇到该字段会警告并跳过
  • 即使强制用 Composer 1.x 生成 autoload,PHP 7.4+ 的 opcache 也可能因文件路径不规范导致类缓存失效
  • 主流框架(Laravel、Symfony)自 2015 年起已全面转向 PSR-4,依赖包基本不再提供 PSR-0 兼容层

旧项目迁移 PSR-4 的最小改动方式

不重写类名,只调整目录结构和 composer.json

src/
├── Acme/
│   └── Foo/
│       └── Bar.php   // 内部 class Acme_Foo_Bar {}

对应改为 PSR-4:

{
    "autoload": {
        "psr-4": {
            "Acme\\": "src/Acme/"
        }
    }
}
  • 类名需同步改为命名空间形式:class Acme_Foo_Barnamespace Acme\Foo; class Bar
  • 若无法修改类名(如闭源 SDK),可用 files 加载:"files": ["src/helpers.php"],但仅适用于函数/常量
  • composer validate 确认 JSON 格式合法,再 composer dump-autoload -o 生成优化后映射

真正棘手的是那些把下划线当命名空间又没文档的遗留包——它们往往依赖 __autoload 或自定义加载器,强行塞进 Composer 的 PSR-0 只会让问题延迟爆发。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
PHP Symfony框架
PHP Symfony框架

本专题专注于PHP主流框架Symfony的学习与应用,系统讲解路由与控制器、依赖注入、ORM数据操作、模板引擎、表单与验证、安全认证及API开发等核心内容。通过企业管理系统、内容管理平台与电商后台等实战案例,帮助学员全面掌握Symfony在企业级应用开发中的实践技能。

82

2025.09.11

laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

324

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

283

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

456

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

375

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

106

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

73

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

68

2025.08.05

Golang处理数据库错误教程合集
Golang处理数据库错误教程合集

本专题整合了Golang数据库错误处理方法、技巧、管理策略相关内容,阅读专题下面的文章了解更多详细内容。

2

2026.02.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 11.1万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号