Класс Helper
Абстрактный базовый класс для всех других Helpers в CakePHP. Предоставляет общие методы и функции.
Методы обратного вызова
Helpers поддерживают ряд методов обратного вызова. Эти обратные вызовы позволяют вам подключиться к различным событиям жизненного цикла представления и либо изменить существующее содержимое представления, либо выполнить другую логику, специфичную для приложения. События не реализуются в этом базовом классе, так как реализация метода обратного вызова подписывает помощника на связанное событие. Методы обратного вызова следующие:
-
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 -
$fieldsetpublicНе используется.array -
$helpersprotectedСписок helper, используемых этим helperarray -
$tagspublicНе используется.array
Унаследованные свойства
Краткое описание методов
- __call() publicПредоставляет ошибки, не влияющие на работу, при вызове несуществующих методов.
- __construct() publicКонструктор по умолчанию
- __debugInfo() public
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
- __get() publicЛеничная загрузка helper.
- __set() publicМагический setter для удалённых свойств.
- _cleanConfirmMessage() protectedВозвращает строку, предназначенную для использования в confirm()
- _confirm() protectedВозвращает строку, которая должна использоваться в качестве обработчика onclick для диалоговых окон confirm.
- addClass() publicДобавляет указанный класс к параметрам элемента
- getView() publicПолучить экземпляр представления, к которому привязан этот helper.
- 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 - Представление, к которому прикрепляется данный помощник.
- массив
$configнеобязательно [] - Параметры конфигурации для помощника.
__debugInfo()source public
__debugInfo( )
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
Возвращает
массив__get()source public
__get( string $name )
Леничная загрузка helper.
Параметры
- строка
$name - Имя свойства, к которому обращаются.
Возвращает
Cake\View\Helper|nullЭкземпляр helper, если helper с заданным именем существует
__set()source public
__set( string $name , mixed $value )
Магический setter для удалённых свойств.
Параметры
- строка
$name - Имя свойства.
- смешанное
$value - Значение для установки.
_cleanConfirmMessage()source protected
_cleanConfirmMessage( string $message )
Возвращает строку, предназначенную для использования в confirm()
Параметры
- строка
$message - Сообщение для очистки
Возвращает
смешанное_confirm()source protected
_confirm( string $message , string $okCode , string $cancelCode = '' , array $options = [] )
Возвращает строку, которая должна использоваться в качестве обработчика onclick для диалоговых окон confirm.
Параметры
- строка
$message - Сообщение для отображения
- строка
$okCode - Код, который будет выполнен после того, как пользователь выберет «ОК»
- строка
$cancelCodeнеобязательно '' - Код, который будет выполнен после того, как пользователь выберет «Отмена»
- массив
$optionsнеобязательно [] - Массив опций
Возвращает
строкакод JS onclick
addClass()source public
addClass( array $options = [] , string|null $class = null , string $key = 'class' )
Добавляет указанный класс к параметрам элемента
Параметры
- массив
$optionsнеобязательно [] - Массив опций/атрибутов, к которым добавляется класс
- строка|null
$classнеобязательно null - Имя добавляемого класса.
- строка
$keyнеобязательно 'class' - Ключ, используемый для класса.
Возвращает
массивМассив опций со свойством $key.
getView()source public
getView( )
Получить экземпляр представления, к которому привязан этот helper.
Возвращает
Cake\View\ViewПривязанный экземпляр представления.
implementedEvents()source public
implementedEvents( )
Получить обработчики событий View, к которым этот помощник проявляет интерес.
Определяя один из методов обратного вызова, предполагается, что помощник заинтересован в соответствующем событии.
Переопределите этот метод, если вам необходимо добавить нестандартные обработчики событий. Или если вы хотите, чтобы помощники реагировали на нестандартные события.
Возвращает
массивРеализация
Cake\Event\EventListenerInterface::implementedEvents() initialize()source public
initialize( array $config )
Метод-обработчик события конструктора.
Реализуйте этот метод, чтобы избежать необходимости переопределения конструктора и вызова родительского класса.
Параметры
- массив
$config - Настройки конфигурации, предоставленные этому помощнику.
Методы, используемые из 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 True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
config()source public deprecated
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']);
Устаревший
3.4.0 используйте setConfig()/getConfig() вместо этого.Параметры
- строка|массив|null
$keyнеобязательно null - Ключ для получения/установки или полный массив конфигураций.
- смешанный тип|null
$valueнеобязательно null - Значение для установки.
- логическое значение
$mergeнеобязательно true - Флаг, указывающий, нужно ли выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
смешанный типЗначение конфигурации, которое читается, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value = null )
Объединить предоставленную конфигурацию с существующей. В отличие от config(), которая выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка определенного значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигураций.
- смешанный тип|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key = null , mixed $default = null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определенного значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- строка|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- смешанный тип
$defaultнеобязательно null - Возвращаемое значение, если ключ не существует.
Возвращает
смешанный типЗначение конфигурации, которое читается.
setConfig()source public
setConfig( string|array $key , mixed|null $value = null , boolean $merge = true )
Устанавливает конфигурацию.
Использование
Установка определенного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигураций.
- смешанный тип|null
$valueнеобязательно null - Значение для установки.
- логическое значение
$mergeнеобязательно true - Флаг, указывающий, нужно ли выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
$this
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробное описание свойств
$_helperMapsource
protected массив
Таблица поиска помощников, используемая для ленивой загрузки объектов помощников.
[]
$fieldsetsource
public массив
Не используется.
Устаревший
3.7.0 Это свойство не используется и будет удалено в 4.0.0.[]
$tagssource
public массив
Не используется.
Устаревший
3.7.0 Это свойство не используется и будет удалено в 4.0.0.[]
© 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.7/class-Cake.View.Helper.html