這篇文章為大家帶來了關於php的相關知識，其中主要跟大家聊一聊什麼是重構？怎麼更好的重構PHP程式碼？有興趣的朋友下面一起來看看吧，希望對大家有幫助。
重構指的是不改變原有功能的情況下，修改或重新編寫程式碼。
在下面的範例中，我將向你展示如何更好地寫程式碼。
#1 - 表現力
這可能只是一個簡單的技巧，但編寫富有表現力的程式碼可以大大改進我們的程式碼。總是讓程式碼自我解釋，這樣未來的你或其他開發人員都能知道程式碼中發生了什麼。
不過也有開發人員表示，命名是程式設計中最困難的事情之一。這就是為什麼這不像聽起來那麼容易的原因之一。
範例#1 - 命名
之前
// ❌ 这个方法是用来做什么的，方法名表达并不清晰 // ❌ 是设置状态还是检查状态呢？ $status = $user->status('pending');
之後
// ✅ 通过添加 is，使方法名表达的意图更清晰 // ✅ 检测用户状态是否与给定状态相等 // ✅ 同时新变量名让我们可以推断它是布尔值 $isUserPending = $user->isStatus('pending');
範例#2 - 命名
#之前
// ❌ 这个类返回的是什么？类名？类全名？还是类路径？ return $factory->getTargetClass();
之後
// ✅ 我们获取的是类路径 // ✅ 如果用户想要类名？则找错了方法 return $factory->getTargetClassPath();
範例#3 - 提取
之前
// ❌ 重复的代码 ( "file_get_contents", "base_path" 方法以及文件扩展)
// ❌ 此刻，我们不去关心如何获得code examples
public function setCodeExamples(string $exampleBefore, string $exampleAfter)
{
$this->exampleBefore = file_get_contents(base_path("$exampleBefore.md"));
$this->exampleAfter = file_get_contents(base_path("$exampleAfter.md"));
}之後
public function setCodeExamples(string $exampleBefore, string $exampleAfter)
{
// ✅ 代码直接说明了我们的意图：获取code example(不关注如何获取)
$this->exampleBefore = $this->getCodeExample($exampleBefore);
$this->exampleAfter = $this->getCodeExample($exampleAfter);
}
// ✅ 这个新方法可多次调用
private function getCodeExample(string $exampleName): string
{
return file_get_contents(base_path("$exampleName.md"));
}範例#4 - 提取
之前
// ❌ 多重 where 语句，使阅读变得困难 // ❌ 意图究竟是什么呢？ User::whereNotNull('subscribed')->where('status', 'active');
之後
// ✅ 这个新的scope方法说明了发生了什么事 // ✅ 如果我们需要了解更多细节，可以进入这个scope方法内部去了解 // ✅ "subscribed" scope 方法可在其他地方使用 User::subscribed();
範例#5 - 提取
#這是我之前專案的一個例子。我們用命令列導入用戶。 ImportUsersCommand 類別中含有一個 handle 方法，用來處理任務。
之前
protected function handle()
{
// ❌ 这个方法包含太多代码
$url = $this->option('url') ?: $this->ask('Please provide the URL for the import:');
$importResponse = $this->http->get($url);
// ❌ 进度条对用户很有用，不过却让代码显得杂乱
$bar = $this->output->createProgressBar($importResponse->count());
$bar->start();
$this->userRepository->truncate();
collect($importResponse->results)->each(function (array $attributes) use ($bar) {
$this->userRepository->create($attributes);
$bar->advance();
});
// ❌ 很难说清此处发生了哪些行为
$bar->finish();
$this->output->newLine();
$this->info('Thanks. Users have been imported.');
if($this->option('with-backup')) {
$this->storage
->disk('backups')
->put(date('Y-m-d').'-import.json', $response->body());
$this->info('Backup was stored successfully.');
}
}之後
protected function handle(): void
{
// ✅ handle方法是你访问该类首先会查看的方法
// ✅ 现在可以很容易就对这个方法做了些什么有个粗略的了解
$url = $this->option('url') ?: $this->ask('Please provide the URL for the import:');
$importResponse = $this->http->get($url);
$this->importUsers($importResponse->results);
$this->saveBackupIfAsked($importResponse);
}
// ✅ 如果需要了解更多细节，可以查看这些专用的方法
protected function importUsers($userData): void
{
$bar = $this->output->createProgressBar(count($userData));
$bar->start();
$this->userRepository->truncate();
collect($userData)->each(function (array $attributes) use ($bar) {
$this->userRepository->create($attributes);
$bar->advance();
});
$bar->finish();
$this->output->newLine();
$this->info('Thanks. Users have been imported.');
}
// ✅ 不要害怕使用多行代码
// ✅ 这个例子中它让我们核心的 handle 方法更为简洁
protected function saveBackupIfAsked(Response $response): void
{
if($this->option('with-backup')) {
$this->storage
->disk('backups')
->put(date('Y-m-d').'-import.json', $response->body());
$this->info('Backup was stored successfully.');
}
}#2 - 提前返回
提前返回指的是，我們嘗試透過將結構分解為特定case 來避免嵌套的做法。這樣，我們得到了更線性的程式碼，更易於閱讀和了解。不要害怕使用多個 return 語句。
範例#1
之前
public function calculateScore(User $user): int
{
if ($user->inactive) {
$score = 0;
} else {
// ❌ 怎么又有一个 "if"?
if ($user->hasBonus) {
$score = $user->score + $this->bonus;
} else {
// ❌ 由于存在多个层级，大费眼神 ?
$score = $user->score;
}
}
return $score;
}之後
public function calculateScore(User $user): int
{
// ✅ 边缘用例提前检测
if ($user->inactive) {
return 0;
}
// ✅ 每个用例都有自己的代码块，使得更容易跟进
if ($user->hasBonus) {
return $user->score + $this->bonus;
}
return $user->score;
}範例#2
之前
public function sendInvoice(Invoice $invoice): void
{
if($user->notificationChannel === 'Slack')
{
$this->notifier->slack($invoice);
} else {
// ❌ 即使是简单的ELSE都影响代码的可读性
$this->notifier->email($invoice);
}
}之後
public function sendInvoice(Invoice $invoice): bool
{
// ✅ 每个条件都易读
if($user->notificationChannel === 'Slack')
{
return $this->notifier->slack($invoice);
}
// ✅ 不用再考虑ELSE 指向哪里
return $this->notifier->email($invoice);
}Note: 有時你會聽到「防衛語句」 這樣的術語，它是透過提前返回實現。
#3 - 重構成集合 Collection
在 PHP 中，我們在許多不同資料中都用到了陣列。處理及轉換這些陣列可用功能非常有限，並且沒有提供良好的體驗。 (array_walk, usort, etc)
要處理這個問題，有一個 Collection 類別的概念，可用來幫你處理陣列。最為人所知的是 Laravel 中的實現，其中的 collection 類別提供了許多有用的特性，用來處理陣列。
注意: 以下例子， 我會使用 Laravel 的 collect () 輔助函數，不過在其他框架或函式庫中的使用方式也很相似。
範例#1
之前
// ❌ 这里我们有一个临时变量
$score = 0;
// ❌ 用循环没有问题，不过可读性还是有改善空间
foreach($this->playedGames as $game) {
$score += $game->score;
}
return $score;之後
// ✅ 集合是带有方法的对象
// ✅ sum 方法使之更具表现力
return collect($this->playedGames)
->sum('score');範例#2
之前
$users = [
[ 'id' => 801, 'name' => 'Peter', 'score' => 505, 'active' => true],
[ 'id' => 844, 'name' => 'Mary', 'score' => 704, 'active' => true],
[ 'id' => 542, 'name' => 'Norman', 'score' => 104, 'active' => false],
];
// 请求结果: 只显示活跃用户，以 score 排序 ["Mary(704)","Peter(505)"]
$users = array_filter($users, fn ($user) => $user['active']);
// ❌ usort 进行排序处理的又是哪一个对象呢？它是如何实现？
usort($users, fn($a, $b) => $a['score'] < $b['score']);
// ❌ 所有的转换都是分离的，不过都是users相关的
$userHighScoreTitles = array_map(fn($user) => $user['name'] . '(' . $user['score'] . ')', $users);
return $userHighScoreTitles;之後
$users = [
[ 'id' => 801, 'name' => 'Peter', 'score' => 505, 'active' => true],
[ 'id' => 844, 'name' => 'Mary', 'score' => 704, 'active' => true],
[ 'id' => 542, 'name' => 'Norman', 'score' => 104, 'active' => false],
];
// 请求结果: 只显示活跃用户，以 score 排序 ["Mary(704)","Peter(505)"]
// ✅ 只传入一次users
return collect($users)
// ✅ 我们通过管道将其传入所有方法
->filter(fn($user) => $user['active'])
->sortBy('score')
->map(fn($user) => "{$user['name']} ({$user['score']})"
->values()
// ✅ 最后返回数组
->toArray();#4 - 一致性
每一行程式碼都會增加少量的視覺雜訊。程式碼越多，閱讀起來就越困難。這就是為什麼制定規則很重要。保持類似的東西一致將幫助您識別程式碼和模式。這將導致更少的雜訊和更可讀的程式碼。
範例#1
之前
class UserController
{
// ❌ 确定如何命名变量(驼峰或是蛇形等)，不要混用！
public function find($userId)
{
}
}
// ❌ 选择使用单数或者复数形式命名控制器，并保持一致
class InvoicesController
{
// ❌ 修改了样式，如花扣号的位置，影响可读性
public function find($user_id) {
}
}之後
class UserController
{
// ✅ 所有变量驼峰式命名
public function find($userId)
{
}
}
// ✅ 控制器命名规则一致(此处都使用单数)
class InvoiceController
{
// ✅ 花括号的位置(格式)一致，使代码更为可读
public function find($userId)
{
}
}範例#2
之前
class PdfExporter
{
// ❌ "handle" 和 "export" 是类似方法的不同名称
public function handle(Collection $items): void
{
// export items...
}
}
class CsvExporter
{
public function export(Collection $items): void
{
// export items...
}
}
// ❌ 使用时你会疑惑它们是否处理相似的任务
// ❌ 你可能需要再去查看类源码进行确定
$pdfExport->handle();
$csvExporter->export();之後
// ✅ 可通过接口提供通用规则保持一致性
interface Exporter
{
public function export(Collection $items): void;
}
class PdfExporter implements Exporter
{
public function export(Collection $items): void
{
// export items...
}
}
class CsvExporter implements Exporter
{
public function export(Collection $items): void
{
// export items...
}
}
// ✅ 对类似的任务使用相同的方法名，更具可读性
// ✅ 不用再去查看类源码，变可知它们都用在导出数据
$pdfExport->export();
$csvExporter->export();重構❤️ 測試
#我已經提到過重構不會改變程式碼的功能。這在運行測試時很方便，因為它們也應該在重構之後工作。這就是為什麼我只有在有測試的時候才開始重構程式碼。他們將確保我不會無意中更改程式碼的行為。所以別忘了寫測試，甚至去 TDD。
推薦學習：《PHP影片教學》
以上是教你如何更好地重構PHP程式碼的詳細內容。更多資訊請關注PHP中文網其他相關文章！
