如果您使用 PHP 進(jìn)行開(kāi)發(fā)已有一段時(shí)間，您可能遇到過(guò)術(shù)語(yǔ) PSR-12。它是 PHP 社群中最廣泛接受的編碼標(biāo)準(zhǔn)之一，旨在確保不同專案之間 PHP 程式碼庫(kù)的一致性。無(wú)論您是單獨(dú)工作還是作為團(tuán)隊(duì)的一員，遵循 PSR-12 都可以使您的程式碼更乾淨(jìng)、更具可讀性並且更易於維護(hù)。在本部落格中，我們將詳細(xì)介紹 PSR-12 是什麼、它為何重要以及如何將其應(yīng)用到您的專案中。

目錄

1. 什麼是 PSR-12？
2. 為什麼 PSR-12 很重要？
3. PSR-12 的主要規(guī)則
   • 文件結(jié)構(gòu)
   • 命名空間與使用聲明
   • 類別與方法
   • 控制結(jié)構(gòu)
   • 評(píng)論和文件
4. 如何在 PHP 專案中應(yīng)用 PSR-12
5. 幫助您遵循 PSR-12 的工具
6. 最後的想法

什麼是 PSR-12？

PSR-12 是 PHP 編碼風(fēng)格指南，由 PHP-FIG（框架互通性小組）開(kāi)發(fā)。它建立在先前的 PSR-2 標(biāo)準(zhǔn)的基礎(chǔ)上，提供了一組更新的規(guī)則，反映了現(xiàn)代 PHP 實(shí)踐並提高了程式碼庫(kù)之間的一致性。

將 PSR-12 視為編寫乾淨(jìng)、可讀且可維護(hù)的 PHP 程式碼的藍(lán)圖。透過(guò)遵循 PSR-12，開(kāi)發(fā)人員可以確保他們的程式碼遵循標(biāo)準(zhǔn)化結(jié)構(gòu)，從而更輕鬆地與他人合作並進(jìn)行開(kāi)源專案。

為什麼 PSR-12 很重要？

像 PSR-12 這樣的編碼標(biāo)準(zhǔn)不僅僅是對(duì)空格和製表符吹毛求疵。這就是它們重要的原因：

• 可讀性：遵循標(biāo)準(zhǔn)樣式的程式碼更容易閱讀，特別是對(duì)於剛接觸專案的開(kāi)發(fā)人員。
• 協(xié)作：如果每個(gè)人都遵循相同的規(guī)則，那麼合作就會(huì)變得更加順利和有效率。
• 可維護(hù)性：乾淨(jìng)、一致的程式碼更容易調(diào)試、測(cè)試和隨著時(shí)間的推移進(jìn)行擴(kuò)展。
• 互通性：在開(kāi)源專案或整合第三方程式庫(kù)時(shí)，遵循通用標(biāo)準(zhǔn)可確保不同程式碼庫(kù)之間的相容性。

PSR-12 的主要規(guī)則

讓我們深入了解 PSR-12 規(guī)定的一些關(guān)鍵規(guī)則。雖然有許多較小的指南，但以下是最引人注目的指南。

1. 文件結(jié)構(gòu)

• 開(kāi)始標(biāo)籤：PHP 檔案必須使用
• 編碼：檔案必須以 UTF-8 編碼，不含 BOM（位元組順序標(biāo)記）。
• 行長(zhǎng)度：行不應(yīng)超過(guò) 120 個(gè)字符，但最好不超過(guò) 80 個(gè)字符。
• 空白行：PHP 開(kāi)始標(biāo)籤之後或結(jié)束標(biāo)籤前不應(yīng)有空行。此外，return 語(yǔ)句之前以及方法定義之間必須有一個(gè)空行。

2. 命名空間與使用聲明

PSR-12 要求命名空間和使用聲明遵循特定的順序以提高清晰度：

• 命名空間宣告：命名空間宣告必須是 PHP 開(kāi)始標(biāo)記之後的第一行。命名空間後必須有一個(gè)空行。
• Use 宣告：所有 use 宣告必須在??命名空間宣告之後組合在一起，並以空白行分隔。此外，最後一個(gè) use 語(yǔ)句後面必須有一個(gè)空行。

範(fàn)例：

<?php

namespace App\Controllers;

use App\Models\User;
use App\Repositories\UserRepository;

class UserController {
    // Class implementation
}

3. 類別和方法

PSR-12 對(duì)如何宣告類別、屬性和方法強(qiáng)制執(zhí)行一些嚴(yán)格的規(guī)則：

• 類別宣告：class關(guān)鍵字後面必須跟一個(gè)空格，然後是類別名稱。左大括號(hào) { 必須與類別宣告放在同一行，右大括號(hào) } 放在自己的行上。
• 屬性：所有屬性都必須宣告可見(jiàn)性（公有、受保護(hù)、私有）。
• 方法：與類別宣告類似，function 關(guān)鍵字後面必須跟一個(gè)空格，然後是方法名稱。必須為所有方法聲明可見(jiàn)性。

class UserController {
    private $userRepository;

    public function __construct(UserRepository $userRepository) {
        $this->userRepository = $userRepository;
    }
}

4. 控制結(jié)構(gòu)

if、for、switch 等控制結(jié)構(gòu)必須遵循一定的規(guī)則：

• 結(jié)構(gòu)：控製關(guān)鍵字和左括號(hào)之間必須有一個(gè)空格。必須始終使用大括號(hào) {}，即使對(duì)於單行語(yǔ)句也是如此。
• 縮排：控制結(jié)構(gòu)內(nèi)的所有區(qū)塊都必須縮排一級(jí)（通常為四個(gè)空格）。

if ($user->isAdmin()) {
    echo "User is an admin";
} else {
    echo "User is not an admin";
}

5. 評(píng)論和文檔

註解對(duì)於解釋為什麼程式碼的某些部分存在至關(guān)重要。 PSR-12 強(qiáng)調(diào)需要正確、清晰的評(píng)論。

• 區(qū)塊註釋：使用 /* */ 進(jìn)行多行註釋，並在註釋前放置一個(gè)空白行。
• 單行註釋：使用//進(jìn)行內(nèi)聯(lián)註釋，並確保註釋有意義。

<?php

namespace App\Controllers;

use App\Models\User;
use App\Repositories\UserRepository;

class UserController {
    // Class implementation
}

如何在 PHP 專案中應(yīng)用 PSR-12

要在專案中遵循 PSR-12，您可以在編寫程式碼時(shí)手動(dòng)遵守指南，但確保合規(guī)性的最佳方法是使用自動(dòng)化工具。

首先，熟悉這些一般做法：

• 使用一致的縮排：縮排需要四個(gè)空格。
• 限制行長(zhǎng)度：盡量將行長(zhǎng)度控制在 120 個(gè)字元以下，但為了更好的可讀性，最好使用 80 個(gè)字元。
• 組織程式碼結(jié)構(gòu)：遵循類別聲明、可見(jiàn)性和控制結(jié)構(gòu)的規(guī)則。

幫助您遵循 PSR-12 的工具

手動(dòng)確保您的程式碼遵循 PSR-12 可能非常耗時(shí)，但有一些工具可以幫助您自動(dòng)化此流程。

1. PHP_CodeSniffer

確保 PHP 程式碼遵循 PSR-12 的最受歡迎工具之一是 PHP_CodeSniffer。它會(huì)分析您的程式碼並指出您偏離標(biāo)準(zhǔn)的地方。

安裝使用它：

class UserController {
    private $userRepository;

    public function __construct(UserRepository $userRepository) {
        $this->userRepository = $userRepository;
    }
}

然後，針對(duì)您的程式碼執(zhí)行它：

if ($user->isAdmin()) {
    echo "User is an admin";
} else {
    echo "User is not an admin";
}

2. PHP CS 修復(fù)程序

另一個(gè)有用的工具是 PHP CS Fixer。它不僅可以檢測(cè)問(wèn)題，還可以自動(dòng)修復(fù)您的程式碼以符合 PSR-12。

// Fetch user from the repository
$user = $userRepository->find($id);

/*
 * If user is not found, throw an exception.
 * This helps in handling invalid user IDs.
 */
if (!$user) {
    throw new NotFoundException();
}

使用以下命令執(zhí)行修復(fù)程式：

composer require "squizlabs/php_codesniffer=*"

3. PHPStorm

如果您使用 PHPStorm，您可以將其設(shè)定為遵循 PSR-12。前往設(shè)定 -> 編輯器 -> 程式碼風(fēng)格 -> PHP 並將標(biāo)準(zhǔn)設(shè)為 PSR-12。

最後的想法

在 PHP 專案中遵循 PSR-12 不僅僅是遵守任意規(guī)則。它是為了讓你的程式碼更乾淨(jìng)、更易讀、更容易維護(hù)——無(wú)論你是單獨(dú)工作還是與團(tuán)隊(duì)一起工作。透過(guò)遵循 PSR-12，您不僅為自己編寫程式碼，而且為整個(gè) PHP 社群編寫程式碼。

採(cǎi)用此標(biāo)準(zhǔn)是朝著編寫專業(yè)、一致且可維護(hù)的 PHP 程式碼邁出的一步。使用提到的工具使過(guò)程變得更容易，並觀察您的專案變得多麼乾淨(jìng)和有組織！

編碼愉快！

以上是了解 PSR - PHP 程式設(shè)計(jì)風(fēng)格指南的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！