PSR-4 是 PHP 的自动加载标准，通过命名空间前缀与目录的映射实现类文件自动加载，如 "App\": "src/" 对应 App\Controller\HomeController → src/Controller/HomeController.php，且需运行 composer dump-autoload 更新配置。
PSR-4 是 PHP 的一项自动加载标准，全称是 PHP Standard Recommendation 4，由 PHP Framework Interop Group（PHP-FIG）制定，目的是统一类文件的命名与目录结构规则，让不同项目的代码能被 Composer 等工具自动、可靠地加载，无需手动 require 或 include。
PSR-4 的核心约定
它规定了“类名如何映射到文件路径”，关键在于两部分：命名空间前缀（namespace prefix）和对应的根目录（base directory）。只要符合这个映射关系，自动加载器就能根据类名直接定位并载入对应文件。
- 类名中的命名空间分隔符
\对应文件系统中的目录分隔符（如/或\） - 类名的最末一段（即不带命名空间的部分）对应文件名，且必须以
.php结尾 - 命名空间前缀必须以
\结尾（例如App\），不能是空字符串或纯全局命名空间 - 一个前缀只能绑定一个根目录，但一个项目可以注册多个前缀+目录对
一个典型例子
假设你在 composer.json 中这样配置：
那么：
立即学习“PHP免费学习笔记（深入）”；
牛NIUCMS本地O2O系统
下载
牛NIUCMS本地O2O系统是一个以php+mysql进行开发的o2o网站系统。NIUCMS是一款强大的网站管理系统。支持智慧城市、智慧小区、智慧乡村、本地生活门户、本地O2O平台的构建。请注意以下几点：1、这套源码必须要服务器支持伪静态，是支持.htaccess规则的伪静态，一般Apache服务器支持，别搞的下载回去以后说什么缺 少文件，其实源码并非缺少文件。2、这套源码请在php 5.4环境下
-
App\Controller\HomeController→ 对应src/Controller/HomeController.php -
App\Model\User→ 对应src/Model/User.php -
App\Utils\Helper→ 对应src/Utils/Helper.php
Composer 安装后生成的自动加载器会按此规则自动找文件，你只需 new App\Controller\HomeController()，无需额外引入。
PSR-4 和 PSR-0 的主要区别
PSR-0 已废弃，PSR-4 是它的简化替代版：
- PSR-4 不再要求类名中下划线
_转为目录分隔符（PSR-0 支持Zend_Controller_Action映射到Zend/Controller/Action.php，PSR-4 不支持） - PSR-4 不强制类名与文件名完全一致（比如允许
FooBar类放在FooBar.php，但不允许用foobar.php—— 文件名仍需首字母大写，这是 PHP 社区惯例，非 PSR-4 强制） - PSR-4 更轻量，更贴近现代 PHP 命名习惯，也更容易被工具解析
实际使用注意点
虽然 PSR-4 看似简单，但常见问题有：
- 命名空间声明必须和目录结构严格匹配（大小写敏感，尤其在 Linux 环境）
- 修改
composer.json后记得运行composer dump-autoload刷新自动加载映射 - 测试类、命令行类等若不在主 autoload 配置里，可单独加
autoload-dev段落 - 第三方包大多已遵循 PSR-4，所以 composer require 后开箱即用
基本上就这些。PSR-4 不复杂，但它是现代 PHP 项目可维护、可复用的底层基础之一。
