PHP如何优化冗余代码

lichongyang

1 周前

好的，阿若萱，这里给你整理一份 PHP 优化冗余代码的完整指南，从 分析 → 重构 → 设计模式 → 工具 → 框架实践，可以直接落地，提升代码质量、可维护性和性能。

一、什么是冗余代码？

冗余代码通常指：

重复逻辑echo "Hello " . $name; echo "Hello " . $username;
重复函数或条件判断if ($user->role == 'admin') { ... } if ($user->role == 'super') { ... }
不必要的临时变量$temp = $value; return $temp;
过长方法/类，职责不清晰

✅ 冗余代码会导致：

维护成本高
容易出错
性能浪费

二、分析冗余代码的方法

手动阅读 + 比对
- 找重复的 if/else、循环、SQL 查询、文件操作
静态分析工具
- PHP_CodeSniffer（代码风格 + 重复检测）
- PHPMD（潜在问题 + 冗余检测）
- PHPStan / Psalm（类型和重复逻辑分析）
日志 / 调试分析
- 发现重复 SQL 查询、重复循环

三、重构方法

1️⃣ 提取函数 / 方法

Before：

echo "Hello " . $name;
echo "Hello " . $username;

After：

function greet($user) {
    echo "Hello " . $user;
}

greet($name);
greet($username);

2️⃣ 提取类 / 封装组件

将重复业务逻辑封装成类
比如：日志、邮件、文件处理

class Logger {
    public static function info($msg) {
        file_put_contents('log.txt', $msg . PHP_EOL, FILE_APPEND);
    }
}
Logger::info('用户登录');
Logger::info('用户登出');

3️⃣ 使用数组 / 循环替代重复条件

Before：

if ($role == 'admin') { ... }
if ($role == 'editor') { ... }
if ($role == 'user') { ... }

After：

$roleActions = [
    'admin' => 'doAdmin',
    'editor' => 'doEditor',
    'user' => 'doUser'
];

if (isset($roleActions[$role])) {
    $roleActions[$role]();
}

4️⃣ 统一常量 / 配置

避免硬编码重复值
用 define()、const 或配置文件

const STATUS_ACTIVE = 1;
const STATUS_INACTIVE = 0;

if ($user->status === STATUS_ACTIVE) { ... }

5️⃣ 使用设计模式

模式	用途
Singleton	避免重复创建实例（数据库连接、日志）
Factory	动态创建对象，减少重复条件
Strategy	替代复杂 if/else 逻辑
Template	提取重复模板方法

四、实战优化示例

1️⃣ 重复 SQL 查询

Before：

$user = $db->query("SELECT * FROM users WHERE id = $id");
$posts = $db->query("SELECT * FROM posts WHERE user_id = $id");
$comments = $db->query("SELECT * FROM comments WHERE user_id = $id");

After：

function getUserData($id, $db) {
    return [
        'user' => $db->query("SELECT * FROM users WHERE id = $id"),
        'posts' => $db->query("SELECT * FROM posts WHERE user_id = $id"),
        'comments' => $db->query("SELECT * FROM comments WHERE user_id = $id"),
    ];
}
$data = getUserData($id, $db);

✅ 优点：减少重复调用函数，统一处理逻辑

2️⃣ 控制器重复逻辑（ThinkPHP / Laravel）

Before：

public function addUser() {
    $user = new User();
    $user->name = $_POST['name'];
    $user->email = $_POST['email'];
    $user->save();
}
public function updateUser() {
    $user = User::find($_POST['id']);
    $user->name = $_POST['name'];
    $user->email = $_POST['email'];
    $user->save();
}

After：

private function saveUser($data, $id = null) {
    $user = $id ? User::find($id) : new User();
    $user->fill($data);
    $user->save();
    return $user;
}

public function addUser() {
    $this->saveUser($_POST);
}

public function updateUser() {
    $this->saveUser($_POST, $_POST['id']);
}

五、工具和方法推荐

静态分析 + 重构工具
- PHPStorm 自动检测重复代码
- PHPMD / PHP_CodeSniffer
单元测试覆盖逻辑
- 减少重构后引入新 bug
- PHPUnit
Composer 包复用
- 避免重复写函数
- 例如：Carbon（日期）、Guzzle（HTTP）

六、总结优化原则

DRY 原则（Don’t Repeat Yourself）
单一职责原则（每个函数只做一件事）
抽象复用（函数 / 类 / 组件）
配置化替代硬编码
用框架 / 设计模式减少重复逻辑