PHP/Php Framework の変更点

Top / PHP / Php Framework
追加された行はこの色です。
削除された行はこの色です。
PHP/Php Framework へ行く。
PHP/Php Framework の差分を削除
[[PHP]]

「Php Framework」という名前のRuby on Railsを取り入れたPHPのフレームワークに関する補足説明です。
「Php Framework」とは、Ruby on Railsを取り入れたPHPのオープンソース フレームワークです。~
Ruby on Railsの利点を活かしたWebアプリ開発をPHPで活用できるフレームワークです。~



*Php Framework利用によるメリット
+使い慣れたPHPを利用して開発が行え、Smarty・PEARなども簡単に利用可能
+O/Rマッピングによる簡便なデータベースアクセス
+migrationによるデータベース構成のバージョン管理、本番反映が可能
+バックエンドとフロントエンドを容易に開発可能
+開発環境をdevelopment(ローカルPC), test(テストサイトやテスト実行), production(本番サイト)と分けられるので、本番DBに影響を与えず開発可能
+このフレームワークに慣れておくと、Ruby on Railsのプロジェクトも理解しやすくなる



*Php Framework理解と活用のためのステップ
+公式 トップページを参照
+公式 チュートリアルページを参照して、ローカルPCのXAMPP上で動かしてみる
+その際に分かりにくい点は、このページ内の補足で確認
+必要に応じてRuby on Railsも学習して参考とする。



*リンク
-[[[公式]Php Framework トップページ>http://sourceforge.jp/projects/phpfw/wiki/FrontPage]]
-[[[公式]Php Framework チュートリアル>http://sourceforge.jp/projects/phpfw/wiki/setup]]
-[[[公式]Php Framework ActiveRecord>http://sourceforge.jp/projects/phpfw/wiki/record]]



*チュートリアルのローカルPC接続先
フロントエンド~
http://localhost/chiral_fw_sample/samples/application/app/apps_web/frontend/~
~
バックエンド~
http://localhost/chiral_fw_sample/samples/application/app/apps_web/backend/~
~
※パス名は適宜変えてください



*チュートリアル補足：完成後の画面
#ref(PhpFrameworkTutorialFrontendBbsList.gif)
次の構成のデータを入れた、完成後の掲示板リスト画面です。
 タイトル１ bbs本文１
   ├ コメント１
   └ コメント２
 
 タイトル２ bbs本文２
   └ コメント３
----
管理画面のbbs一覧です。
#ref(PhpFrameworkTutorialBackendBbsList.gif)
----
管理画面のcomment一覧です。
#ref(PhpFrameworkTutorialBackendCommentList.gif)



*チュートリアル補足：テーブルの関連性
 bbsテーブル
     id
     subject     ... 掲示内容タイトル
     body        ... 掲示内容本文
     created_at
     updated_at
     'relations' => array(
         'Comment' => 'item',   ... 子供はcommentテーブルです。
                                    親１つに対して子供は複数持てます。
                                    親：子 ＝ １：Ｎの関係です。
     )
     function after_delete() 
     {
         $cnt = $this->delete_items('Comment'); ... 本文を削除したときは、子達のコメントも削除
     }

 commentテーブル
     id
     bbs_id      ... 親(bbs)のidで紐付け
     body        ... コメント本文
     created_at
     updated_at
     'relations' => array(
         'Bbs' => 'header',     ... 親はbbsテーブルです。
                                    子供１つに対して親は１つだけです。
     )



*チュートリアル補足：掲示板リストのビューを書き換えるあたり
 app/apps/frontend/views/bbs/list.html
 
 <h2><?php echo Application_Text::get('TITLE_LIST',
     array('name' => Fw_Record_Config::tablename('Bbs'))); ?></h2>
                 ↑others/texts/Application_Text_Japanese.phpで定義している
                   汎用日本語フォーマットに合わせて"{name}一覧"と表示します。
                   'name'はFw_Record_Config::tablename('Bbs')というテーブル表示名を渡します。
                   テーブル表示名はcommon/models/Bbs.phpで定義します。
 
 <?php echo $this->link(Application_Text::get('LINK_ADD'), array('action' => 'edit')); ?><br />
                   ↑link(表示名, 飛び先)
                     ここでは飛び先に自身と同じコントローラー(bbs)で、edit_actionを渡しています。
 
 <?php $this->output_pager_link($this->pager, $this->pager_params); ?>
              ↑pagerを使用するとき、このように宣言します。
 
 <table border=1>
   <tr>
     <td><?php echo Fw_Record_Config::columnname('Bbs','id');?></td>
     <td><?php echo Fw_Record_Config::columnname('Bbs','subject');?></td>
     <td><?php echo Fw_Record_Config::columnname('Bbs','body');?></td>
     <td><?php echo Fw_Record_Config::columnname('Bbs','created_at');?></td>
     <td><?php echo Fw_Record_Config::columnname('Bbs','updated_at');?></td>
   </tr>
   <?php foreach($this->pager->page_list() as $row){ ?>
         ↑pagerを使用するときのループです。
   <tr>
     <td><?php echo ht($row->id); ?></td>
     <td><?php echo ht($row->subject); ?></td>
     <td><?php echo ht($row->body); ?></td>
     <td><?php echo ht($row->created_at); ?></td>
     <td><?php echo ht($row->updated_at); ?></td>
     <td>
       <?php echo $this->link(Application_Text::get('LINK_EDIT'),
           array('action' => 'edit', 'id' => $row->id())); ?>
                   ↑link(表示名, 飛び先)
                     ここでは飛び先に自身と同じコントローラー(bbs)で、edit_action
                     に加えてidを渡しています。
     </td>
     <td>
       <?php echo $this->link(Application_Text::get('LINK_DELETE'),
           array('action' => 'delete', 'id' => $row->id()),
           array('confirm' => Application_Text::get('CONFIRM_DELETE'))); ?>
                          ↑link(表示名, 飛び先, 削除確認ダイアログ)
     </td>
   </tr>
   <tr>
     <td colspan="7">
 
       <h3><?php echo Application_Text::get('TITLE_LIST',
           array('name' => Fw_Record_Config::tablename('Comment'))); ?></h3>
 
       <?php echo $this->link(Application_Text::get('LINK_ADD'),
           array('controller' => 'comment', 'action' => 'edit', 'bbs_id' => $row->id())); ?><br />
                      ↑link(表示名, 飛び先)
                        飛び先はcontroller, action, パラメータを設定します。
                        パラメータはコントローラ側で$_REQUEST['bbs_id']とすると取得できます。
                            if (isset($_REQUEST['bbs_id']) && $_REQUEST['bbs_id']) {
                                $this->comment->bbs_id = $_REQUEST['bbs_id'];
                            }
 
       <table border=1>
         <tr>
           <td><?php echo Fw_Record_Config::columnname('Comment','id');?></td>
           <td><?php echo Fw_Record_Config::columnname('Comment','body');?></td>
           <td><?php echo Fw_Record_Config::columnname('Comment','created_at');?></td>
           <td><?php echo Fw_Record_Config::columnname('Comment','updated_at');?></td>
                          ↑それぞれフィールド表示名を出力します。
                            定義場所はcommon/models/Comment.phpの次の通りです。
 Fw_Record_Config::set('Comment', array(
     'tablename' => 'comment',         ... テーブル表示名
     'columnnames' => array(
         'id' => 'id',                 ... フィールド表示名
         'bbs_id' => 'bbs_id',         ... 〃
         'body' => 'body',             ... 〃
         'created_at' => 'created_at' ,... 〃
         'updated_at' => 'updated_at' ,... 〃
     ),
     'relations' => array(
         'Bbs' => 'header',
     ),
 
         </tr>
         <?php foreach($row->r('Comment')->findall(array('order' => 'id')) as $row_comment){ ?>
                ↑親オブジェクトが持っているすべての子をforeachでループさせるこの表記法はそのまま覚えましょう。
 
         <tr>
           <td><?php echo ht($row_comment->id); ?></td>
           <td><?php echo ht($row_comment->body); ?></td>
           <td><?php echo ht($row_comment->created_at); ?></td>
           <td><?php echo ht($row_comment->updated_at); ?></td>
           <td>
             <?php echo $this->link(Application_Text::get('LINK_EDIT'),
                 array('controller' => 'comment', 'action' => 'edit', 'id' => $row_comment->id())); ?>
           </td>
           <td>
             <?php echo $this->link(Application_Text::get('LINK_DELETE'),
                 array('controller' => 'comment', 'action' => 'delete', 'id' => $row_comment->id()),
                 array('confirm' => Application_Text::get('CONFIRM_DELETE'))); ?>
           </td>
         </tr>
         <?php } ?>
       </table>
     </td>
   </tr>
 
 
   <?php } ?>
 </table>



*チュートリアル補足：管理画面トップのビューを書き換えるあたり
書き換え後の管理画面トップ
#ref(PhpFrameworkTutorialBackendTop.gif)
 app/apps/backend/views/_layouts/application.html
 
 <html>
 <head>
 <?php echo $this->get('_common/head.html'); ?>
       ↑インクルードはこのように記述します。
         １個上のディレクトリがベースです。
 </head>
 <body>
   <h1>Sample Application Backend</h1>
 
   <div style="background-color: #aa9999;">
 <?php if(Application_Util::get_auth()->is_login()){?>
   Login ID: <?php echo h(Application_Util::get_auth()->info()->loginid); ?>
 <?php }?>
   </div>
   ↑ログインしているときはログインIDを表示
 
   ↓ログインしているときはログアウト画面へのリンクを表示
 <?php if(Application_Util::get_auth()->is_login()){?>
   <div style="background-color: #cccccc;">
     <?php echo $this->link_dynamic(
         'Logout',
         array('controller' => 'auth', 'action' => 'logout',),
         array('class' => 'link_dynamic_link'),
         array('class' => 'link_dynamic_font')); ?> 
         ↑$this->link_dynamic()を用いるとサイト内絶対パスのリンクが作られます。引数は、
             表示名
             飛び先
             リンクのcssなど属性
             フォントのcssなど属性？ ... 使われていないようです
 
           次のようにブラウザに渡ります。
             <a class="link_dynamic_link"
              href="/chiral_fw_sample/samples/application/app/apps_web/backend/auth/logout/">
              Logout</a> 
 
   </div>
 <?php }?>
 
     <?php echo $this->link_dynamic(
         Fw_Record_Config::tablename('Bbs'),
         array('controller' => 'bbs', 'action' => 'list',),
         array('style' => 'color:#2222bb'),
         array('style' => 'color:#22aa22')); ?>
            ↑次のようにブラウザに渡ります。
               <a style="color:#2222bb"
                href="/chiral_fw_sample/samples/application/app/apps_web/backend/bbs/list/">
                bbs</a>
 
     <?php echo $this->link_dynamic(
         Fw_Record_Config::tablename('Comment'),
         array('controller' => 'comment', 'action' => 'list',),
         array('style' => 'color:#2222bb'),
         array('style' => 'color:#22aa22')); ?>
            ↑次のようにブラウザに渡ります。
                 <a style="color:#2222bb"
                  href="/chiral_fw_sample/samples/application/app/apps_web/backend/comment/list/">
                  comment</a>
 
 <?php if(Fw_Controller_Flash::exists('notice')){?>
 <div class="notice"><?php echo Fw_Controller_Flash::get('notice')?></div>
 <?php }?>
 ↑フレームワークからのNoticeが有れば表示されます。
 
 <div>
   <?php echo $this->contents; ?>
 </div>
 ↑コントローラーで生成した本文です。
 
 <?php
 $trace_string = Fw_Controller_Debug::trace_string();
 echo $trace_string;
 ?>
 ↑
 develop環境でのトレース出力です。
 
 </body>
 </html>



*ビュー記述例
**Ruby on Railsテンプレート例(拡張子は.rhtml)
 <% Rubyプログラム %>
 <%= タグを出力するRubyプログラム %>
 <%=h 本文を出力するRubyプログラム %>

**Php Framework通常テンプレート例(拡張子は.html)
 <?php PHPプログラム; ?>
 <?php echo タグPHP文字列; ?>
 <?php echo ht(本文PHP文字列); ?>

&lt;?php echo タグPHP文字列; ?&gt;で「タグPHP文字列」によく書かれるフレーズ
|記述内容|記述例|
|membersテーブルのuidフィールド表示名|Fw_Record_Config::columnname('Member','uid')|
|マッピングされたmemberオブジェクトのuidフィールド値をhtmlエスケープした値|ht($this->member->uid)|
|表示名配列career_hashを参照して表示|$this->career_hash[ $this->member->career_id ]|
|memberオブジェクトnameフィールドに入力するテキストボックス(幅50)|$this->record("textbox", "member", "name", array('size' => '50')|
|memberオブジェクトannounceフィールドに入力するテキストエリア|$this->record("textarea", "member", "announce", array('rows' => '20', 'cols' => '50'))|
|memberオブジェクトnameフィールドに入力する選択|$this->record("select", "member", "sex", $this->SEX_HASH, array(), array('include_blank' => true))|
|モデルにマッピングされていないテキストボックス コントローラからは$_REQUEST['point_up_down']で参照|$this->textbox("point_up_down", "", array('size' => '20', 'style' => 'text-align:right'))|

**Php Framework Smartyテンプレート例(拡張子は.tpl)
 { * コメント *}
 { Smartyの制御文 }
 { include file="info/_type_detail_`$content_type_id`.tpl" }