PhpRiot
Become Zend Certified

Prepare for the ZCE exam using our quizzes (web or iPad/iPhone). More info...


When you're ready get 7.5% off your exam voucher using voucher CJQNOV23 at the Zend Store

Name

assign() — assign variables/objects to the templates

Description

void assign(mixed var);
void assign(string varname,
            mixed var,
            bool nocache);

You can explicitly pass name/value pairs, or associative arrays containing the name/value pairs.

If you pass the optional third nocache parameter of TRUE, the variable is assigned as nocache variable. See Cacheability of Variables for details.

Note

When you assign/register objects to templates, be sure that all properties and methods accessed from the template are for presentation purposes only. It is very easy to inject application logic through objects, and this leads to poor designs that are difficult to manage. See the Best Practices section of the Smarty website.

Example 168. assign()



<?php
// passing name/value pairs
$smarty->assign('Name''Fred');
$smarty->assign('Address'$address);

// passing an associative array
$smarty->assign(array('city' => 'Lincoln''state' => 'Nebraska'));

// passing an array
$myArray = array('no' => 10'label' => 'Peanuts');
$smarty->assign('foo',$myArray);

// passing a row from a database (eg adodb)
$sql 'select id, name, email from contacts where contact ='.$id;
$smarty->assign('contact'$db->getRow($sql));
?>

These are accessed in the template with


{* note the vars are case sensitive like php *}
{$Name}
{$Address}
{$city}
{$state}

{$foo.no}, {$foo.label}
{$contact.id}, {$contact.name},{$contact.email}


To access more complex array assignments see {foreach} and {section}

See also assignByRef(), getTemplateVars(), clearAssign(), append() and {assign}

Smarty Template Engine