CakePHP+Oracleでデータを取り出し表示するまで

#CakePHP #OracleDB

このページでやること

前回は CakePHP v2 から Oracle 11g XE に接続するところまですすめました。

今回は連載の中で作成した、テーブル「t4characters」（table for charactersの略）から値を取り出して、ブラウザ上で表示するまでの内部の流れをお話します。

※CakePHP v2 フレームワークの構造上もっとよい書き方はあるかと思います。そんなご指摘ありましたら、ぜひコメントにて教えていただければと思います。

サンプルプログラムと役割

大規模なWebアプリ開発でよくサーバ側アプりで使われる考え方（＝アーキテクチャ）として、MVC フレームワークという考え方があります。

今回は MVC フレームワークの中身についてお話することはしないのですが、MVC フレームワークの考えに沿った形でサンプルプログラムを作成していきます。

作る PHP ファイル

今回は大きく分けて、以下の役割をもつ PHP ファイルを作成します。

1. Controller（業務ロジックの流れを制御）
1. DBのテーブルから情報を取得するManager（Controllerから再利用可能な、Componentの一つとして実装）
1. Model（t4charactersと紐づく、Entity として作成。DBレコード相当のデータを保持）
1. Layout（画面出力時のレイアウトを担当）
1. View（画面出力を担当）

ご参考程度ですが、 MVC フレームワークにあてはめるとそれぞれ、上の各項目はそれぞれ以下のように相当します。

Model は２番、３番
View は４番、５番
Controller は１番

実際に作ってみる

難しいことはさておき、実際に作っていこうと思います。

Controller の作成

まずは Controller から。どんなことをサーバ側で処理して結果を返すかの流れを制御します。

/app/Controller/TestpageController.php を作成します。

TestpageController.php

<?php
class TestpageController extends AppController {
  public $name = "Testpage";
  public $uses = null;
  public $autoRender = true;
  public $autoLayout = true;
  public $layout="testpage";
  var $components = array('T4charactersMgr');
  function index() {
    $entity = $this->T4charactersMgr->getEntityById(2);
    $this->set('entity' , $entity);
  }
}

Manager の作成

次に、Manager を作成します。この中でデータ操作関連をまとめます。

/app/Controller/Component/T4charactersMgrComponent.php を作成します。

T4charactersMgrComponent.php

<?php
class T4charactersMgrComponent extends Object {
  var $name = "T4charactersMgr";
  function startup($controller){
    $this->controller = $controller;
  }
  function initialize(){}
  function getEntityById( $id ) {
    App::import('Model','T4characters');
    $dbo_T4characters = new T4characters();
    $entity = $dbo_T4characters->find(
       'first'
      ,array('conditions'=>array('id' => $id)));
    return $entity['T4characters'];
  }
}

Model の作成

次にModel を作成します。形だけで中身は適当です。これでもとりあえず動きます。

ファイルとして /app/Model/T4characters.php を作成しましょう。

T4characters.php

<?php
class T4characters extends AppModel {
  var $name = 'T4characters';
  var $validate = array();
}

Layout の作成

次に Layout を作成します。こちらもとりあえずなもの。画面表示するときのテンプレート（ひな形）です。

ファイルは /app/View/Layouts/testpage.ctp として新規作成。

testpage.ctp

<!DOCTYPE html>
<html lang=ja>
<head><title>CakePHP テストページ</title></head>
<body><h1>ヘッダー</h1><hr />
<?php echo $content_for_layout; ?>
<hr /><h1>フッター</h1></body>
</html>

View の作成

最後に View を作成します。

testpage.php

<?php
echo "name=".$entity['name']."<br />";
echo "hp=".$entity['hp']."<br />";

おつかれさまでした。

作成したアプリへのアクセス

これで一通り作成完了。ブラウザからアクセスすると・・

Oracleからデータ取得した画面

このとおり！無事に表示されました。

連載記事のまとめ

当連載記事を通して、Webサーバ、PHPプログラム実行、データベース連携の基本的な Web アプリケーションの流れを理解する助けとなれば、筆者の私もとても嬉しいです。

2021年1月追記

2021年1月現在、CakePHP のバージョン、PHPバージョン、Oracleバージョンもメジャーバージョンが新しくなりましたが、サーバプログラミングの基本的な動きは今も変わらないので、覚えた内容は役立つはず。役立つといいな。

Webアプリの開発環境をイチから作成シリーズ記事

連載内容
その１（Eclipse＆Java SDK7 導入）
その２（Eclipse の Plugin 導入）
その３（Oracle DB 11g XE R2 インストール）
その４（Oracle DB 11g XE R2 疎通確認）
その５（XAMPP インストール）
その６（Apache + PHP + Eclipse連携）
その７（Apache + PHP + Oracle連携）
その８（CakePHP + Oracle連携）
その９（CakePHP + Oracle連携） ←いまココ

ページの更新履歴

更新日	更新内容
2013.10.25	ページ公開
2018.3.17	スマホからレイアウトが崩れて読みにくいので修正。ついでに文章構造もHTML5用に訂正。