Symfonyマニュアル

14日目: フィード

昨日、あなたは自身の symfony アプリケーションの開発を始めました。今やめないでください。symfony をさらに学ぶにつれて、アプリケーションに新しい機能を追加したり、どこかでそれをホストしたり、コミュニティと共有しようとしてください。

今日からまったく違うことをします。求人情報を探している場合、新しいものが投稿されるとすぐに知らせてくれることが望ましいでしょう。1時間ごとに Web サイトを確認するのはあまり便利ではないので、Jobeet のユーザーに最新情報を提供するために求人情報のフィードを追加します。

フォーマット

symfony フレームワークはフォーマットと mime-yype を標準サポートします。これは同じ Model と Controller がリクエストされたフォーマットに基づいて異なるテンプレートを持てることを意味します。デフォルトのフォーマットは HTML ですが、txt、js、css、json、xml、rdf もしくは atom のように、symfony は~くつかのフォーマットをそのまま使えます。

フォーマットは request オブジェクトの setRequestFormat() メソッドを使って設定できます:

[php]
$request->setRequestFormat('xml');

しかし、たいていの場合、フォーマットは URL に埋め込まれます。このケースでは、特別な変数の sf_format が対応するルートで使われる場合、symfony が設定します。求人リストでは、リストの URL は次の通りです:

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

この URL は次の内容と同等です:

http://www.jobeet.com.localhost/frontend_dev.php/job.html

両方の URL は同等です。sfPropelRouteCollection クラスによって生成されたルートは拡張子として sf_format を持ち、html はデフォルトのフォーマットだからです。app:routes タスクを実行すれば自身で確認できます: 両方の URL は同等です。sfDoctrineRouteCollection クラスによって生成されたルートは拡張子として sf_format を持ち、html はデフォルトのフォーマットだからです。app:routes タスクを実行すれば自身で確認できます:

Cli

フィード

最新の求人フィード

異なるフォーマットをサポートすることは異なるテンプレートを作ることと同じくらい簡単です。最新の求人用に Atom フィードを作るには、indexSuccess.atom.php テンプレートを作ります:

[php]
<!-- apps/frontend/modules/job/templates/indexSuccess.atom.php -->
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>Jobeet</title>
  <subtitle>Latest Jobs</subtitle>
  <link href="" rel="self"/>
  <link href=""/>
  <updated></updated>
  <author><name>Jobeet</name></author>
  <id>Unique Id</id>

  <entry>
    <title>Job title</title>
    <link href="" />
    <id>Unique id</id>
    <updated></updated>
    <summary>Job description</summary>
    <author><name>Company</name></author>
  </entry>
</feed>

SIDEBAR テンプレートの名前

html は Web アプリケーションでもっとも使われる共通のフォーマットなので、テンプレートの名前から省略できます。indexSuccess.php と indexSuccess.html.php テンプレートは同等で symfony は最初に見つけた方を使います。

なぜデフォルトでテンプレートのサフィックスは Success なのでしょうか？アクションはレンダリングするテンプレートを指定して返すことができます。アクションが何も返さない場合、次のコードと同等です:
[php]
return sfView::SUCCESS; // == 'Success'
サフィックスを変更したい場合、次のように何かを返せば良いだけです:
[php]
return sfView::ERROR; // == 'Error'

return 'Foo';
昨日見たように、テンプレートの名前は setTemplate() メソッドを利用して変更することもできます:
[php]
$this->setTemplate('foo');

デフォルトでは、symfony はフォーマットに従って Content-Type レスポンスを変更します。なお、HTML ではないすべてのフォーマットにはレイアウトは無効です。Atom フィードに関して、symfony は Content-Type を application/atom+xml; charset=utf-8 に変更します。

Jobeet のフッターにおいて、フィードへのリンクを追加します:

[php]
<!-- apps/frontend/templates/layout.php -->
<li class="feed">
  <a href="<?php echo url_for('job', array('sf_format' => 'atom')) ?>">Full feed</a>
</li>

内部 URI は変数として sf_format を使用した求人リストと同じです。

ブラウザがフィードを自動的に検出できるように <link> タグをレイアウトの head セクションに追加します:

[php]
<!-- apps/frontend/templates/layout.php -->
<link rel="alternate" type="application/atom+xml" title="Latest Jobs"
  href="<?php echo url_for('job', array('sf_format' => 'atom'), true) ?>" />

href リンク属性に関して、url_for() ヘルパーの第2引数により絶対 URL が使われます。

Atom テンプレートのヘッダーを次のコードで置き換えます:

[php]
<!-- apps/frontend/modules/job/templates/indexSuccess.atom.php -->
<title>Jobeet</title>
<subtitle>Latest Jobs</subtitle>
<link href="<?php echo url_for('job', array('sf_format' => 'atom'), true) ?>" rel="self"/>
<link href="<?php echo url_for('homepage', true) ?>"/>

getCreatedAt('U')) ?> getLatestPost()->getDateTimeObject('created_at')->format('U')) ?> Jobeet 'atom'), true)) ?>

タイムスタンプを日付として得るための getCreatedAt() の引数として使う U の使い方にご注目ください。タイムスタンプを日付として得るための format() の引数として使う U の使い方にご注目ください。最新の投稿に日付を得るために、getLatestPost() メソッドを作ります:

[php] // lib/model/JobeetJobPeer.php class JobeetJobPeer extends BaseJobeetJobPeer { static public function getLatestPost() { $criteria = new Criteria(); self::addActiveJobsCriteria($criteria);

    return JobeetJobPeer::doSelectOne($criteria);
  }

  // ...
}

[php] // lib/model/doctrine/JobeetJobTable.class.php class JobeetJobTable extends DoctrineTable { public function getLatestPost() { $q = DoctrineQuery::create()->from('JobeetJob j');

    $this->addActiveJobsQuery($q);

    return $q->fetchOne();
  }

  // ...
}

フィードエントリーは次のコードで生成されます:

[php]
<!-- apps/frontend/modules/job/templates/indexSuccess.atom.php -->
<?php use_helper('Text') ?>
<?php foreach ($categories as $category): ?>
  <?php foreach ($category->getActiveJobs(sfConfig::get('app_max_jobs_on_homepage')) as $job): ?>
    <entry>
      <title>
        <?php echo $job->getPosition() ?> (<?php echo $job->getLocation() ?>)
      </title>
      <link href="<?php echo url_for('job_show_user', $job, true) ?>" />
      <id><?php echo sha1($job->getId()) ?></id>

getCreatedAt('U')) ?> getDateTimeObject('created_at')->format('U')) ?>

getLogo()): ?>

         <div>
           <?php echo simple_format_text($job->getDescription()) ?>
         </div>

         <h4>How to apply?</h4>

         <p><?php echo $job->getHowToApply() ?></p>
       </div>
      </summary>
      <author>
        <name><?php echo $job->getCompany() ?></name>
      </author>
    </entry>
  <?php endforeach ?>
<?php endforeach ?>

リクエストオブジェクト ($sf_request) の getHost() メソッドは現在のホストを返します。企業ロゴの絶対パスを作る際に役立ちます。

TIP フィードを作成する際に、curl もしくは wget のようなコマンドラインツールを使えばフィードの実際の内容を見れるのでデバッグが楽になります。

カテゴリの最新求人フィード

Jobeet のゴールの1つはよりターゲットを絞った求人を見つけるための手助けになることです。ですので、それぞれのカテゴリ用のフィードを提供する必要があります。

最初に、異なるフォーマットのサポートを追加するために category ルートを更新しましょう:

[yml]
// apps/frontend/config/routing.yml
category:
  url:     /category/:slug.:sf_format
  class:   sf<propel>Propel</propel><doctrine>Doctrine</doctrine>Route
  param:   { module: category, action: show, sf_format: html }
  options: { model: JobeetCategory, type: object }
  requirements:
    sf_format: (?:html|atom)

これで、category ルートは html と atom フォーマットの両方を理解します。テンプレートのカテゴリフィードへのリンクを更新します:

[php]
<!-- apps/frontend/modules/job/templates/indexSuccess.php -->
<div class="feed">
  <a href="<?php echo url_for('category', array('sf_subject' => $category, 'sf_format' => 'atom')) ?>">Feed</a>
</div>

<!-- apps/frontend/modules/category/templates/showSuccess.php -->
<div class="feed">
  <a href="<?php echo url_for('category', array('sf_subject' => $category, 'sf_format' => 'atom')) ?>">Feed</a>
</div>

最後のステップは showSuccess.atom.php テンプレートを作ることです。しかしこのフィードは求人の一覧も表示するので、_list.atom.php パーシャルを作ることでフィードエントリを生成するコードをリファクタリングできます。html フォーマットのように、パーシャルはフォーマット固有です:

[php]
<!-- apps/frontend/modules/job/templates/_list.atom.php -->
<?php use_helper('Text') ?>

<?php foreach ($jobs as $job): ?>
  <entry>
    <title><?php echo $job->getPosition() ?> (<?php echo $job->getLocation() ?>)</title>
    <link href="<?php echo url_for('job_show_user', $job, true) ?>" />
    <id><?php echo sha1($job->getId()) ?></id>

getCreatedAt('U')) ?> getDateTimeObject('created_at')->format('U')) ?>

getLogo()): ?>

       <div>
         <?php echo simple_format_text($job->getDescription()) ?>
       </div>

       <h4>How to apply?</h4>

       <p><?php echo $job->getHowToApply() ?></p>
     </div>
    </summary>
    <author>
      <name><?php echo $job->getCompany() ?></name>
    </author>
  </entry>
<?php endforeach ?>

求人フィードのテンプレートを単純にするために _list.atom.php パーシャルを使うことができます:

[php]
<!-- apps/frontend/modules/job/templates/indexSuccess.atom.php -->
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>Jobeet</title>
  <subtitle>Latest Jobs</subtitle>
  <link href="<?php echo url_for('job', array('sf_format' => 'atom'), true) ?>" rel="self"/>
  <link href="<?php echo url_for('homepage', true) ?>"/>

getCreatedAt('U')) ?> getLatestPost()->getDateTimeObject('created_at')->format('U')) ?> Jobeet 'atom'), true)) ?>

<?php foreach ($categories as $category): ?>
  <?php include_partial('job/list', array('jobs' => $category->getActiveJobs(sfConfig::get('app_max_jobs_on_homepage')))) ?>
<?php endforeach ?>
</feed>

最後に、showSuccess.atom.php テンプレートを作ります:

[php]
<!-- apps/frontend/modules/category/templates/showSuccess.atom.php -->
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>Jobeet (<?php echo $category ?>)</title>
  <subtitle>Latest Jobs</subtitle>
  <link href="<?php echo url_for('category', array('sf_subject' => $category, 'sf_format' => 'atom'), true) ?>" rel="self" />
  <link href="<?php echo url_for('category', array('sf_subject' => $category), true) ?>" />

getLatestPost()->getCreatedAt('U')) ?> getLatestPost()->getDateTimeObject('created_at')->format('U')) ?> Jobeet $category), true)) ?>

  <?php include_partial('job/list', array('jobs' => $pager->getResults())) ?>
</feed>

メインの求人情報フィードと同じように、カテゴリ用の最新の求人の投稿日付が必要です:

[php]

// lib/model/JobeetCategory.php // lib/model/doctrine/JobeetCategory.class.php class JobeetCategory extends BaseJobeetCategory { public function getLatestPost() { return $this->getActiveJobs(1)->getFirst(); }

  // ...
}

カテゴリフィード

また明日

symfony の多くの機能と同じように、ネイティブのフォーマットサポートによって難なくフィードを Web サイトに追加できます。今日は、求職者のユーザーエクスペリエンスを強化しました。明日は、Web サービスを提供することで求人の投稿者に優れた公開機能を提供する方法を経験することになります。

ORM