Класс Helper
Абстрактный базовый класс для всех других Helpers в CakePHP. Предоставляет общие методы и возможности.
Методы обратного вызова
Helpers поддерживают ряд методов обратного вызова. Эти обратные вызовы позволяют вам подключиться к различным событиям жизненного цикла представления и либо изменять существующее содержимое представления, либо выполнять другую специфическую для приложения логику. События не реализованы в этом базовом классе, так как реализация метода обратного вызова подписывает helper на соответствующее событие. Методы обратного вызова следующие:
-
beforeRender(Event $event, $viewFile)- beforeRender вызывается перед отрисовкой файла представления. -
afterRender(Event $event, $viewFile)- afterRender вызывается после отрисовки файла представления, но перед отрисовкой макета. - beforeLayout(Event $event, $layoutFile)` - beforeLayout вызывается перед отрисовкой макета.
-
afterLayout(Event $event, $layoutFile)- afterLayout вызывается после отрисовки макета. -
beforeRenderFile(Event $event, $viewFile)- Вызывается перед отрисовкой любого фрагмента представления. -
afterRenderFile(Event $event, $viewFile, $content)- Вызывается после отрисовки любого фрагмента представления. Если слушатель возвращает ненулевое значение, выходные данные отрисованного файла будут установлены на это значение.
- Cake\View\Helper реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait
Непосредственные подклассы
- Cake\View\Helper\BreadcrumbsHelper
- Cake\View\Helper\FlashHelper
- Cake\View\Helper\UrlHelper
- Cake\View\Helper\FormHelper
- Cake\View\Helper\HtmlHelper
- Cake\View\Helper\NumberHelper
- Cake\View\Helper\PaginatorHelper
- Cake\View\Helper\RssHelper
- Cake\View\Helper\SessionHelper
- Cake\View\Helper\TextHelper
- Cake\View\Helper\TimeHelper
Краткое описание свойств
- Экземпляр View, к которому прикреплён этот helper
$_Viewprotected -
$_defaultConfigprotectedЗначения конфигурации по умолчанию для этого helper.array -
$_helperMapprotectedТаблица поиска helper, используемая для ленивой загрузки объектов helper.array -
$fieldsetpublicarrayСодержит поля ['имя_поля' => ['тип' => 'строка', 'длина' => 100]], первичный ключ и правила валидации ['имя_поля']
-
$helperspublicСписок helper, используемых этим helperarray -
$pluginpublicПуть к плагинуstring - Объект запроса
$requestpublic -
$tagspublicХранит шаблоны тегов.array -
$themepublicТекущее имя темы, если таковое имеется.string
Наследуемые свойства
Краткое описание методов
- __call() publicОбеспечивает некритические ошибки при вызове отсутствующих методов.
- __construct() publicКонструктор по умолчанию
- __debugInfo() public
Возвращает массив, который может быть использован для описания внутреннего состояния этого объекта.
- __get() publicЛениво загружает helper.
- _confirm() protectedВозвращает строку, которая должна использоваться в качестве обработчика onclick для диалоговых окон подтверждения.
- addClass() publicДобавляет заданный класс к опциям элемента
- implementedEvents() publicПолучить View обратные вызовы, в которых заинтересован этот helper.
- initialize() publicМетод привязки конструктора.
Подробное описание методов
__call()source public
__call( string $method , array $params )
Обеспечивает некритические ошибки при вызове отсутствующих методов.
Параметры
- строка
$method - Метод для вызова
- массив
$params - Массив параметров для метода.
__construct()source public
__construct( Cake\View\View $View , array $config [] )
Конструктор по умолчанию
Параметры
-
Cake\View\View$View - Представление, к которому прикрепляется helper.
- массив
$configнеобязательно [] - Настройки конфигурации для helper.
__debugInfo()source public
__debugInfo( )
Возвращает массив, который может быть использован для описания внутреннего состояния этого объекта.
Возвращает
массив__get()source public
__get( string $name )
Лениво загружает helper.
Параметры
- строка
$name - Имя свойства, к которому осуществляется доступ.
Возвращает
Cake\View\Helper|nullЭкземпляр helper, если helper с указанным именем существует
_confirm()source protected
_confirm( string $message , string $okCode , string $cancelCode '' , array $options [] )
Возвращает строку, которая должна использоваться в качестве обработчика onclick для диалоговых окон подтверждения.
Параметры
- строка
$message - Сообщение для отображения
- строка
$okCode - Код, который будет выполнен после того, как пользователь выберет 'OK'
- строка
$cancelCodeнеобязательно '' - Код, который будет выполнен после того, как пользователь выберет 'Отмена'
- массив
$optionsнеобязательно [] - Массив опций
Возвращает
строкакод onclick JS
addClass()source public
addClass( array $options [] , string|null $class null , string $key 'class' )
Добавляет заданный класс к опциям элемента
Параметры
- массив
$optionsнеобязательно [] - Массив опций/атрибутов, к которым нужно добавить класс
- строка|null
$classнеобязательно null - Имя класса, который добавляется.
- строка
$keyнеобязательно 'class' - ключ, который нужно использовать для класса.
Возвращает
массивМассив опций с установленным $key.
implementedEvents()source public
implementedEvents( )
Получить View обратные вызовы, в которых заинтересован этот helper.
Определяя один из методов обратного вызова, предполагается, что helper заинтересован в связанном событии.
Переопределите этот метод, если вам нужно добавить слушатели событий, отличные от стандартных. Или если вы хотите, чтобы helpers прослушивали нестандартные события.
Возвращает
массивРеализация
Cake\Event\EventListenerInterface::implementedEvents() initialize()source public
initialize( array $config )
Метод привязки конструктора.
Реализуйте этот метод, чтобы избежать необходимости переопределения конструктора и вызова родительского.
Параметры
- массив
$config - Настройки конфигурации, предоставленные этому helper.
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удалить единственный ключ конфигурации
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
_configRead()source protected
_configRead( string|null $key )
Чтение переменной конфигурации
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
смешанный_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записать переменную конфигурации
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный
$value - Значение для записи.
- логический|строка
$mergeнеобязательно false Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
config()source public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Использование
Чтение всей конфигурации:
$this->config();
Чтение определенного значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определенного значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив|null
$keyнеобязательно null - Ключ для получения/установки или полный массив конфигураций.
- смешанный|null
$valueнеобязательно null - Значение для установки.
- логический
$mergeнеобязательно true - Выполнять ли рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию истина.
Возвращает
смешанныйЗначение конфигурации, которое читается, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить неверный ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Объединение предоставленной конфигурации с существующей конфигурацией. В отличие от config(), которая выполняет рекурсивное объединение для вложенных ключей, этот метод выполняет простое объединение.
Установка определенного значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигураций.
- смешанный|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this Сам объект.
Подробное описание свойств
$_helperMapsource
protected массив
Таблица поиска помощников, используемая для ленивой загрузки объектов помощников.
[]
$fieldsetsource
public массив
Хранит поля ['field_name' => ['type' => 'строка', 'длина' => 100]], primaryKey и validates ['field_name']
[]
© 2005–2017 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.3/class-Cake.View.Helper.html