Get Smarty


Donate Bitcoin Bitcoin

Smarty Icon

You may use the Smarty logo according to the trademark notice.

Smarty Template Engine Smarty Template Engine

For sponsorship, advertising, news or other inquiries, contact us at:

Sites Using Smarty

Buy cheap glasses from and save up to 80%.

Where to buy dental loupes? is your best choice!

Where to buy discount wedding dresses and cheap smart dresses free shipping -

Find Wedding Dresses Online at Canada from

Wholesale Fashion Jewelry from wholesalers

Soccer xp shop is discounted Soccer Cleats and Cheap Soccer Shoes for Sale at



{foreach} est utilisé pour parcourir un simple tableau associatif, contrairement à {section} qui effectue une boucle sur les tableaux de données. La synthaxe pour {foreach} est plus simple que {section}, mais ne peut être utilisé que pour des tableau simple. Chaque {foreach} doit aller de paire avec une balise fermante {/foreach}.

Nom attribut Type Requis Defaut Description
from tableau oui n/a Le tableau à parcourir
item chaîne de caractère Oui n/a Le nom de la variable "élément courant"
key chaîne de caractère Non n/a Le nom de la variable représentant la clef courante.
name chaîne de caractère Non n/a Le nom de la boucle foreach, qui nous permettra d'accéder à ses propriétés.
  • Required attributes are from and item.

  • The name of the {foreach} loop can be anything you like, made up of letters, numbers and underscores, like PHP variables.

  • {foreach} loops can be nested, and the nested {foreach} names must be unique from each other.

  • The from attribute, usually an array of values, determines the number of times {foreach} will loop.

  • {foreachelse} is executed when there are no values in the from variable.

  • {foreach} loops also have their own variables that handle properties. These are accessed with: {$} with name being the name attribute.


    The name attribute is only required when you want to access a {foreach} property, unlike {section}. Accessing a {foreach} property with name undefined does not throw an error, but leads to unpredictable results instead.

  • {foreach} properties are index, iteration, first, last, show, total.

Example 7.5. L'attribut item

$arr = array(1000, 1001, 1002);
$smarty->assign('myArray', $arr);


Template pour afficher $myArray dans une liste non-ordonnée.

 {foreach from=$myArray item=foo}


L'exemple ci-dessus affichera :



Example 7.6. Utilisation des attributs item et key

$arr = array(9 => 'Tennis', 3 => 'Natation', 8 => 'Programmation');
$smarty->assign('myArray', $arr);


Le template affiche le tableau $myArray comme paire clé/valeur, comme la fonction PHP foreach.

 {foreach from=$myArray key=k item=v}
 <li>{$k}: {$v}</li>


L'exemple ci-dessus affichera :

 <li>9: Tennis</li>
 <li>3: Natation</li>
 <li>8: Programmation</li>


Example 7.7. {foreach} avec un attribut associatif item

$items_list = array(23 => array('no' => 2456, 'label' => 'Salad'),
    96 => array('no' => 4889, 'label' => 'Cream')
$smarty->assign('items', $items_list);


Le template affiche $items avec $myId dans l'URL.

 {foreach from=$items key=myId item=i}
 <li><a href="item.php?id={$myId}">{$}: {$i.label}</li>

L'exemple ci-dessus affichera :

<li><a href="item.php?id=23">2456: Salad</li>
<li><a href="item.php?id=96">4889: Cream</li>


Example 7.8. {foreach} avec item et key

Assigne un tableau à Smarty, la clé contient la clé pour chaque valeur de la boucle.

$smarty->assign('contacts', array(
array('phone' => '1',
         'fax' => '2',
         'cell' => '3'),
         array('phone' => '555-4444',
         'fax' => '555-3333',
         'cell' => '760-1234')


Le template affiche $contact.

{foreach name=outer item=contact from=$contacts}
    <hr />
    {foreach key=key item=item from=$contact}
        {$key}: {$item}<br />


L'exemple ci-dessus affichera :

<hr />
phone: 1<br />
fax: 2<br />
cell: 3<br />
<hr />
phone: 555-4444<br />
fax: 555-3333<br />
cell: 760-1234<br />


Example 7.9. Exemple d'une base de données avec {foreachelse}

Exemple d'un script de recherche dans une base de données (e.g. PEAR ou ADODB), le résultat de la requête est assigné à Smarty.

$search_condition = "where name like '$foo%' ";
$sql = 'select contact_id, name, nick from contacts '.$search_condition.' order by name';
$smarty->assign('results', $db->getAssoc($sql) );


Le template qui affiche None found si aucun résultat avec {foreachelse}.

{foreach key=cid item=con from=$results}
<a href="contact.php?contact_id={$cid}">{$} - {$con.nick}</a><br />
Aucun élément n'a été trouvé dans la recherche



index contient l'index courant du tableau, en commançant par zéro.

Example 7.10. Exemple avec index

 {* L'en-tête du block est affiché toutes les 5 lignes *}
 {foreach from=$items key=myId item=i name=foo}
 {if $ % 5 == 0}



iteration contient l'itération courante de la boucle et commence toujours à 1, contrairement à index. Il est incrémenté d'un, à chaque itération.

Example 7.11. Exemple avec iteration et index

{* this will output 0|1, 1|2, 2|3, ... etc *}
{foreach from=$myArray item=i name=foo}



first vaut TRUE si l'itération courante de {foreach} est l'initial.

Example 7.12. Exemple avec first

 {* affiche LATEST sur le premier élément, sinon, l'id *}
  {foreach from=$items key=myId item=i name=foo}
  <td>{if $}LATEST{else}{$myId}{/if}</td>



last est défini à TRUE si l'itération courante de {foreach} est la dernière.

Example 7.13. Exemple avec last

{* Ajout une barre horizontale à la fin de la liste *}
{foreach from=$items key=part_id item=prod name=products}
<a href="#{$part_id}">{$prod}</a>{if $smarty.foreach.products.last}<hr>{else},{/if}
... contenu ...



show est utilisé en tant que paramètre à {foreach}. show est une valeur booléenne. S'il vaut FALSE, {foreach} ne sera pas affiché. S'il y a un {foreachelse}, il sera affiché alternativement.


total contient le nombre d'itérations que cette boucle {foreach} effectuera. Il peut être utilisé dans ou après un {foreach}.

Example 7.14. Exemple avec total

{* affiche les lignes retournées à la fin *}
{foreach from=$items key=part_id item=prod name=foo}
{if $}
<div id="total">{$} items</div>
... quelque chose d'autre ...


Voir aussi {section} et $smarty.foreach.

No comments for this page.
Post a Comment
All comments are moderated. Support questions are ignored, use the forums instead.
Email: (not shown)
What is 0 plus 0? (Are you human?)