Class Cell
Cell base.
Constants
-
stringTEMPLATE_FOLDER ¶'cell'Constant for folder name containing cell templates.
Property Summary
-
$View protected
Cake\View\ViewInstance of the View created during rendering. Won't be set until after Cell::__toString()/render() is called.
-
$_cache protected
array|boolCaching setup.
-
$_eventClass protected
stringDefault class name for new event objects.
-
$_eventManager protected
Cake\Event\EventManagerInterface|nullInstance of the Cake\Event\EventManager this object is using to dispatch inner events.
-
$_tableLocator protected
Cake\ORM\Locator\LocatorInterface|nullTable locator instance
-
$_validCellOptions protected
array<string>List of valid options (constructor's fourth arguments) Override this property in subclasses to allow which options you want set as properties in your Cell.
-
$_viewBuilder protected
Cake\View\ViewBuilder|nullThe view builder instance being used.
-
$action protected
stringThe cell's action to invoke.
-
$args protected
arrayArguments to pass to cell's action.
-
$defaultTable protected
string|nullThis object's default table alias.
-
$request protected
Cake\Http\ServerRequestAn instance of a Cake\Http\ServerRequest object that contains information about the current request. This object contains all the information about a request and several methods for reading additional information about the request.
-
$response protected
Cake\Http\ResponseAn instance of a Response object that contains information about the impending response
Method Summary
-
__construct() public
Constructor.
-
__debugInfo() public
Debug info.
-
__toString() public
Magic method.
-
_cacheConfig() protected
Generate the cache key to use for this cell.
-
createView() public
Constructs the view class instance based on the current configuration.
-
dispatchEvent() public
Wrapper for creating and dispatching events.
-
fetchTable() public
Convenience method to get a table instance.
-
getEventManager() public
Returns the Cake\Event\EventManager manager instance for this object.
-
getTableLocator() public
Gets the table locator.
-
initialize() public
Initialization hook method.
-
render() public
Render the cell.
-
set() public
Saves a variable or an associative array of variables for use inside a template.
-
setEventManager() public
Returns the Cake\Event\EventManagerInterface instance for this object.
-
setTableLocator() public
Sets the table locator.
-
viewBuilder() public
Get the view builder being used.
Method Detail
__construct() ¶ public
__construct(Cake\Http\ServerRequest $request, Cake\Http\Response $response, Cake\Event\EventManagerInterface|null $eventManager = null, array<string, mixed> $cellOptions = [])Constructor.
Parameters
-
Cake\Http\ServerRequest$request The request to use in the cell.
-
Cake\Http\Response$response The response to use in the cell.
-
Cake\Event\EventManagerInterface|null$eventManager optional The eventManager to bind events to.
-
array<string, mixed>$cellOptions optional Cell options to apply.
__toString() ¶ public
__toString(): stringMagic method.
Starts the rendering process when Cell is echoed.
Note This method will trigger an error when view rendering has a problem. This is because PHP will not allow a __toString() method to throw an exception.
Returns
stringThrows
ErrorInclude error details for PHP 7 fatal errors.
_cacheConfig() ¶ protected
_cacheConfig(string $action, string|null $template = null): arrayGenerate the cache key to use for this cell.
If the key is undefined, the cell class and action name will be used.
Parameters
-
string$action The action invoked.
-
string|null$template optional The name of the template to be rendered.
Returns
arraycreateView() ¶ public
createView(string|null $viewClass = null): Cake\View\ViewConstructs the view class instance based on the current configuration.
Parameters
-
string|null$viewClass optional Optional namespaced class name of the View class to instantiate.
Returns
Cake\View\ViewThrows
Cake\View\Exception\MissingViewExceptionIf view class was not found.
dispatchEvent() ¶ public
dispatchEvent(string $name, array $data = [], TSubject|null $subject = null): Cake\Event\EventInterface<TSubject>Wrapper for creating and dispatching events.
Returns a dispatched event.
Parameters
-
string$name Name of the event.
-
array$data optional Any value you wish to be transported with this event to it can be read by listeners.
-
TSubject|null$subject optional The object that this event applies to ($this by default).
Returns
Cake\Event\EventInterface<TSubject>fetchTable() ¶ public
fetchTable(string|null $alias = null, array<string, mixed> $options = []): Cake\ORM\TableConvenience method to get a table instance.
Parameters
-
string|null$alias optional The alias name you want to get. Should be in CamelCase format. If
nullthen the value of $defaultTable property is used.-
array<string, mixed>$options optional The options you want to build the table with. If a table has already been loaded the registry options will be ignored.
Returns
Cake\ORM\TableThrows
Cake\Core\Exception\CakeExceptionIf `$alias` argument and `$defaultTable` property both are `null`.
See Also
getEventManager() ¶ public
getEventManager(): Cake\Event\EventManagerInterfaceReturns the Cake\Event\EventManager manager instance for this object.
You can use this instance to register any new listeners or callbacks to the object events, or create your own events and trigger them at will.
Returns
Cake\Event\EventManagerInterfacegetTableLocator() ¶ public
getTableLocator(): Cake\ORM\Locator\LocatorInterfaceGets the table locator.
Returns
Cake\ORM\Locator\LocatorInterfaceinitialize() ¶ public
initialize(): voidInitialization hook method.
Implement this method to avoid having to overwrite the constructor and calling parent::__construct().
Returns
voidrender() ¶ public
render(string|null $template = null): stringRender the cell.
Parameters
-
string|null$template optional Custom template name to render. If not provided (null), the last value will be used. This value is automatically set by
CellTrait::cell().
Returns
stringThrows
Cake\View\Exception\MissingCellTemplateExceptionBadMethodCallExceptionset() ¶ public
set(array|string $name, mixed $value = null): $thisSaves a variable or an associative array of variables for use inside a template.
Parameters
-
array|string$name A string or an array of data.
-
mixed$value optional Value in case $name is a string (which then works as the key). Unused if $name is an associative array, otherwise serves as the values to $name's keys.
Returns
$thissetEventManager() ¶ public
setEventManager(Cake\Event\EventManagerInterface $eventManager): $thisReturns the Cake\Event\EventManagerInterface instance for this object.
You can use this instance to register any new listeners or callbacks to the object events, or create your own events and trigger them at will.
Parameters
-
Cake\Event\EventManagerInterface$eventManager the eventManager to set
Returns
$thissetTableLocator() ¶ public
setTableLocator(Cake\ORM\Locator\LocatorInterface $tableLocator): $thisSets the table locator.
Parameters
-
Cake\ORM\Locator\LocatorInterface$tableLocator LocatorInterface instance.
Returns
$thisviewBuilder() ¶ public
viewBuilder(): Cake\View\ViewBuilderGet the view builder being used.
Returns
Cake\View\ViewBuilderProperty Detail
$View ¶ protected
Instance of the View created during rendering. Won't be set until after Cell::__toString()/render() is called.
Type
Cake\View\View$_eventManager ¶ protected
Instance of the Cake\Event\EventManager this object is using to dispatch inner events.
Type
Cake\Event\EventManagerInterface|null$_validCellOptions ¶ protected
List of valid options (constructor's fourth arguments) Override this property in subclasses to allow which options you want set as properties in your Cell.
Type
array<string>$request ¶ protected
An instance of a Cake\Http\ServerRequest object that contains information about the current request. This object contains all the information about a request and several methods for reading additional information about the request.
Type
Cake\Http\ServerRequest$response ¶ protected
An instance of a Response object that contains information about the impending response
Type
Cake\Http\Response