web-dev-qa-db-ja.com

PHPのどのコーディング規約に従うべきですか?

SunのJava PHPコードのコード規則)に固執する必要がありますか?

28
Igor Drincic

PHPの場合は、次のことをお勧めします Zendsの提案

ご存知かもしれませんが Zendは最も広く使用されているフレームワークです!

40
prakash

PHP Framework Interop Group によって承認された)のPSR標準の1つに従う必要があります

  • PSR- -標準のファイル、クラス、および名前空間の規則を提供することを目的としています。
  • PSR-1 -共有PHPコード間の高レベルの技術的相互運用性を確保することを目的としています。
  • PSR-2 -コードの標準化を検討しているプロジェクト向けのコーディングスタイルガイドを提供します。
  • PSR- -ロギングライブラリの一般的なインターフェイスについて説明します。 LoggerInterfaceは、ログを8つのRFC5424レベルに書き込むための8つのメソッドを公開します。
  • PSR-4 -ファイルパスからクラスを自動ロードするための仕様について説明します。完全に相互運用可能であり、PSR-0を含む他の自動ロード仕様に加えて使用できます。
49
Justin

更新:人々も使用します [〜#〜] psr [〜#〜] 最近はたくさん


ZendFrameworkとPEAR標準は、ほとんど最も一般的なコーディング規則です。会社が別の規則を採用している場合は、会社の規則に従ってください。規則がまったくないよりはましです。そして、それらは機能するだけです。誰もがそれらに固執する場合。

参照:

基本的に、すべての主要なフレームワークには、ドキュメントのどこかにコーディング規約があります。公式(ただしほとんど不明なIMO)PHPコーディングガイドラインは次の場所にあります。

コーディング規約に照らしてコードを検証する必要がある場合は、 CodeSniffer の使用を検討してください。一部のIDEは、テンプレートによる自動ソースコードフォーマットも提供します。たとえば、Zend StudioにはZFコーディングガイドラインが組み込まれているため、クリックするだけでコードをその規則に合わせてフォーマットできます。

22
Gordon

いくつかのオプションがあります。

Zend: http://framework.zend.com/manual/en/coding-standard.html

梨: http://pear.php.net/manual/en/standards.php

Wordpress: http://codex.wordpress.org/WordPress_Coding_Standards

しかし、prakashが示唆しているように、Zendは良い選択です。

7
Sajid

Gordonが言うように、 Zend およびPEAR標準は効果的な業界標準です。

ただし、会社のコードはこれらよりも前のものである可能性が高いため、コードベースのサイズによっては、これらの1つに移行するために時間を費やしてもほとんど価値がない場合があります。 (とはいえ、静的コード分析ツールを使用したい場合は、これを推進力として使用して、Zendへの移行などを真剣に検討することができます。)

ただし、現実的である限り、彼らが固執する賢明な基準がある限り、ここでは実際の問題はありません。それに応じてコードを「見る」方法を調整することになります。

2
John Parker

どのコーディングスタイルにも長所と短所があります。統合を行う多くのソースからのコードの操作に多くの時間を費やしているため、1日で多くの異なるスタイル(異なる命名規則、中括弧の配置、タブとスペースなど)が表示されることがあります。

私に関する限り、既存のコードを使用している場合に最も重要なことは、編集しているコードのスタイルに従うことです。そうしないと、あなたの後に続く人にとって物事が難しくなります。

あなたが新しいコードを書いているなら、あなたはあなたが最も効率的になる方法でそれをする自由を持っているべきです。

会社のコーディングガイドラインは詳細に説明されていないことが多く、数年後にソフトウェアチームで少し混乱した後、忘れられてしまうことがよくあります;-)

2
Adam

ビジネスをしている場合は、ビジネスコード規則に従ってください。

個人プロジェクトの場合は、特定の言語仕様を取得できます(JavaよりもJava、PHPよりもPhpを実行する場合)。個人プロジェクトの場合は、いくつかの変更を加えることができます。欲望...

オープンソースプロジェクトを行う場合は、すでに実施されているものを確認する必要があります。

2

コーディングスタイルはグループによって異なり、1つのサイズですべてのタイプのものに適合するわけではありません。最も重要なことは、一貫して従い、行き過ぎない基準を持つことです。ルールが多すぎると、不十分な場合と同じくらい悪い場合があります。

以前はK&Rスタイル(2番目)を好みました。 Allmanスタイル(好み)に調整する必要があった後、コードが読みやすくなり、好みが変わったと感じました。

これ ウィキペディアの記事 はまともな出発点です。また、特にPEARコーディング標準へのリンクも含まれています。

1
George Marian

そこには多くの異なるコーディング規約があります。他の人が何を使用しているかを見て(サンプルコードを読んで、何が行われているのかを理解するのがいかに簡単かを確認してください)、選択してください。

重要なのは、1つを選択してそれに固執することです。

1
Treb