diff --git a/docs/ru/programmers/api-functions/api-append-by-ref.xml b/docs/ru/programmers/api-functions/api-append-by-ref.xml index 07385e43..72fdf80c 100644 --- a/docs/ru/programmers/api-functions/api-append-by-ref.xml +++ b/docs/ru/programmers/api-functions/api-append-by-ref.xml @@ -1,13 +1,13 @@ - + - append_by_ref - + append_by_ref() + добавляет значение по ссылке - + <title>Описание voidappend_by_ref stringvarname @@ -15,27 +15,37 @@ boolmerge - Эта функция используется для добавления значений к шаблону по ссылке. - Если вы добавляете переменную по ссылке то, соответсвенно, можете - изменять значение переменной, на которую она ссылается. Для объектов, - append_by_ref() так же помогает избежать их копирования в памяти. - Смотрите руководство PHP на предмет ссылок на переменные для более глубокого - пояснения. Если вы устанавливаете необязательный третий параметр в true, - то значение не добавляется, а сливается с текущим массивом. - - ¬e.parameter.merge; + Используется для добавления значений + в шаблон по ссылке. Если вы добавляете значение переменной по ссылке и это + значение изменяется в шаблоне, эти изменения будут отражены в начальной + переменной. Для объектов, + append_by_ref() также позволяет избежать внутреннего копирования добавляемого + объекта. + См. руководство PHP для более подробного описания работы передачи переменных + по ссылкам. + Если вы укажете необязательный третий аргумент, равный true, значение будет + совмещено с существующим массивом, вместо добавления. + + ¬e.parameter.merge; append_by_ref append_by_ref("Name",$myname); -$smarty->append_by_ref("Address",$address); +// добавление пар ключ / значение +$smarty->append_by_ref('Name', $myname); +$smarty->append_by_ref('Address', $address); ?> ]]> + + См. также + append() + и + assign(). + + - + - append - + append() + добавляет элемент к назначенному массиву - + <title>Описание voidappend mixedvar @@ -19,12 +19,12 @@ boolmerge - Функция используется для добавления элемента в назначенный (assigned) массив. - Если вы добавляете к строковому значению, оно конвертируется в значение - массива, и, затем добавляется. Вы можете передавать пары имя/значение - явно, или в виде ассоциативного массива, состоящего из пар имя/значение. - Если вы устанавливаете необязательный третий - параметр в true, то значение будет не добавлено, а слито с текущим массивом. + Если вы добавляете значение к строковому значению, последнее будет + предварительно преобразовано в массив. Вы можете явно передавать пары + ключей / значений, либо ассоциативный массив, содержащий пары + ключей / значений. + Если вы укажете необязательный третий аргумент, равный true, значение будет + совмещено с существующим массивом, вместо добавления. ¬e.parameter.merge; @@ -32,16 +32,22 @@ append("Name","Fred"); -$smarty->append("Address",$address); +// передаем пары ключ / значение +$smarty->append("Name", "Fred"); +$smarty->append("Address", $address); -// передача ассоциативного массива -$smarty->append(array("city" => "Lincoln","state" => "Nebraska")); +// передаем ассоциативный массив +$smarty->append(array('city' => 'Lincoln', 'state' => 'Nebraska')); ?> ]]> + См. также + append_by_ref(), + assign() + и + get_template_vars() + - + - assign_by_ref - + assign_by_ref() + назначает переменную по ссылке - + <title>Описание voidassign_by_ref stringvarname mixedvar - Эта функция используется для передачи значения переменной - в шаблон по ссылке, вместо создания ее копии. Смотрите - руководство PHP на предмет ссылок на переменные для - более глубокого пояснения. - - - Техническое замечание - - Функция используется для передачи значения в шаблон по ссылке. - Если вы назначаете переменную по ссылке, то имеете возможность - менять значение переменной, на которую она ссылается. - Что касается объектов, то assign_by_ref() помогает избежать - копирования переданных в шаблон объектов в памяти. - Смотрите руководство PHP на предмет ссылок на переменные. + Используется для назначения переменных + шаблонуу по ссылке, вместо создания копии. + См. руководство PHP для более подробного описания работы передачи переменных + по ссылкам. - - - assign_by_ref + + Техническое Замечание + + Эта функция используется для назначения переменных шаблону по ссылке. + Если вы назначаете переменную по ссылке и значение этой переменной + изменяется в шаблоне, эти изменения будут отражены в начальной переменной. + Для объектов, + assign_by_ref() также позволяет избежать внутреннего копирования добавляемого + объекта. + См. руководство PHP для более подробного описания работы передачи переменных + по ссылкам. + + + + assign_by_ref() assign_by_ref('Name', $myname); $smarty->assign_by_ref('Address', $address); ?> ]]> + + См. также + assign(), + clear_all_assign(), + append() + и + {assign} + + + diff --git a/docs/ru/programmers/api-functions/api-assign.xml b/docs/ru/programmers/api-functions/api-assign.xml index 3e0dd949..6f3724dd 100644 --- a/docs/ru/programmers/api-functions/api-assign.xml +++ b/docs/ru/programmers/api-functions/api-assign.xml @@ -1,13 +1,13 @@ - + - assign - + assign() + назначает значение шаблону - + <title>Описание voidassign mixedvar @@ -18,25 +18,58 @@ mixedvar - Функция используется для присвоения значений в шаблонах. Вы можете - явно передавать пары имя/значение, или ассоциативные массивы, - содержащие пары имя/значение. - - - assign + Вы можете явно передавать пары ключей / значений, либо ассоциативный + массив, содержащий пары ключей / значений. + + + assign() assign('Name', 'Fred'); $smarty->assign('Address', $address); // передача ассоциативного массива -$smarty->assign(array("city" => "Lincoln", "state" => "Nebraska")); +$smarty->assign(array('city' => 'Lincoln', 'state' => 'Nebraska')); + +// передача строки из базы данных (напр. ADODB) +$sql = 'select id, name, email from contacts where contact ='.$id; +$smarty->assign('contact', $db->getRow($sql)); ?> +]]> + + + Обращаемся к переменным из шаблона + + + + + Для более сложных назначений массивов см. + {foreach} + и + {section} + + + + См. также + assign_by_ref(), + get_template_vars(), + clear_assign(), + append() + и + {assign} + - + - clear_all_assign - + clear_all_assign() + очищает список назначенных переменных - + <title>Описание voidclear_all_assign - - Очищает все ранее присвоенные значения переменных. - - - clear_all_assign + + clear_all_assign() assign('Name', 'Fred'); +$smarty->assign('Address', $address); + +// выведет только что назначенные переменные +print_r($smarty->get_template_vars()); + +// очищаем список назначенных переменных $smarty->clear_all_assign(); + +// не выведет ничего +print_r($smarty->get_template_vars()); + ?> ]]> + + См. также + clear_assign(), + clear_config(), + assign() + и + append() + + diff --git a/docs/ru/programmers/api-functions/api-clear-all-cache.xml b/docs/ru/programmers/api-functions/api-clear-all-cache.xml index 7ee8b204..ed028b77 100644 --- a/docs/ru/programmers/api-functions/api-clear-all-cache.xml +++ b/docs/ru/programmers/api-functions/api-clear-all-cache.xml @@ -1,33 +1,39 @@ - + - clear_all_cache - + clear_all_cache() + полностью очищает кэш шаблонов - + <title>Описание voidclear_all_cache intexpire_time - Полностью очищает кэш шаблонов. В качестве необязательного - параметра, вы можете указать минимальный возраст файлов кэша в секундах, - по достижению которого они будут очищены. - - - clear_all_cache + В качестве необязательного параметра, вы можете указать минимальный возраст + файлов кэша в секундах, прежде чем они будут очищены. + + + clear_all_cache clear_all_cache(); ?> ]]> + + См. также + clear_cache(), + is_cached() + и + кэширование + - + - clear_assign - + clear_assign() + очищает назначенную переменную - + <title>Описание voidclear_assign mixedvar - Очищает присвоенное ранее значение переменной. Это может быть - как обычная переменная, так и массив некоторых значений. - - - clear_assign + Может принимать имя переменной, либо массив с именами переменных. + + + clear_assign() clear_assign("Name"); +// очищает одну переменную +$smarty->clear_assign('Name'); -// очистить значения несколько переменных -$smarty->clear_assign(array("Name", "Address", "Zip")); +// очищает несколько переменных +$smarty->clear_assign(array('Name', 'Address', 'Zip')); ?> ]]> + + См. также + clear_all_assign(), + clear_config(), + get_template_vars(), + assign() + и + append() + - + - clear_cache - + clear_cache() + очищает кэш определенного шаблона - + <title>Описание voidclear_cache stringtemplate stringcache_id - stringcompile_id + stringcompile_id + intexpire_time - Очищает кэш указанного шаблона. Если у вас есть - несколько кэшированных копий шаблона, вы можете - очистить конкретную копию, указав cache_id в - качестве второго параметра. Вы так же можете передать - compile id в качестве третьего параметра или - "сгруппировать" шаблоны вместе и удалить группу. - Для получения дополнительной информации, смотрите - раздел "Кэширование". - В качестве необязательного четвертого параметра вы - можете указать минимальное время в секундах, в - течение которого кэш будет существовать перед очисткой. - - - clear_cache + Если вы используете + множественное кэширование + для шаблона, вы можете очистить определенный кэш, передавая + cache_id в качестве второго аргумента. + Также, вы можете педать + $compile_id + в качестве третьего аргумента. + Вы можете "группировать" шаблоны + вместе, чтобы их можно было удалять группой. + См. раздел Кэширование для получения + дополнительной информации. + В качестве необязательного четвертого аргумента вы можете передать минимальный + возраст файла кэша в секундах, прежде чем он будет очищен. + + + clear_cache() clear_cache("index.tpl"); +// очищает кэш шаблона +$smarty->clear_cache('index.tpl'); -// очистить кэшированную копию с конкретным cache id -// при множественном кэшировании шаблона -$smarty->clear_cache("index.tpl", "CACHEID"); +// очищает определенный идентификатор кэша для шаблонов со множественным кэшированием +$smarty->clear_cache('index.tpl', 'CACHEID'); ?> ]]> + + См. также + clear_all_cache() + и + кэширование. + + diff --git a/docs/ru/programmers/api-functions/api-clear-compiled-tpl.xml b/docs/ru/programmers/api-functions/api-clear-compiled-tpl.xml index 063fdd3a..36244e00 100644 --- a/docs/ru/programmers/api-functions/api-clear-compiled-tpl.xml +++ b/docs/ru/programmers/api-functions/api-clear-compiled-tpl.xml @@ -1,38 +1,42 @@ - + - clear_compiled_tpl - + clear_compiled_tpl() + очищает скомпилированную версию указанного шаблона - + <title>Описание voidclear_compiled_tpl stringtpl_file - stringcompile_id + stringcompile_id + intexp_time - Очищает указанную откомпилированную версию шаблона, - или все откомпилированные файлы шаблона если ничего не указано. - Если вы передадите аргумент compile_id, только откомпилированные версии - шаблонов с этим compile_id будут очищены. Если вы передадите аргумент exp_time, только - откомпилированные версии шаблонов старше exp_time секунд будут очищены. - По умолчанию очищаются все откомпилированные версии шаблонов независимо от их возраста. - Эта функция только для опытных пользователей и обычно в ее - использовании необходимости нет. - - - clear_compiled_tpl + Очищает скомпилированную версию указанного шаблона, либо все скомпилированные + файлы, если конкретный файл не указан. + Если вы укажете аргумент + $compile_id, будут очищены + только те скомпилированные версии, которые имеют такой идентификатор. + Если вы укажете аргумент exp_time, будут очищены только те скомпилированные + версии, которые будут старше этого кол-ва секунд. + По умолчанию очищаются все скомпилированные шаблоны, независимо от их + возраста. + Эта функция предназначена для продвинутого использования и для решения + обычных задачь необходимости в ней нет. + + + clear_compiled_tpl() clear_compiled_tpl("index.tpl"); -// очистить всю директорию с откомпилированными шаблонами +// очищает скомпилированные версии всех шаблонов $smarty->clear_compiled_tpl(); ?> ]]> @@ -60,3 +64,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + diff --git a/docs/ru/programmers/api-functions/api-clear-config.xml b/docs/ru/programmers/api-functions/api-clear-config.xml index 5c7014c2..32b7f0c6 100644 --- a/docs/ru/programmers/api-functions/api-clear-config.xml +++ b/docs/ru/programmers/api-functions/api-clear-config.xml @@ -1,36 +1,46 @@ - + - clear_config - + clear_config() + очищает назначенную конфигурационную переменную - + <title>Описание voidclear_config stringvar - Функция очищает все назначенные конфигурационные - переменные. Если передано имя переменной, - значит очищается только она. - - - clear_config + Очищает все назначенные + конфигурационные переменные. + Если указано имя переменной, только эта переменная будет очищена. + + + clear_config() clear_config(); -// очищаем только одну переменную +// очищает одну конфигурационную переменную $smarty->clear_config('foobar'); ?> ]]> + + См. также + get_config_vars(), + config variables, + config files, + {config_load}, + config_load() + и + clear_assign() + - + - config_load - + config_load() + загружает данные из конфигурационного файла и назначает их шаблону - + <title>Описание voidconfig_load stringfile stringsection - Функция загружает данные из файла конфигурации - (config file) и помещает их в шаблон. Это - аналог функции шаблона - config_load. + Эта функция загружает данные из + конфигурационного файла + и назначает их шаблону. Работает идентично функции шаблона + {config_load}. - Техническое замечание + Техническое Замечание - Начиная с версии Smarty 2.4.0, переменные шаблона подставляются при - вызове fetch() или display(). Кофигурационные переменные, - загружаемые при вызове config_load() всегда глобальны. - Для повышения скорости работы, конфигурационные файлы тоже - компилируются и к ним применительны настройки force_compile и compile_check. + Начиная с версии Smarty 2.4.0, присвоенные переменные шаблона сохраняются + между вызовами методов + fetch() + и + display(). + Конфигурационные переменные, загруженные через config_load(), всегда + находятся в глобальной зоне видимости. Конфигурационные файлы также + компилируются для более быстрой обработки, и учитывают настройки + $force_compile + и + $compile_check. - config_load + config_load() config_load('my.conf'); -// загрузка секции конфигурационного файла -$smarty->config_load('my.conf','foobar'); +// загружаем секцию +$smarty->config_load('my.conf', 'foobar'); ?> ]]> + + См. также + {config_load}, + get_config_vars(), + clear_config(), + и + конфигурационные переменные. + - + - display - + display() + отображает шаблон - + <title>Описание voiddisplay stringtemplate stringcache_id - stringcompile_id + stringcompile_id + - Функция отоброжает шаблон. Укажите верный тип ресурса шаблонов - и путь. В качестве необязательного второго параметра, - вы можете передать cache id. Смотрите раздел - Кэширование - для дополнительной информации. - - ¶meter.compileid; - - display + Данная функция отображает шаблон, в отличие от + fetch(). + В качестве первого аргумента следуедует указать доступный тип и путь к + ресурсу шаблона. + В качестве второго необязательного аргумета, вы можете передать идентификатор + кэша. + См. раздел + Кэширование + для получения дополнительной информации. + + ¶meter.compileid; + + display() caching = true; -// обращаемся к базе только в случае отсутствия кэша -if(!$smarty->is_cached("index.tpl")) -{ +// выполняем запрос к БД только в том случае, если кэш не существует +if(!$smarty->is_cached("index.tpl")) { - // подставляем некоторые данные - $address = "245 N 50th"; - $db_data = array( - "City" => "Lincoln", - "State" => "Nebraska", - "Zip" = > "68502" - ); + // немного данных для примера + $address = "245 N 50th"; + $db_data = array( + "City" => "Lincoln", + "State" => "Nebraska", + "Zip" => "68502" + ); - $smarty->assign("Name","Fred"); - $smarty->assign("Address",$address); - $smarty->assign($db_data); + $smarty->assign("Name","Fred"); + $smarty->assign("Address",$address); + $smarty->assign($db_data); } -// отображаем результат +// выводим результат $smarty->display("index.tpl"); ?> ]]> - - - - Используйте синтаксис ресурсов шаблонов для - отображения файлов, находящихся вне директории $template_dir. - - - Примеры отображения шаблонов из различных ресурсов + + + + Используйте синтаксис ресурсов шаблона для отображения файлов + за пределами директории + $template_dir. + + + Пример работы функции display() с ресурсами шаблона display("/usr/local/include/templates/header.tpl"); +$smarty->display('/usr/local/include/templates/header.tpl'); -// абсолютный файловый путь (тоже самое) -$smarty->display("file:/usr/local/include/templates/header.tpl"); +// абсолютный файловый путь (тот же результат) +$smarty->display('file:/usr/local/include/templates/header.tpl'); -// абсолютный путь Windows (ОБЯЗАТЕЛЬНО используйте префикс "file:") -$smarty->display("file:C:/www/pub/templates/header.tpl"); +// абсолютный файловый путь под Windows (префикс "file:" ОБЯЗАТЕЛЕН) +$smarty->display('file:C:/www/pub/templates/header.tpl'); -// вставка из ресурса под названием "db" -$smarty->display("db:header.tpl"); +// использование ресурса шаблона с именем "db" +$smarty->display('db:header.tpl'); ?> ]]> См. также - fetch() и - template_exists. + fetch() + и + template_exists(). + +