ドキュメントを書くのは時間がかかるし、自分の後に誰も読まないことが多いので、ソースコードに直接コメントを書くのは良い習慣です。しかし、不必要に多くのテキストを使用すると、コードが乱雑になり、同時にモニターに収まらなくなり、また可読性が低下する可能性があります。
したがって、どんなコードも自己説明的であるべきです。つまり、コードを読んだときに、それが何をするのかがすぐにわかり、たった一つのことをするだけであるべきなのです。
例えば、ある関数が getUserProfileById($id)…
コードの秩序を保つためには、名前の由来を明確にルール化することが重要です。このページでは、私や一緒に仕事をしている人たちを含め、多くのプログラマーが使っている比較的一般的なアプローチを紹介します。
開発チームに所属している人は、ぜひそのルールを使ってください。しかし、一般的な開発では、いくつかの良い習慣を確立することが有益です。
PHPの構文全体の概念は本当に広いので、ここでのガイドは専門性の高い多くのカテゴリーに分けました。
手っ取り早く解決したい場合は、PSR…
他のプログラマーが読みやすく、かつエレガントなコードを維持するためには、統一された書式を学ぶ必要があります。スペースとタブの使い分けについて説明します。
コードのインデントにはスペースとタブのどちらがよいのでしょうか？これはしばしば議論の尽きないテーマです。もしあなたが手っ取り早く明確な答えをお探しなら、ほとんどの優秀なプログラマーはタブを使うことを好みますが、うまく分解してみましょう。
空間…
文字列の区切りには、引用符とアポストロフィのどちらかを使用することができます。個人的には、特殊な改行文字やタブでない限り、アポストロフィーだけが好ましいと思います。
その理由はいくつかありますが、建設的に考えて行きましょう。
引用符を使用しない主な理由は、セキュリティとデータ型の不適切な取り扱いです。
文字列の中でHTMLタグを使用する
HTMLコードを文字列で返す必要がある場合、文字列を引用符で囲むと、かなり厄介なエスケープをしなければならなくなります。
return "<…