cakephp-1.3 > HtmlHelper :: image()
A AclBase AclBehavior AclComponent AclNode AclShell Aco AcoAction AjaxHelper ApcEngine ApiShell App AppController AppController AppHelper AppHelper AppModel AppModel Aro AuthComponent B BakeShell BakeTask BehaviorCollection C Cache CacheEngine CacheHelper CakeErrorController CakeLog CakeRoute CakeSchema CakeSession CakeSocket ClassRegistry Component Configure ConnectionManager ConsoleShell ContainableBehavior Controller ControllerTask CookieComponent D DataSource DbAcl DbAclSchema DbConfigTask DboMssql DboMysql DboMysqlBase DboMysqli DboOracle DboPostgres DboSource DboSqlite Debugger Dispatcher E EmailComponent ErrorHandler ErrorHandler ExtractTask F File FileEngine FileLog FixtureTask Folder FormHelper H Helper HtmlHelper HttpSocket I I18n I18nModel i18nSchema I18nShell Inflector IniAcl J JavascriptHelper JqueryEngineHelper JsBaseEngineHelper JsHelper L L10n M MagicDb MagicFileResource MediaView MemcacheEngine Model ModelBehavior ModelTask MootoolsEngineHelper Multibyte N NumberHelper O Object Overloadable Overloadable Overloadable2 Overloadable2 P PagesController PagesController PaginatorHelper Permission PluginShortRoute PluginTask ProjectTask PrototypeEngineHelper R RequestHandlerComponent Router RssHelper S Sanitize Scaffold ScaffoldView SchemaShell Security SecurityComponent SessionComponent SessionHelper SessionsSchema Set Shell ShellDispatcher String T TemplateTask TestSuiteShell TestTask TextHelper ThemeView TimeHelper TranslateBehavior TreeBehavior V Validation View ViewTask X XcacheEngine Xml XmlElement XmlHelper XmlManager XmlNode XmlTextNode

image

line:604 at /cake/libs/view/helpers/html.php
Creates a formatted IMG element. If `$options['url']` is provided, an image link will be generated with the link pointed at `$options['url']`. This method will set an empty alt attribute if one is not supplied.

Method

(string) image ($path, $options = array())

Parameters

ParameterTypeCommentDefault
$path string required Path to the image file, relative to the app/webroot/img/ directory.
$options array optional Array of HTML attributes. array()

Return

string

Comment

Creates a formatted IMG element. If `$options['url']` is provided, an image link will be
generated with the link pointed at `$options['url']`. This method will set an empty
alt attribute if one is not supplied.

### Usage

Create a regular image:

`echo $html->image('cake_icon.png', array('alt' => 'CakePHP'));`

Create an image link:

`echo $html->image('cake_icon.png', array('alt' => 'CakePHP', 'url' => 'http://cakephp.org'));`

@param string $path Path to the image file, relative to the app/webroot/img/ directory.
@param array $options Array of HTML attributes.
@return string completed img tag
@access public
@link http://book.cakephp.org/view/1441/image