CakePHP
  • Documentation
    • Book
    • API
    • Videos
    • Reporting Security Issues
    • Privacy Policy
    • Logos & Trademarks
  • Business Solutions
  • Swag
  • Road Trip
  • Team
  • Community
    • Community
    • Get Involved
    • Issues (GitHub)
    • Bakery
    • Featured Resources
    • Training
    • Meetups
    • My CakePHP
    • CakeFest
    • Newsletter
    • Linkedin
    • YouTube
    • Facebook
    • Twitter
    • Mastodon
    • Help & Support
    • Forum
    • Stack Overflow
    • Slack
    • Paid Support
CakePHP

C CakePHP 1.3 API

  • Overview
  • Tree
  • Deprecated
  • Version:
    • 1.3
      • 4.2
      • 4.1
      • 4.0
      • 3.9
      • 3.8
      • 3.7
      • 3.6
      • 3.5
      • 3.4
      • 3.3
      • 3.2
      • 3.1
      • 3.0
      • 2.10
      • 2.9
      • 2.8
      • 2.7
      • 2.6
      • 2.5
      • 2.4
      • 2.3
      • 2.2
      • 2.1
      • 2.0
      • 1.3
      • 1.2

Classes

  • AclBase
  • AclBehavior
  • AclComponent
  • AclNode
  • AclShell
  • Aco
  • AcoAction
  • AjaxHelper
  • ApcEngine
  • ApiShell
  • App
  • AppController
  • AppHelper
  • AppModel
  • Aro
  • AuthComponent
  • BakeShell
  • BakeTask
  • BehaviorCollection
  • Cache
  • CacheEngine
  • CacheHelper
  • CakeErrorController
  • CakeLog
  • CakeRoute
  • CakeSchema
  • CakeSession
  • CakeSocket
  • ClassRegistry
  • Component
  • Configure
  • ConnectionManager
  • ConsoleShell
  • ContainableBehavior
  • Controller
  • ControllerTask
  • CookieComponent
  • DataSource
  • DbAcl
  • DbConfigTask
  • DboMssql
  • DboMysql
  • DboMysqlBase
  • DboMysqli
  • DboOracle
  • DboPostgres
  • DboSource
  • DboSqlite
  • Debugger
  • EmailComponent
  • ErrorHandler
  • ExtractTask
  • File
  • FileEngine
  • FileLog
  • FixtureTask
  • Folder
  • FormHelper
  • Helper
  • HtmlHelper
  • HttpSocket
  • I18n
  • I18nModel
  • I18nShell
  • Inflector
  • IniAcl
  • JavascriptHelper
  • JqueryEngineHelper
  • JsBaseEngineHelper
  • JsHelper
  • L10n
  • MagicDb
  • MagicFileResource
  • MediaView
  • MemcacheEngine
  • Model
  • ModelBehavior
  • ModelTask
  • MootoolsEngineHelper
  • Multibyte
  • NumberHelper
  • Object
  • Overloadable
  • Overloadable2
  • PagesController
  • PaginatorHelper
  • Permission
  • PluginShortRoute
  • PluginTask
  • ProjectTask
  • PrototypeEngineHelper
  • RequestHandlerComponent
  • Router
  • RssHelper
  • Sanitize
  • Scaffold
  • ScaffoldView
  • SchemaShell
  • Security
  • SecurityComponent
  • SessionComponent
  • SessionHelper
  • Set
  • Shell
  • String
  • TemplateTask
  • TestSuiteShell
  • TestTask
  • TextHelper
  • ThemeView
  • TimeHelper
  • TranslateBehavior
  • TreeBehavior
  • Validation
  • View
  • ViewTask
  • XcacheEngine
  • Xml
  • XmlElement
  • XmlHelper
  • XmlManager
  • XmlNode
  • XmlTextNode

Functions

  • mb_encode_mimeheader
  • mb_stripos
  • mb_stristr
  • mb_strlen
  • mb_strpos
  • mb_strrchr
  • mb_strrichr
  • mb_strripos
  • mb_strrpos
  • mb_strstr
  • mb_strtolower
  • mb_strtoupper
  • mb_substr
  • mb_substr_count

Class TemplateTask

Template Task can generate templated output Used in other Tasks

PHP versions 4 and 5

CakePHP(tm) : Rapid Development Framework (http://cakephp.org) Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)

Licensed under The MIT License Redistributions of files must retain the above copyright notice.

Object
Extended by Shell
Extended by TemplateTask
Package: cake\cake\console\libs\tasks
Copyright: Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
Link: CakePHP(tm) Project
Since: CakePHP(tm) v 1.3
License: License (http://www.opensource.org/licenses/mit-license.php)
Location: tasks/template.php

Properties summary

  • $templatePaths public
    array

    Paths to look for templates on. Contains a list of $theme => $path

  • $templateVars public
    array
    variables to add to template scope

Inherited Properties

  • DbConfig, Dispatch, alias, args, className, command, interactive, name, params, shell, taskNames, tasks, uses

Method Summary

  • _findTemplate() public

    Find a template inside a directory inside a path. Will scan all other theme dirs if the template is not found in the first directory.

  • _findThemes() public
    Find the paths to all the installed shell themes in the app.
  • generate() public
    Runs the template
  • getThemePath() public

    Find the theme name for the current operation. If there is only one theme in $templatePaths it will be used. If there is a -theme param in the cli args, it will be used. If there is more than one installed theme user interaction will happen

  • initialize() public
    Initialize callback. Setup paths for the template task.
  • set() public
    Set variable values to the template scope

Method Detail

_findTemplate() public ¶

_findTemplate( string $path , string $directory , string $filename )

Find a template inside a directory inside a path. Will scan all other theme dirs if the template is not found in the first directory.

Parameters
string $path
The initial path to look for the file on. If it is not found fallbacks will be used.
string $directory
Subdirectory to look for ie. 'views', 'objects'
string $filename
lower_case_underscored filename you want.
Returns
string
filename will exit program if template is not found.

_findThemes() public ¶

_findThemes( )

Find the paths to all the installed shell themes in the app.

Bake themes are directories not named skel inside a vendors/shells/templates path.

Returns
array
Array of bake themes that are installed.

generate() public ¶

generate( string $directory , string $filename , string $vars = null )

Runs the template

Parameters
string $directory
directory / type of thing you want
string $filename
template name
string $vars optional null
Additional vars to set to template scope.
Returns
contents
of generated code template

getThemePath() public ¶

getThemePath( )

Find the theme name for the current operation. If there is only one theme in $templatePaths it will be used. If there is a -theme param in the cli args, it will be used. If there is more than one installed theme user interaction will happen

Returns
string
returns the path to the selected theme.

initialize() public ¶

initialize( )

Initialize callback. Setup paths for the template task.

Overrides
Shell::initialize()

set() public ¶

set( mixed $one , mixed $two = null )

Set variable values to the template scope

Parameters
mixed $one
A string or an array of data.
mixed $two optional null

Value in case $one is a string (which then works as the key). Unused if $one is an associative array, otherwise serves as the values to $one's keys.

Methods inherited from Shell

__construct() public ¶

__construct( $dispatch )

Constructs this Shell instance.

Overrides
Object::__construct()

_checkArgs() public ¶

_checkArgs( integer $expectedNum , string $command = null )

Will check the number args matches otherwise throw an error

Parameters
integer $expectedNum
Expected number of paramters
string $command optional null
Command

_checkUnitTest() public ¶

_checkUnitTest( )

Action to create a Unit Test

Returns
boolean
Success

_controllerName() public ¶

_controllerName( string $name )

Creates the proper controller plural name for the specified controller class name

Parameters
string $name
Controller class name
Returns
string
Controller plural name

_controllerPath() public ¶

_controllerPath( string $name )

Creates the proper controller path for the specified controller class name

Parameters
string $name
Controller class name
Returns
string
Path to controller

_loadDbConfig() public ¶

_loadDbConfig( )

Loads database file and constructs DATABASE_CONFIG class makes $this->DbConfig available to subclasses

Returns
boolean

_loadModels() public ¶

_loadModels( )

if var $uses = true Loads AppModel file and constructs AppModel class makes $this->AppModel available to subclasses if var $uses is an array of models will load those models

Returns
boolean

_modelKey() public ¶

_modelKey( string $name )

Creates the proper underscored model key for associations

Parameters
string $name
Model class name
Returns
string
Singular model key

_modelName() public ¶

_modelName( string $name )

Creates the proper controller camelized name (singularized) for the specified name

Parameters
string $name
Name
Returns
string
Camelized and singularized controller name

_modelNameFromKey() public ¶

_modelNameFromKey( string $key )

Creates the proper model name from a foreign key

Parameters
string $key
Foreign key
Returns
string
Model name

_pluginPath() public ¶

_pluginPath( string $pluginName )

Find the correct path for a plugin. Scans $pluginPaths for the plugin you want.

Parameters
string $pluginName
Name of the plugin you want ie. DebugKit
Returns
string
$path path to the correct plugin.

_pluralHumanName() public ¶

_pluralHumanName( string $name )

Creates the plural human name used in views

Parameters
string $name
Controller name
Returns
string
Plural human name

_pluralName() public ¶

_pluralName( string $name )

Creates the plural name for views

Parameters
string $name
Name to use
Returns
string
Plural name for views

_singularHumanName() public ¶

_singularHumanName( string $name )

Creates the singular human name used in views

Parameters
string $name
Controller name
Returns
string
Singular human name

_singularName() public ¶

_singularName( string $name )

creates the singular name for use in views.

Parameters
string $name
Returns
string
$name

_welcome() public ¶

_welcome( )

Displays a header for the shell

createFile() public ¶

createFile( string $path , string $contents )

Creates a file at given path

Parameters
string $path
Where to put the file.
string $contents
Content to put in the file.
Returns
boolean
Success

err() public ¶

err( mixed $message = null , integer $newlines = 1 )

Outputs a single or multiple error messages to stderr. If no parameters are passed outputs just a newline.

Parameters
mixed $message optional null
A string or a an array of strings to output
integer $newlines optional 1
Number of newlines to append

error() public ¶

error( string $title , string $message = null )

Displays a formatted error message and exits the application with status code 1

Parameters
string $title
Title of the error
string $message optional null
An optional error message

help() public ¶

help( )

Outputs usage text on the standard output. Implement it in subclasses.

hr() public ¶

hr( integer $newlines = 0 )

Outputs a series of minus characters to the standard output, acts as a visual separator.

Parameters
integer $newlines optional 0
Number of newlines to pre- and append

in() public ¶

in( string $prompt , mixed $options = null , string $default = null )

Prompts the user for input, and returns it.

Parameters
string $prompt
Prompt text.
mixed $options optional null
Array or string of options.
string $default optional null
Default input value.
Returns
Either
the default value, or the user-provided input.

loadTasks() public ¶

loadTasks( )

Loads tasks defined in var $tasks

Returns
boolean

nl() public ¶

nl( integer $multiplier = 1 )

Returns a single or multiple linefeeds sequences.

Parameters
integer $multiplier optional 1
Number of times the linefeed sequence should be repeated
Returns
string

out() public ¶

out( mixed $message = null , integer $newlines = 1 )

Outputs a single or multiple messages to stdout. If no parameters are passed outputs just a newline.

Parameters
mixed $message optional null
A string or a an array of strings to output
integer $newlines optional 1
Number of newlines to append
Returns
integer
Returns the number of bytes returned from writing to stdout.

shortPath() public ¶

shortPath( string $file )

Makes absolute file path easier to read

Parameters
string $file
Absolute file path
Returns
sting
short path

startup() public ¶

startup( )

Starts up the Shell allows for checking and configuring prior to command or main execution can be overriden in subclasses

Methods inherited from Object

Object() public ¶

Object( )

A hack to support __construct() on PHP 4 Hint: descendant classes have no PHP4 class_name() constructors, so this constructor gets called first and calls the top-layer __construct() which (if present) should call parent::__construct()

Returns
Object

__openPersistent() public ¶

__openPersistent( string $name , string $type = null )

Open the persistent class file for reading Used by Object::_persist()

Parameters
string $name
Name of persisted class
string $type optional null
Type of persistance (e.g: registry)

_persist() public ¶

_persist( string $name , string $return , $object , $type = null )

Checks for a persistent class file, if found file is opened and true returned If file is not found a file is created and false returned If used in other locations of the model you should choose a unique name for the persistent file There are many uses for this method, see manual for examples

Parameters
string $name
name of the class to persist
string $return
$object the object to persist
$object
$type optional null
Returns
boolean
Success

_savePersistent() public ¶

_savePersistent( string $name , object $object )

You should choose a unique name for the persistent file

There are many uses for this method, see manual for examples

Parameters
string $name
name used for object to cache
object $object
the object to persist
Returns
boolean
true on save, throws error if file can not be created

_set() public ¶

_set( array $properties = array() )

Allows setting of multiple properties of the object in a single line of code. Will only set properties that are part of a class declaration.

Parameters
array $properties optional array()
An associative array containing properties and corresponding values.

_stop() public ¶

_stop( $status = 0 )

Stop execution of the current script. Wraps exit() making testing easier.

Parameters
$status optional 0
http://php.net/exit for values

cakeError() public ¶

cakeError( string $method , array $messages = array() )

Used to report user friendly errors. If there is a file app/error.php or app/app_error.php this file will be loaded error.php is the AppError class it should extend ErrorHandler class.

Parameters
string $method
Method to be called in the error class (AppError or ErrorHandler classes)
array $messages optional array()
Message that is to be displayed by the error class
Returns
error
message

dispatchMethod() public ¶

dispatchMethod( string $method , array $params = array() )

Calls a method on this object with the given parameters. Provides an OO wrapper for call_user_func_array

Parameters
string $method
Name of the method to call
array $params optional array()
Parameter list to use when calling $method
Returns
mixed
Returns the result of the method call

log() public ¶

log( string $msg , integer $type = LOG_ERROR )

Convience method to write a message to CakeLog. See CakeLog::write() for more information on writing to logs.

Parameters
string $msg
Log message
integer $type optional LOG_ERROR
Error type constant. Defined in app/config/core.php.
Returns
boolean
Success of log write

requestAction() public ¶

requestAction( mixed $url , array $extra = array() )

Calls a controller's method from any location. Can be used to connect controllers together or tie plugins into a main application. requestAction can be used to return rendered views or fetch the return value from controller actions.

Parameters
mixed $url
String or array-based url.
array $extra optional array()
if array includes the key "return" it sets the AutoRender to true.
Returns
mixed

Boolean true or false on success/failure, or contents of rendered action if 'return' is set in $extra.


toString() public ¶

toString( )

Object-to-string conversion. Each class can override this method as necessary.

Returns
string
The name of this class

Properties detail

$templatePaths ¶

public array

Paths to look for templates on. Contains a list of $theme => $path

array()

$templateVars ¶

public array

variables to add to template scope

array()
OpenHub
Rackspace
Rackspace
  • Business Solutions
  • Showcase
  • Documentation
  • Book
  • API
  • Videos
  • Reporting Security Issues
  • Privacy Policy
  • Logos & Trademarks
  • Community
  • Get Involved
  • Issues (GitHub)
  • Bakery
  • Featured Resources
  • Training
  • Meetups
  • My CakePHP
  • CakeFest
  • Newsletter
  • Linkedin
  • YouTube
  • Facebook
  • Twitter
  • Mastodon
  • Help & Support
  • Forum
  • Stack Overflow
  • Slack
  • Paid Support

Generated using CakePHP API Docs