html_image

属性名称TypeRequiredDefaultDescription
namestringYesn/aname/path to image
borderstringNo0size of border around image
heightstringNoactual image heightheight to display image
widthstringNoactual image widthwidth to display image
basedirstringnoweb server doc rootdirectory to base relative paths from

html_image is a custom function that generates an HTML tag for an image. The height and width are automatically calculated from the image file if none are supplied.

basedir is the base directory that relative image paths are based from. If not given, the web server document root (env variable DOCUMENT_ROOT) is used as the base. If security is enabled, the path to the image must be within a secure directory.

Technical Note: html_image requires a hit to the disk to read the image and calculate the height and width. If you don't use template caching, it is generally better to avoid html_image and leave image tags static for optimal performance.

Example 8-7. html_image

index.php:



require('Smarty.php.class');

$smarty = new Smarty;

$smarty->display('index.tpl');



index.tpl:



{image file="pumpkin.jpg"}

{image file="/path/from/docroot/pumpkin.jpg"}

{image file="../path/relative/to/currdir/pumpkin.jpg"}



OUTPUT: (possible)



<img src="pumpkin.jpg" border="0" width="44" height="68">

<img src="/path/under/docroot/pumpkin.jpg" border="0" width="44" height="68">

<img src="../path/relative/to/currdir/pumpkin.jpg" border="0" width="44" height="68">