PHP でしばらく開発をしている人なら、PSR-12 という用語に遭遇したことがあるでしょう。これは、PHP コミュニティで最も広く受け入れられているコーディング標(biāo)準(zhǔn)の 1 つであり、さまざまなプロジェクト間で PHP コードベースの一貫性を確保することを目的としています。単獨(dú)で作業(yè)している場合でも、チームの一員として作業(yè)している場合でも、PSR-12 に従うことで、コードがよりクリーンになり、読みやすくなり、保守が容易になります。このブログでは、PSR-12 とは何か、なぜ重要なのか、プロジェクトにどのように適用できるのかを詳しく説明します。

目次

1. PSR-12 とは何ですか?
2. PSR-12 はなぜ重要ですか?
3. PSR-12 の重要なルール
   • ファイル構(gòu)造
   • 名前空間と使用宣言
   • クラスとメソッド
   • 制御構(gòu)造
   • コメントとドキュメント
4. PHP プロジェクトに PSR-12 を適用する方法
5. PSR-12 の追跡に役立つツール
6. 最終的な感想

PSR-12とは何ですか？

PSR-12 は、PHP-FIG (Framework Interoperability Group) によって開発された、PHP 用の コーディング スタイル ガイド です。これは、以前の PSR-2 標(biāo)準(zhǔn)に基づいて構(gòu)築されており、最新の PHP の実踐を反映し、コードベース間の一貫性を向上させる更新されたルール セットを提供します。

PSR-12 は、クリーンで読みやすく、保守しやすい PHP コードを作成するための青寫真と考えてください。 PSR-12 に従うことで、開発者はコードが標(biāo)準(zhǔn)化された構(gòu)造に準(zhǔn)拠していることを確認(rèn)できるため、他のユーザーとのコラボレーションやオープンソース プロジェクトでの作業(yè)が容易になります。

PSR-12 が重要な理由

PSR-12 のようなコーディング標(biāo)準(zhǔn)は、スペースやタブの細(xì)かい點(diǎn)を気にするだけではありません。それらが重要な理由は次のとおりです:

• 読みやすさ: 標(biāo)準(zhǔn)スタイルに従ったコードは、特にプロジェクトに慣れていない開発者にとって読みやすくなります。
• コラボレーション: 全員が同じルールに従えば、共同作業(yè)がよりスムーズかつ効率的になります。
• 保守性: クリーンで一貫性のあるコードは、時(shí)間の経過とともにデバッグ、テスト、拡張が容易になります。
• 相互運(yùn)用性: オープンソース プロジェクトまたはサードパーティ ライブラリを統(tǒng)合する場合、共通の標(biāo)準(zhǔn)に従うことで、異なるコードベース間での互換性が確保されます。

PSR-12 の重要なルール

PSR-12 が規(guī)定する重要なルールのいくつかを詳しく見てみましょう。細(xì)かいガイドラインは數(shù)多くありますが、最も目立つガイドラインを以下に示します。

1. ファイル構(gòu)造

• 開始タグ: PHP ファイルでは
• エンコーディング: ファイルは BOM (バイト オーダー マーク) なしで UTF-8 でエンコードする必要があります。
• 行の長さ: 行は 120 文字を超えてはなりませんが、80 文字までの行が推奨されます。
• 空白行: PHP の開始タグの後または終了タグの前に空白行があってはなりません。さらに、return ステートメントの前およびメソッド定義の間に 1 つの空白行が必要です。

2. 名前空間と使用宣言

PSR-12 では、明確性を高めるために、名前空間と使用宣言が特定の順序に従う必要があります。

• 名前空間宣言: 名前空間宣言は、PHP 開始タグの後の最初の行である必要があります。名前空間の後には空白行が 1 行必要です。
• Use 宣言: すべての use 宣言は、名前空間宣言の後にグループ化し、空白行で區(qū)切る必要があります。さらに、最後の use ステートメントの後には空行が 1 行必要です。

例:

<?php

namespace App\Controllers;

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

class UserController {
    // Class implementation
}

3. クラスとメソッド

PSR-12 では、クラス、プロパティ、メソッドの宣言方法に関していくつかの厳格なルールが適用されます。

• クラス宣言: class キーワードの後に??スペース、その後にクラス名を続ける必要があります。開き中括弧 { はクラス宣言と同じ行に配置し、閉じ中括弧 } は別の行に配置する必要があります。
• プロパティ: すべてのプロパティに対して可視性 (パブリック、プロテクト、プライベート) を宣言する必要があります。
• メソッド: クラス宣言と同様に、関數(shù)キーワードの後に??スペース、その後にメソッド名を続ける必要があります。すべてのメソッドに対して可視性を宣言する必要があります。

class UserController {
    private $userRepository;

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




<h4>
  
  
  4. 制御構(gòu)造
</h4>

<p>if、for、switch などの制御構(gòu)造は、特定のルールに従う必要があります:</p>

<ul>
<li>
<strong>構(gòu)造</strong>: 制御キーワードと左括弧の間にはスペースが 1 つ必要です。単一行のステートメントであっても、中括弧 {} を常に使用する必要があります。</li>
<li>
<strong>インデント</strong>: 制御構(gòu)造內(nèi)のすべてのブロックは 1 レベル (通常は 4 つのスペース) でインデントする必要があります。
</li>
</ul>

<pre class="brush:php;toolbar:false">if ($user->isAdmin()) {
    echo "User is an admin";
} else {
    echo "User is not an admin";
}

5. コメントとドキュメント

コメントは、コードの特定の部分が存在する理由を説明するために非常に重要です。 PSR-12 は、適切かつ明確なコメントの必要性を強(qiáng)調(diào)しています。

• コメントをブロック: 複數(shù)行のコメントには /* */ を使用し、コメントの前に空行を置きます。
• 単一行コメント: インライン コメントには // を使用し、コメントが意味のあるものであることを確認(rèn)してください。

<?php

namespace App\Controllers;

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

class UserController {
    // Class implementation
}

PHP プロジェクトに PSR-12 を適用する方法

プロジェクトで PSR-12 に従うには、コードを記述するときにガイドラインに手動(dòng)で従うこともできますが、確実に準(zhǔn)拠する最善の方法は、自動(dòng)化ツールを使用することです。

まず、次の一般的な方法をよく理解してください:

• 一貫したインデントを使用する: インデントには 4 つのスペースが必要です。
• 行の長さを制限する: 読みやすくするためには 80 文字が推奨されますが、行は 120 文字未満に抑えるようにしてください。
• コード構(gòu)造を整理する: クラス宣言、可視性、および制御構(gòu)造のルールに従います。

PSR-12 の追跡に役立つツール

コードが PSR-12 に従っていることを手動(dòng)で確認(rèn)するには時(shí)間がかかる場合がありますが、このプロセスの自動(dòng)化に役立つツールがあります。

1.PHP_CodeSniffer

PHP コードが PSR-12 に従っていることを確認(rèn)するための最も人気のあるツールの 1 つは、PHP_CodeSniffer です。コードを分析し、標(biāo)準(zhǔn)から逸脫している箇所を指摘します。

インストールして使用するには:

class UserController {
    private $userRepository;

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

次に、コードに対して実行します。

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

2. PHP CS フィクサー

もう 1 つの便利なツールは、PHP CS Fixer です。問題を検出するだけでなく、PSR-12 に準(zhǔn)拠するようにコードを自動(dòng)的に修正することもできます。

// 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();
}

次のコマンドでフィクサーを?qū)g行します:

composer require "squizlabs/php_codesniffer=*"

3.PHPStorm

PHPStorm を使用している場合は、PSR-12 に従うように設(shè)定できます。 設(shè)定 -> に移動(dòng)します。 編集者 -> コードスタイル -> PHP を選択し、標(biāo)準(zhǔn)を PSR-12 に設(shè)定します。

最終的な考え

PHP プロジェクトで PSR-12 に従うことは、単に任意のルールに従うだけではありません。一人で作業(yè)している場合でも、チームで作業(yè)している場合でも、コードをよりクリーンで読みやすく、保守しやすくすることが重要です。 PSR-12 に従うことで、自分自身のためだけでなく、PHP コミュニティ全體のためにコードを書くことになります。

この標(biāo)準(zhǔn)の採用は、プロフェッショナルで一貫性があり、保守しやすい PHP コードを作成するための一歩です。前述のツールを使用してプロセスを簡単にし、プロジェクトがどれだけクリーンで整理されたものになるかを見てください!

コーディングを楽しんでください!

以上がPSR を理解する - PHP コーディング スタイル ガイドの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。