Класс 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\FlashHelper, 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, Cake\View\Helper\UrlHelperПодробное описание методов
__callsource public
__call( string $method , array $params )
Предоставляет ошибки, не являющиеся фатальными, при вызовах отсутствующих методов.
Параметры
- строка
$method - Метод для вызова
- массив
$params - Массив параметров для метода.
__constructsource public
__construct( Cake\View\View $View , array $config [] )
Конструктор по умолчанию
Параметры
-
Cake\View\View$View - Представление, к которому подключается helper.
- массив
$configнеобязательно [] - Настройки конфигурации для helper.
__debugInfosource public
__debugInfo( )
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
Возвращает
arrayмассив
__getsource public
__get( string $name )
Ленично загружает helpers.
Параметры
- строка
$name - Имя свойства, к которому осуществляется доступ.
Возвращает
Cake\View\Helper|nullЭкземпляр helper, если helper с указанным именем существует
_confirmsource protected
_confirm( string $message , string $okCode , string $cancelCode '' , array $options [] )
Возвращает строку, используемую в качестве обработчика onclick для диалогов подтверждения.
Параметры
- строка
$message - Сообщение, которое должно быть отображено
- строка
$okCode - Код, который будет выполнен после того, как пользователь выбрал 'OK'
- строка
$cancelCodeнеобязательно '' - Код, который будет выполнен после того, как пользователь выбрал 'Отмена'
- массив
$optionsнеобязательно [] - Массив опций
Возвращает
stringJS-код onclick
addClasssource public
addClass( array $options [] , string $class null , string $key 'class' )
Добавляет указанный класс к параметрам элемента
Параметры
- массив
$optionsнеобязательно [] - Массив опций/атрибутов, к которым нужно добавить класс
- строка
$classнеобязательно null - Имя добавляемого класса.
- строка
$keyнеобязательно 'class' - ключ для использования класса.
Возвращает
arrayМассив опций со значением $key.
implementedEventssource public
implementedEvents( )
Получить методы обратного вызова представления, которые интересуют этот helper.
Определяя один из методов обратного вызова, предполагается, что helper интересуется соответствующим событием.
Переопределите этот метод, если вам нужно добавить нестандартные слушатели событий. Или если вы хотите, чтобы helpers прослушивали нестандартные события.
Возвращает
arrayмассив
Реализация
Cake\Event\EventListenerInterface::implementedEvents() Методы, используемые из Cake\Core\InstanceConfigTrait
_configDeletesource protected
_configDelete( string $key )
Удалить ключ конфигурации
Параметры
- строка
$key - Ключ для удаления.
Выбрасывает
Cake\Core\Exception\Exceptionесли пытаетесь перезаписать существующую конфигурацию
_configReadsource protected
_configRead( string|null $key )
Прочитать переменную конфигурации
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
mixedсмешанный тип
_configWritesource protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записать переменную конфигурации
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный тип
$value - Значение для записи.
- булево|строка
$mergeнеобязательно false - Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.
Выбрасывает
Cake\Core\Exception\Exceptionесли пытаетесь перезаписать существующую конфигурацию
configsource 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 - Выполнять ли рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию истинно.
Возвращает
mixedЗначение конфигурации, которое считывается, или сам объект при операциях записи.
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить неверный ключ.
configShallowsource 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 - Значение для установки.
Возвращает
mixedСам объект.
Краткое описание свойств
Свойства, используемые из Cake\Core\InstanceConfigTrait
$_configInitializedsource
protected boolean
Указатель, был ли конфигурация свойства уже настроено с значениями по умолчанию
false
© 2005–2016 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.
http://api.cakephp.org/3.1/class-Cake.View.Helper.html