ビュー¶

別の echo¶

テンプレート中の変数を echo または print します。

<?php echo $variable; ?>

短いタグにも対応しています。

<?= $variable ?>

別の制御構文¶

if 、 for 、 foreach 、 switch 、そして while のような制御構文は単純な形式で書くことができます。括弧は必要ないことに注意してください。 代わりに、 foreach の閉じ括弧は endforeach に置き換えられています。 上記の各制御構造は endif 、 endfor 、 endforeach 、 endwhile のような閉じ構文を持っています。各制御構造の後（最後の一つを除いて）に セミコロン (;) ではなく、 コロン (:) があることにも注意してください。

以下は foreach の使用例です。

<ul>
<?php foreach ($todo as $item): ?>
  <li><?= $item ?></li>
<?php endforeach; ?>
</ul>

別の例として、 if/elseif/else の用法です。コロンに注意してください。

<?php if ($username === 'sally'): ?>
   <h3>やあ、Sally</h3>
<?php elseif ($username === 'joe'): ?>
   <h3>やあ、Joe</h3>
<?php else: ?>
   <h3>やあ、知らない人</h3>
<?php endif; ?>

もしも、 Twig のようなテンプレート言語を使いたいのであれば、 ビューのサブクラスがテンプレート言語と CakePHP の橋渡しをしてくれるでしょう。

テンプレートファイルは /src/Template/ の中の、ファイルを使用するコントローラーにちなんで 名付けられたフォルダーに置かれ、その対応するアクション名にちなんで名付けられます。 例えば、 Products コントローラーの view() アクションのビューファイルは通常、 /src/Template/Products/view.ctp となります。

CakePHP のビューレイヤーはいくつかの異なるパーツによって作り上げられています。 各パーツは異なる役割を持っており、この章で説明していきます。

• テンプレート: テンプレートは実行中のアクション固有のページの一部分です。 アプリケーションの応答の中心となります。

• エレメント: 小さな、再利用可能なちょっとしたコードです。エレメントは通常、 ビューの中で描画されます。

• レイアウト: アプリケーションの多くのインターフェイスをくるむ表示コードを入れる テンプレートファイルです。ほとんどのビューはレイアウトの中に描画されます。

• ヘルパー: これらのクラスはビューレイヤーの様々な場所で必要とされるロジックを カプセル化します。とりわけ、CakePHP のヘルパーはフォームの構築や AJAX 機能の構築、 モデルデータのページ切替、RSS フィードの提供などの手助けをしてくれます。

• cells: これらのクラスは、自己完結型のUI部品を作成する 小さなコントローラー風の機能を提供します。 より詳しい情報は ビューセル を参照してください。

ビュー変数¶

コントローラーの中で set() で設定した変数は、 アクションが描画するビューやレイアウトの双方で使用可能です。 加えて、設定した変数はエレメントの中でも使用可能です。 もしも、追加の変数をビューからレイアウトに渡す必要があれば、 ビューテンプレートの中から set() を呼ぶか、 ビューブロックの使用 が利用できます。

CakePHP は自動では出力をエスケープしませんので、ユーザーデータを出力する前には いつも エスケープしなければならないことを覚えておいてください。 h() 関数でユーザーコンテンツをエスケープできます。

<?= h($user->bio); ?>

ビュー変数の設定¶

Cake\View\View::set(string $var, mixed $value)¶

ビューにはコントローラーオブジェクトの set() と類似の set() メソッドがあります。 ビューファイルから set() を使うと後で描画されるレイアウトやエレメントに変数を追加できます。 set() の使い方のより詳しい情報は ビュー変数の設定 を参照してください。

ビューファイルでは、次のように記述できます。

$this->set('activeMenuButton', 'posts');

そしてレイアウトでは、 $activeMenuButton 変数が使用でき、 'posts' という値を持ちます。

ビューの継承¶

ビューの継承によって、あるビューを他のビューでくるむことができるようになります。 ビューブロック と組み合わせることでビューを DRY に保つための 強力な方法が得られます。例えば、あなたが作成しているアプリケーションの特定のビューで、 サイドバーの描画を変える必要があるとします。共通のビューファイルを継承することで、 サイドバーのマークアップの繰り返しを避けられ、そしてただ変化する場所を定義するだけです。

<!-- src/Template/Common/view.ctp -->
<h1><?= $this->fetch('title') ?></h1>
<?= $this->fetch('content') ?>

<div class="actions">
    <h3>関連アクション</h3>
    <ul>
    <?= $this->fetch('sidebar') ?>
    </ul>
</div>

上記のビューファイルを親ビューとして使うことができます。これは sidebar と title ブロックを定義しているビューが継承することを期待しています。 content ブロックは CakePHP が作る特別なブロックで、継承しているビューの捕捉されなかったすべての内容が入ります。 ビューファイルに投稿のデータが格納されている $post という変数があるとすれば、 ビューは次のようになります。

<!-- src/Template/Posts/view.ctp -->
<?php
$this->extend('/Common/view');

$this->assign('title', $post->title);

$this->start('sidebar');
?>
<li>
<?php
echo $this->Html->link('edit', [
    'action' => 'edit',
    $post->id
]);
?>
</li>
<?php $this->end(); ?>

// 残りの内容は親ビューの 'content' ブロックとして使用可能です。
<?= h($post->body) ?>

上記の例はどのようにビューを継承できるかを示しており、ブロック一式を生成しています。 定義されたブロックの中に入っていないあらゆるコンテンツは捕捉され、 content という特別な名前のブロックに配置されます。ビューに extend() の呼び出しがある場合、 現在のビューファイルは最後まで実行されます。実行完了後、継承されたビューが描画されます。 一つのビューファイルで二回以上 extend() が呼び出される場合、 次に処理される親ビューを上書きします。

$this->extend('/Common/view');
$this->extend('/Common/index');

上記は /Common/index.ctp が現在のビューの親ビューとして描画される結果になります。

継承されたビューは好きなだけ入れ子にすることができます。必要に応じて 各ビューは他のビューを継承することができます。各親ビューは一つ前のビューの内容を content ブロックとして取得できます。

blocks() メソッドを使って、存在するブロックを列挙することができます。

$list = $this->blocks();

ブロックの表示¶

ブロックの表示には fetch() メソッドを使います。fetch() は もしもブロックが存在しなかった場合に '' を返してブロックを出力します。

<?= $this->fetch('sidebar') ?>

fetch を使うとブロックが存在するかどうかによってブロックに囲まれたコンテンツの表示を 切り替えることができます。これはレイアウトや継承されたビューで 見出しや他のマークアップ表示を切り替えたい場合に役に立ちます。

// src/Template/Layout/default.ctp の中で
<?php if ($this->fetch('menu')): ?>
<div class="menu">
    <h3>Menu options</h3>
    <?= $this->fetch('menu') ?>
</div>
<?php endif; ?>

ブロックが存在しない場合の既定の値を指定することもできます。 これによって、ブロックが存在しない場合のプレースホルダーを追加することでききます。 既定値は第二引数で指定します。

<div class="shopping-cart">
    <h3>買い物かご</h3>
    <?= $this->fetch('cart', '買い物かごが空です') ?>
</div>

スクリプトと CSS ファイルのためのブロック使用¶

HtmlHelper はビューブロックと結び付いており、その script() 、 css() 、そして meta() メソッドは block = true のオプションで使われると 同名のブロックをそれぞれ更新します。

<?php
// ビューファイルの中で
$this->Html->script('carousel', ['block' => true]);
$this->Html->css('carousel', ['block' => true]);
?>

// レイアウトファイルの中で
<!DOCTYPE html>
<html lang="en">
    <head>
    <title><?= $this->fetch('title') ?></title>
    <?= $this->fetch('script') ?>
    <?= $this->fetch('css') ?>
    </head>
    // 残りのレイアウトが続きます

Cake\View\Helper\HtmlHelper はスクリプトや CSS が入るブロックを 制御することもできます。

// ビューファイルの中で
$this->Html->script('carousel', ['block' => 'scriptBottom']);

// レイアウトの中で
<?= $this->fetch('scriptBottom') ?>

プラグインのレイアウト使用¶

もしプラグインに存在するレイアウトを使いたい場合、 プラグイン記法 を使うことが出来ます。例えば、 Contacts プラグインの contact レイアウトを使うには 次のようにします。

namespace App\Controller;

class UsersController extends AppController
{
    public function viewActive()
    {
        $this->viewBuilder()->setLayout('Contacts.contact');
        // あるいは 3.4 以前では以下
        $this->viewBuilder()->layout('Contacts.contact');
        // あるいは 3.1 以前では以下
        $this->layout = 'Contacts.contact';
    }
}

エレメントに変数を渡す¶

element メソッドの第二引数を通してエレメントにデータを渡すことができます。

echo $this->element('helpbox', [
    "helptext" => "おお、このテキストはとても役に立つ。"
]);

エレメントファイルの内部では、引数で渡されたすべての変数を パラメーター配列のメンバーとして利用できます。(テンプレートファイルにおけるコントローラーの Controller::set() メソッドと同様の動作です。) 上記の例では src/Template/Element/helpbox.ctp の中で $helptext 変数が使えます。

// src/Template/Element/helpbox.ctp の中で
echo $helptext; // 出力 "おお、このテキストはとても役に立つ。"

View::element() メソッドは、エレメントのためのオプションもサポートしています。 サポートされるオプションは、 'cache' と 'callbacks' です。例えば:

echo $this->element('helpbox', [
        "helptext" => "これはエレメントに $helptext として渡されます",
        "foobar" => "これはエレメントに $foobar として渡されます",
    ],
    [
        // "long_view" のキャッシュ設定を使います
        "cache" => "long_view",
        // エレメントから before/afterRender が呼び出されるには true に設定してください
        "callbacks" => true
    ]
);

エレメントは Cache クラスを通じてキャッシュされます。 設定済みのキャッシュのいずれかにエレメントが保存されるように設定できます。 その結果、何処にいつまでエレメントを保存しておくのかを非常に柔軟に制御することができます。 あるアプリケーションの中で同じエレメントの異なるバージョンをキャッシュするためには、 次の書式を使って一意のキャッシュキーを提供してください。

$this->element('helpbox', [], [
        "cache" => ['config' => 'short', 'key' => 'unique value']
    ]
);

もしもエレメント中で、データソースからの動的なデータのような、さらなるロジックが必要であれば、 エレメントの代わりにビューセルを使用することを検討してください。 詳細は ビューセルについて 参照してください。

エレメントのキャッシュ¶

キャッシュパラメーターを渡すだけで CakePHP のビューキャッシュの恩恵を得られます。 true を渡した場合、 'default' のキャッシュ設定に基づいてエレメントがキャッシュされます。 あるいは、どのキャッシュ設定を使うかを設定することができます。 Cache の設定についての詳細は キャッシュ を参照してください。 エレメントキャッシュの単純な例は以下のようになります。

echo $this->element('helpbox', [], ['cache' => true]);

あるビューの中で同じエレメントを二回以上描画し、かつキャッシュが有効であれば、 毎回異なる名前の 'key' パラメーターを設定するようにしてください。 後続の呼び出しが、その前の element() の呼び出しでキャッシュされた結果を 上書してしまうのを避けることができるでしょう。例えば:

echo $this->element(
    'helpbox',
    ['var' => $var],
    ['cache' => ['key' => 'first_use', 'config' => 'view_long']]
);

echo $this->element(
    'helpbox',
    ['var' => $differenVar],
    ['cache' => ['key' => 'second_use', 'config' => 'view_long']]
);

上の例は、双方の element() の結果が別々にキャッシュされるようにします。 もしすべてのエレメントのキャッシュで同じ設定を使いたい場合、 View::$elementCache を設定することで繰り返しを避けられます。 CakePHP は element() に何も渡されなかった場合、この設定を使います。

プラグインのエレメントの要求¶

もしプラグインを使っていて、そのプラグインのエレメントを使いたければ、慣れ親しんだ プラグイン記法 を使うだけでよいです。もしもビューが プラグインのコントローラー/アクションで描画される場合、他のプラグイン名が渡されなければ、 使用されるすべてのエレメントに対して自動的にそのプラグイン名が接頭されます。 もしエレメントがプラグインに存在しない場合、メインの APP フォルダーの中を探します。

echo $this->element('Contacts.helpbox');

もしビューがプラグインの一部であれば、プラグイン名を省略できます。 例えば、Contacts プラグインの ContactsController の中にいる場合、次の:

echo $this->element('helpbox');
// と
echo $this->element('Contacts.helpbox');

は等価で、描画されるエレメントは同じになります。

プラグインのサブフォルダー中のエレメント (例: plugins/Contacts/Template/Element/sidebar/helpbox.ctp) については、 以下を使ってください。

echo $this->element('Contacts.sidebar/helpbox');

ルーティングプレフィックスとエレメント¶

ルーティングプレフィックスを設定している場合、レイアウトやビューがそうであるように、 エレメントのパスの解決は、プレフィックスの場所に切り替わります。 "Admin" プレフィックスが設定されていて、次のように呼ぶとすれば:

echo $this->element('my_element');

エレメントはまず src/Template/Admin/Element/ から探されます。 もしもファイルが存在しなければ、既定の場所から探されます。

ビューの断片のキャッシュ¶

Cake\View\View::cache(callable $block, array $options = [])¶

時には、ビュー出力の断片を生成するのに時間がかかることがあります。 たとえば、 ビューセル の描画や、時間のかかるヘルパーの操作など。 アプリケーションの実行を速くする手助けのために、 CakePHP はビューの断片をキャッシュする方法を提供します。

// ローカル変数を想定しています
echo $this->cache(function () use ($user, $article) {
    echo $this->cell('UserProfile', [$user]);
    echo $this->cell('ArticleFull', [$article]);
}, ['key' => 'my_view_key']);

既定ではキャッシュされたビューの内容は View::$elementCache のキャッシュ設定になりますが、 これを変更するために config オプションを使用できます。

イベント一覧¶

• View.beforeRender

• View.beforeRenderFile

• View.afterRenderFile

• View.afterRender

• View.beforeLayout

• View.afterLayout

アプリケーションの イベントリスナー をこれらのイベントに アタッチする、または ヘルパーコールバック を使うことができます。