なぜ一部の PHP コードベースは楽しく作業できるのに、他のコードベースは迷路のように感じられるのか疑問に思ったことはありませんか?その多くは、一貫したコーディング標準に従うことに帰着します。 PSR-1 は、チームがよりクリーンで保守しやすいコードを作成できるようにする、最新の PHP 開発の基盤である PSR-1 を見てみましょう!
PSR-1 ルールの概要
1. ファイルと名前空間
- ファイルでは
- ファイルでは、PHP コードには BOM なしの UTF-8 のみを使用する必要があります
- ファイルはシンボル (クラス、関数、定数) を宣言するか、副作用 (出力の生成、設定の変更など) を引き起こすかのいずれかを行う必要がありますが、両方を行うべきではありません
2. 名前空間とクラス名
- クラスは StudlyCaps で宣言する必要があります
- クラス定数は、アンダースコア区切り文字を使用してすべて大文字で宣言する必要があります
3. クラスメソッド
- メソッド名はキャメルケースで宣言する必要があります
実際の実装
サンプル リポジトリから正しい PSR-1 実装を見てみましょう:
$id, 'name' => 'John Doe'];
}
}
この例は次のことを示しています。
- StudlyCaps を使用した適切な名前空間宣言
- StudlyCaps のクラス名
- アンダースコアを含む大文字の定数
- キャメルケースのメソッド名
一般的な違反と修正
複合的な責任
名前が間違っています
最新の PHP ツールとの統合
サンプル リポジトリには次のセットアップが含まれています:
- PSR-1 検証用の PHP_CodeSniffer (コンポーザー チェック スタイル)
- 自動スタイル修正 (作曲家修正スタイル)
- 実装をテストするための PHPUnit
- PSR-4 に続く Composer の自動ロード
次のステップ
次回の投稿では、これらの基本的なコーディング標準をより包括的なスタイル ガイドラインで拡張する PSR-12 について説明します。この投稿は、PHP シリーズの PSR 標準の一部です。
リソース
- PSR-1 の公式仕様
- PHP_CodeSniffer PSR-1 ルールセット
-
シリーズ サンプル リポジトリ (v0.1.0 - PSR-1 実装)
以上がPSR - PHP の基本コーディング標準の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。