PHP/Php Framework

Last-modified: 2018-11-14 (水) 15:23:56 (2153d)

Top / PHP / Php Framework

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も学習して参考とする。

↑

リンク

↑

チュートリアルのローカルPC接続先

フロントエンド
http://localhost/chiral_fw_sample/samples/application/app/apps_web/frontend/

バックエンド
http://localhost/chiral_fw_sample/samples/application/app/apps_web/backend/

※パス名は適宜変えてください

↑

チュートリアル補足：完成後の画面

次の構成のデータを入れた、完成後の掲示板リスト画面です。

タイトル１ bbs本文１
  ├ コメント１
  └ コメント２

タイトル２ bbs本文２
  └ コメント３

管理画面のbbs一覧です。

管理画面のcomment一覧です。

↑

チュートリアル補足：テーブルの関連性

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>

↑

チュートリアル補足：管理画面トップのビューを書き換えるあたり

書き換え後の管理画面トップ

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文字列); ?>

<?php echo タグPHP文字列; ?>で「タグ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" }

添付ファイル:

PhpFrameworkTutorialBackendBbsList.gif 708件 [詳細]

PhpFrameworkTutorialBackendCommentList.gif 794件 [詳細]

PhpFrameworkTutorialBackendTop.gif 644件 [詳細]

PhpFrameworkTutorialFrontendBbsList.gif 677件 [詳細]