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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->

<sect1 id="advanced.features.objects">
 <title>Objets</title>
 <para>
  Smarty donne l'acc<63>s aux <ulink url="&url.php-manual;object">objets</ulink>
  PHP <20> travers les templates. Il y a 2 moyens d'y avoir acc<63>s.
 </para>
 <itemizedlist spacing="compact">
 <listitem><para>
  Le premier consiste <20>
  <link linkend="api.register.object">allouer les objets</link>
  au template puis de les utiliser avec une syntaxe similaire a celles
  des <link linkend="language.custom.functions">fonctions personnalis<69>es</link>.
 </para></listitem>
 <listitem><para>
  Le deuxi<78>me moyen consiste <20> <link linkend="api.assign">assigner</link> des objets
  aux templates et de les utiliser comme n'importe quelle
  variable.
 </para></listitem>
 </itemizedlist>
 <para>
  La premi<6D>re m<>thode a une syntaxe beaucoup plus sympathique.
  Elle est aussi plus s<>curis<69>e, puisqu'un objet allou<6F> ne peut avoir acc<63>s
  qu'a certaines m<>thodes et propri<72>t<EFBFBD>s. N<>anmoins,
  <emphasis role="bold">un objet allou<6F> ne peut pas avoir de lien sur lui-m<>me 
  ou <20>tre mis dans un tableau d'objet</emphasis>, etc.
  Vous devez choisir la m<>thode qui correspond a vos
  besoins, mais tGchez d'utiliser la premi<6D>re m<>thode autant que possible
  afin de r<>duire la syntaxe des templates au minimum.
 </para>
 <para>
  Si l'option de <link linkend="variable.security">s<EFBFBD>curit<EFBFBD></link>
  est activ<69>e, aucune m<>thode ou fonctions priv<69>es
  n'est accessible (commentant par "_"). S'il existe une m<>thode et une
  propri<72>t<EFBFBD> du m<>me nom, c'est la m<>thode qui sera utilis<69>e.
 </para>
 <para>
  Vous pouvez restreindre l'acc<63>s aux m<>thodes et aux propri<72>t<EFBFBD>s en
  les listant dans un tableau en tant que troisi<73>me param<61>tre
  d'allocation.
 </para>
 <para>
  Par d<>faut, les param<61>tres pass<73>s aux objets depuis le template le sont de la
  m<>me fa<66>on que les <link linkend="language.custom.functions">fonctions utilisateurs</link> 
  les r<>cup<75>rent.
  Le premier param<61>tre correspond <20> un tableau associatif, le second <20> l'objet
  Smarty. Si vous souhaitez que les param<61>tres soient pass<73>s un <20> un, comme
  dans un appel traditionnel, d<>finissez registration, quatri<72>me param<61>tre optionnel,
  <20> &false;.
 </para>
 <para>
  Le cinqui<75>me param<61>tre optionnel n'a d'effet que si le param<61>tre
  <parameter>format</parameter> vaut <literal>true</literal> et il contient
  une liste de m<>thodes qui doivent <20>tre trait<69>es comme des blocks. Cel<65> signifie
  que ces m<>thodes ont un tag fermant dans le template
  (<literal>{foobar->meth2}...{/foobar->meth2}</literal>) et que les param<61>tres
  de ces m<>thodes fonctionnent de la m<>me fa<66>on que les param<61>tres des
  <link linkend="plugins.block.functions">blocks de fonctions des plugins</link> :
  Ils contiennent 4 param<61>tres
  <parameter>$params</parameter>,
  <parameter>$content</parameter>,
  <parameter>&amp;$smarty</parameter> et
  <parameter>&amp;$repeat</parameter> et ils fonctionnent de la m<>me
  fa<66>on que les blocks de fonctions des plugins.
 </para>
 <example>
  <title>Utilisation d'un objet allou<6F> ou assign<67></title>
  <programlisting role="php">
<![CDATA[
<?php
// la classe

class My_Object() {
  function meth1($params, &$smarty_obj) {
    return 'Ceci est ma methode 1';
  }
}

$myobj = new My_Object;
// enregistre l'objet
$smarty->register_object('foobar',$myobj);
// on restreint l'acc<63>s a certaines m<>thodes et propri<72>t<EFBFBD>s en les listant
$smarty->register_object('foobar',$myobj,array('meth1','meth2','prop1'));
// pour utiliser le format habituel de param<61>tre objet, passez le bool<6F>en = false
$smarty->register_object('foobar',$myobj,null,false);

// on peut aussi assigner des objets. Assignez par r<>f<EFBFBD>rence quand c'est possible
$smarty->assign_by_ref('myobj', $myobj);

$smarty->display('index.tpl');
?>

?>
]]>
  </programlisting>
  <para>
   Et voici comment acc<63>der <20> vos objets dans <filename>index.tpl</filename> :
  </para>
  <programlisting>
<![CDATA[
{* acc<63>s a notre objet enregistr<74> *}
{foobar->meth1 p1="foo" p2=$bar}

{* on peut aussi assigner la sortie *}
{foobar->meth1 p1="foo" p2=$bar assign="output"}
the output was {$output)

{* access our assigned object *}
{$myobj->meth1("foo",$bar)}
]]>
  </programlisting>
 </example>
 <para>
  Voir aussi
  <link linkend="api.register.object"><varname>register_object()</varname></link> et
  <link linkend="api.assign"><varname>assign()</varname></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
-->