FuelBeans 4 : ヘロー、わーるど

では定番のhello worldを表示してみましょう。NetBeansの使い方にも慣れていきます。

とりあえず、タスクやら何やら、色々表示されていると思いますが、そのままにしておきましょう。(IDEに慣れている方は、どうぞ消してください）

新しいphpコードを書き、実行してみましょう。

1. 左側、プロジェクトのタブを選んでください。fuelphpがあると思います。これがプロフェクト名でしたね。＋をクリックするか、名前をダブルクリックすると、ツリーが展開されます。
2. ソースファイルとインクルードパスが存在しています。ソースファイルはphpfuelフォルダー下のファイル構成そのものです。+をクリックするか、名前をダブルクリックし、展開してください。（唯一、表示されないのは、NetBeansがプロジェクトの管理に利用する、nbprojectという名前のフォルダーです。これはプロジェクトの横のファイルタブで表示されるツリーの中では表示されます。）
3. docs、fuel、publicが見えると思います。では、手始めにdocsフォルダーを消してしまいましょう。英語のドキュメントが入っていますが、最新ではありません。日本語版は、nekogetさんが公開してくれているFuelPHP日本語ドキュメントで、現在一部が翻訳されています。翻訳されていない部分は英語ですが、ほぼ最新版にアップデートされています。では、docsを右クリックし、削除を選んでください。確認ウィンドウがでますから、「はい」ボタンをクリックしましょう。
4. fuelフォルダーが、いわゆるプログラム・コードが存在する場所です。publicフォルダーはwebブラウザからアクセスするフォルダーです。この２つの名前も場所も決め打ちではありません。実際に、実用段階でWebアプリとして公開する場合は、セキュリティー上変更するか移動すべきです。今は、開発の練習段階です。このままにしておきましょう。
5. fuelフォルダーを展開してください。app、core、packageの３つがあります。appは自分の開発コードを入れる場所で、自由にファイルを付け足したり、削除したりできます。coreはFuelPHPフレームワーク本体です。フレームワークとして動作するために必要なプログラムコードが入っています。この内容を変更するのは止めましょう。（もちろん、変更してもかまいませんが、不具合などが出た場合、いじってしまえば、質問しても誰も答えられません。）packageはある機能を実現するための用意されたプログラムの集まりです。ライブラリーと行っても良いでしょう。これは自分で作成することも出来ますし、他の人が作成したものをコピーして利用することも出来ます。
6. では、appフォルダーを展開してください。たくさんフォルダーが存在しています。簡単に説明しましょう
   • cache：キャシュ機能を利用した時のキャッシュ先。
   • classes：自分で書くコードはほとんどここに書くことになるフォルダー。クラスのオートロードの対象フォルダー。
   • config：設定ファイルのためのフォルダー。
   • lang：多言語対応のためのフォルダー。多言語に対応しない場合であっても、メッセージのハードコードを避けるために、利用すべき。
   • logs：FuelPHPがフレームワークとして利用する、ログの保存フォルダー。
   • migrations：コマンドラインでDB構造を変更した時のコードが保存されるフォルダー。
   • modules：HMVC構造を利用する場合のフォルダー。
   • tasks：FuelPHPのコマンドラインの起動ヘルパーであるoilを利用して起動できるコードを保存するフォルダー。
   • tmp：その名のとおり、一時使用ファイルを保存するフォルダー。
   • vendor：FuelPHP以外のパッケージだとか、オープンソースのコードだとかを利用するためのフォルダー。
   • views：FuelPHPで利用するビューを設置するフォルダー。
7. classesを開いてください。その中にいわゆるMVCのためのフォルダーが存在しています。controllerはコントローラーを保存するフォルダーです。Modelはモデルを保存するフォルダーです。viewはビュー自体を保存するフォルダーではありません。気をつけてください。最初は戸惑うと思います。ビュー自体は通常、クラスではありませんから、classesの下にはなく、classesと同じ階層のviews（複数形）のフォルダーに入れます。このviewフォルダーはビューとモデルとの仲立ちをするクラス(ビューモデル）を入れるためのフォルダーです。
8. ではcontrollerを開いてください。welcome.phpが存在します。これが、現在publicフォルダーへアクセスしているときに、表示されているページのコントローラーです。これとは別に、新しいコントローラークラスを定義して「ヘロー世界」を表示しましょう。controllerを右クリックし、新規→PHPファイルを選びます。
9. ファイル名にはhelloworldと指定してください。.phpは付ける必要はありません。自動的に付けられます。ファイル名にhelloは避けてください。（詳しい話は後回しにしますが、デフォルトのルーティングでhelloが既に定義されてしまっているがために、トラブります。）では、完了をクリックしてください。
10. エディターにphpのテンプレートファイルが表示されます。<?phpで始まり、コメントが続き、最後が?>で終わっています。左側のプロジェクトで、controller下にhelloworld.phpが作成されているのを確認してください。
11. コードを書きます。まずはビューを使わず、echoで表示してみましょう。

<?php

class Controller_Helloworld extends Controller {
    
    function action_index() {
        echo 'hello world';
    }
}

12. ファイル名はhellowroldでした。FuelPHPのファイル名は小文字統一です。アンダーバーを使いません。クラス名はclassesフォルダー以下のディレクトリー構造に従って決定します。コントローラーはcontrollerフォルダーの下ですから、クラス名はControllerで始まります。アンダーバーがフォルダーの階層です。controllerフォルダーの下のhelloworldファイルですからController_Helloworldクラスになります。頭の一文字を大文字にします。FuelPHPの数少ない規約の部分です。これは、PHP5.3から導入された、クラスのオートロードの仕組みに関連しています。クラス名とそのクラスの含まれているファイル位置を対応させることで、クラスをinclude/requireで読み込まなくても、自動的に読み込む仕組みを実現するためのものです。FuelPHPはこのオートロードのために、ファイルとクラスの命名規則が指定されています。
13. 拡張しているControllerクラスはコアに含まれています。コントローラーは直接もしくは、間接的にこのクラスを拡張します。
14. では実行しましょう。IDEの緑の右三角、実行アイコンをクリックしましょう。ブラウザには、FuelPHPのウェルカムページが表示されます。では、ブラウザのURLの最後に/helloworldを付けてクリックしましょう。hello worldが表示されます。
15. IDEに戻り、fuelphpを右クリック、プロパティを選んでください。
16. 左側で「実行環境」をクリックしてください。右側にプロジェクトを作成した時とほぼ同じ、設定内容が表示されます。プロジェクトURLに/helloworldをつけ、了解をクリックしてください。
17. IDEから実行アイコンをクリックしましょう。今度は、直接hello worldが表示されます。このようにFuelPHPで実行するためには、ブラウザのURLを変更する方法と、IDEの実行URLを変更する方法があります。数回試す程度であれば、ブラウザのURLを書き換え、何十回も繰り返し、ソース変更と実行を繰り返すような場合なら、実行環境を書き換えるなど、上手く使いこなしましょう。また、URLを一度書き換え、ブラウザで毎回リロードする方法もあります。色々なURLを切り替えて試す必要があるのなら、実行環境の新規ボタンで、環境自体を何パターンも定義し、切り替えてながら実行する方法もあります。そこら辺はおいおい、やって行きましょう。