Класс AjaxView
Класс представления, используемый для ответов AJAX. В настоящее время он только переключает стандартный макет и устанавливает тип ответа — по умолчанию text/html.
Константы
-
stringNAME_TEMPLATE'templates'
Константа для типа, используемого для App::path().
-
stringPLUGIN_TEMPLATE_FOLDER'plugin'
Константа для имени папки, содержащей файлы для переопределения шаблонов плагинов.
-
stringTYPE_ELEMENT'element'
Константа для типа файла представления 'element'.
-
stringTYPE_LAYOUT'layout'
Константа для типа файла представления 'layout'.
-
stringTYPE_TEMPLATE'template'
Константа для типа файла представления 'template'.
Краткое описание свойств
- $Blocks public @property
Cake\View\ViewBlock - $Breadcrumbs public @property
Cake\View\Helper\BreadcrumbsHelper - $Flash public @property
Cake\View\Helper\FlashHelper - $Form public @property
Cake\View\Helper\FormHelper - $Html public @property
Cake\View\Helper\HtmlHelper - $Number public @property
Cake\View\Helper\NumberHelper - $Paginator public @property
Cake\View\Helper\PaginatorHelper - $Text public @property
Cake\View\Helper\TextHelper - $Time public @property
Cake\View\Helper\TimeHelper - $Url public @property
Cake\View\Helper\UrlHelper - $_config protected
arrayКонфигурация во время выполнения
- $_configInitialized protected
boolУказывает, была ли конфигурация уже настроена по умолчанию
- $_current protected
stringФайл представления, который в данный момент рендерится. Используется для разрешения родительских файлов.
- $_currentType protected
stringВ данный момент рендерится элемент. Используется для поиска родительских фрагментов для элементов.
- $_defaultConfig protected
array<string, mixed>Параметры конфигурации по умолчанию.
- $_eventClass protected
stringИмя класса по умолчанию для новых объектов событий.
- $_eventManager protected
Cake\Event\EventManagerInterface|nullЭкземпляр Cake\Event\EventManager, используемый этим объектом для отправки внутренних событий.
- $_ext protected
stringРасширение файла. По умолчанию ".php".
- $_helpers protected
Cake\View\HelperRegistryКоллекция хелперов
- $_parents protected
string[]Имена представлений и их родителей, используемые с View::extend();
- $_passedVars protected
string[]Список переменных для сбора из связанного контроллера.
- $_paths protected
string[]Содержит массив путей.
- $_pathsForPlugin protected
string[][]Содержит массив путей плагинов.
- $_stack protected
string[]Стек контента, используется для вложенных шаблонов, которые все используют View::extend();
- $_viewBlockClass protected
stringКласс ViewBlock.
- $autoLayout protected
boolВключает или выключает традиционный режим CakePHP для применения файлов макета. Включено по умолчанию. Выключение означает, что макеты не будут автоматически применяться к рендеряемым шаблонам.
- $elementCache protected
stringКонфигурация кэша, которую View будет использовать для хранения кэшированных элементов. Изменение этого параметра изменит конфигурацию кэша по умолчанию, под которой хранятся элементы. Вы также можете выбрать конфигурацию кэша для каждого элемента.
- $helpers protected
arrayМассив имён встроенных хелперов для включения.
- $layout protected
stringИмя файла макета для рендеринга шаблона внутри. Указанное имя — имя файла макета в папке
templates/layout/без расширения .php. - $layoutPath protected
stringИмя подпапки макетов, содержащей макеты для этого представления.
- $name protected
stringИмя контроллера, который создал представление, если таковой имеется.
- $plugin protected
string|nullИмя плагина.
- $request protected
Cake\Http\ServerRequestЭкземпляр объекта \Cake\Http\ServerRequest, содержащий информацию о текущем запросе. Этот объект содержит всю информацию о запросе и несколько методов для чтения дополнительной информации о запросе.
- $response protected
Cake\Http\ResponseСсылка на объект Response
- $subDir protected
stringПодкаталог для этого файла шаблона. Часто используется для маршрутизации на основе расширений. Например, с расширением
xml, $subDir будетxml/ - $template protected
stringИмя файла шаблона для рендеринга. Указанное имя — имя файла в папке
templates/<SubFolder>/без расширения .php. - $templatePath protected
stringИмя подпапки, содержащей шаблоны для этого представления.
Краткое описание методов
__construct()public
Конструктор
__get()public
Магический метод доступа к помощникам.
_checkFilePath()protected
Проверка, что путь к файлу представления не выходит за пределы определённых путей шаблонов.
_configDelete()protected
Удаление одного ключа конфигурации.
_configRead()protected
Чтение ключа конфигурации.
_configWrite()protected
Запись ключа конфигурации.
_createCell()protected
Создание и настройка экземпляра ячейки.
_elementCache()protected
Генерация параметров кэша для элемента.
_evaluate()protected
Метод для безопасной оценки шаблона/скрипта представления.
_getElementFileName()protected
Поиск имени файла элемента, возвращает false при ошибке.
_getLayoutFileName()protected
Возвращает имя файла макета для этого шаблона в виде строки.
_getSubPaths()protected
Поиск всех путей к подшаблонам, основываясь на $basePath. Если в текущем запросе определён префикс, этот метод добавит префиксный путь к шаблону к $basePath, переходя вверх в случае вложенного префикса. Это по существу используется для поиска префиксных путей к шаблонам элементов и макетов.
_getTemplateFileName()protected
Возвращает имя файла шаблона для заданного действия в виде строки. Имена действий с CamelCase по умолчанию преобразуются в нижний регистр с подчеркиванием. Это означает, что у вас могут быть имена действий LongActionNames, которые ссылаются на шаблоны long_action_names.php. Вы можете изменить правило преобразования, переопределив _inflectTemplateFileName.
_inflectTemplateFileName()protected
Изменение имени файла шаблона представления в нижний регистр с подчеркиванием.
_paths()protected
Возвращает все возможные пути для поиска файлов представления в порядке их обработки.
_render()protected
Выводит и возвращает результат для заданного имени файла шаблона с его массивом данных. Обрабатывает родительские/расширенные шаблоны.
_renderElement()protected
Вывод элемента и вызов обратных вызовов before и afterRender для него и запись в кэш, если используется кэш.
append()public
Добавление в существующий или новый блок.
assign()public
Установка содержимого блока. Это перепишет любое существующее содержимое.
blocks()public
Получение имён всех существующих блоков.
cache()public
Создание кэшированного блока логики представления.
cell()protected
Вывод заданной ячейки.
configShallow()public
Слияние предоставленной конфигурации с существующей конфигурацией. В отличие от
config(), которая выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.disableAutoLayout()public
Отключение традиционного режима CakePHP по применению файлов макетов. Макеты не будут автоматически применяться к визуализируемым представлениям.
dispatchEvent()public
Обёртка для создания и отправки событий.
element()public
Вывод части PHP с предоставленными параметрами и возвращает HTML, XML или любую другую строку.
elementExists()public
Проверка существования элемента.
enableAutoLayout()public
Включение или отключение традиционного режима CakePHP по применению файлов макетов. Включено по умолчанию. Выключение означает, что макеты не будут автоматически применяться к визуализируемым представлениям.
end()public
Завершение захвата блока. Дополнение к View::start()
exists()public
Проверка существования блока.
extend()public
Обеспечение расширения/наследования шаблонов или элементов. Шаблоны могут расширять родительский шаблон и заполнять блоки в родительском шаблоне.
fetch()public
Получение содержимого блока. Если блок пустой или неопределён, возвращается пустая строка.
get()public
Возвращает содержимое заданной переменной представления.
getConfig()public
Получение значения конфигурации.
getConfigOrFail()public
Возвращает конфигурацию для этого конкретного ключа.
getCurrentType()public
Получение текущего типа шаблона.
getElementPaths()protected
Получение итератора для путей к элементам.
getEventManager()public
Возвращает экземпляр менеджера событий Cake\Event\EventManager для этого объекта.
getLayout()public
Получение имени файла макета для вывода шаблона внутри него. Указанное имя — имя файла макета в
templates/layout/без расширения .php.getLayoutPath()public
Получение пути к файлам макетов.
getLayoutPaths()protected
Получение итератора для путей к файлам макетов.
getName()public
Возвращает имя контроллера представления.
getPlugin()public
Возвращает имя плагина.
getRequest()public
Получение экземпляра запроса.
getResponse()public
Получение экземпляра ответа.
getSubDir()public
Получение подкаталога для файлов этого шаблона.
-
getTemplate() public
Получить имя файла шаблона для рендеринга. Указанное имя является именем файла в
templates/<SubFolder>/без расширения .php. -
getTemplatePath() public
Получить путь к файлам шаблонов.
-
getTheme() public
Получить текущую тему представления.
-
getVars() public
Возвращает список переменных, доступных в текущем контексте представления.
-
helpers() public
Получить реестр помощников, используемый этим классом представления.
-
initialize() public
Метод инициализации.
-
isAutoLayoutEnabled() public
Возвращает значение, указывающее, включён ли стандартный режим CakePHP по применению файлов макета. Выключенный режим означает, что макеты не будут автоматически применяться к рендеряемым представлениям.
-
loadHelper() public
Загружает помощника. Делегирует загрузку помощника классу
HelperRegistry::load(). -
loadHelpers() public
Взаимодействие с HelperRegistry для загрузки всех помощников.
-
log() public
Удобный метод для записи сообщения в журнал. Для получения дополнительной информации о записи в журналы см. Log::write().
-
pluginSplit() public
Разделяет имя плагина в формате с точкой на имя плагина и имя файла. Если в $name нет точки, то индекс 0 будет null. Проверяет, загружен ли плагин; в противном случае имя файла останется неизменным для имён файлов, содержащих точку.
-
prepend() public
Добавить в начало существующего или нового блока.
-
render() public
Рендерит представление для данного файла шаблона и макета.
-
renderLayout() public
Рендерит макет. Возвращает вывод из _render().
-
reset() public
Сбросить содержимое блока. Это перезапишет любое существующее содержимое.
-
set() public
Сохраняет переменную или ассоциативный массив переменных для использования внутри шаблона.
-
setConfig() public
Устанавливает конфигурацию.
-
setElementCache() public
Установить конфигурацию кэша, которую будет использовать представление для хранения кэшированных элементов.
-
setEventManager() public
Возвращает экземпляр Cake\Event\EventManagerInterface для данного объекта.
-
setLayout() public
Установить имя файла макета для рендеринга шаблона внутри него. Указанное имя является именем файла макета в
templates/layout/без расширения .php. -
setLayoutPath() public
Установить путь к файлам макетов.
-
setPlugin() public
Устанавливает имя плагина.
-
setRequest() public
Устанавливает объекты запроса и настраивает ряд свойств контроллера на основе содержимого запроса. Свойства, которые устанавливаются:
-
setResponse() public
Устанавливает экземпляр ответа.
-
setSubDir() public
Установить подкаталог для файлов шаблонов.
-
setTemplate() public
Установить имя файла шаблона для рендеринга. Указанное имя является именем файла шаблона в
templates/<SubFolder>/без расширения .php. -
setTemplatePath() public
Установить путь к файлам шаблонов.
-
setTheme() public
Установить тему представления для использования.
-
start() public
Начать захват вывода для 'блока'.
Подробное описание методов
__construct() public
__construct(Cake\Http\ServerRequest|null $request = null, Cake\Http\Response|null $response = null, Cake\Event\EventManager|null $eventManager = null, array $viewOptions = [])
Конструктор
Параметры
-
Cake\Http\ServerRequest|null$request optional Экземпляр запроса.
-
Cake\Http\Response|null$response optional Экземпляр ответа.
-
Cake\Event\EventManager|null$eventManager optional Экземпляр менеджера событий.
-
array$viewOptions optional Параметры представления. См. View::$_passedVars для списка параметров, которые устанавливаются как свойства класса.
__get() public
__get(string $name): mixed
Магический аксессор для помощников.
Параметры
-
string$name Имя атрибута для получения.
Возвращает
mixed_checkFilePath() protected
_checkFilePath(string $file, string $path): string
Проверка того, что путь к файлу представления не выходит за пределы определенных путей к шаблонам.
Проверке будут подвергаться только пути, содержащие .., поскольку именно они чаще всего могут ссылаться на файлы за пределами путей к шаблонам.
Параметры
-
string$file Путь к файлу шаблона.
-
string$path Базовый путь, внутри которого должен находиться $file.
Возвращает
stringВызывает исключение
InvalidArgumentException_configDelete() protected
_configDelete(string $key): void
Удаляет один ключ конфигурации.
Параметры
-
string$key Ключ для удаления.
Возвращает
voidВызывает исключение
Cake\Core\Exception\CakeExceptionесли пытаетесь перезаписать существующую конфигурацию
_configRead() protected
_configRead(string|null $key): mixed
Читает ключ конфигурации.
Параметры
-
string|null$key Ключ для чтения.
Возвращает
mixed_configWrite() protected
_configWrite(string|array $key, mixed $value, bool|string $merge = false): void
Записывает ключ конфигурации.
Параметры
-
string|array$key Ключ для записи.
-
mixed$value Значение для записи.
-
bool|string$merge optional True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Возвращает
voidВызывает исключение
Cake\Core\Exception\CakeExceptionесли пытаетесь перезаписать существующую конфигурацию
_createCell() protected
_createCell(string $className, string $action, string|null $plugin, array $options): Cake\View\Cell
Создает и настраивает экземпляр ячейки.
Параметры
-
string$className Имя класса ячейки.
-
string$action Имя действия.
-
string|null$plugin Имя плагина.
-
array$options Параметры конструктора для ячейки.
Возвращает
Cake\View\Cell_elementCache() protected
_elementCache(string $name, array $data, array $options): array
Генерирует параметры конфигурации кэша для элемента.
Параметры
-
string$name Имя элемента
-
array$data Данные
-
array$options Параметры элемента
Возвращает
array_evaluate() protected
_evaluate(string $templateFile, array $dataForView): string
Метод песочницы для оценки скрипта шаблона/представления.
Параметры
-
string$templateFile Имя файла шаблона.
-
array$dataForView Данные для включения в отображаемое представление.
Возвращает
string_getElementFileName() protected
_getElementFileName(string $name, bool $pluginCheck = true): string|false
Находит имя файла элемента, возвращает false в случае неудачи.
Параметры
-
string$name Имя элемента для поиска.
-
bool$pluginCheck optional - если false, будет игнорировать плагин запроса, если разобранный плагин не загружен
Возвращает
string|false_getLayoutFileName() protected
_getLayoutFileName(string|null $name = null): string
Возвращает имя файла макета для этого шаблона в виде строки.
Параметры
-
string|null$name optional Имя макета для поиска.
Возвращает
stringВызывает исключение
Cake\View\Exception\MissingLayoutExceptionкогда макет не может быть найден
RuntimeException_getSubPaths() protected
_getSubPaths(string $basePath): string[]
Находит все пути к подшаблонам на основе $basePath. Если в текущем запросе определен префикс, этот метод добавит путь к префиксному шаблону перед $basePath, каскадируя вверх в случае, если префикс вложен. Это в основном используется для поиска префиксных путей к шаблонам для элементов и макетов.
Параметры
-
string$basePath Базовый путь, для которого нужно получить префиксный путь.
Возвращает
string[]_getTemplateFileName() protected
_getTemplateFileName(string|null $name = null): string
Возвращает имя файла шаблона данного действия в виде строки. Имена действий в формате CamelCase будут по умолчанию преобразованы в нижний регистр с подчеркиваниями. Это означает, что вы можете иметь LongActionNames, которые ссылаются на шаблоны long_action_names.php. Вы можете изменить правило склонения, переопределив _inflectTemplateFileName.
Параметры
-
string|null$name optional Действие контроллера для поиска имени файла шаблона
Возвращает
stringВызывает исключение
Cake\View\Exception\MissingTemplateExceptionкогда файл шаблона не может быть найден.
RuntimeExceptionКогда имя шаблона не указано.
_inflectTemplateFileName() protected
_inflectTemplateFileName(string $name): string
Изменяет имя файла шаблона представления на формат с подчеркиваниями.
Параметры
-
string$name Имя файла, который должен быть склонен.
Возвращает
string_paths() protected
_paths(string|null $plugin = null, bool $cached = true): string[]
Возвращает все возможные пути для поиска файлов представлений в порядке
Параметры
-
string|null$plugin optional Необязательное имя плагина для поиска файлов представлений.
-
bool$cached optional Установите значение false, чтобы принудительно обновить пути к представлениям. По умолчанию true.
Возвращает
string[]_render() protected
_render(string $templateFile, array $data = []): string
Рендерит и возвращает вывод для заданного имени файла шаблона с его массивом данных. Обрабатывает родительские/расширенные шаблоны.
Параметры
-
string$templateFile Имя файла шаблона
-
array$data optional Данные для включения в отображаемое представление. Если пусто, будет использоваться текущий View::$viewVars.
Возвращает
stringВызывает исключение
LogicExceptionКогда блок остается открытым.
_renderElement() protected
_renderElement(string $file, array $data, array $options): string
Рендерит элемент и запускает обратные вызовы before и afterRender для него, а также записывает в кэш, если используется кэш
Parameters
-
string$file Путь к файлу элемента
-
array$data Данные для рендеринга
-
array$options Параметры элемента
Returns
stringappend() public
append(string $name, mixed $value = null): $this
Добавление к существующему или новому блоку.
Добавление к новому блоку создаст блок.
Parameters
-
string$name Имя блока
-
mixed$value optional Контент для блока. Значение будет приведено к строковому типу.
Returns
$thisSee Also
assign() public
assign(string $name, mixed $value): $this
Установка контента для блока. Это перезапишет любой существующий контент.
Parameters
-
string$name Имя блока
-
mixed$value Контент для блока. Значение будет приведено к строковому типу.
Returns
$thisSee Also
blocks() public
blocks(): string[]
Получение имен всех существующих блоков.
Returns
string[]See Also
cache() public
cache(callable $block, array $options = []): string
Создание кэшированного блока логики представления.
Это позволяет кэшировать блок вывода представления в кэше, определенном в elementCache.
Этот метод сначала попытается прочитать кэш. Если кэш пуст, блок $block будет запущен, и вывод будет сохранен.
Parameters
-
callable$block Блок кода, вывод которого вы хотите кэшировать.
-
array$options optional Параметры, определяющие ключ кэша и т.д.
Returns
stringThrows
RuntimeExceptionКогда в $options отсутствует параметр 'key'.
cell() protected
cell(string $cell, array $data = [], array $options = []): Cake\View\Cell
Рендерит заданную ячейку.
Пример:
// 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'); Ячейки не рендерятся, пока не будут выведены.
Parameters
-
string$cell Необходимо указать имя ячейки и, необязательно, действие ячейки. Например:
TagCloud::smallListвызоветView\Cell\TagCloudCell::smallList(),displayдействие будет вызываться по умолчанию, если оно не предоставлено.-
array$data optional Дополнительные аргументы для метода ячейки. Например:
cell('TagCloud::smallList', ['a1' => 'v1', 'a2' => 'v2'])сопоставляется сView\Cell\TagCloud::smallList(v1, v2)-
array$options optional Параметры для конструктора Cell
Returns
Cake\View\CellThrows
Cake\View\Exception\MissingCellExceptionЕсли класс Cell не найден.
BadMethodCallExceptionЕсли класс Cell не указал действие ячейки.
configShallow() public
configShallow(string|array $key, mixed|null $value = null): $this
Объединение предоставленной конфигурации с существующей конфигурацией. В отличие от config(), который выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка конкретного значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Parameters
-
string|array$key Ключ для установки или полный массив конфигураций.
-
mixed|null$value optional Значение для установки.
Returns
$thisdisableAutoLayout() public
disableAutoLayout(): $this
Отключает традиционный режим CakePHP применения файлов макетов. Макетов не будут автоматически применяться к отображаемым представлениям.
Returns
$thisdispatchEvent() public
dispatchEvent(string $name, array|null $data = null, object|null $subject = null): Cake\Event\EventInterface
Обёртка для создания и отправки событий.
Возвращает отправленное событие.
Parameters
-
string$name Имя события.
-
array|null$data optional Любое значение, которое вы хотите передать с этим событием, чтобы оно могло быть прочитано слушателями.
-
object|null$subject optional Объект, к которому относится это событие ($this по умолчанию).
Returns
Cake\Event\EventInterfaceelement() public
element(string $name, array $data = [], array $options = []): string
Рендерит фрагмент PHP с предоставленными параметрами и возвращает HTML, XML или любую другую строку.
Это реализует концепцию элементов (или «частичных макетов»), и массив $params используется для отправки данных, которые будут использоваться в элементе. Элементы могут быть кэшированы, что улучшает производительность, используя параметр cache.
Parameters
-
string$name Имя файла шаблона в папке
templates/element/илиMyPlugin.templateдля использования шаблона элемента из MyPlugin. Если элемент не найден в плагине, будет выполнен обычный поиск по каскаду путей представлений.-
array$data optional Массив данных, которые должны быть доступны для отображаемого представления (т.е. элемента)
-
array$options optional Массив параметров. Возможные ключи:
Returns
stringThrows
Cake\View\Exception\MissingElementExceptionКогда элемент отсутствует, а `ignoreMissing` равно false.
elementExists() public
elementExists(string $name): bool
Проверяет, существует ли элемент
Parameters
-
string$name Имя файла шаблона в папке
templates/element/илиMyPlugin.templateдля проверки шаблона элемента из MyPlugin. Если элемент не найден в плагине, будет выполнен обычный поиск по каскаду путей представлений.
Returns
boolenableAutoLayout() public
enableAutoLayout(bool $enable = true): $this
Включает или отключает традиционный режим CakePHP применения файлов макетов. Включен по умолчанию. Отключение означает, что макеты не будут автоматически применяться к отображаемым представлениям.
Parameters
-
bool$enable optional Логическое значение для включения/отключения.
Returns
$thisend() public
end(): $this
Завершение блока захвата. Дополнение к View::start()
Returns
$thisSee Also
exists() public
exists(string $name): bool
Проверка существования блока
Parameters
-
string$name Имя блока
Returns
boolextend() public
extend(string $name): $this
Обеспечивает расширение/наследование шаблона или элемента. Шаблоны могут расширять родительский шаблон и заполнять блоки в родительском шаблоне.
Parameters
-
string$name Шаблон или элемент, который нужно «расширить» текущим.
Returns
$thisThrows
LogicExceptionкогда вы расширяете шаблон самим собой или создаете циклы расширения.
LogicExceptionкогда вы расширяете элемент, которого не существует
fetch() public
fetch(string $name, string $default = ''): string
Извлечь содержимое блока. Если блок пустой или неопределён, будет возвращено пустое значение.
Параметры
-
string$name Имя блока
-
string$default необязательный Значение по умолчанию
Возвращает
stringСм. также
get() public
get(string $var, mixed $default = null): mixed
Возвращает содержимое заданной переменной представления.
Параметры
-
string$var Переменная представления, содержимое которой нужно получить.
-
mixed$default необязательный Значение по умолчанию/запасное значение для $var.
Возвращает
mixedgetConfig() public
getConfig(string|null $key = null, mixed $default = null): mixed
Получить значение конфигурации.
В настоящее время, если конфигурация не задана, она проверяется в соответствующей переменной представления с префиксом «_». Использование специальных переменных представления с префиксом «_» устарело, и этот резервный метод будет удалён в CakePHP 4.1.0.
Параметры
-
string|null$key необязательный Ключ для получения значения или null для всей конфигурации.
-
mixed$default необязательный Возвращаемое значение, если ключ не существует.
Возвращает
mixedgetConfigOrFail() public
getConfigOrFail(string $key): mixed
Возвращает конфигурацию для данного ключа.
Значение конфигурации для этого ключа должно существовать, оно никогда не может быть null.
Параметры
-
string$key Ключ для получения.
Возвращает
mixedВызывает исключение
InvalidArgumentExceptiongetCurrentType() public
getCurrentType(): string
Получить текущий тип шаблона
Возвращает
stringgetElementPaths() protected
getElementPaths(string|null $plugin): Generator
Получить итератор для путей элементов.
Параметры
-
string|null$plugin Плагин, для которого нужно получить пути.
Возвращает
GeneratorgetEventManager() public
getEventManager(): Cake\Event\EventManagerInterface
Возвращает экземпляр менеджера Cake\Event\EventManager для данного объекта.
Вы можете использовать этот экземпляр для регистрации новых слушателей или обратных вызовов на события объекта, или создавать собственные события и вызывать их по мере необходимости.
Возвращает
Cake\Event\EventManagerInterfacegetLayout() public
getLayout(): string
Получить имя файла макета, внутри которого нужно отобразить шаблон. Указанное имя - имя файла макета в templates/layout/ без расширения .php.
Возвращает
stringgetLayoutPath() public
getLayoutPath(): string
Получить путь к файлам макета.
Возвращает
stringgetLayoutPaths() protected
getLayoutPaths(string|null $plugin): Generator
Получить итератор для путей макетов.
Параметры
-
string|null$plugin Плагин, для которого нужно получить пути.
Возвращает
GeneratorgetName() public
getName(): string
Возвращает имя контроллера представления.
Возвращает
stringgetPlugin() public
getPlugin(): string|null
Возвращает имя плагина.
Возвращает
string|nullgetRequest() public
getRequest(): Cake\Http\ServerRequest
Получает экземпляр запроса.
Возвращает
Cake\Http\ServerRequestgetResponse() public
getResponse(): Cake\Http\Response
Получает экземпляр ответа.
Возвращает
Cake\Http\ResponsegetSubDir() public
getSubDir(): string
Получить подкаталог для файлов шаблонов.
Возвращает
stringСм. также
getTemplate() public
getTemplate(): string
Получить имя файла шаблона для отображения. Указанное имя - имя файла в templates/<SubFolder>/ без расширения .php.
Возвращает
stringgetTemplatePath() public
getTemplatePath(): string
Получить путь к файлам шаблонов.
Возвращает
stringgetTheme() public
getTheme(): string|null
Получить текущую тему представления.
Возвращает
string|nullgetVars() public
getVars(): string[]
Возвращает список переменных, доступных в текущем контексте представления.
Возвращает
string[]helpers() public
helpers(): Cake\View\HelperRegistry
Получить реестр помощников, используемый этим классом представления.
Возвращает
Cake\View\HelperRegistryinitialize() public
initialize(): void
Метод инициализации.
Свойства, такие как $helpers и т.д., не могут быть статически инициализированы в вашем пользовательском классе представления, так как они перезаписываются значениями из контроллера в конструкторе. Поэтому этот метод позволяет манипулировать ими по мере необходимости после того, как экземпляр представления будет создан.
Возвращает
voidisAutoLayoutEnabled() public
isAutoLayoutEnabled(): bool
Возвращает значение, указывающее, включён ли в CakePHP стандартный режим применения файлов макета. Выключенный режим означает, что макеты не будут автоматически применяться к рендеру представлений.
Возвращает
HelperRegistry::load()loadHelper() public
loadHelper(string $name, array $config = []): Cake\View\Helper
Загружает помощника. Делегирует загрузку помощника классу HelperRegistry::load()
Параметры
-
string$name Имя помощника для загрузки.
-
array$config необязательный Настройки для помощника.
Возвращает
Cake\View\HelperСм. также
loadHelpers() public
loadHelpers(): $this
Взаимодействие с HelperRegistry для загрузки всех помощников.
Возвращает
$thislog() public
log(string $message, int|string $level = LogLevel::ERROR, string|array $context = []): bool
Удобный метод для записи сообщения в журнал. См. Log::write() для получения дополнительной информации о записи в журналы.
Параметры
-
string$message Сообщение журнала.
-
int|string$level необязательный Уровень ошибки.
-
string|array$context необязательный Дополнительные данные журнала, относящиеся к этому сообщению.
Возвращает
boolpluginSplit() public
pluginSplit(string $name, bool $fallback = true): array
Разделяет имя плагина в формате «точка» на плагин и имя файла. Если $name не содержит точку, то индекс 0 будет равен null. Проверяет, загружен ли плагин, иначе имя файла останется неизменным для имен файлов, содержащих точку
Parameters
-
string$name Имя, которое вы хотите разделить на плагин.
-
bool$fallback optional Если true, использует плагин, установленный в текущем запросе, когда проанализированный плагин не загружен
Returns
arrayprepend() public
prepend(string $name, mixed $value): $this
Добавляет в начало существующего или нового блока.
Добавление в начало нового блока создаст этот блок.
Parameters
-
string$name Имя блока
-
mixed$value Контент для блока. Значение будет приведено к строковому типу.
Returns
$thisSee Also
render() public
render(string|null $template = null, string|false|null $layout = null): string
Рендерит представление для заданного файла шаблона и макета.
Render запускает обратные вызовы помощников, которые вызываются до и после рендеринга шаблона, а также до и после макета. Обратные вызовы помощников вызываются:
beforeRenderafterRenderbeforeLayoutafterLayout
Если View::$autoLayout установлено в false, шаблон будет возвращен без изменений.
Имена шаблонов и макетов могут указывать на шаблоны или макеты плагинов. Используя синтаксис Plugin.template, можно использовать шаблон/макет плагина вместо шаблонов приложения. Если выбранный плагин не найден, шаблон будет расположен вдоль обычного каскада путей представления.
Parameters
-
string|null$template optional Имя файла шаблона для использования
-
string|false|null$layout optional Макет для использования. False для отключения.
Returns
stringThrows
Cake\Core\Exception\CakeExceptionЕсли есть ошибка в представлении.
renderLayout() public
renderLayout(string $content, string|null $layout = null): string
Рендерит макет. Возвращает вывод из _render().
Создается несколько переменных для использования в макете.
Parameters
-
string$content Контент для рендеринга в шаблоне, заключенный в окружающий макет.
-
string|null$layout optional Имя макета
Returns
stringThrows
Cake\Core\Exception\CakeExceptionесли есть ошибка в представлении.
reset() public
reset(string $name): $this
Сбрасывает содержимое блока. Это перезапишет любое существующее содержимое.
Parameters
-
string$name Имя блока
Returns
$thisSee Also
set() public
set(string|array $name, mixed $value = null): $this
Сохраняет переменную или ассоциативный массив переменных для использования внутри шаблона.
Parameters
-
string|array$name Строка или массив данных.
-
mixed$value optional Значение, если $name является строкой (которая затем работает как ключ). Не используется, если $name является ассоциативным массивом, в противном случае служит значениями для ключей $name.
Returns
$thisThrows
RuntimeExceptionЕсли операция объединения массивов завершилась неудачей.
setConfig() public
setConfig(string|array $key, mixed|null $value = null, bool $merge = true): $this
Устанавливает конфигурацию.
Usage
Установка конкретного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Parameters
-
string|array$key Ключ для установки или полный массив конфигураций.
-
mixed|null$value optional Значение для установки.
-
bool$merge optional Необходимо ли рекурсивно объединять или перезаписывать существующую конфигурацию, по умолчанию true.
Returns
$thisThrows
Cake\Core\Exception\CakeExceptionПри попытке установить недопустимый ключ.
setElementCache() public
setElementCache(string $elementCache): $this
Устанавливает конфигурацию кэша, которую View будет использовать для хранения кэшированных элементов
Parameters
-
string$elementCache Имя конфигурации кэша.
Returns
$thisSee Also
setEventManager() public
setEventManager(Cake\Event\EventManagerInterface $eventManager): $this
Возвращает экземпляр Cake\Event\EventManagerInterface для этого объекта.
Вы можете использовать этот экземпляр для регистрации любых новых прослушивателей или обратных вызовов для событий объекта или создания собственных событий и их запуска по желанию.
Parameters
-
Cake\Event\EventManagerInterface$eventManager eventManager для установки
Returns
$thissetLayout() public
setLayout(string $name): $this
Устанавливает имя файла макета для рендеринга шаблона внутри него. Указанное имя — это имя файла макета в templates/layout/ без расширения .php.
Parameters
-
string$name Имя файла макета для установки.
Returns
$thissetLayoutPath() public
setLayoutPath(string $path): $this
Устанавливает путь для файлов макетов.
Parameters
-
string$path Путь для файлов макетов.
Returns
$thissetPlugin() public
setPlugin(string|null $name): $this
Устанавливает имя плагина.
Parameters
-
string|null$name Имя плагина.
Returns
$thissetRequest() public
setRequest(Cake\Http\ServerRequest $request): $this
Устанавливает объекты запроса и настраивает ряд свойств контроллера на основе содержимого запроса. Устанавливаемые свойства:
- $this->request - на параметр $request
- $this->plugin - на значение, возвращаемое $request->getParam('plugin')
Parameters
-
Cake\Http\ServerRequest$request Экземпляр запроса.
Returns
$thissetResponse() public
setResponse(Cake\Http\Response $response): $this
Устанавливает экземпляр ответа.
Parameters
-
Cake\Http\Response$response Экземпляр ответа.
Returns
$thissetSubDir() public
setSubDir(string $subDir): $this
Устанавливает подкаталог для этих файлов шаблонов.
Parameters
-
string$subDir Имя подкаталога.
Returns
$thisSee Also
setTemplate() public
setTemplate(string $name): $this
Устанавливает имя файла шаблона для рендеринга. Указанное имя — это имя файла в templates/<SubFolder>/ без расширения .php.
Parameters
-
string$name Имя файла шаблона для установки.
Returns
$thissetTemplatePath() public
setTemplatePath(string $path): $this
Установить путь к файлам шаблонов.
Параметры
-
string$path Путь к файлам шаблонов.
Возвращает
$thissetTheme() public
setTheme(string|null $theme): $this
Установить используемую тему представления.
Параметры
-
string|null$theme Имя темы.
Возвращает
$thisstart() public
start(string $name): $this
Начать захват вывода для 'блока'.
Можно использовать 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 Имя блока для захвата.
Возвращает
$thisСм. также
Подробное описание свойств
$Blocks public @property
Тип
Cake\View\ViewBlock$Breadcrumbs public @property
Тип
Cake\View\Helper\BreadcrumbsHelper$Flash public @property
Тип
Cake\View\Helper\FlashHelper$Form public @property
Тип
Cake\View\Helper\FormHelper$Html public @property
Тип
Cake\View\Helper\HtmlHelper$Number public @property
Тип
Cake\View\Helper\NumberHelper$Paginator public @property
Тип
Cake\View\Helper\PaginatorHelper$Text public @property
Тип
Cake\View\Helper\TextHelper$Time public @property
Тип
Cake\View\Helper\TimeHelper$Url public @property
Тип
Cake\View\Helper\UrlHelper$_config protected
Конфигурация времени выполнения
Тип
array$_configInitialized protected
Было ли свойство конфигурации уже настроено с настройками по умолчанию
Тип
bool$_current protected
Текущий файл представления для отрисовки. Используется для разрешения родительских файлов.
Тип
string$_currentType protected
В данный момент происходит отрисовка элемента. Используется для поиска родительских фрагментов для элементов.
Тип
string$_defaultConfig protected
Параметры пользовательской конфигурации по умолчанию.
Тип
array<string, mixed>$_eventClass protected
Имя класса по умолчанию для новых объектов событий.
Тип
string$_eventManager protected
Экземпляр Cake\Event\EventManager, который этот объект использует для отправки внутренних событий.
Тип
Cake\Event\EventManagerInterface|null$_ext protected
Расширение файла. По умолчанию ".php".
Тип
string$_helpers protected
Коллекция помощников
Тип
Cake\View\HelperRegistry$_parents protected
Имена представлений и их родителей, используемые с View::extend();
Тип
string[]$_passedVars protected
Список переменных для сбора из связанного контроллера.
Тип
string[]$_paths protected
Содержит массив путей.
Тип
string[]$_pathsForPlugin protected
Содержит массив путей плагинов.
Тип
string[][]$_stack protected
Стек содержимого, используемый для вложенных шаблонов, которые все используют View::extend();
Тип
string[]$_viewBlockClass protected
Класс ViewBlock.
Тип
string$autoLayout protected
Включает или отключает обычный режим CakePHP применения файлов макетов. Включен по умолчанию. Отключение означает, что макеты не будут автоматически применяться к отрисованным шаблонам.
Тип
bool$elementCache protected
Конфигурация кэша, которую View будет использовать для хранения кэшированных элементов. Изменение этого значения изменит конфигурацию по умолчанию, под которой хранятся элементы. Вы также можете выбрать конфигурацию кэша для каждого элемента.
Тип
string$helpers protected
Массив имен встроенных помощников для включения.
Тип
array$layout protected
Имя файла макета для отрисовки шаблона внутри. Указанное имя - это имя файла макета в templates/layout/ без расширения .php.
Тип
string$layoutPath protected
Имя подпапки макетов, содержащей макеты для этого представления.
Тип
string$name protected
Имя контроллера, который создал представление, если таковой имеется.
Тип
string$plugin protected
Имя плагина.
Тип
string|null$request protected
Экземпляр объекта \Cake\Http\ServerRequest, содержащий информацию о текущем запросе. Этот объект содержит всю информацию о запросе и несколько методов для чтения дополнительной информации о запросе.
Тип
Cake\Http\ServerRequest$response protected
Ссылка на объект Response
Тип
Cake\Http\Response$subDir protected
Подкаталог для этого файла шаблона. Часто используется для маршрутизации на основе расширений. Например, с расширением xml, $subDir будет xml/
Тип
string$template protected
Имя файла шаблона для рендеринга. Указанное имя — это имя файла в templates/<SubFolder>/ без расширения .php.
Тип
string$templatePath protected
Имя подпапки, содержащей шаблоны для этого представления.
Тип
string$theme protected
Тема представления, используемая для отображения.
Тип
string|null$viewVars protected
Массив переменных.
Тип
array
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.2/class-Cake.View.AjaxView.html