Spec-Zone.ru › CakePHP 3.8

Класс Вид

Вид, V в триаде MVC. Вид взаимодействует с помощниками и переменными представления, переданными из контроллера, чтобы отобразить результаты действия контроллера. Часто это HTML, но может также принимать форму JSON, XML, PDF или потоковых файлов.

CakePHP использует двухэталонную схему представления. Это означает, что сначала содержимое шаблона отображается, а затем вставляется в выбранный макет. Это также означает, что вы можете передавать данные из шаблона в макет с помощью $this->set()

Класс представления поддерживает использование плагинов в качестве тем. Вы можете установить

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

в вашем контроллере, чтобы использовать плагин SuperHot в качестве темы. Например, если текущее действие — PostsController::index(), то класс представления будет искать файл шаблона plugins/SuperHot/Template/Posts/index.ctp. Если шаблон темы не найден для текущего действия, используется файл шаблона приложения по умолчанию.

Cake\View\View реализует Cake\Event\EventDispatcherInterface использует Cake\View\CellTrait , Cake\Event\EventDispatcherTrait , Cake\Log\LogTrait , Cake\Routing\RequestActionTrait , Cake\View\ViewVarsTrait

Прямые подклассы

  • Cake\View\AjaxView
  • Cake\View\SerializedView

Косвенные подклассы

  • Cake\View\JsonView
  • Cake\View\XmlView
Пространство имен: Cake\View
Расположение: View/View.php

Краткое описание констант

  • string

    NAME_ELEMENT
    'Element'
  • string

    NAME_TEMPLATE
    'Template'
  • string

    TYPE_ELEMENT
    'element'
  • string

    TYPE_LAYOUT
    'layout'
  • string

    TYPE_TEMPLATE
    'view'
  • string

    TYPE_VIEW
    'view'

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

  • $Blocks protected
    Cake\View\ViewBlock
    Экземпляр ViewBlock.
  • $_current protected
    string
    Файл представления, который в данный момент отображается. Используется для разрешения родительских файлов.
  • $_currentType protected
    string

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

  • $_ext protected
    string
    Расширение файла. По умолчанию используется шаблон CakePHP ".ctp".
  • $_helpers protected
    Cake\View\HelperRegistry
    Коллекция помощников
  • $_parents protected
    array
    Имена представлений и их родителей, используемые с View::extend();
  • $_passedVars protected
    array
    Список переменных для сбора из связанного контроллера.
  • $_paths protected
    array
    Содержит массив путей.
  • $_pathsForPlugin protected
    array
    Содержит массив путей плагинов.
  • $_stack protected
    array
    Стек содержимого, используемый для вложенных шаблонов, которые все используют View::extend();
  • $_viewBlockClass protected
    string
    Класс ViewBlock.
  • $autoLayout protected
    boolean

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

  • $elementCache protected
    string

    Конфигурация кэша, которую будет использовать View для хранения кэшированных элементов. Изменение этого параметра изменит конфигурацию по умолчанию, в которой хранятся элементы. Также можно выбрать конфигурацию кэша для каждого элемента.

  • $hasRendered public
    boolean
    Истинно, когда представление было отображено.
  • $helpers protected
    array
    Массив имён встроенных помощников для включения.
  • $layout protected
    string

    Имя файла макета, в котором нужно отобразить шаблон. Указанное имя — имя файла макета в /src/Template/Layout без расширения .ctp.

  • $layoutPath protected
    string
    Имя подпапки макетов, содержащей макеты для этого представления.
  • $name protected
    string
    Имя контроллера, который создал представление, если таковой имеется.
  • $passedArgs public
    array
    Текущие переданные параметры. Передаются представлению из создающего контроллера для удобства.
  • $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

    Имя файла шаблона для отображения. Указанное имя — имя файла в /src/Template/ без расширения .ctp.

  • $templatePath protected
    string
    Имя подпапки, содержащей шаблоны для этого представления.
  • $theme protected
    string|null
    Тема представления, используемая для отображения.
  • $uuids public
    array
    Список сгенерированных UUID DOM.

Краткое описание магических свойств

  • $Blocks public
    Cake\View\ViewBlock
  • $Breadcrumbs public
    Cake\View\Helper\BreadcrumbsHelper
  • $Flash public
    Cake\View\Helper\FlashHelper
  • $Form public
    Cake\View\Helper\FormHelper
  • $Html public
    Cake\View\Helper\HtmlHelper
  • $Number public
    Cake\View\Helper\NumberHelper
  • $Paginator public
    Cake\View\Helper\PaginatorHelper
  • $Rss public
    Cake\View\Helper\RssHelper
  • $Session public
    Cake\View\Helper\SessionHelper
  • $Text public
    Cake\View\Helper\TextHelper
  • $Time public
    Cake\View\Helper\TimeHelper
  • $Url public
    Cake\View\Helper\UrlHelper
  • $view public
    string
  • $viewPath public
    string

Наследуемые магические свойства

  • _validViewOptions

Наследуемые свойства

  • _eventClass, _eventManager _viewBuilder, viewClass, viewVars

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

  • __construct() public
    Конструктор
  • __get() public
    Магический аксессор для хелперов.
  • __set() public
    Магический сеттер для устаревших свойств.
  • _checkFilePath() protected
    Проверка, что путь к файлу представления не выходит за пределы определенных путей шаблонов.
  • _elementCache() protected
    Генерация конфигурационных параметров кэша для элемента.
  • _evaluate() protected
    Метод песочницы для оценки шаблона/скрипта представления.
  • _getElementFileName() protected
    Поиск имени файла элемента, возвращает false при ошибке.
  • _getLayoutFileName() protected
    Возвращает имя файла макета для этого шаблона в виде строки.
  • _getSubPaths() protected

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

  • _getViewFileName() protected

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

  • _inflectViewFileName() protected
    Изменение имени файла шаблона представления в нижний регистр с подчёркиванием.
  • _paths() protected
    Возвращает все возможные пути для поиска файлов представлений в порядке.
  • _render() protected

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

  • _renderElement() protected

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

  • append() public
    Добавить в существующий или новый блок.
  • assign() public

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

  • autoLayout() public deprecated

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

  • blocks() public
    Получить имена всех существующих блоков.
  • cache() public
    Создать кэшированный блок логики представления.
  • disableAutoLayout() public
    Отключить традиционный режим CakePHP по применению файлов макета.
  • element() public
    Отображает фрагмент PHP с предоставленными параметрами и возвращает HTML, XML или любую другую строку.
  • elementExists() public
    Проверяет существование элемента
  • enableAutoLayout() public

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

  • end() public
    Завершить блок захвата. Комплементарно к View::start()
  • exists() public
    Проверить наличие блока
  • extend() public

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

  • fetch() public

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

  • get() public
    Возвращает содержимое заданной переменной представления.
  • getCurrentType() public
    Получить текущий тип представления
  • getLayout() public

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

  • getLayoutPath() public
    Получить путь к файлам макета.
  • getName() public
    Возвращает имя контроллера представления.
  • getPlugin() public
    Возвращает имя плагина.
  • getRequest() public
    Получить экземпляр запроса.
  • getResponse() public
    Получить экземпляр ответа.
  • getSubDir() public
    Получить поддиректорию для файлов шаблона.
  • getTemplate() public

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

  • getTemplatePath() public
    Получить путь к файлам шаблонов.
  • getTheme() public
    Получить текущую тему представления.
  • getVars() public
    Возвращает список переменных, доступных в текущем контексте представления.
  • helpers() public
    Получить реестр хелперов, используемый этим классом представления.
  • initialize() public
    Метод обработки инициализации.
  • isAutoLayoutEnabled() public

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

  • layout() public deprecated

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

  • layoutPath() public deprecated
    Получить/установить путь к файлам макета.
  • loadHelper() public
    Загружает хелпер. Делегирует загрузку хелпера HelperRegistry::load().
  • loadHelpers() public
    Взаимодействие с HelperRegistry для загрузки всех хелперов.
  • pluginSplit() public

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

  • prepend() public
    Добавить в начало существующего или нового блока.
  • render() public
    Отображает представление для заданного файла шаблона и макета.
  • renderLayout() public

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

  • reset() public

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

  • setElementCache() public
    Установить конфигурацию кэша, которую будет использовать представление для хранения кэшированных элементов.
  • setLayout() public

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

  • setLayoutPath() public
    Установить путь к файлам макета.
  • setPlugin() public
    Устанавливает имя плагина.
  • setRequest() public

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

  • setResponse() public
    Устанавливает экземпляр ответа.
  • setSubDir() public
    Установить подкаталог для файлов шаблонов.
  • setTemplate() public

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

  • setTemplatePath() public
    Установить путь к файлам шаблонов.
  • setTheme() public
    Установить тему представления для использования.
  • start() public
    Начать захват вывода для «блока»
  • template() public deprecated

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

  • templatePath() public deprecated
    Получить/установить путь к файлам шаблонов.
  • theme() public deprecated
    Тема представления для использования.
  • uuid() public deprecated
    Генерирует уникальный, не случайный идентификатор DOM для объекта на основе типа объекта и целевого URL.

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

__construct()source public

__construct( Cake\Http\ServerRequest $request = null , Cake\Http\Response $response = null , Cake\Event\EventManager $eventManager = null , array $viewOptions = [] )

Конструктор

Параметры

Cake\Http\ServerRequest $request необязательно null
Экземпляр запроса.
Cake\Http\Response $response необязательно null
Экземпляр ответа.
Cake\Event\EventManager $eventManager необязательно null
Экземпляр менеджера событий.
массив $viewOptions необязательно []

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

__get()source public

__get( string $name )

Магический аксессор для помощников.

Параметры

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

Возвращает

смешанный

__set()source public

__set( string $name , mixed $value )

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

Параметры

строка $name
Имя свойства.
смешанный $value
Значение свойства.

_checkFilePath()source protected

_checkFilePath( string $file , string $path )

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

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

Параметры

строка $file
Путь к файлу шаблона.
строка $path
Базовый путь, внутри которого должен быть $file.

Возвращает

строка
Путь к файлу

Исключения

InvalidArgumentException

_elementCache()source protected

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

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

Параметры

строка $name
Имя элемента
массив $data
Данные
массив $options
Параметры элемента

Возвращает

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

_evaluate()source protected

_evaluate( string $viewFile , array $dataForView )

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

Параметры

строка $viewFile
Имя файла представления
массив $dataForView
Данные для включения в отрисовываемое представление.

Возвращает

строка
Отрисованный вывод

_getElementFileName()source protected

_getElementFileName( string $name , boolean $pluginCheck = true )

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

Параметры

строка $name
Имя элемента для поиска.
булево $pluginCheck необязательно true
  • если false, игнорирует плагин запроса, если загруженный плагин не загружен

Возвращает

строка|ложь
Строка имени файла элемента или false, когда файл не найден.

_getLayoutFileName()source protected

_getLayoutFileName( string|null $name = null )

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

Параметры

строка|null $name необязательно null
Имя макета для поиска.

Возвращает

строка
Имя файла макета (.ctp).

Исключения

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

_getSubPaths()source protected

_getSubPaths( string $basePath )

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

Параметры

строка $basePath
Базовый путь, по которому нужно получить префиксный.

Возвращает

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

_getViewFileName()source protected

_getViewFileName( string|null $name = null )

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

Параметры

строка|null $name необязательно null
Действие контроллера для поиска имени файла шаблона

Возвращает

строка
Имя файла шаблона

Исключения

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

_inflectViewFileName()source protected

_inflectViewFileName( string $name )

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

Параметры

строка $name
Имя файла, которое должно быть склонено.

Возвращает

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

_paths()source protected

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

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

Параметры

строка|null $plugin необязательно null
Необязательное имя плагина для поиска файлов представлений.
булево $cached необязательно true
Установите в значение false, чтобы принудительно обновить пути к представлениям. По умолчанию true.

Возвращает

массив
пути

_render()source protected

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

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

Параметры

строка $viewFile
Имя файла представления
массив $data необязательный []

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

Возвращает

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

Выбрасывает

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

Вызывает

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

_renderElement()source protected

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

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

Параметры

строка $file
Путь к файлу элемента
массив $data
Данные для отображения
массив $options
Параметры элемента

Возвращает

строка

Вызывает

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

append()source public

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

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

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

Параметры

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

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

Возвращает


$this

См. также

\Cake\View\ViewBlock::concat()

assign()source public

assign( string $name , mixed $value )

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

Параметры

строка $name
Имя блока
смешанный $value

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

Возвращает


$this

См. также

\Cake\View\ViewBlock::set()

autoLayout()source public устаревший

autoLayout( boolean|null $autoLayout = null )

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

Устаревший

3.5.0 Используйте isAutoLayoutEnabled()/enableAutoLayout() вместо этого.

Параметры

boolean|null $autoLayout необязательный null
Логическое значение для включения/отключения. Если null, возвращает текущее значение.

Возвращает

boolean|null

blocks()source public

blocks( )

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

Возвращает

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

См. также

\Cake\View\ViewBlock::keys()

cache()source public

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

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

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

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

Параметры

вызов $block
Блок кода, для которого вы хотите кэшировать вывод.
массив $options необязательный []
Параметры, определяющие ключ кэша и т.д.

Возвращает

строка
Содержимое рендеринга.

Выбрасывает

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

disableAutoLayout()source public

disableAutoLayout( )

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

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

Возвращает


$this

element()source 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, чтобы не выбрасывать исключения. - plugin - Установка в false заставит использовать элемент приложения из шаблонов плагина, когда плагин имеет элемент с тем же именем. По умолчанию true

Возвращает

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

Выбрасывает

Cake\View\Exception\MissingElementException

Когда элемент отсутствует и ignoreMissing равно false.


elementExists()source public

elementExists( string $name )

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

Параметры

строка $name

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

Возвращает

boolean
Успех

enableAutoLayout()source public

enableAutoLayout( boolean $enable = true )

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

Параметры

boolean $enable необязательный true
Логическое значение для включения/выключения.

Возвращает


$this

end()source public

end( )

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

Возвращает


$this

См. также

\Cake\View\ViewBlock::end()

exists()source public

exists( string $name )

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

Параметры

строка $name
Имя блока

Возвращает

boolean

extend()source public

extend( string $name )

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

Параметры

строка $name
Шаблон или элемент для «расширения» текущего.

Возвращает


$this

Выбрасывает

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

fetch()source public

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

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

Параметры

строка $name
Имя блока
строка $default необязательный ''
Текст по умолчанию

Возвращает

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

См. также

\Cake\View\ViewBlock::get()
END_OF_DOCUMENT_MARKER

get()source public

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

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

Параметры

строка $var
Переменная представления, содержимое которой нужно получить.
смешанный $default необязательный null
Значение по умолчанию/резервное содержимое переменной $var.

Возвращает

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

getCurrentType()source public

getCurrentType( )

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

Возвращает

строка

getLayout()source public

getLayout( )

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

Возвращает

строка

getLayoutPath()source public

getLayoutPath( )

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

Возвращает

строка

getName()source public

getName( )

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

Возвращает

строка|null

С тех пор как

3.7.7

getPlugin()source public

getPlugin( )

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

Возвращает

строка|null

С тех пор как

3.7.0

getRequest()source public

getRequest( )

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

Возвращает

Cake\Http\ServerRequest

С тех пор как

3.7.0

getResponse()source public

getResponse( )

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

Возвращает

Cake\Http\Response

С тех пор как

3.7.0

getSubDir()source public

getSubDir( )

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

Возвращает

строка

См. также

\Cake\View\View::$subDir

С тех пор как

3.7.0

getTemplate()source public

getTemplate( )

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

Возвращает

строка

getTemplatePath()source public

getTemplatePath( )

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

Возвращает

строка

getTheme()source public

getTheme( )

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

Возвращает

строка|null

getVars()source public

getVars( )

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

Возвращает

строка[]
Массив имен заданных переменных представления.

helpers()source public

helpers( )

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

Возвращает

Cake\View\HelperRegistry

initialize()source public

initialize( )

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

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

isAutoLayoutEnabled()source public

isAutoLayoutEnabled( )

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

Возвращает

boolean

layout()source public устаревшее

layout( string|null $name = null )

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

Устарело

3.5.0 Используйте getLayout()/setLayout() вместо этого.

Параметры

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

Возвращает

строка|null

layoutPath()source public устаревшее

layoutPath( string|null $path = null )

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

Устарело

3.5.0 Используйте getLayoutPath()/setLayoutPath() вместо этого.

Параметры

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

Возвращает

строка|null

loadHelper()source public

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

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

Параметры

строка $name
Имя помощника для загрузки.
массив $config необязательный []
Настройки для помощника.

Возвращает

Cake\View\Helper
объект помощника.

См. также

\Cake\View\HelperRegistry::load()

loadHelpers()source public

loadHelpers( )

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

Возвращает


$this

pluginSplit()source public

pluginSplit( string $name , boolean $fallback = true )

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

Параметры

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

Возвращает

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

prepend()source public

prepend( string $name , mixed $value )

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

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

Параметры

строка $name
Имя блока
смешанный $value

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

Возвращает


$this

См. также

\Cake\View\ViewBlock::concat()

render()source public

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

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

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

  • beforeRender
  • afterRender
  • beforeLayout
  • afterLayout

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

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

Параметры

string|false|null $view необязательно null
Имя файла представления для использования
string|null $layout необязательно null
Макет для использования.

Возвращает

string|null
Содержимое, отрисованное с помощью шаблона, или null, если содержимое уже было отрисовано и возвращено ранее.

Выбрасывает

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

Вызывает

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

renderLayout()source 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]

reset()source public

reset( string $name )

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

Параметры

string $name
Имя блока

Возвращает


$this

См. также

\Cake\View\ViewBlock::set()

setElementCache()source public

setElementCache( string $elementCache )

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

Параметры

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

Возвращает


$this

См. также

\Cake\View\View::$elementCache

С версии

3.7.0

setLayout()source public

setLayout( string $name )

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

Параметры

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

Возвращает


$this

setLayoutPath()source public

setLayoutPath( string $path )

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

Параметры

string $path
Путь к файлам макетов.

Возвращает


$this

setPlugin()source public

setPlugin( string $name )

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

Параметры

string $name
Имя плагина.

Возвращает


$this

С версии

3.7.0

setRequest()source public

setRequest( Cake\Http\ServerRequest $request )

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

  • $this->request - В $request параметр
  • $this->plugin - В значение, возвращаемое $request->getParam('plugin')
  • $this->passedArgs - То же, что и $request->params['pass]

Параметры

Cake\Http\ServerRequest $request
Экземпляр запроса.

Возвращает


$this

С версии

3.7.0

setResponse()source public

setResponse( Cake\Http\Response $response )

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

Параметры

Cake\Http\Response $response
Экземпляр ответа.

Возвращает


$this

С версии

3.7.0

setSubDir()source public

setSubDir( string $subDir )

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

Параметры

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

Возвращает


$this

См. также

\Cake\View\View::$subDir

С версии

3.7.0

setTemplate()source public

setTemplate( string $name )

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

Параметры

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

Возвращает


$this

setTemplatePath()source public

setTemplatePath( string $path )

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

Параметры

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

Возвращает


$this

setTheme()source public

setTheme( string|null $theme )

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

Параметры

string|null $theme
Имя темы.

Возвращает


$this

start()source 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
Имя блока для захвата.

Возвращает


$this

См. также

\Cake\View\ViewBlock::start()

template()source public deprecated

template( string|null $name = null )

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

Устарело

3.5.0 Используйте getTemplate()/setTemplate() вместо этого.

Параметры

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

Возвращает

string|null

templatePath()source public deprecated

templatePath( string|null $path = null )

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

Устарело

3.5.0 Используйте getTemplatePath()/setTemplatePath() вместо этого.

Параметры

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

Возвращает

string|null

theme()source public deprecated

theme( string|null $theme = null )

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

Устарело

3.5.0 Используйте getTheme()/setTheme() вместо этого.

Параметры

string|null $theme необязательно null
Имя темы. Если null, возвращает текущую тему.

Возвращает

string|null

uuid()source public deprecated

uuid( string $object , string $url )

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

Устаревшее

3.7.0 Этот метод устарел и будет удален в версии 4.0.0.

Параметры

строка $object
Тип объекта, например 'форма' или 'ссылка'
строка $url
Целевой URL объекта

Возвращает

строка

Методы, используемые из Cake\View\CellTrait

_createCell()source protected

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

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

Параметры

строка $className
Имя класса ячейки.
строка $action
Имя действия.
строка $plugin
Имя плагина.
массив $options
Опции конструктора для ячейки.

Возвращает

Cake\View\Cell

cell()source protected

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
Если класс ячейки не указал действие ячейки.

Методы, используемые из Cake\Event\EventDispatcherTrait

dispatchEvent()source public

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

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

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

Параметры

строка $name
Имя события.
массив|null $data необязательно null

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

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

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

Возвращает

Cake\Event\Event

eventManager()source public deprecated

eventManager( Cake\Event\EventManager $eventManager = null )

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

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

Устаревшее

3.5.0 Используйте getEventManager()/setEventManager() вместо этого.

Параметры

Cake\Event\EventManager $eventManager необязательно null
менеджер eventManager для установки

Возвращает

Cake\Event\EventManager

getEventManager()source public

getEventManager( )

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

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

Возвращает

Cake\Event\EventManager

setEventManager()source public

setEventManager( Cake\Event\EventManager $eventManager )

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

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

Параметры

Cake\Event\EventManager $eventManager
менеджер eventManager для установки

Возвращает


$this

Методы, используемые из Cake\Log\LogTrait

log()source public

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

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

Параметры

смешанный $msg
Сообщение журнала.
целое число|строка $level необязательно LogLevel::ERROR
Уровень ошибки.
строка|массив $context необязательно []
Дополнительные данные журнала, относящиеся к этому сообщению.

Возвращает

логическое значение
Успех записи в журнал.

Методы, используемые из Cake\Routing\RequestActionTrait

requestAction()source public deprecated

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)
]);

Устаревшее

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

Параметры

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

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

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

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

Возвращает

смешанный тип

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


Методы, используемые из Cake\View\ViewVarsTrait

createView()source public

createView( string|null $viewClass = null )

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

Параметры

строка|null $viewClass необязательно null
Необязательное именованное имя класса представления для экземпляризации.

Возвращает

Cake\View\View

Исключения

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

set()source public

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

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

Параметры

строка|массив $name
Строка или массив данных.
смешанный $value необязательно null

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

Возвращает


$this

viewBuilder()source public

viewBuilder( )

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

Возвращает

Cake\View\ViewBuilder
END_OF_DOCUMENT_MARKER

viewOptions()source public deprecated

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

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

Устаревшее

3.7.0 Используйте ViewBuilder::setOptions() или любой из его методов-сеттеров вместо этого.

Параметры

string|array|null $options необязательный null
Строка или массив строк для добавления в _validViewOptions.
boolean $merge необязательный true

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

Возвращает

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

Магические методы, унаследованные от Cake\Event\EventDispatcherInterface

getEventManager()

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

$Blockssource

protected Cake\View\ViewBlock

Экземпляр ViewBlock.

$_currentsource

protected string

Файл представления, который в данный момент рендерится. Используется для разрешения родительских файлов.

$_currentTypesource

protected string

В настоящее время рендерится элемент. Используется для поиска родительских фрагментов для элементов.

''

$_extsource

protected string

Расширение файла. По умолчанию — шаблон CakePHP ".ctp".

'.ctp'

$_helperssource

protected Cake\View\HelperRegistry

Коллекция хелперов

$_parentssource

protected array

Имена представлений и их родителей, используемые с View::extend();

[]

$_passedVarssource

protected array

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

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

$_pathssource

protected array

Хранит массив путей.

[]

$_pathsForPluginsource

protected array

Хранит массив путей плагинов.

[]

$_stacksource

protected array

Стек содержимого, используется для вложенных шаблонов, которые все используют View::extend();

[]

$_viewBlockClasssource

protected string

Класс ViewBlock.

ViewBlock::class

$autoLayoutsource

protected boolean

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

true

$elementCachesource

protected string

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

См.

\Cake\View\View::element()
'default'

$hasRenderedsource

public boolean

Истина, когда представление было рендерировано.

Устаревшее

3.7.0 Свойство устарело и будет удалено в версии 4.0.0.
false

$helperssource

protected array

Массив имён встроенных хелперов для включения.

[]

$layoutsource

protected string

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

'default'

$layoutPathsource

protected string

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

$namesource

protected string

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

$passedArgssource

public array

Текущие переданные параметры. Передаются в представление из создающего контроллера для удобства.

Устаревшее

3.1.0 Используйте $this->request->getParam('pass') вместо этого.
[]

$pluginsource

protected string|null

Имя плагина.

$requestsource

protected Cake\Http\ServerRequest

Экземпляр объекта \Cake\Http\ServerRequest, содержащий информацию о текущем запросе. Этот объект содержит всю информацию о запросе и несколько методов для чтения дополнительной информации о запросе.

$responsesource

protected Cake\Http\Response

Ссылка на объект Response

$subDirsource

protected string

Подкаталог для этого файла шаблона. Это часто используется для маршрутизации на основе расширений. Например, с расширением xml, $subDir будет xml/

''
END_OF_DOCUMENT_MARKER

$templatesource

protected строка

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

$templatePathsource

protected строка

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

$themesource

protected строка|null

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

$uuidssource

public массив

Список сгенерированных UUID DOM.

Устаревшее

3.7.0 Свойство устарело и будет удалено в версии 4.0.0.
[]

Подробное описание магических свойств

$Blockssource

public Cake\View\ViewBlock

$Breadcrumbssource

public Cake\View\Helper\BreadcrumbsHelper

$Flashsource

public Cake\View\Helper\FlashHelper

$Formsource

public Cake\View\Helper\FormHelper

$Htmlsource

public Cake\View\Helper\HtmlHelper

$Numbersource

public Cake\View\Helper\NumberHelper

$Paginatorsource

public Cake\View\Helper\PaginatorHelper

$Rsssource

public Cake\View\Helper\RssHelper

$Sessionsource

public Cake\View\Helper\SessionHelper

$Textsource

public Cake\View\Helper\TextHelper

$Timesource

public Cake\View\Helper\TimeHelper

$Urlsource

public Cake\View\Helper\UrlHelper

$viewsource

public строка

$viewPathsource

public строка

© 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/3.8/class-Cake.View.View.html

Spec-Zone.ru

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