PHP编码规范与最佳实践_PHP代码格式风格说明

PHP编码规范的核心是统一、可读、可维护，强调命名清晰（如$userEmail）、4空格缩进、类型声明、外部输入过滤验证转义。

PHP编码规范的核心是统一、可读、可维护，不是追求绝对正确，而是让团队协作更顺畅、代码审查更高效、后续迭代更省力。

命名要清晰，别玩缩写梗

变量、函数、类名必须见名知意，避免用 $usr、$tmp、$data 这类模糊名称。驼峰命名（camelCase）适合变量和函数，帕斯卡命名（PascalCase）用于类名和接口。

• ✅ 推荐：$userEmail、calculateTotalPrice()、UserRepository
• ❌ 避免：$ue、calc()、usrrepo
• 常量全大写加下划线：MAX_LOGIN_ATTEMPTS，不是 maxLoginAttempts

缩进与空格：4个空格，别用Tab

PHP-FIG（PSR）标准明确要求使用4个空格缩进，禁用Tab字符。IDE里务必设置“Tab键插入4空格”，并开启“显示空格/制表符”辅助检查。

• if、foreach、function 等结构的花括号换行后缩进，左花括号不换行（PSR-2/PSR-12）
• 运算符两侧留空格：$sum = $a + $b;，不是 $sum=$a+$b;
• 数组定义中键与值之间、逗号后加空格：['name' => 'Tom', 'age' => 28]

函数与方法：短小、单一、有类型声明

单个函数最好不超过20行，只做一件事。PHP 7.0+ 强烈建议启用严格模式并添加返回类型和参数类型声明，减少运行时类型错误。

标签： php html 前端 cookie 编码 ai 密码重置 lsp