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