たみぼうず

システムの仕様を決めるときはできるだけシンプルにするとメンテナンスが楽になります。

細かいところまで気にすれば気にするほど良い、というものではありません。

複雑な仕様はコード量を多くし、かつ、理解を妨げます。

一つのファイルが大きくならないようにすることは可読性の向上に貢献しますが、逆にファイルを分けすぎると良くない場合があります。

これまでに、システムがどのように動くのかを知りたい時に、関数から関数の呼び出しごとに新しいファイ ...

コードは上から下へと読みますが、その時に処理のまとまりが直感的にわかると良いです。

例えば一つの関数の中でも、処理段階によっていくつかに分かれると思います。

そのようなまとまりを表現する際には、空行を挟むと良い ...

新聞のようにコードを書くことで秩序のある書式を保つことができるという論があります。

以下がポイントです。

クラス名や関数名をみればそのファイルが何をするコードが書かれているかがわかる(見出し)
ファイルの上部に ...

納期に間に合わせるために、まずは期待した動きを実現できているか、ということはシステムにとってとても重要なことです。

しかし、たいていのシステムには”必ず”変更が加わります。

今は正しく動 ...

以下のコードは同じnamespace内のExceptionのみをcatchします。

try{//なんらかのExceptionをthrowさせる処理}catch(Exception $e){//例外処理}

すべてのExcept ...

以前種から撒いたひまわりは今は２メートルを超えるほど立派になりました。

しかし、この前強風が吹いた時に、ものすごく勢いでひまわりがしなって折れそうになっていたので、ずっとそばで寄り添っていました。

今後も雨の中 ...

例えば以下のようなコメントがあったとします。

//ここでのurlは、テスト環境では 本番環境では です。

補足のため非常に親切なように見えますが、このような情報をコードに埋め込んでしまうと、いざurlが変わったときにコメン ...

重複がなく、命名も明確でわかりやすい コードを書くことは非常に重要ですが、どのタイミングでそのコードをかけばいいのでしょうか。

できれば、はじめから書けると良いですが、まだシステム全体が把握できていない初期の段階ではこれら ...

try/catchブロック内の処理は、それぞれ関数として抽出すると良いとされています。

try{//　ここに細かい処理を書かかない。関数に抽出してそれを呼び出す calcPrice()}catch(e){//　上記と同様 rep ...