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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
   <sect1 id="advanced.features.objects">
    <title>Objets</title>
    <para>
    Smarty donne l'acc<63>s aux objets PHP a travers les templates. Il y
    a 2 moyens d'y avoir acc<63>s. Le premier consiste a allouer les objets
    au template puis de les utiliser avec une syntaxe similaire a celles
    des fonctions personnalis<69>es. Le deuxi<78>me moyen consiste a allouer
    des objets aux templates et de les utiliser comme n'importe quelle
    variable. 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, un objet allou<6F>
    ne peut pas avoir de lien sur lui-m<>me ou <20>tre mis dans un tableau
    d'objet, 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 s<>curit<69> 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 templates le sont de la
  m<>me faton que les fonctions utilisateurs les r<>cup<75>rent.
  Le premier param<61>tre correspond a un tableau associatif, le second a l'objet
  Smarty. Si vous souhaitez que les param<61>tres soient pass<73>es un a un, comme
  dans un appel traditionnel, d<>finissez registration, quatri<72>me param<61>tre optionnel,
  a false.
	</para>
    <example>
     <title>utilisation d'un objet allou<6F> ou assign<67></title>
     <programlisting>
&lt;?php
// la classe

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

$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");
?&gt;

TEMPLATE:

{* 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>
</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
-->