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免费学习笔记(深入)”;
开头加 declare(strict_types=1); 参数类型写在变量前:public function save(User $user): bool 避免超长参数列表,多参数考虑封装成 Value Object 或数组配置(但需文档说明) 私有方法命名用小写字母+下划线(如 validate_email_format())也可接受,但需团队统一
安全与健壮性:永远别信外部输入
$_GET、$_POST、$_COOKIE、文件上传、数据库结果……所有外部数据默认视为不可信。过滤、验证、转义三步不能少。
输出到HTML前用 htmlspecialchars($str, ENT_QUOTES, 'UTF-8') 数据库操作强制用PDO预处理语句,杜绝拼接SQL 文件路径拼接避免用户控制全部路径,用 basename() 或白名单校验文件名 敏感操作(如密码重置、支付)加CSRF Token 和权限校验,别只靠前端隐藏按钮
基本上就这些——不需要记住全部PSR条目,但坚持命名清晰、缩进一致、类型明确、输入设防,你的PHP代码就已经比多数项目高出一截。
以上就是PHP编码规范与最佳实践_PHP代码格式风格说明的详细内容,更多请关注php中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1342724.html
微信扫一扫
支付宝扫一扫