Fix tests

Add docs
This commit is contained in:
Ivan Shalganov 2013-02-08 14:23:10 +04:00
parent a27f604eb5
commit 0659d27878
7 changed files with 71 additions and 116 deletions

View File

@ -1,113 +0,0 @@
Модификаторы
============
## Оператор if
Реализация "оператора if":http://php.net/if из PHP
```smarty
{if <expresion>}
{*...some code...*}
{/if}
```
Код, расположенный в теге `if` будет выполнен/выведен если выражение @<expression>@ возвращает значение приводимое к `TRUE`
Использование блока `elseif`
```smarty
{if <expresion1>}
{*...some code...*}
{elseif <expresion2>}
{*...some code...*}
{/if}
```
Код, расположенный после тега `elseif` будет выполнен/выведен, если выражение @<expression1>@ вернуло значение приводимое к `FALSE`, **<expression2>** - приводимое к `TRUE`
Использование блока `else`
```smarty
{if <expresion>}
{*...some code...*}
{else}
{*...some code...*}
{/if}
```
Код, расположенный после тега `else` будет выполнен/выведен, если выражение **<expression>** вернуло значение приводимое к `FALSE`
В тестируемых выражениях могут быть использованы "логические операторы":http://www.php.net/manual/en/language.operators.logical.php , что позволяет обрабатывать сочетания нескольких условий.
## Оператор foreach
Реализация оператора [foreach в PHP](http://docs.php.net/foreach)
Общий синтаксис:
```smarty
{foreach <array> as <key_var> => <value_var> index=<index_var> first=<first_flag> last=<last_flag>}
{*...some code...*}
{if <expression1>}
{break}
{/if}
{*...some code...*}
{if <expression2>}
{continue}
{/if}
{*...some code...*}
{foreachelse}
{*...some code...*}
{/foreach}
```
(!) <index_var>, <first_flag>, <last_flag>, <key_var> и <value_var> могут быть только переменные (допускаются вложенности на подобие $a.b.c, но массив $a.b должен быть объявлен).
Перебор значений массива $list
```smarty
{foreach $list as $value}
<div>{$value}</div>
{/foreach}
```
Перебор ключей и значений массива $list
```smarty
{foreach $list as $key => $value}
<div>{$key}: {$value}</div>
{/foreach}
```
Получение номера (индекса) итерации
```smarty
{foreach $list as $value index=$index}
<div>№{$index}: {$value}</div>
{/foreach}
```
Определение первого элемента
```smarty
{foreach $list as $value first=$first}
<div>{if $first} first item {/if} {$value}</div>
{/foreach}
```
Переменная `$first` будет иметь значение `TRUE`, если текущая итерация является первой.
Определение последнего элемента
```smarty
{foreach $list as $value last=$last}
<div>{if $last} last item {/if} {$value}</div>
{/foreach}
```
Переменная `$last` будет иметь значение `TRUE`, если текущая итерация является последней.
Использование @last@ замедляет работу цикла и требует от `$list` быть *countable*. Если есть возможность используйте `first` параметр.
### Вложенные теги
* `{break}` используется для выхода из цикла до достижения последней итерации. Если в цикле встречается тег `{break}`, цикл завершает свою работу, и далее выполняется код, следующий сразу за блоком цикла
* `{continue}` используется для прерывания текущей итерации. Если в цикле встречается тег `{continue}`, часть цикла, следующая после тега, не выполняется, и начинается следующая итерация. Если текущая итерация была последней, цикл завершается.
* `{foreachelse}` ограничивает код, который должен быть выполнен, если итерируемый объект пуст.

3
docs/mods/upper.md Normal file
View File

@ -0,0 +1,3 @@
Modifier |upper
===============

View File

@ -1,3 +1,39 @@
Tag {if}
========
Реализация оператора if из PHP
### {if}
```smarty
{if <expresion>}
{*...some code...*}
{/if}
```
Код, расположенный в теге `{if}` будет выполнен/выведен если выражение *<expression>* возвращает значение приводимое к **TRUE**
### {elseif}
```smarty
{if <expresion1>}
{*...some code...*}
{elseif <expresion2>}
{*...some code...*}
{/if}
```
Код, расположенный после тега `{elseif}` будет выполнен/выведен, если выражение <expression1> вернуло значение приводимое к **FALSE**, <expression2> - приводимое к **TRUE**
### {else}
```smarty
{if <expresion>}
{*...some code...*}
{else}
{*...some code...*}
{/if}
```
Код, расположенный после тега `{else}` будет выполнен/выведен, если выражение <expression> вернуло значение приводимое к **FALSE**
В тестируемых выражениях могут быть использованы логические операторы , что позволяет обрабатывать сочетания нескольких условий.

10
docs/tags/ignore.md Normal file
View File

@ -0,0 +1,10 @@
Tag {ignore}
============
Тег {ignore} позволяет отключить парсер на фрагмент шаблона, таким образом все фигурные скобки в блоке будут проигнорированы.
```smarty
{ignore}
var data = {"time": obj.ts};
{ignore}
```

14
docs/tags/include.md Normal file
View File

@ -0,0 +1,14 @@
Tag {include}
=============
`{include}` tags are used for including other templates in the current template. Any variables available in the current template are also available within the included template.
```smarty
{include "about.tpl"}
```
Переменные для подключаемого шаблона можно переопределить
```smarty
{include "about.tpl" page=$item limit=50}
```

View File

@ -11,8 +11,11 @@ class TemplateTest extends \PHPUnit_Framework_TestCase {
public static $aspect;
public function setUp() {
exec("rm -f ".ASPECT_RESOURCES.'/compile/*');
if(!file_exists(ASPECT_RESOURCES.'/compile')) {
mkdir(ASPECT_RESOURCES.'/compile', 0777, true);
} else {
exec("rm -f ".ASPECT_RESOURCES.'/compile/*');
}
self::$aspect = Aspect::factory(ASPECT_RESOURCES.'/template', ASPECT_RESOURCES.'/compile');
self::$aspect->addTemplate(new Render("welcome.tpl", function ($tpl) {
echo "<b>Welcome, ".$tpl["username"]." (".$tpl["email"].")</b>";

View File

@ -15,7 +15,9 @@ class AspectTest extends \PHPUnit_Framework_TestCase {
}
public function setUp() {
if(!file_exists(ASPECT_RESOURCES.'/compile')) {
mkdir(ASPECT_RESOURCES.'/compile', 0777, true);
}
self::tearDownAfterClass();
$this->aspect = $aspect = Aspect::factory(ASPECT_RESOURCES.'/template', ASPECT_RESOURCES.'/compile');
$aspect->setCompileDir(ASPECT_RESOURCES.'/compile');