摘要：簡(jiǎn)評(píng)，是基于羅伯特馬丁的經(jīng)典編程書(shū)籍代碼整潔之道的適用版本，并不是一個(gè)風(fēng)格指南，而是在中編寫可讀可重用和可重構(gòu)的軟件的指南。當(dāng)函數(shù)做的事多于一件事情時(shí)，他們更難編寫和測(cè)試。這是面向?qū)ο蟮脑O(shè)計(jì)原則中的開(kāi)放封閉原則的一部分。

簡(jiǎn)評(píng)： Clean Code PHP，是基于羅伯特·馬丁的經(jīng)典編程書(shū)籍 ——「代碼整潔之道」的 PHP 適用版本，并不是一個(gè)風(fēng)格指南，而是在
PHP 中編寫可讀、可重用和可重構(gòu)的軟件的指南。當(dāng)然切忌機(jī)械地遵循這里的原則。

不添加不需要的上下文

如果你的類名或?qū)ο竺Q有具體的含義，請(qǐng)不要重復(fù)該變量的名稱。
差：

好：

函數(shù)參數(shù)數(shù)量（理想情況是 2 個(gè)以下）
限制函數(shù)參數(shù)的數(shù)量是非常重要的，因?yàn)樗尯瘮?shù)更容易測(cè)試，參數(shù)超過(guò)三個(gè)的話，你必須用每個(gè)多帶帶的參數(shù)測(cè)試大量不同的情況。
無(wú)參數(shù)是理想的情況。一個(gè)或兩個(gè)參數(shù)是可以的，但應(yīng)該避免三個(gè)。通常，如果你有兩個(gè)以上的參數(shù)，那么你的函數(shù)試圖完成太多的功能，若不是，大多數(shù)時(shí)候，較高級(jí)的對(duì)象就足以作為參數(shù)（譯者注：比如數(shù)組、對(duì)象）。
差：

好：
title = "Foo";
$config->body = "Bar";
$config->buttonText = "Baz";
$config->cancellable = true;

function createMenu(MenuConfig $config) {
    // ...
}

一個(gè)函數(shù)應(yīng)該只完成一件事
這是軟件工程中最重要的規(guī)則。當(dāng)函數(shù)做的事多于一件事情時(shí)，他們更難編寫和測(cè)試。 當(dāng)你可以將函數(shù)隔離成一個(gè)動(dòng)作時(shí)，可以輕松重構(gòu)，代碼也將更易讀。
差：
find($client);
        if ($clientRecord->isActive()) {
            email($client);
        }
    }
}

好：
function emailClients($clients) {
    $activeClients = activeClients($clients);
    array_walk($activeClients, "email");
}

function activeClients($clients) {
    return array_filter($clients, "isClientActive");
}

function isClientActive($client) {
    $clientRecord = $db->find($client);
    return $clientRecord->isActive();
}

使用 get 和 set 方法
在 PHP 中，可以為方法設(shè)置 public、protected 和 private 關(guān)鍵字，可以控制對(duì)象上的屬性可見(jiàn)性。這是面向?qū)ο蟮脑O(shè)計(jì)原則中的開(kāi)放/封閉原則的一部分。
差：
class BankAccount
{
    public $balance = 1000;
}

$bankAccount = new BankAccount();

// Buy shoes...
$bankAccount->balance -= 100;

好：
class BankAccount
{
    private $balance;

    public function __construct($balance = 1000)
    {
      $this->balance = $balance;
    }

    public function withdrawBalance($amount)
    {
        if ($amount > $this->balance) {
            throw new Exception("Amount greater than available balance.");
        }

        $this->balance -= $amount;
    }

    public function depositBalance($amount)
    {
        $this->balance += $amount;
    }

    public function getBalance()
    {
        return $this->balance;
    }
}

$bankAccount = new BankAccount();

// Buy shoes...
$bankAccount->withdrawBalance($shoesPrice);

// Get balance
$balance = $bankAccount->getBalance();

原文：Clean Code Concepts Adapted for PHP