Spec-Zone.ru › CakePHP 4.2

Класс AjaxView

Класс представления, используемый для ответов AJAX. В настоящее время он только переключает стандартный макет и устанавливает тип ответа — по умолчанию text/html.

Пространство имен: Cake\View

Константы

  • string
    NAME_TEMPLATE
    'templates'

    Константа для типа, используемого для App::path().

  • string
    PLUGIN_TEMPLATE_FOLDER
    'plugin'

    Константа для имени папки, содержащей файлы для переопределения шаблонов плагинов.

  • string
    TYPE_ELEMENT
    'element'

    Константа для типа файла представления 'element'.

  • string
    TYPE_LAYOUT
    'layout'

    Константа для типа файла представления 'layout'.

  • string
    TYPE_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

    Имя подпапки, содержащей шаблоны для этого представления.

  • $theme protected
    string|null

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

  • $viewVars protected
    array

    Массив переменных.

Краткое описание методов

  • __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

string

append() public

append(string $name, mixed $value = null): $this

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

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

Parameters

string $name

Имя блока

mixed $value optional

Контент для блока. Значение будет приведено к строковому типу.

Returns

$this

See Also

\Cake\View\ViewBlock::concat()

assign() public

assign(string $name, mixed $value): $this

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

Parameters

string $name

Имя блока

mixed $value

Контент для блока. Значение будет приведено к строковому типу.

Returns

$this

See Also

\Cake\View\ViewBlock::set()

blocks() public

blocks(): string[]

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

Returns

string[]

See Also

\Cake\View\ViewBlock::keys()

cache() public

cache(callable $block, array $options = []): string

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

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

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

Parameters

callable $block

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

array $options optional

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

Returns

string

Throws

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\Cell

Throws

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

$this

disableAutoLayout() public

disableAutoLayout(): $this

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

Returns

$this

dispatchEvent() 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\EventInterface

element() 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

string

Throws

Cake\View\Exception\MissingElementException
Когда элемент отсутствует, а `ignoreMissing` равно false.

elementExists() public

elementExists(string $name): bool

Проверяет, существует ли элемент

Parameters

string $name

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

Returns

bool

enableAutoLayout() public

enableAutoLayout(bool $enable = true): $this

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

Parameters

bool $enable optional

Логическое значение для включения/отключения.

Returns

$this

end() public

end(): $this

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

Returns

$this

See Also

\Cake\View\ViewBlock::end()

exists() public

exists(string $name): bool

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

Parameters

string $name

Имя блока

Returns

bool

extend() public

extend(string $name): $this

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

Parameters

string $name

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

Returns

$this

Throws

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

fetch() public

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

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

Параметры

string $name

Имя блока

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

Значение по умолчанию

Возвращает

string

См. также

\Cake\View\ViewBlock::get()

get() public

get(string $var, mixed $default = null): mixed

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

Параметры

string $var

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

mixed $default необязательный

Значение по умолчанию/запасное значение для $var.

Возвращает

mixed

getConfig() public

getConfig(string|null $key = null, mixed $default = null): mixed

Получить значение конфигурации.

В настоящее время, если конфигурация не задана, она проверяется в соответствующей переменной представления с префиксом «_». Использование специальных переменных представления с префиксом «_» устарело, и этот резервный метод будет удалён в CakePHP 4.1.0.

Параметры

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

Ключ для получения значения или null для всей конфигурации.

mixed $default необязательный

Возвращаемое значение, если ключ не существует.

Возвращает

mixed

getConfigOrFail() public

getConfigOrFail(string $key): mixed

Возвращает конфигурацию для данного ключа.

Значение конфигурации для этого ключа должно существовать, оно никогда не может быть null.

Параметры

string $key

Ключ для получения.

Возвращает

mixed

Вызывает исключение

InvalidArgumentException

getCurrentType() public

getCurrentType(): string

Получить текущий тип шаблона

Возвращает

string

getElementPaths() protected

getElementPaths(string|null $plugin): Generator

Получить итератор для путей элементов.

Параметры

string|null $plugin

Плагин, для которого нужно получить пути.

Возвращает

Generator

getEventManager() public

getEventManager(): Cake\Event\EventManagerInterface

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

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

Возвращает

Cake\Event\EventManagerInterface

getLayout() public

getLayout(): string

Получить имя файла макета, внутри которого нужно отобразить шаблон. Указанное имя - имя файла макета в templates/layout/ без расширения .php.

Возвращает

string

getLayoutPath() public

getLayoutPath(): string

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

Возвращает

string

getLayoutPaths() protected

getLayoutPaths(string|null $plugin): Generator

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

Параметры

string|null $plugin

Плагин, для которого нужно получить пути.

Возвращает

Generator

getName() public

getName(): string

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

Возвращает

string

getPlugin() public

getPlugin(): string|null

Возвращает имя плагина.

Возвращает

string|null

getRequest() public

getRequest(): Cake\Http\ServerRequest

Получает экземпляр запроса.

Возвращает

Cake\Http\ServerRequest

getResponse() public

getResponse(): Cake\Http\Response

Получает экземпляр ответа.

Возвращает

Cake\Http\Response

getSubDir() public

getSubDir(): string

Получить подкаталог для файлов шаблонов.

Возвращает

string

См. также

\Cake\View\View::$subDir

getTemplate() public

getTemplate(): string

Получить имя файла шаблона для отображения. Указанное имя - имя файла в templates/<SubFolder>/ без расширения .php.

Возвращает

string

getTemplatePath() public

getTemplatePath(): string

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

Возвращает

string

getTheme() public

getTheme(): string|null

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

Возвращает

string|null

getVars() public

getVars(): string[]

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

Возвращает

string[]

helpers() public

helpers(): Cake\View\HelperRegistry

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

Возвращает

Cake\View\HelperRegistry

initialize() public

initialize(): void

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

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

Возвращает

void

isAutoLayoutEnabled() 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

См. также

\Cake\View\HelperRegistry::load()

loadHelpers() public

loadHelpers(): $this

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

Возвращает

$this

log() public

log(string $message, int|string $level = LogLevel::ERROR, string|array $context = []): bool

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

Параметры

string $message

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

int|string $level необязательный

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

string|array $context необязательный

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

Возвращает

bool

pluginSplit() public

pluginSplit(string $name, bool $fallback = true): array

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

Parameters

string $name

Имя, которое вы хотите разделить на плагин.

bool $fallback optional

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

Returns

array

prepend() public

prepend(string $name, mixed $value): $this

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

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

Parameters

string $name

Имя блока

mixed $value

Контент для блока. Значение будет приведено к строковому типу.

Returns

$this

See Also

\Cake\View\ViewBlock::concat()

render() public

render(string|null $template = null, string|false|null $layout = null): string

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

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

  • beforeRender
  • afterRender
  • beforeLayout
  • afterLayout

Если View::$autoLayout установлено в false, шаблон будет возвращен без изменений.

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

Parameters

string|null $template optional

Имя файла шаблона для использования

string|false|null $layout optional

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

Returns

string

Throws

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

renderLayout() public

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

Рендерит макет. Возвращает вывод из _render().

Создается несколько переменных для использования в макете.

Parameters

string $content

Контент для рендеринга в шаблоне, заключенный в окружающий макет.

string|null $layout optional

Имя макета

Returns

string

Throws

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

reset() public

reset(string $name): $this

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

Parameters

string $name

Имя блока

Returns

$this

See Also

\Cake\View\ViewBlock::set()

set() public

set(string|array $name, mixed $value = null): $this

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

Parameters

string|array $name

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

mixed $value optional

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

Returns

$this

Throws

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

$this

Throws

Cake\Core\Exception\CakeException
При попытке установить недопустимый ключ.

setElementCache() public

setElementCache(string $elementCache): $this

Устанавливает конфигурацию кэша, которую View будет использовать для хранения кэшированных элементов

Parameters

string $elementCache

Имя конфигурации кэша.

Returns

$this

See Also

\Cake\View\View::$elementCache

setEventManager() public

setEventManager(Cake\Event\EventManagerInterface $eventManager): $this

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

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

Parameters

Cake\Event\EventManagerInterface $eventManager

eventManager для установки

Returns

$this

setLayout() public

setLayout(string $name): $this

Устанавливает имя файла макета для рендеринга шаблона внутри него. Указанное имя — это имя файла макета в templates/layout/ без расширения .php.

Parameters

string $name

Имя файла макета для установки.

Returns

$this

setLayoutPath() public

setLayoutPath(string $path): $this

Устанавливает путь для файлов макетов.

Parameters

string $path

Путь для файлов макетов.

Returns

$this

setPlugin() public

setPlugin(string|null $name): $this

Устанавливает имя плагина.

Parameters

string|null $name

Имя плагина.

Returns

$this

setRequest() public

setRequest(Cake\Http\ServerRequest $request): $this

Устанавливает объекты запроса и настраивает ряд свойств контроллера на основе содержимого запроса. Устанавливаемые свойства:

  • $this->request - на параметр $request
  • $this->plugin - на значение, возвращаемое $request->getParam('plugin')

Parameters

Cake\Http\ServerRequest $request

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

Returns

$this

setResponse() public

setResponse(Cake\Http\Response $response): $this

Устанавливает экземпляр ответа.

Parameters

Cake\Http\Response $response

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

Returns

$this

setSubDir() public

setSubDir(string $subDir): $this

Устанавливает подкаталог для этих файлов шаблонов.

Parameters

string $subDir

Имя подкаталога.

Returns

$this

See Also

\Cake\View\View::$subDir

setTemplate() public

setTemplate(string $name): $this

Устанавливает имя файла шаблона для рендеринга. Указанное имя — это имя файла в templates/<SubFolder>/ без расширения .php.

Parameters

string $name

Имя файла шаблона для установки.

Returns

$this

setTemplatePath() public

setTemplatePath(string $path): $this

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

Параметры

string $path

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

Возвращает

$this

setTheme() public

setTheme(string|null $theme): $this

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

Параметры

string|null $theme

Имя темы.

Возвращает

$this

start() 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

См. также

\Cake\View\ViewBlock::start()

Подробное описание свойств

$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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API