voltエンジン

Volt は、PHPのためにCで記述されており、とても速く、デザイナにも扱いやすいテンプレート言語です。簡単にビューを書けるようにヘルパーセットも提供されており、また、Phalcon の他のコンポーネントに高度に統合されているので、コーディング量も少なく使い勝手はいいと思います。voltで書かれたコードは初回読み込み時にキャッシュとして、phpファイルにコンパイルされます。phalcon volt ドキュメントより抜粋。

voltの有効化

サービスコンテナの設定時に：$di = new Phalcon\DI\FactoryDefault();

use Phalcon\Mvc\View;
// Voltをテンプレートエンジンとして登録する
$di->set('view', function () {
    $view = new View();
    $view->setViewsDir('../app/views/');
    $view->registerEngines(
        array(
            ".volt" => 'Phalcon\Mvc\View\Engine\Volt'
        )
    );
    return $view;
});

コントローラからビューへのデータ設定

MVCモデルではデータの取得や加工等をコントローラで行いコントローラからビューへデータを渡す必要があります。
Phalconでは以下のように２通りの書き方があります。
コントローラのアクション内で

//例えばモデルPostから取得したデータをビューへ受け渡す場合
$post = Post::findFirst();
$this->view->post = $post;
//または
$this->view->setVar("post", $post);
//もちろん変数でなくても
$this->view->name = "テスト";
//または
$this->view->setVar("name", "テスト");

コントローラからセットした変数（$this->view->post　or $this->view->setVar(“post”, ????)）をビューで利用するためには

{{ post }}

でＯＫです。

voltの表記

設定した変数や文字を出力する場合、{{}}

{{ post }}

制御分を扱う場合、{% %}

{% if a==b %}
{% endif %}

といった感じになります。phpで書くよりコーディング量は減りますね

制御文

よく利用する制御文の利用方法と解説

変数

変数postの属性にアクセスする
voltの場合

{{ post.title }}

phpの場合

$post->title

変数postが配列のときのアクセス
voltの場合

{{ post['title'] }}

phpの場合

$post['title']

if文

if文の書き方
voltの場合

{% set a = 1 %}
{% if a === 1 %}
OK
{% else %}
ELSE
{% endif %}

コンパイル後のphp

<?php $a = 1; ?>
<?php if ($a === 1) { ?>
OK
<?php } else { ?>
ELSE
<?php } ?>

ループ

単純なループ
voltのforはforeachにコンパイルされます。
voltの場合

{% set numbers = ['one': 1, 'two': 2, 'three': 3] %}
{% for value in numbers %}
  Value: {{ value }}
{% endfor %}

コンパイル後のphp

<?php $numbers = array('one' => 1, 'two' => 2, 'three' => 3); ?>
<?php foreach ($numbers as $value) { ?>
  Value: <?php echo $value; ?>
<?php } ?>

keyとvalueの扱い
voltの場合

{% set numbers = ['one': 1, 'two': 2, 'three': 3] %}
{% for name, value in numbers %}
  Name: {{ name }} Value: {{ value }}
{% endfor %}

コンパイル後のphp

<?php $numbers = array('one' => 1, 'two' => 2, 'three' => 3); ?>
<?php foreach ($numbers as $name => $value) { ?>
  Name: <?php echo $name; ?> Value: <?php echo $value; ?>
<?php } ?>

for文とifを同時に書く。ループに条件をつけることができます。
コンパイル後のphpをみるとforeachの直下にif文が入っていることが分かります。
voltの場合

{% set numbers = ['one': 1, 'two': 2, 'three': 3] %}
{% for value in numbers if value < 2 %}
  Value: {{ value }}
{% endfor %}

コンパイル後のphp

<?php $numbers = array('one' => 1, 'two' => 2, 'three' => 3); ?>
<?php foreach ($numbers as $value) { if ($value < 2) { ?>
  Value: <?php echo $value; ?>
<?php } ?><?php } ?>

もちろん、「break」と「continue」があります。ループから抜けたり、現在のブロック内で強制的に次のイテレーションへ移ったりすることができます。
voltの場合

{% set numbers = ['one': 1, 'two': 2, 'three': 3] %}
{% for index, value in numbers %}
    {% if index is even %}
        {% continue %}
    {% else %}
    	{% break %}
    {% endif %}
    ...
{% endfor %}

コンパイル後のphp

<?php $numbers = array('one' => 1, 'two' => 2, 'three' => 3); ?>
<?php foreach ($numbers as $index => $value) { ?>
    <?php if (((($index) % 2) == 0)) { ?>
        <?php continue; ?>
    <?php } else { ?>
    	<?php break; ?>
    <?php } ?>
    ...
<?php } ?>

この中で利用している「{% if index is even %}」については後ほど解説します。

ループの特別な変数

loop.index

ループ中、現在のイテレーションが何番目かを返す（順番は1からスタート）

loop.index0

ループ中、現在のイテレーションが何番目かを返す（順番は0からスタート）

loop.revindex

ループ中、現在のイテレーションがループの最後から何番目かを返す（順番は1からスタート）

loop.revindex0

ループ中、現在のイテレーションがループの最後から何番目かを返す（順番は0からスタート）

loop.first

ループの最初のイテレーションであれば、(boolean)trueを返す

loop.last

ループの最後のイテレーションであれば、(boolean)trueを返す

loop.length

ループの要素数を返す

実際にコーディングし、その結果を記載します。

{% set numbers = ['one', 'two', 'three','four'] %}
{% for index, value in numbers %}
	{% if loop.first %}
    	最初<br>
    	loop.length:{{ loop.length }}<br>
    {% endif %}
    {% if loop.last %}
    	最後<br>
    {% endif %}
    value:{{ value }}<br>
    loop.index:{{ loop.index }}<br>
    loop.index0:{{ loop.index0 }}<br>
    loop.revindex:{{ loop.revindex }}<br>
    loop.revindex0:{{ loop.revindex0 }}<br>
{% endfor %}

実行結果は

/*** 1週目 ***/
最初
loop.length:4
value:one
loop.index:1
loop.index0:0
loop.revindex:4
loop.revindex0:3
/*** 2週目 ***/
value:two
loop.index:2
loop.index0:1
loop.revindex:3
loop.revindex0:2
/*** 3週目 ***/
value:three
loop.index:3
loop.index0:2
loop.revindex:2
loop.revindex0:1
/*** 4週目 ***/
最後
value:four
loop.index:4
loop.index0:3
loop.revindex:1
loop.revindex0:0

となります。これは重宝します。ちなみに、コンパイル後のphpは

<?php
    $v22032113141iterator = $numbers;
    $v22032113141incr = 0;
    $v22032113141loop = new stdClass();
    $v22032113141loop->length = count($v22032113141iterator);
    $v22032113141loop->index = 1;
    $v22032113141loop->index0 = 1;
    $v22032113141loop->revindex = $v22032113141loop->length;
    $v22032113141loop->revindex0 = $v22032113141loop->length - 1;
?><?php
    foreach ($v22032113141iterator as $index => $value) {
?><?php
        $v22032113141loop->first = ($v22032113141incr == 0);
        $v22032113141loop->index = $v22032113141incr + 1;
        $v22032113141loop->index0 = $v22032113141incr;
        $v22032113141loop->revindex = $v22032113141loop->length - $v22032113141incr;
        $v22032113141loop->revindex0 = $v22032113141loop->length - ($v22032113141incr + 1);
        $v22032113141loop->last = ($v22032113141incr == ($v22032113141loop->length - 1));
?>
	<?php if ($v22032113141loop->first) { ?>
    	    最初<br>
    	    loop.length:<?php echo $v22032113141loop->length; ?><br>
        <?php } ?>
        <?php if ($v22032113141loop->last) { ?>
    	    最後<br>
        <?php } ?>
        value:<?php echo $value; ?><br>
        loop.index:<?php echo $v22032113141loop->index; ?><br>
        loop.index0:<?php echo $v22032113141loop->index0; ?><br>
        loop.revindex:<?php echo $v22032113141loop->revindex; ?><br>
        loop.revindex0:<?php echo $v22032113141loop->revindex0; ?><br>
<?php
        $v22032113141incr++;
    }
?>

コンパイル後のphpもごちゃごちゃしていますが、やってることは単純なのです。phpにて他の書き方もできますが、コーディング量は抑えられます。
※stdClassはhttp://php.net/manual/ja/language.oop5.basic.phpによると、定義済みのクラス。

演算子

以下の演算子はphpのものと使い方は同じです。

演算子

=

代入演算子

+=

加算代入

-=

減算代入

*=

乗算代入

/=

除算代入

+

加算

–

減算

*

乗算

/

除算

%

余り {{ 10 % 3 }} は、1が出力

比較演算子

==

型の相互変換をした後で両辺の値が等しければtrue

!=

型の相互変換をした後で両辺の値が等しくなければtrue

<>

型の相互変換をした後で両辺の値が等しくなければtrue

>

左の値が右の値より大きければtrue

<

右の値が左の値より大きければtrue

<=

左の値が右の値以上であればtrue

>=

右の値が左の値以上であればtrue

===

両辺の型と値が等しければtrue

!==

両辺の型と値が等しくなければtrue

論理演算子

A or B

AまたはBがtrueなら、trueを返す

and

AとBの両方がtrueなら、trueを返す

その他

以下のものは少し解説します。

~

演算子の両辺をつなげます。例えば、

{{ "hello " ~ "world" }}

の出力結果は「hello world」となり、phpで表現すると

<?php echo 'hello ' . 'world'; ?>

となる

|

前の演算子に対し、後ろの演算子にてフィルターをかける。例えば、

{{ "hello"|uppercase }}

の出力結果は「HELLO」となり、phpで表現すると

<?php echo Phalcon\Text::upper('hello'); ?>

となる

..

演算子の両辺の文字（1文字のみ）または整数の間のすべてを配列として返す。例えば、

{{ 'a'..'z' }}

は、phpで表現すると

<?php echo range('a', 'z'); ?>

となり、

{{ 1..10 }}

は

<?php echo var_dump(range(1, 10)); ?>

となる。出力結果は、array(10) { [0]=> int(1) [1]=> int(2) [2]=> int(3) [3]=> int(4) [4]=> int(5) [5]=> int(6) [6]=> int(7) [7]=> int(8) [8]=> int(9) [9]=> int(10) }

is

==と同じ働きをする。例えば

{% if 'aaa' is 'bbb' %}

はphpで表現すると

<?php if ('aaa' == 'bbb') { ?>

in

演算子の左辺が右に含まれているかどうかチェックする。

{% if 'a' in 'abc' %}

これはtrueの処理になり、一方

{% if 'd' in 'abc' %}

は、falseの処理になる。phpで表現すると

<?php if ($this->isIncluded('a', 'abc')) { ?>

になる

is not

!=と同じ働きをする。例えば

{% if 'aaa' is not 'bbb' %}

はphpで表現すると

<?php if ('aaa' != 'bbb') { ?>

‘a’ ? ‘b’ : ‘c’

phpの三項演算子と同じ働きをする。

{{ true ? 'b' : 'c' }}

は「b」を出力、一方

{{ false ? 'b' : 'c' }}

は「c」を出力

++

phpと同様のインクリメント

–

phpと同様のデクリメント

長くなったので一旦ここまでです。
続きはVolt vol2に記載します。