PHP Manual

PEAR Manual

Smarty Manual

PostgreSQL

MySQL Manual

Perl Manual

smarty manual
prevchapter 7. built-in functionsnext

{foreach},{foreachelse}

{foreach} loops are an alternative to {section} loops. {foreach} is used to loop over a single associative array. the syntax for {foreach} is much easier than {section}, but as a tradeoff it can only be used for a single array. {foreach} tags must be paired with {/foreach} tags. required parameters are from and item. the name of the {foreach} loop can be anything you like, made up of letters, numbers and underscores. {foreach} loops can be nested, and the nested {foreach} names must be unique from each other. the from variable (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.

attribute nametyperequireddefaultdescription
fromarrayyesn/athe array you are looping through
itemstringyesn/athe name of the variable that is the current element
keystringnon/athe name of the variable that is the current key
namestringnon/athe name of the foreach loop for accessing foreach properties

example 7-5. {foreach} - item

<?php
$arr = array( 1001,1002,1003);
$smarty->assign('custid', $arr);
?> 
{* this example will print out all the values of the $custid array *} {foreach from=$custid item=curr_id}   id: {$curr_id}<br /> {/foreach}

the above example will output: 

id: 1000<br /> id: 1001<br /> id: 1002<br />

example 7-6. {foreach} - item and key

// the key contains the key for each looped value
// assignment looks like this:
<?php
 $smarty->assign('contacts', array(
                             array('phone' => '1',
                                   'fax' => '2',
                                   'cell' => '3'),
                             array('phone' => '555-4444',
                                   'fax' => '555-3333',
                                   'cell' => '760-1234')
                             ));
?> 
{foreach name=outer item=contact from=$contacts}   <hr />   {foreach key=key item=item from=$contact}     {$key}: {$item}<br />   {/foreach} {/foreach}

the above example will output: 

<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-7. {foreach} - database example (eg pear or adodb)

<?php
  $sql = 'select contact_id, name, nick from contacts order by contact';
  $smarty->assign("contacts", $db->getassoc($sql));
?> 
{foreach key=cid item=con from=$contacts}   <a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br /> {/foreach}

{foreach} loops also have their own variables that handle {foreach} properties. these are indicated like so: {$smarty.foreach.foreachname.varname} with foreachname being the name specified as the name attribute of foreach

see {section} for examples of the properties below as they are identical

iteration

iteration is used to display the current loop iteration.iteration always starts with 1 and is incremented by one on each iteration.

first

first is set to true if the current foreach iteration is the first one.

last

last is set to true if the current foreach iteration is the last one.

show

show is used as a parameter to foreach. show is a boolean value, true or false. if false, the foreach will not be displayed. if there is a foreachelse present, that will be alternately displayed.

total

total is used to display the number of iterations that this foreach will loop. this can be used inside or after the foreach.

see also {section} and $smarty.foreach.

prevhomenext
{config_load}up{if},{elseif},{else}