PHP関連/Jobeetチュートリアル第４日目(Doctrine版)

Top / PHP関連 / Jobeetチュートリアル第４日目(Doctrine版)

[ トップ ]   [ 編集 | 凍結解除 | 差分 | バックアップ | 添付 | リロード ]   [ 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ ]

Jpbeetチュートリアル第４日目(Doctrine版) †

作成中...

http://www.symfony-project.org/jobeet/1_2/Doctrine/ja/04

この節では、symfonyの2番目のORMであるDoctrineにおける内容を記載しております。

時間の目安 †

第４日目のチュートリアルが完了するまでの目安

3時間～10時間

第4日目は、画面系のMVCモデルの解説とテンプレートの解説になります。
フレームワークの重要な要素であるため、さらっと流さず、じっくりと考えて試したいですね。

MVCモデル †

symfonyは、フロントコントローラタイプのMVCデザインパターンで構成されています。

• モデル(Model) --- ビジネスロジックを定義します。ビジネスロジックとはなんぞや。
  画面の入出力に影響しない業務ロジックに関する部分です。主にデータベースにアクセスしてデータを取ってくる、
  データを加工する、データをチェックするというような業務に密接なロジックの部分になります。
  後述しますが、アクションのロジックは、このモデルのカテゴリーに含まれます。
  
• ビュー(View) --- 画面表示に関わる部分をビューと呼びます。ビューの部分には業務ロジックを含まないようにします。
  (含む実装も出来てしまうので、注意が必要です。)
  
• コントローラー(Controler) -- コントローラは、フレームワークが準備してくれているため、基本いじる必要性はありません。
  アクションと呼ばれる部分も、コントローラの一部と言えるのかも知れないのですが、
  業務ロジックが多く含まれるため、自分はモデルに含まれると考えています。
  
   
  

symfonyの画面表示の方法 †

symfonyの画面表示の方法は、グローバルテンプレートと呼ばれるレイアウトファイル[layout.php]を ページの雛形にして、
ページ個別のテンプレートを組み合わせて、全体のページを作ります。

イメージファイルとcss(カスケードスタイルシート) †

イメージファイルとcss(カスケードスタイルシート)をダウンロードします。
ダウンロードしたファイルを、[web/images/] と [web/css/]ディレクトリに配置します。

デフォルトのテンプレートを置き換える †

デフォルトのテンプレートを置き換えて、以下のURLにアクセスしてみました。

http://jobeet.localhost/frontend_dev.php/job

カスケードスタイルシート(CSS)の読み出し †

カスケードスタイルシート(CSS)は、[<?php include_stylesheets() ?>]の部分で読み出されます。
このメソッドは、デフォルトでViewレイヤーのアプリケーション設定ファイルである[view.yml]の設定により、読み出します。
デフォルトのview.ymlは以下のようになっています。

default:
  http_metas:
    content-type: text/html

  metas:
    #title:        symfony project
    #description:  symfony project
    #keywords:     symfony, project
    #language:     en
    #robots:       index, follow

  stylesheets:    [main.css]

  javascripts:    []

  has_layout:     on
  layout:         layout

CSSの読み出しは、以下のように階層化されています。

1. デフォルトの設定は、フレームワークの設定が使用される。
2. 次の階層は、プロジェクト階層の設定で、config/ のディレクトリにあるview.yml が参照される。
3. 次の階層は、アプリケーション階層の設定で、apps/APP/config/ のディレクトリにあるview.ymlが参照される。
4. モジュール階層の設定は、apps/APP/modules/MODULE/config/ のディレクトリにあるview.ymlが参照される。

view.ymlからCSSファイルを読み出さない設定 †

下記のような設定をすれば、テンプレートからスタイルシートを読み出すことができます。

<?php use_stylesheet('main.css') ?>

JavaScript †

JavaScriptも同様で、テンプレート内から

<?php use_javascript(’test.js') ?>

のように設定すれば、テンプレートからJavaScriptを読み出すことができます。
もちろん、yml設定ファイルから読み出すことも可能です。

アクション †

アクションは、クラスメソッドで表されます。
自動で作成された [/apps/frontend/modules/job/actions/actions.class.php]を見てみます。

class jobActions extends sfActions
{
  public function executeIndex(sfWebRequest $request)
  {
    $this->jobeet_job_list = JobeetJobPeer::doSelect(new Criteria());
  }
   : (省略)

executeIndexメソッドは、JobeetJobPeerモデルクラスのdoSelectメソッドを呼び出して、jobeet_job_listという名の配列を取得します。
つまり、Jobeet_jobを単純にSELECTした結果をjobeet_job_listという名の配列として取り出すわけですね。

doSelect()メソッドの実体は、jobeet/lib/model/om/BaseJobeetJobPeer.phpに、
public static function doSelect(Criteria $criteria, PropelPDO $con = null)として定義されています。

new Criteria()は、ある意味呪文的なものとして考えました。なぜなら、引数が要求しているから。

jobeet_job_listは、どこに定義されているのでしょうか。
grepで探してみたら、jobeet/apps/frontend/modules/job/templates/indexSuccess.php に定義されていました。

[jobeet_job_list]は、jobeet_jobエンティティのSELECTした結果が格納されています。

jobeet/apps/frontend/modules/job/templates/indexSuccess.php は、Viewクラスにカテゴライズされているので、
チュートリアルでは、「自動的にテンプレート(View)に渡されます。」と書かれているのだと思います。

Properlが作るモデルを理解しないと、ぱっとは理解できませんね。

コントローラからビューにデータを渡す †

自動的にコントローラからビューにデータを渡している内容以外に、データを渡したい場合、以下のように コントローラ(アクション)にプロパティを追加します。

public function executeFooBar(sfWebRequest $request)
{
  $this->foo = 'bar';
  $this->bar = array('bar', 'baz');
}

テンプレート †

テンプレートは、Viewにカテゴライズされる部分です。
自動的に作成される[jobeet/apps/frontend/modules/job/templates/indexSuccess.php]は、次のとおりになります。

<h1>Job List</h1>

<table>
  <thead>
    <tr>
      <th>Id</th>
      <th>Category</th>
      <th>Type</th>
      <th>Company</th>
      <th>Logo</th>
      <th>Url</th>
      <th>Position</th>
      <th>Location</th>
      <th>Description</th>
      <th>How to apply</th>
      <th>Token</th>
      <th>Is public</th>
      <th>Is activated</th>
      <th>Email</th>
      <th>Expires at</th>
      <th>Created at</th>
      <th>Updated at</th>
    </tr>
  </thead>
  <tbody>
    <?php foreach ($jobeet_job_list as $jobeet_job): ?>
    <tr>
      <td><a href="<?php echo url_for('job/show?id='.$jobeet_job->getId()) ?>"><?php echo $jobeet_job->getId() ?></a></td>
      <td><?php echo $jobeet_job->getCategoryId() ?></td>
      <td><?php echo $jobeet_job->getType() ?></td>
      <td><?php echo $jobeet_job->getCompany() ?></td>
      <td><?php echo $jobeet_job->getLogo() ?></td>
      <td><?php echo $jobeet_job->getUrl() ?></td>
      <td><?php echo $jobeet_job->getPosition() ?></td>
      <td><?php echo $jobeet_job->getLocation() ?></td>
      <td><?php echo $jobeet_job->getDescription() ?></td>
      <td><?php echo $jobeet_job->getHowToApply() ?></td>
      <td><?php echo $jobeet_job->getToken() ?></td>
      <td><?php echo $jobeet_job->getIsPublic() ?></td>
      <td><?php echo $jobeet_job->getIsActivated() ?></td>
      <td><?php echo $jobeet_job->getEmail() ?></td>
      <td><?php echo $jobeet_job->getExpiresAt() ?></td>
      <td><?php echo $jobeet_job->getCreatedAt() ?></td>
      <td><?php echo $jobeet_job->getUpdatedAt() ?></td>
    </tr>
    <?php endforeach; ?>
  </tbody>
</table>

<a href="<?php echo url_for('job/new') ?>">New</a>

このままだと、余計な部分も表示されしまっているので、それを削るのと同時に、若干見た目を変えて見ましょう。

[jobeet/apps/frontend/modules/job/templates/indexSuccess.php]を以下のように変更します。

<?php use_stylesheet('jobs.css') ?>
 
<div id="jobs">
  <table class="jobs">
    <?php foreach ($jobeet_job_list as $i => $job): ?>
      <tr class="<?php echo fmod($i, 2) ? 'even' : 'odd' ?>">
        <td class="location"><?php echo $job->getLocation() ?></td>
        <td class="position">
          <a href="<?php echo url_for('job/show?id='.$job->getId()) ?>">
            <?php echo $job->getPosition() ?>
          </a>
        </td>
        <td class="company"><?php echo $job->getCompany() ?></td>
      </tr>
    <?php endforeach; ?>
  </table>
</div>

修正を確認してみる †

以下のURLにアクセスしてみます。

http://jobeet.localhost/frontend_dev.php/job

見た目が大きく変わりました。

jobeet_job_listに、JOBEET_JOBスキーマの読み出し結果が入っています。
$jobに１レコードが入ります。
even と oddで、CSSクラスを変えることによりスプレッドを見やすくしています。
getLocation()とgetPosition()とgetCompany()により、就業場所、業務、企業名のみ表示するようになっています。

詳細画面をカスタマイズする †

[showSuccess.php]を以下のように修正します。

<?php use_stylesheet('job.css') ?>
<?php use_helper('Text') ?>
 
<div id="job">
  <h1><?php echo $job->getCompany() ?></h1>
  <h2><?php echo $job->getLocation() ?></h2>
  <h3>
    <?php echo $job->getPosition() ?>
    <small> - <?php echo $job->getType() ?></small>
  </h3>
 
  <?php if ($job->getLogo()): ?>
    <div class="logo">
      <a href="<?php echo $job->getUrl() ?>">
        <img src="/uploads/jobs/<?php echo $job->getLogo() ?>"
          alt="<?php echo $job->getCompany() ?> logo" />
      </a>
    </div>
  <?php endif; ?>
 
  <div class="description">
    <?php echo simple_format_text($job->getDescription()) ?>
  </div>
 
  <h4>How to apply?</h4>
 
  <p class="how_to_apply"><?php echo $job->getHowToApply() ?></p>
 
  <div class="meta">
    <small>posted on <?php echo $job->getCreatedAt('m/d/Y') ?></small>
  </div>
 
  <div style="padding: 20px 0">
    <a href="<?php echo url_for('job/edit?id='.$job->getId()) ?>">
      Edit
    </a>
  </div>
</div>

次に、アクションクラスの[executeShow]メソッドを以下のように書き換えます。

public function executeShow(sfWebRequest $request)
{
  $this->job = JobeetJobPeer::retrieveByPk($request->getParameter('id'));
  $this->forward404Unless($this->job);
}

修正を確認してみる †

修正を確認してみます。
以下のURLにアクセスしてみます。

http://jobeet.localhost/frontend_dev.php/job

かっこよく変わりました。

スロット †

レイアウトのほかで、固定的に表示したいコンテンツがある場合、スロットを使用します。

動的にタイトルを変更するために、スロットを追加します。

<title>
  <?php if (!include_slot('title')): ?>
    Jobeet - Your best job board
  <?php endif; ?>
</title>

レイアウトPHPに、スロット埋め込み用のコードを埋め込みます。
また、テンプレートの部分に、スロットヘルパーを定義します。

<?php slot('title') ?>
  <?php echo sprintf('%s is looking for a %s', $job->getCompany(), $job->getPosition()) ?>
<?php end_slot(); ?>

2010-07-09

• Salesforce関連/Workbook チュートリアル3
• Salesforce関連
• Salesforce関連/Workbook チュートリアル2

2010-07-08

• Salesforce関連/Mileage Trackerコンポーネントの削除
• Salesforce関連/Workbook チュートリアル1

2010-07-07

• Salesforce関連/Work

2010-06-29

• Salesforce関連/Metadata
• Salesforce関連/Web Services APIs(2)
• Salesforce関連/Apex APIs

2010-06-28

• DB関連/Oracle開発者ライセンス

• Java関連/Eclipse(x64)のダウンロード(9002)
• DB関連/OracleClientのダウンロード(Windows)(5522)
• DB関連/DBコーディング規約/DBネーミング規約(5487)
• Java関連/Javaコーディング規約/Javaネーミング規約(5451)
• DB関連/テーブル定義書(4913)
• DB関連/Oracle 11g R2のダウンロードとインストール(Linux版)その３(4886)
• DB関連/Oracle 11g R2のダウンロードとインストール(Linux版)その１(4783)
• 標準化/設計ドキュメントテンプレート(4606)
• DB関連(4444)
• Java関連(4317)
• Linux関連/TeraTermのダウンロードとインストール(3999)
• Java関連/Javaコーディング規約(3839)
• DB関連/Oracle 11g R2のダウンロードとインストール(Linux版)その２(3663)
• Java関連/SJC-WC(3594)
• DB関連/Oracle JDBCドライバーのダウンロードとインストール(Windows)(3536)
• DB関連/Oracle 11g R2のダウンロードとインストール(Linux版)その４(3287)
• DB関連/MySQL-JDBCドライバーのダウンロードとインストール(3111)
• Java関連/Eclipse(x64)-WTPのインストール(3051)
• 標準化/ドキュメントの種類(3047)
• Subversion関連/SVNサーバーのダウンロード(2874)

       

Last-modified: 2009-07-31 (金) 09:35:53 (403d)

Web Master: anonymous

PukiWiki 1.4.7 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL.
Based on "PukiWiki" 1.3 by yu-ji. Powered by PHP 5.2.11. HTML convert time: 0.116 sec. skin simple3 by hirokasa with Google Analytics.