FuelBeans 19 : 整形。わっ私、やってませんから

プラグインで、NetBeansに関しては書くこともないし、お休みかなと思いましたが、これをやっておきましょう。整形です。

整形といって、フォーマットの方です。外科手術ではありません。NetBeansは優秀ですが、メスや注射器を持てる手がないのです。残念ながら。

整形はコーディングルールに従って、設定します。とはいえ、NetBeansが、あなたの必要な整形規則を全部フォローしてくれることはないでしょう。最終的には、多少自分で手を加える必要があります。

とはいえ、自分で開発している段階では、自分で見やすいようにすればいいのです。趣味の問題です。会社とか、他の人とか、プロジェクトが絡んだら、最終的にその形に合わせて、整形すればいいのです。外部の整形ツールもありますしね。

NetBeansで整形を利用する場合の注意点は1つだけです。エラーが発生しているときは、整形しないことです。

エラーにもよりますが、構文解析でエラーになっている場合は、構文が間違っており、構文に従って整形することはできません。ですから、悲惨な結果になります。

そんな時は慌てず、コントロール＋Zを押して、整形前に戻し、エラーを修正し、その後に整形し直すことです。

エラー修正してから、整形しても同じですって？いいえ。経験してもらえば分かりますが、コメントの段落づけが、ずれてしまいがちです。

コメントはそれを書く人の趣味や、思惑があり、あるものは前後のインデントに合わせるが、ある者は行頭から書きたいとかあります。ですから、行頭から始めるコメントは、インデントされません。構文が間違っていると、余計な空白が取り除かれた形、つまり、全行が行頭から始まる形態になります。そこでコードを修正し、エラーを取り、整形しても、行頭から始まるコメントは、思った位置にインデントされず、行頭に残ったままになります。

エディターの整形を設定する

では、具体的な設定に移ります。できるだけFuelPHPのコーディングルールに沿った形にしようと思います。

FuelPHP日本語ドキュメント(nekogetさん提供)コーディング規約

この規約どおりには出来ません。FuelPHPの開発メンバーはPhpStromを愛用している人が多いらしく、NetBeansのことは考慮していないようです。（つまり、ほとんどPhpStromの整形パターンです。）

• ツール→オプション→エディター→整形で設定します。なお、ここで設定した内容は全プロジェクトで適用されます。特定のプロジェクトだけ、別の整形パターンを設定したい場合、プロジェクトのプロパティで設定可能です。
• 言語をPHPに切り替えます。タブとインデントを設置します。（7.1ではプレビューが乱れているバグがあります。）
  1. 設定内容は読んだままです。難しいもの、分かりづらいものはありません。唯一、右マージンが慣れていない人には理解しづらいと思います。要は、画面右端、折り返しの桁数です。
  2. FuelPHPの規則に合わせるためには、タブを空白文字に…はオフ、インデント、タブは4を設定します。開始インデントは0、継続インデント、配列宣言のインデントは4を設定します。
  3. 行折り返しはお好みでどうぞ。任意の場所は折り返し時、マウスを使用しての範囲選択が非常に面倒なので、単語のあとをお勧めします。
• カテゴリーを位置揃えに変更します。
  1. 改行は修飾子のあとを除いて、全部チェックを付けます。
  2. グループの複数行の位置揃えは、代入、配列初期化子両方にチェックを付けます。これは、代入文がまとまっているときに、=の位置を揃える、配列の代入時に=>の位置を揃える機能です。新しいオプションで、今のところ完全には揃わないようです。
  3. 複数行の位置揃えは全部チェックを外します。（正直、何をやっているのか、私もわかりません。）
• カテゴリーを中括弧にします。
  1. 全項目を改行に設定します。
• カテゴリーを空行にします。
  1. 上から、1を続けて6回、0、1、0、1、PHPドキュメントを含まないグループフィールドにチェックを入れ、1、0、1、0、1、0、0です。
• カテゴリーを空白にします。
• 1. キーワードの前は全項目チェックを入れます。
  2. 丸括弧の前は、メソッド／関数…の２つはオフ、配列宣言はオフ、それ以外には全部チェックを入れます。
  3. 演算子の周囲は、単項演算子、文字列連結演算子、オブジェクト演算子はオフ、それ以外はチェックを入れます。
  4. 左中括弧の前は、全項目にチェックを入れます。
  5. 丸括弧の内側は、全部チェックを外します。
  6. その他では、コンマの前、セミコロンの前はオフ、それ以外は全項目にチェックを入れます。
• カテゴリーを折り返しにします。
  1. 上から、なし、なし、長い場合、長い場合、常時、常時、なし、常時が４回続き、なしが３回続きます。
  2. ブロックの開く中括弧と閉じる中カッコにはチェックを入れます。
  3. 同じ行の文にはチェックを入れます