Класс View

public function beforeRender(\Cake\Event\Event $event)
{
     $this->viewBuilder()->theme('SuperHot');
}

__constructsource public

__construct( Cake\Network\Request $request null , Cake\Network\Response $response null , Cake\Event\EventManager $eventManager null , array $viewOptions [] )

Конструктор

Параметры

Cake\Network\Request $request необязательно null

Экземпляр запроса.

Cake\Network\Response $response необязательно null

Экземпляр ответа.

Cake\Event\EventManager $eventManager необязательно null

Экземпляр менеджера событий.

массив $viewOptions необязательно []

Параметры представления. См. View::$_passedVars для списка параметров, которые устанавливаются как свойства класса.

__getsource public

__get( string $name )

Магический аксессор для helpers.

Параметры

строка $name

Имя атрибута для получения.

Возвращает

mixed
смешанное

__setsource public

__set( string $name , mixed $value )

Магический сеттер для устаревших свойств.

Параметры

строка $name

Имя свойства.

смешанное $value

Значение свойства.

_checkFilePathsource protected

_checkFilePath( string $file , string $path )

Проверка, что путь к файлу представления не выходит за пределы определённых путей шаблонов.

Проверяются только пути, содержащие .., так как они наиболее склонны к разрешению файлов за пределами путей шаблонов.

Параметры

строка $file

Путь к файлу шаблона.

строка $path

Базовый путь, в котором должен находиться $file.

Возвращает

string
Путь к файлу

Выбрасывает

InvalidArgumentException
\InvalidArgumentException

_elementCachesource protected

_elementCache( string $name , array $data , array $options )

Генерация параметров кэширования для элемента.

Параметры

строка $name

Имя элемента

массив $data

Данные

массив $options

Параметры элемента

Возвращает

array
Конфигурация кэша элемента.

_evaluatesource protected

_evaluate( string $viewFile , array $dataForView )

Метод для оценки шаблона / скрипта представления.

Параметры

строка $viewFile

Имя файла представления

массив $dataForView

Данные для включения в отрисованное представление. Если пусто, будет использован текущий View::$viewVars.

Возвращает

string
Результат рендеринга

_getElementFileNamesource protected

_getElementFileName( string $name )

Находит имя файла элемента, возвращает false при неудаче.

Параметры

строка $name

Имя элемента для поиска.

Возвращает

string|false
Строка с именем файла элемента или false при отсутствии файла.

_getLayoutFileNamesource protected

_getLayoutFileName( string|null $name null )

Возвращает имя файла макета для этого шаблона в виде строки.

Параметры

строка|null $name необязательно null

Имя макета для поиска.

Возвращает

string
Имя файла макета (.ctp).

Выбрасывает

Cake\View\Exception\MissingLayoutException
при невозможности найти макет

_getSubPathssource protected

_getSubPaths( string $basePath )

Находит все пути к подшаблонам, основанные на $basePath. Если в текущем запросе определён префикс, этот метод добавит префиксный путь к шаблонам к $basePath, переходя вверх по иерархии в случае вложенного префикса. Это используется для поиска префиксных путей шаблонов для элементов и макетов.

Параметры

строка $basePath

Базовый путь, для которого нужно получить префиксный.

Возвращает

array
Массив со всеми путями шаблонов.

_getViewFileNamesource protected

_getViewFileName( string|null $name null )

Возвращает имя файла шаблона действия (.ctp) в виде строки. Имена действий с верблюжьей нотацией преобразуются в нижний регистр с дефисами по умолчанию. Это позволяет использовать имена действий с верблюжьей нотацией, которые ссылаются на представления с нижним регистром с дефисами. Вы можете изменить правило инфлексии, переопределив _inflectViewFileName.

Параметры

строка|null $name необязательно null

Действие контроллера для поиска имени файла шаблона

Возвращает

string
Имя файла шаблона

Выбрасывает

Cake\View\Exception\MissingTemplateException
при невозможности найти файл представления.

_inflectViewFileNamesource protected

_inflectViewFileName( string $name )

Изменение имени файла шаблона представления в формате с нижним регистром и дефисами.

Параметры

строка $name

Имя файла, которое нужно изменить.

Возвращает

string
Имя файла после преобразования

_pathssource protected

_paths( string|null $plugin null , boolean $cached true )

Возвращает все возможные пути к файлам представления в порядке их обработки.

Параметры

строка|null $plugin необязательно null

Необязательное имя плагина для поиска файлов представления.

логическое значение $cached необязательно true

Установите в false, чтобы принудительно обновить пути к представлениям. По умолчанию true.

Возвращает

array
Пути

_rendersource protected

_render( string $viewFile , array $data [] )

Отображает и возвращает вывод для заданного имени файла шаблона с его массивом данных. Обрабатывает родительские/расширенные шаблоны.

Параметры

строка $viewFile

Имя файла представления

массив $data необязательно []

Данные для включения в отображаемое представление. Если пусто, будут использоваться текущие View::$viewVars.

Возвращает

string
Отображенный вывод

Выбрасывает

LogicException
Когда блок остается открытым.

Вызывает

View.beforeRenderFile $this, [$viewFile]
View.afterRenderFile $this, [$viewFile, $content]

_renderElementsource protected

_renderElement( string $file , array $data , array $options )

Отображает элемент и вызывает обратные вызовы before и afterRender для него и записывает в кэш, если используется кэш.

Параметры

строка $file

Путь к файлу элемента

массив $data

Данные для отображения

массив $options

Параметры элемента

Возвращает

string
строка

Вызывает

View.beforeRender $this, [$file]
View.afterRender $this, [$file, $element]

appendsource public

append( string $name , mixed $value null )

Добавляет к существующему или новому блоку.

Добавление к новому блоку создаст этот блок.

Параметры

строка $name

Имя блока

смешанный $value необязательно null

Содержимое блока.

См.

Cake\View\ViewBlock::concat()

assignsource public

assign( string $name , mixed $value )

Устанавливает содержимое блока. Это перезапишет любое существующее содержимое.

Параметры

строка $name

Имя блока

смешанный $value

Содержимое блока.

См.

Cake\View\ViewBlock::set()

autoLayoutsource public

autoLayout( boolean $autoLayout null )

Включает или выключает традиционный режим CakePHP по применению файлов макета. Включено по умолчанию. Выключение означает, что макеты не будут автоматически применяться к отображаемым шаблонам.

Параметры

boolean $autoLayout необязательно null

Булево значение для включения/выключения. Если null, возвращает текущее значение.

Возвращает

boolean|null
bool|null

blockssource public

blocks( )

Получить имена всех существующих блоков.

Возвращает

array
Массив, содержащий блоки.

См.

Cake\View\ViewBlock::keys()

cachesource public

cache( callable $block , array $options [] )

Создать кэшированный блок логики представления.

Это позволяет кэшировать блок вывода представления в кэш, определенный в elementCache.

Этот метод сначала попытается прочитать кэш. Если кэш пуст, $block будет выполнен, и результат будет сохранен.

Параметры

вызываемая функция $block

Блок кода, вывод которого вы хотите кэшировать.

массив $options необязательно []

Параметры, определяющие ключ кэша и т. д.

Возвращает

string
Содержимое, которое отображается.

Выбрасывает

RuntimeException
Когда в $options отсутствует опция 'key'.

elementsource public

element( string $name , array $data [] , array $options [] )

Отображает фрагмент PHP с предоставленными параметрами и возвращает HTML, XML или любую другую строку.

Это реализует концепцию элементов (или «частичных макетов»), и массив $params используется для передачи данных, которые будут использоваться в элементе. Элементы могут быть кэшированы, улучшая производительность, используя опцию cache.

Параметры

строка $name

Имя файла шаблона в папке /src/Template/Element/, или MyPlugin.template для использования шаблона элемента из MyPlugin. Если элемент не найден в плагине, будет произведён поиск в обычной цепочке путей представления.

массив $data необязательно []

Массив данных, которые будут доступны отображаемому представлению (т. е. элементу).

массив $options необязательно []

Массив параметров. Возможные ключи: - cache - Может быть true, чтобы включить кэширование, используя конфигурацию в View::$elementCache. Или массив. Если массив, можно использовать следующие ключи: - config - Используется для хранения кэшированного элемента в пользовательской конфигурации кэша. - key - Используется для определения ключа, используемого в Cache::write(). Будет префикс с element_ - callbacks - Устанавливается в true для запуска обратных вызовов beforeRender и afterRender для этого элемента. По умолчанию false. - ignoreMissing - Используется для обработки отсутствующих элементов. Установите в true, чтобы не выбрасывать исключения.

Возвращает

string
Отображенный элемент

Выбрасывает

Cake\View\Exception\MissingElementException
Если элемент отсутствует и ignoreMissing равно false.

elementExistssource public

elementExists( string $name )

Проверяет наличие элемента

Параметры

строка $name

Имя файла шаблона в папке /src/Template/Element/ или MyPlugin.template для проверки шаблона элемента из MyPlugin. Если элемент не найден в плагине, будет произведён поиск в обычной цепочке путей представления.

Возвращает

boolean
Успех

endsource public

end( )

Завершить блок захвата. Дополнение к View::start()

См.

Cake\View\ViewBlock::end()

existssource public

exists( string $name )

Проверка существования блока

Параметры

строка $name

Имя блока

Возвращает

boolean
bool

extendsource public

extend( string $name )

Обеспечивает расширение/наследование шаблона или элемента. Представления могут расширять родительское представление и заполнять блоки в родительском шаблоне.

Параметры

строка $name

Шаблон или элемент, с которым нужно «расширить» текущий.

Выбрасывает

LogicException
при расширении шаблона с самим собой или создании циклов расширения.
LogicException
если вы расширяете элемент, которого нет.

fetchsource public

fetch( string $name , string $default '' )

Получить содержимое блока. Если блок пустой или неопределён, будет возвращено ''.

Параметры

строка $name

Имя блока

строка $default необязательно ''

Текс по умолчанию

Возвращает

string
содержимое блока или $default, если блок не существует.

См.

Cake\View\ViewBlock::get()

getsource public

get( string $var , mixed $default null )

Возвращает содержимое заданной переменной View.

Параметры

строка $var

Переменная представления, содержимое которой нужно получить.

смешанный $default необязательно null

Содержимое по умолчанию/значение по умолчанию $var.

Возвращает

mixed
Содержимое названной переменной, если она установлена, иначе $default.

getCurrentTypesource public

getCurrentType( )

Получить текущий тип представления

Возвращает

string
строка

getVarssource public

getVars( )

Возвращает список переменных, доступных в текущем контексте представления.

Возвращает

array
Массив имен установленных переменных представления.

helperssource public

helpers( )

Получить реестр помощников, используемый этим классом представления.

Возвращает

Cake\View\HelperRegistry
\Cake\View\HelperRegistry

initializesource public

initialize( )

Метод инициализации.

Свойства, такие как $helpers и т. д., не могут быть инициализированы статически в вашем пользовательском классе представления, так как они перезаписываются значениями из контроллера в конструкторе. Этот метод позволяет манипулировать ими по мере необходимости после построения экземпляра представления.

layoutsource public

layout( string $name null )

Получить/установить имя файла макета для рендеринга шаблона внутри него. Указанное имя — это имя файла макета в /src/Template/Layout без расширения .ctp.

Параметры

string $name необязательный null

Имя файла макета для установки. Если null, возвращает текущее имя.

Возвращает

string|null
string|null

layoutPathsource public

layoutPath( string $path null )

Получить/установить путь к файлам макета.

Параметры

string $path необязательный null

Путь к файлам макета. Если null, возвращает текущий путь.

Возвращает

string|null
string|null

loadHelpersource public

loadHelper( string $name , array $config [] )

Загружает помощника. Делегирует загрузку помощника HelperRegistry::load().

Параметры

string $name

Имя помощника для загрузки.

array $config необязательный []

Настройки помощника.

Возвращает

Cake\View\Helper
Созданный объект помощника.

См. также

Cake\Core\ObjectRegistry::load()

loadHelperssource public

loadHelpers( )

Взаимодействие с HelperRegistry для загрузки всех помощников.

pluginSplitsource public

pluginSplit( string $name , boolean $fallback true )

Разделяет имя плагина в формате точка на имя плагина и имя файла. Если в $name нет точки, то индекс 0 будет null. Проверяет, загружен ли плагин, иначе имя файла останется неизменным для имён файлов, содержащих точку.

Параметры

string $name

Имя плагина, которое нужно разделить.

boolean $fallback необязательный true

Если true, использует плагин, установленный в текущем запросе, когда загруженный плагин не найден.

Возвращает

array
Массив с 2 индексами. 0 => имя плагина, 1 => имя файла

prependsource public

prepend( string $name , mixed $value )

Добавить в начало существующего или нового блока.

Добавление в начало нового блока создаст этот блок.

Параметры

string $name

Имя блока.

mixed $value

Содержимое блока.

См. также

Cake\View\ViewBlock::concat()

rendersource public

render( string|null $view null , string|null $layout null )

Рендерит представление для заданного файла шаблона и макета.

Render вызывает обратные вызовы помощников, которые срабатывают до и после рендеринга шаблона, а также до и после макета. Обратные вызовы помощников вызываются:

• beforeRender
• afterRender
• beforeLayout
• afterLayout

Если View::$autoRender равно false и не предоставлен $layout, шаблон будет возвращен без обработки.

Имена шаблонов и макетов могут указывать на плагин шаблонов/макетов. Используя синтаксис Plugin.template, можно использовать шаблон/макет плагина вместо приложений. Если выбранный плагин не найден, шаблон будет расположен по стандартному пути к представлениям.

Параметры

string|null $view необязательный null

Имя файла представления для использования.

string|null $layout необязательный null

Макет для использования.

Возвращает

string|null
Отрендеренное содержимое или null, если содержимое уже было отрендерено и возвращено ранее.

Исключения

Cake\Core\Exception\Exception
Если возникает ошибка в представлении.

Вызывает

View.beforeRender $this, [$viewFileName]
View.afterRender $this, [$viewFileName]

renderLayoutsource public

renderLayout( string $content , string|null $layout null )

Рендерит макет. Возвращает вывод из _render(). Возвращает false при ошибке. Для использования в макете создаются несколько переменных.

Параметры

string $content

Содержимое для рендеринга в шаблоне, обернутое окружающим макетом.

string|null $layout необязательный null

Имя макета.

Возвращает

mixed
Отрендеренный вывод или false при ошибке

Исключения

Cake\Core\Exception\Exception
Если возникает ошибка в представлении.

Вызывает

View.beforeLayout $this, [$layoutFileName]
View.afterLayout $this, [$layoutFileName]

resetsource public

reset( string $name )

Сбросить содержимое блока. Это перезапишет любое существующее содержимое.

Параметры

string $name

Имя блока.

См. также

Cake\View\ViewBlock::set()

startsource public

start( string $name )

Начать захват вывода для 'блока'.

Вы можете использовать start для блока несколько раз, чтобы добавлять или вставлять содержимое в режиме захвата.

// Append content to an existing block.
$this->start('content');
echo $this->fetch('content');
echo 'Some new content';
$this->end();

// Prepend content to an existing block
$this->start('content');
echo 'Some new content';
echo $this->fetch('content');
$this->end();

Параметры

string $name

Имя блока для захвата.

См. также

Cake\View\ViewBlock::start()

templatesource public

template( string $name null )

Получить/установить имя файла шаблона для рендеринга. Указанное имя — это имя файла в /src/Template/<SubFolder> без расширения .ctp.

Параметры

string $name необязательный null

Имя файла шаблона для установки. Если null, возвращает текущее имя.

Возвращает

string|null
string|null

templatePathsource public

templatePath( string $path null )

Получить/установить путь к файлам шаблонов.

Параметры

string $path необязательный null

Путь к файлам шаблонов. Если null, возвращает текущий путь.

Возвращает

string|null
string|null

themesource public

theme( string $theme null )

Тема представления для использования.

Параметры

string $theme необязательный null

Имя темы. Если null, возвращает текущую тему.

Возвращает

string|null
string|null

uuidsource public

uuid( string $object , string $url )

Генерирует уникальный, неслучайный идентификатор DOM для объекта, основанный на типе объекта и целевом URL.

Параметры

строка $object

Тип объекта, например, 'форма' или 'ссылка'

строка $url

Целевой URL объекта

Возвращает

string
строка

_createCellsource protected

_createCell( string $className , string $action , string $plugin , array $options )

Создаёт и настраивает экземпляр ячейки.

Параметры

строка $className

Имя класса ячейки.

строка $action

Имя действия.

строка $plugin

Имя плагина.

массив $options

Опции конструктора для ячейки.

Возвращает

Cake\View\Cell;
\Cake\View\Cell;

cellsource public

cell( string $cell , array $data [] , array $options [] )

Отображает заданную ячейку.

Пример:

// Taxonomy\View\Cell\TagCloudCell::smallList()
$cell = $this->cell('Taxonomy.TagCloud::smallList', ['limit' => 10]);

// App\View\Cell\TagCloudCell::smallList()
$cell = $this->cell('TagCloud::smallList', ['limit' => 10]);

Действие display будет использоваться по умолчанию, если действие не указано:

// Taxonomy\View\Cell\TagCloudCell::display()
$cell = $this->cell('Taxonomy.TagCloud');

Ячейки не отображаются, пока они не выведены.

Параметры

строка $cell

Необходимо указать имя ячейки и, необязательно, имя действия ячейки. Например: TagCloud::smallList вызовет View\Cell\TagCloudCell::smallList(), действие display будет вызвано по умолчанию, если оно не указано.

массив $data необязательно []

Дополнительные аргументы для метода ячейки. Например: cell('TagCloud::smallList', ['a1' => 'v1', 'a2' => 'v2']) соответствует View\Cell\TagCloud::smallList(v1, v2)

массив $options необязательно []

Опции для конструктора ячейки

Возвращает

Cake\View\Cell
Экземпляр ячейки

Выбрасывает

Cake\View\Exception\MissingCellException
Если класс ячейки не найден.
BadMethodCallException
Если класс ячейки не указал действие ячейки.

dispatchEventsource public

dispatchEvent( string $name , array|null $data null , object|null $subject null )

Обёртка для создания и отправки событий.

Возвращает обработанное событие.

Параметры

строка $name

Имя события.

массив|null $data необязательно null

Любое значение, которое вы хотите передать с этим событием, чтобы его могли прочитать слушатели.

объект|null $subject необязательно null

Объект, к которому относится это событие (по умолчанию $this).

Возвращает

Cake\Event\Event
\Cake\Event\Event

Реализация

Cake\Event\EventDispatcherInterface::dispatchEvent()

eventManagersource public

eventManager( Cake\Event\EventManager $eventManager null )

Возвращает экземпляр менеджера Cake\Event\EventManager для этого объекта.

Вы можете использовать этот экземпляр для регистрации новых слушателей или обратных вызовов для событий объекта, или для создания собственных событий и их запуска по своему желанию.

Параметры

Cake\Event\EventManager $eventManager необязательно null

устанавливаемый eventManager

Возвращает

Cake\Event\EventManager
\Cake\Event\EventManager

Реализация

Cake\Event\EventDispatcherInterface::eventManager()

logsource public

log( mixed $msg , integer|string $level LogLevel::ERROR , string|array $context [] )

Удобный метод для записи сообщения в журнал. Дополнительную информацию о записи в журналы см. в Log::write().

Параметры

смешанный $msg

Сообщение журнала.

целое число|строка $level необязательно LogLevel::ERROR

Уровень ошибки.

строка|массив $context необязательно []

Дополнительные данные журнала, относящиеся к этому сообщению.

Возвращает

boolean
Успех записи в журнал.

requestActionsource public

requestAction( string|array $url , array $extra [] )

Вызывает метод контроллера из любой точки. Может использоваться для подключения контроллеров или связи плагинов с основным приложением. requestAction может возвращать отображённые представления или извлекать возвращаемое значение из действий контроллеров.

Под капотом этот метод использует Router::reverse() для преобразования параметра $url в строковый URL. Вы должны использовать форматы URL, совместимые с Router::reverse().

Примеры

Базовый пример получения возвращаемого значения действия контроллера:

$variables = $this->requestAction('/articles/popular');

Базовый пример request action для получения отображаемой страницы без макета.

$viewHtml = $this->requestAction('/articles/popular', ['return']);

Вы также можете передать URL в виде массива:

$vars = $this->requestAction(['controller' => 'articles', 'action' => 'popular']);

Передача других данных запроса

Вы можете передать POST, GET, COOKIE и другие данные в запрос, используя соответствующие ключи. Куки можно передать с помощью ключа cookies. Параметры GET можно установить с помощью ключа query, а данные POST можно отправить с помощью ключа post.

$vars = $this->requestAction('/articles/popular', [
  'query' => ['page' => 1],
  'cookies' => ['remember_me' => 1],
]);

Отправка значений среды или заголовков

По умолчанию действия, отправленные с помощью этого метода, будут использовать глобальные значения $_SERVER и $_ENV. Если вы хотите переопределить эти значения для действия запроса, вы можете указать значения:

$vars = $this->requestAction('/articles/popular', [
  'environment' => ['CONTENT_TYPE' => 'application/json']
]);

Передача сессии

По умолчанию действия, отправленные с помощью этого метода, будут использовать стандартный объект сессии. Если вы хотите использовать конкретный экземпляр сессии, вам нужно указать его.

$vars = $this->requestAction('/articles/popular', [
  'session' => new Session($someSessionConfig)
]);

Параметры

строка|массив $url

Строка или URL в формате массива. В отличие от других массивов URL в CakePHP, этот URL не будет автоматически обрабатывать переданные аргументы в параметре $url.

массив $extra необязательно []

если массив содержит ключ "return", он устанавливает autoRender в true. Также может использоваться для отправки данных GET/POST и переданных аргументов.

Возвращает

mixed
Булево значение true или false при успехе/неудачи или содержимое обработанного действия, если в $extra указан ключ 'return'.

createViewsource public

createView( string|null $viewClass null )

Создаёт экземпляр класса представления на основе текущей конфигурации.

Параметры

строка|null $viewClass необязательно null

Необязательное имя класса представления с пространством имён для инициализации.

Возвращает

Cake\View\View
\Cake\View\View

Выбрасывает

Cake\View\Exception\MissingViewException
Если класс представления не найден.

setsource public

set( string|array $name , string|array|null|boolean $value null )

Сохраняет переменную или ассоциативный массив переменных для использования внутри шаблона.

Параметры

строка|массив $name

Строка или массив данных.

строка|массив|null|boolean $value необязательно null

Значение в случае, если $name является строкой (тогда она работает как ключ). Не используется, если $name является ассоциативным массивом, в противном случае служит значениями для ключей $name.

Возвращает

mixed
$this

viewBuildersource public

viewBuilder( )

Получить используемый билдер представлений.

Возвращает

Cake\View\ViewBuilder
\Cake\View\ViewBuilder

viewOptionssource public

viewOptions( string|array|null $options null , boolean $merge true )

Получить/установить допустимые опции представления в свойстве _validViewOptions объекта. Свойство создаётся как пустой массив, если оно не задано. Если вызвано без параметров, оно вернёт текущий список допустимых опций представления. См. createView().

Параметры

строка|массив|null $options необязательно null

строка или массив строк, которые нужно добавить в _validViewOptions.

булево $merge необязательно true

Объединить или переопределить существующие допустимые опции представления. По умолчанию true.

Возвращает

array
Обновлённые опции представления в виде массива.

null

''

'.ctp'

[]

[
    'viewVars', 'autoLayout', 'helpers', 'template', 'layout', 'name', 'theme',
    'layoutPath', 'templatePath', 'plugin', 'passedArgs'
]

[]

[]

[]

true

'default'

false

[]

'default'

null

null

[]

null

null

null

null

null

[]

'\Cake\Event\Event'

null

null

[]