Spec-Zone.ru › CakePHP 3.8

Класс 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
Пространство имен: Cake\View
Расположение: View/Helper.php

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

  • $_View protected
    Cake\View\View
    Экземпляр View, к которому прикреплен этот помощник
  • $_defaultConfig protected
    array
    Настройка по умолчанию для этого помощника.
  • $_helperMap protected
    array
    Таблица поиска помощников, используемая для ленивой загрузки объектов помощников.
  • $fieldset public
    array
    Не используется.
  • $helpers protected
    array
    Список помощников, используемых этим помощником
  • $tags public
    array
    Не используется.

Унаследованные свойства

  • _config, _configInitialized

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

  • __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
При попытке установить недопустимый ключ.

Подробности свойств

$_Viewsource

protected Cake\View\View

Экземпляр View, к которому прикреплён этот помощник

$_defaultConfigsource

protected массив

Настройки по умолчанию для этого помощника.

[]

$_helperMapsource

protected массив

Таблица поиска помощников, используемая для отложенной загрузки объектов помощников.

[]

$fieldsetsource

public массив

Не используется.

Устаревшее

3.7.0 Это свойство не используется и будет удалено в 4.0.0.
[]

$helperssource

protected массив

Список помощников, используемых этим помощником

[]

$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

Spec-Zone.ru

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