smarty/docs/ru/programmers/advanced-features/advanced-features-objects.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0 Maintainer: freespace Status: ready -->
<sect1 id="advanced.features.objects">
 <title>Объекты</title>
 <para>
  Smarty позволяет использовать в шаблонах
  <ulink url="&url.php-manual;object">объекты</ulink> PHP.
  Существуют два способа их вызова. Первый -
  <link linkend="api.register.object">зарегистрировать объект</link> для
  шаблона, затем вызвать его примерно так же, как и
  <link linkend="language.custom.functions">пользовательские функции</link>.
  Второй - <link linkend="api.assign">назначить</link> объект шаблону и использовать его,
  как любую другую присвоенную переменную. Первый метод гораздо аккуратнее
  и безопаснее, так как у зарегистрированного объекта можно ограничить
  свойства и методы. Но, в тоже время, <emphasis role="bold">зарегистрированный объект
  нельзя использовать в циклах, нельзя помещать в массив объектов</emphasis>,
  и так далее. Выбор способа за вами, но используйте по
  возможности первый, чтобы максимально упростить синтаксис шаблона.
 </para>
 <para>
  В <link linkend="variable.security">безопасном режиме</link>
  недоступны приватные методы и функции (имена которых начинаются с "_").
  Если существует и метод, и свойство с одинаковыми именами,
  то будет использован метод.
 </para>
 <para>
  Вы можете ограничить использование объекта только некоторыми
  методами и свойствами. Для этого перечислите их в массиве и укажите
  этот массив третьим параметром при регистрации объекта.
 </para>
 <para>
  По умолчанию, параметры из шаблона передаются объекту точно так же,
  как и
  <link linkend="language.custom.functions">пользовательской функции</link>.
  Первым параметром передаётся
  ассоциативный массив, вторым - объект Smarty. Если вы хотите передавать
  параметры по одному, как при традиционном обращении с объектами, установите
  четвёртый параметр вызова в false.
 </para>
 <para>
  Необязательный пятый параметр вступает в силу только в том случае, если
  свойство <parameter>format</parameter> равно <literal>true</literal>.
  Он содержит список методов, которые должны обрабатываться как блоки.
  Это означает, что в шаблоне у методы будут иметь закрывающие тэги
  (<literal>{foobar->meth2}...{/foobar->meth2}</literal>) и параметры
  методов будут иметь такие же синопсисы, как и параметры для
  <link linkend="plugins.block.functions">block-function-plugins</link>:
  <parameter>$params</parameter>,
  <parameter>$content</parameter>,
  <parameter>&amp;$smarty</parameter>
  и
  <parameter>&amp;$repeat</parameter>. Кроме того, они ведут себя так же, как и
  block-function-plugins.
 </para>
 <example>
  <title>использование зарегистрированного или присвоенного объекта</title>
  <programlisting role="php">
<![CDATA[
<?php
// сам объект

class My_Object {
	function meth1($params, &$smarty_obj) {
		return 'this is my meth1';
	}
}

$myobj = new My_Object;
// регистрация объекта (по ссылке)
$smarty->register_object('foobar',$myobj);
// если мы хотим ограничить доступ к определенным методам или свойствам, перечисляем их
$smarty->register_object('foobar',$myobj,array('meth1','meth2','prop1'));
// если мы хотим использовать традиционный формат параметров объекта, передаем false
$smarty->register_object('foobar',$myobj,null,false);

// Мы так же можем назначать объекты. Назначение идёт по ссылке, если это возможно.
$smarty->assign_by_ref('myobj', $myobj);

$smarty->display('index.tpl');
?>
]]>
  </programlisting>
  <para>
   А вот так можно получить доступ к объекту в index.tpl:
  </para>
  <programlisting>
<![CDATA[
{* обращаемся к нашему зарегистрированному объекту *}
{foobar->meth1 p1='foo' p2=$bar}

{* вывод объекта можно сохранить в переменную *}
{foobar->meth1 p1='foo' p2=$bar assign='output'}
the output was {$output}

{* обращаемся к нашему назначенному объекту *}
{$myobj->meth1('foo',$bar)}
]]>
  </programlisting>
 </example>
 <para>
  См. также
  <link linkend="api.register.object">register_object()</link>
  и
  <link linkend="api.assign">assign()</link>
 </para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->