— y2sunlight 2020-04-21

PSR(PHP Standards Recommendations)は「PHP標準勧告」などと呼ばれており、PHP-FIG(PHP Framework Interop Group)が策定しているPHPのコーディング規約並びに標準インターフェース規格です。本編のフレームワーク編では何かとPSRを参考にしておりますので、この際、正確に勉強しようと思い本章を作ることにしました。ソフトウエア界には標準とか規約と呼ばれるものが多く存在し、従うか否かは自由なのですが、PSRについてはPHPエンジニアとして大いに参考になる思います。

本章は、若干の補足を加筆してはいるものの単にPSRのサイトを日本語に翻訳したものに過ぎません。英語が堪能な方は原文をご参照下さい。翻訳に当たっては、基本的に機械翻訳を使い、理解できない部分は独断で意訳しております。拙い訳では御座いますが恥を忍んで投稿しておりますので、ご指摘など御座いましたらコメントを頂ければ幸いです。

尚、PSR関連の投稿は本章作成時点のステータースがACCEPTED(承認)及びDraft(草稿)なものを対象としています。初回はPSR6までを予定しおり、逐次追加してPSR19までを投稿する予定です。

リンク

• https://www.php-fig.org/ — PHP-FIG(PSRを策定しているグループ)
• https://www.php-fig.org/psr/ — PSR の本家

• PSR - PHP標準勧告
• PSR-1: Basic Coding Standard - 基本コーディング規約
• PSR-3: Logger Interface - ロガーインターフェイス
• PSR-4: Autoloading Standard - オートローディング規約
• PSR-5: PHPDoc Standard(Draft) - PHPDoc規約
• PSR-6: Caching Interface - キャッシングインターフェイス
• PSR-7: HTTP Message Interface - HTTPメッセージインターフェイス
• PSR-11: Container Interface - コンテナインターフェイス
• PSR-12: Extended Coding Style - 拡張コーディングスタイル
• PSR-13: Link definition interfaces - リンク定義インターフェース
• PSR-14: Event Dispatcher - イベントディスパッチャー
• PSR-15: HTTP Server Request Handlers - HTTPサーバーリクエストハンドラー
• PSR-16: Common Interface for Caching Libraries - キャッシングライブラリのための共通インターフェース
• PSR-17: HTTP Factories - HTTPファクトリー
• PSR-18: HTTP Client - HTTPクライアント
• PSR-19: PHPDoc tags(Draft) - PHPDocタグ

— 原文より抜粋して翻訳 PHP Standards Recommendations) 2020-04-21 現在

PSRワークフロー細則によれば、各PSRには作業中のステータスがあります。提案が参加投票に合格すると、ここに Draft (ドラフト)としてリストされます。 PSRが Accepted (承認)とマークされていない限り、変更される可能性があります。Draft中は大幅に変更される可能性がありますが、レビューにはわずかな変更しかありません。

PSRのワークフローは以下のようなステータスがあります：

1. Pre-Draft(プレドラフト) — 参加投票に合格するとDraftに進みます
2. Draft(ドラフト) — 準備投票に合格するとReviewに進みます
3. Review(レビュー) — 承認投票に合格するとAcceptedに進みます
4. Accepted(承認) — 正式承認され提案(いわゆるPSR勧告となります)

これ以外に次の２つのステータスもあります：

• Deprecated(非推奨) — 承認されが不要になった提案（通常新バージョンに変わった提案）
• Abandoned(放棄) — 積極的な議論がなく放棄されれた提案

PSRワークフロー細則にも記載されているように、提案の1人または複数の Editor (編集者)は、本質的にPSRの主要な寄稿者および作成者であり、2人の投票メンバーによってサポートされています。これらのメンバーの1人が、レビューと投票を管理を担当する Coordinator (コーディネーター)で、もう1人が2人目のsponsor (スポンサー)です。