PSR规范由PHP-FIG制定，旨在提升项目互操作性。核心包括PSR-1基础规范、PSR-12代码风格、PSR-4自动加载等。PSR-1要求类名大驼峰、方法名小驼峰、文件UTF-8无BOM；PSR-12规定4空格缩进、控制结构换行、参数逗号后空格等格式；PSR-4通过composer.json配置命名空间与路径映射，实现类自动加载。推荐使用PHP-CS-Fixer或PHP_CodeSniffer工具确保规范执行，结合IDE插件提升效率。遵循PSR-12与PSR-4并借助工具链，是当前PHP开发最佳实践，有助于团队协作与代码维护。
PHP编码规范的最佳实践主要围绕可读性、一致性和团队协作展开。虽然“PHPPSR规范”这一说法并不准确，但通常指的是由PHP-FIG（Framework Interop Group）制定的PSR系列标准。这些标准不是强制性的语言规则，而是推荐的编码规范和接口约定，旨在提升不同PHP项目之间的互操作性。
理解PSR规范的核心作用
PSR（PHP Standard Recommendation）是由各大PHP框架和社区共同推动的一系列标准提案。它们不规定语法细节，而是聚焦于代码结构、自动加载、日志接口等通用问题。常见的PSR包括：
- PSR-1：基础编码规范 – 规定类名、方法名、文件编码等基本要求
- PSR-2：编码风格指南 – 已被PSR-12取代，曾规定缩进、花括号位置等格式
- PSR-4：自动加载标准 – 定义命名空间与文件路径的映射规则
- PSR-12：扩展的编码风格 – 当前推荐的代码格式化标准，兼容并扩展PSR-2
- PSR-3：日志接口 – 统一日志记录器的使用方式
- PSR-7：HTTP消息接口 – 提供请求和响应对象的标准定义
PSR-1 和 PSR-12 的关键实践
这两个是目前最常用于日常开发的编码规范，直接影响代码外观和结构。
PSR-1 要点：
立即学习“PHP免费学习笔记（深入）”；
- PHP代码必须使用
或=标签 - 文件必须以UTF-8无BOM格式保存
- 一个文件只做一件事：要么声明一个类、函数或常量，要么执行有副作用的逻辑（建议分离）
- 类名必须遵循大驼峰命名法（CamelCase）
- 类中的常量全部大写，用下划线分隔
- 方法名使用小驼峰命名法（camelCase）
PSR-12 风格规范重点：
- 每行代码不超过80~120字符，提高可读性
- 使用4个空格进行缩进，不使用tab
- 控制结构（if、for、while等）的左花括号另起一行
- 方法声明时，参数列表的逗号后加一个空格
- 闭包函数的
use关键字前后有空格，参数与use之间也需注意间距 - namespace声明后必须有一个空行，use语句块之后也要有一个空行
PSR-4 自动加载的实际应用
PSR-4让类文件可以被Composer自动加载，无需手动引入。配置在composer.json中即可生效。
示例：
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
这意味着：
- 命名空间
App\Controller\UserController对应文件路径src/Controller/UserController.php - 文件名必须与类名一致
- 目录结构反映命名空间层级
运行composer dump-autoload后，所有符合规则的类都能被自动加载。
工具辅助保持规范一致性
手动遵守规范容易出错，借助工具能大幅提升效率。
- PHP_CodeSniffer：检测代码是否符合PSR标准，支持PSR-1、PSR-12等
- PHP-CS-Fixer：不仅能检查还能自动修复格式问题，集成到CI流程中很实用
- IDE配置：如PhpStorm、VS Code可通过插件实时提示或格式化代码
例如使用PHP-CS-Fixer快速格式化整个项目：
php-cs-fixer fix src/ --rules=@PSR12
基本上就这些。遵循PSR规范不是追求完美主义，而是建立团队共识、减少沟通成本的有效方式。尤其在多人协作或开源项目中，统一风格能让代码更易维护。选择PSR-12作为基础编码风格，配合PSR-4实现自动加载，再用工具链保障执行，就是当前PHP社区广泛认可的最佳实践路径。
