Класс 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, к которому прикреплен этот помощник
$_Viewprotected -
$_defaultConfigprotectedНастройка по умолчанию для этого помощника.array -
$_helperMapprotectedТаблица поиска помощников, используемая для ленивой загрузки объектов помощников.array -
$fieldsetpublicНе используется.array -
$helpersprotectedСписок помощников, используемых этим помощникомarray -
$tagspublicНе используется.array
Унаследованные свойства
Краткое описание методов
- __call() publicПредоставление ошибок, не приводящих к сбою, при вызовах отсутствующих методов.
- __construct() publicКонструктор по умолчанию
- __debugInfo() public
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
- __get() publicЛенивая загрузка помощников.
- __set() publicМагический установщик для удаленных свойств.
- _cleanConfirmMessage() protectedВозвращает строку, предназначенную для использования в confirm()
- _confirm() protectedВозвращает строку, которая должна использоваться в качестве обработчика onclick для диалоговых окон подтверждения.
- addClass() publicДобавляет указанный класс к параметрам элемента
- getView() publicПолучение экземпляра представления, к которому привязан этот помощник.
- implementedEvents() publicПолучение обратных вызовов представления, которыми интересуется этот помощник.
- initialize() publicМетод обработки конструктора.
Подробное описание методов
__call()source public
__call( string $method , array $params )
Предоставление ошибок, не приводящих к сбою, при вызовах отсутствующих методов.
Параметры
- string
$method - Метод для вызова
- array
$params - Массив параметров для метода.
__construct()source public
__construct( Cake\View\View $View , array $config = [] )
Конструктор по умолчанию
Параметры
-
Cake\View\View$View - Представление, к которому прикрепляется помощник.
- array
$configнеобязательно [] - Параметры конфигурации для помощника.
__debugInfo()source public
__debugInfo( )
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
Возвращает
array__get()source public
__get( string $name )
Ленивая загрузка помощников.
Параметры
- string
$name - Имя свойства, к которому осуществляется доступ.
Возвращает
Cake\View\Helper|nullЭкземпляр помощника, если помощник с указанным именем существует
__set()source public
__set( string $name , mixed $value )
Магический установщик для удаленных свойств.
Параметры
- string
$name - Имя свойства.
- mixed
$value - Значение для установки.
_cleanConfirmMessage()source protected
_cleanConfirmMessage( string $message )
Возвращает строку, предназначенную для использования в confirm()
Параметры
- string
$message - Сообщение для очистки
Возвращает
mixed_confirm()source protected
_confirm( string $message , string $okCode , string $cancelCode = '' , array $options = [] )
Возвращает строку, которая должна использоваться в качестве обработчика onclick для диалоговых окон подтверждения.
Параметры
- string
$message - Сообщение, которое должно быть отображено
- string
$okCode - Код, который должен быть выполнен после того, как пользователь выбрал «ОК»
- string
$cancelCodeнеобязательно '' - Код, который должен быть выполнен после того, как пользователь выбрал «Отмена»
- array
$optionsнеобязательно [] - Массив опций
Возвращает
stringкод onclick JS
addClass()source public
addClass( array $options = [] , string|null $class = null , string $key = 'class' )
Добавляет указанный класс к параметрам элемента
Параметры
- array
$optionsнеобязательно [] - Массив параметров/атрибутов, к которым нужно добавить класс
- string|null
$classнеобязательно null - Имя добавляемого класса.
- string
$keyнеобязательно 'class' - ключ, который следует использовать для класса.
Возвращает
arrayМассив параметров со значением $key.
getView()source public
getView( )
Получение экземпляра представления, к которому привязан этот помощник.
Возвращает
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 устаревшее
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 - Возвращаемое значение, если ключ не существует.
Возвращает
смешанный типДанные конфигурации по указанному ключу или 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.8/class-Cake.View.Helper.html