代码质量很少靠一次重构提升,更多靠日常的小习惯累积。下面十条不涉及框架和架构,改起来成本很低,但坚持三个月,你会明显感觉代码好读了。

1. 提前返回,减少嵌套

<?php
// 不推荐
function check($user) {
    if ($user) {
        if ($user->active) {
            if ($user->role === 'admin') {
                return true;
            }
        }
    }
    return false;
}

// 推荐
function check($user) {
    if (!$user) return false;
    if (!$user->active) return false;
    return $user->role === 'admin';
}

2. 变量名说清”是什么”,而不是”是什么类型”

$data、$arr、$tmp 这类名字等于没起名。改成 $orderList、$expiredUsers,读代码时省下的脑力远超命名时花的几秒。

3. 魔法数字提取成常量

if ($status == 3) 三个月后没人记得 3 是什么。写成 OrderStatus::PAID 或常量,语义立刻清楚。

4. 一个函数只做一件事

名字里出现”并且””顺便”的时候,就该拆了。函数越短,测试和复用越容易。

5. 用严格比较

=== 不只是风格问题,它避免了一整类类型转换导致的 bug。

6. 输出一律转义

<?php
// 模板里输出用户数据
echo htmlspecialchars($title, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');

// URL 参数
echo urlencode($keyword);

// JS 变量
echo json_encode($config, JSON_UNESCAPED_UNICODE);

7. 异常不要吞掉

catch (Exception $e) {} 是排查噩梦的源头。至少要记录日志,或者把异常转换成对用户有意义的提示。

8. 数组操作优先用内置函数

array_filter、array_map、array_column 比手写 foreach 更快也更少出错。

9. 配置与代码分离

数据库密码、第三方密钥不要写死在业务代码里,放到环境变量或配置文件,并且确保配置文件不在 Web 可访问目录。

10. 提交前自己读一遍 diff

这一步能拦掉大部分调试代码残留:var_dump、注释掉的逻辑、临时改的路径。

这十条没有一条需要学习新知识,难的是持续。建议每周挑一条刻意练习,比一次性全部改更容易形成习惯。

本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。