What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
void smarty_function_name( |
$params, | |
&$smarty) ; |
array $params
;object &$smarty
;
Alle einer Funktion übergebenen Parameter werden in der Variable
$params
als assoziatives Array abgelegt. Sie können
auf diese Werte entweder direkt mit $params['start']
zugreifen
oder sie mit extract($params)
in die Symbol-Tabelle importieren.
Die Ausgabe der Funktion wird verwendet, um das Funktions-Tag im Template
(fetch
Funktion, zum Beispiel) zu ersetzen.
Alternativ kann sie auch etwas tun, ohne eine Ausgabe zurückzuliefern
(assign
Funktion, zum Beispiel).
Falls die Funktion dem Template Variablen zuweisen oder
auf eine andere Smarty-Funktionalität zugreifen möchte, kann dazu das
übergebene $smarty
Objekt verwendet werden.
Sehen Sie dazu: register_function(), unregister_function().
Example 16.1. Funktionsplugin mit Ausgabe
<?php /* * Smarty plugin * ------------------------------------------------------------- * File: function.eightball.php * Type: function * Name: eightball * Purpose: outputs a random magic answer * ------------------------------------------------------------- */ function smarty_function_eightball($params, &$smarty) { $answers = array('Yes', 'No', 'No way', 'Outlook not so good', 'Ask again soon', 'Maybe in your reality'); $result = array_rand($answers); return $answers[$result]; } ?>
Es kann im Template wie folgt angewendet werden:
Question: Will we ever have time travel? Answer: {eightball}.
Example 16.2. Funktionsplugin ohne Ausgabe
<?php /* * Smarty plugin * ------------------------------------------------------------- * File: function.assign.php * Type: function * Name: assign * Purpose: assign a value to a template variable * ------------------------------------------------------------- */ function smarty_function_assign($params, &$smarty) { if (empty($params['var'])) { $smarty->trigger_error("assign: missing 'var' parameter"); return; } if (!in_array('value', array_keys($params))) { $smarty->trigger_error("assign: missing 'value' parameter"); return; } $smarty->assign($params['var'], $params['value']); } ?>