Spec-Zone.ru › CakePHP 3.4

Класс Event

Представляет класс транспортировки событий по системе. Получает имя, объект-источник и необязательную полезную нагрузку. Имя может быть любой строкой, уникально идентифицирующей событие в приложении, в то время как объект-источник представляет объект, к которому относится событие.

Пространство имен: Cake\Event
Расположение: Event/Event.php

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

  • $_data protected
    array
    Дополнительные данные для метода, получающего событие
  • $_name protected
    string
    Имя события
  • $_stopped protected
    boolean
    Флаг, обозначающий остановку события (по умолчанию false)
  • $_subject protected
    object
    Объект, к которому относится событие (обычно тот же объект, который генерирует событие)
  • $result public
    mixed
    Свойство для хранения результата обработки слушателями событий

Краткое описание магических свойств

  • $data public
    array
    (устаревшее) Дополнительные данные для метода, получающего событие
  • $name public
    string
    (устаревшее) Имя события
  • $result public
    mixed
    (устаревшее) Свойство для хранения результата обработки слушателями событий
  • $subject public
    object
    (устаревшее) Объект, к которому относится событие

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

  • __construct() public
    Конструктор
  • __get() public
    Предоставляет чтение только для свойств name и subject.
  • __set() public
    Обеспечивает обратную совместимость для записи данных и свойств результата.
  • data() public
    Доступ к данным/полезной нагрузке события.
  • getData() public
    Доступ к данным/полезной нагрузке события.
  • getName() public
    Возвращает имя события. Обычно используется в качестве идентификатора события.
  • getResult() public
    Значение результата обработки слушателями события.
  • getSubject() public
    Возвращает объект-источник события.
  • isStopped() public
    Проверяет, остановлено ли событие.
  • name() public
    Возвращает имя события. Обычно используется в качестве идентификатора события.
  • result() public
    Значение результата обработки слушателями события.
  • setData() public
    Присваивает значение данным/полезной нагрузке события.
  • setResult() public
    Слушатели могут прикрепить значение результата к событию.
  • stopPropagation() public
    Прекращает дальнейшую обработку события.
  • subject() public
    Возвращает объект-источник события.

Подробное описание методов

__construct()source public

__construct( string $name , object|null $subject null , array|ArrayAccess|null $data null )

Конструктор

Примеры использования:

$event = new Event('Order.afterBuy', $this, ['buyer' => $userData]);
 $event = new Event('User.afterRegister', $UserModel);

Параметры

строка $name
Имя события
объект|null $subject необязательно null
объект, к которому относится это событие (обычно объект, генерирующий событие)
массив|ArrayAccess|null $data необязательно null
любое значение, которое вы хотите передать вместе с этим событием, чтобы слушатели могли его прочитать

__get()source public

__get( string $attribute )

Предоставляет чтение только для свойств name и subject.

Устарело

3.4.0 Свойства public будут удалены.

Параметры

строка $attribute
Имя атрибута.

Возвращает

смешанное

__set()source public

__set( string $attribute , mixed $value )

Обеспечивает обратную совместимость для записи данных и свойств результата.

Устарело

3.4.0 Свойства public будут удалены.

Параметры

строка $attribute
Имя атрибута.
смешанное $value
Значение для установки.

data()source public

data( string|null $key null )

Доступ к данным/полезной нагрузке события.

Устарело

3.4.0 используйте getData() вместо этого.

Параметры

строка|null $key необязательно null
Элемент полезной нагрузки данных для возврата или null для возврата всех данных.

Возвращает

массив|смешанное|null

Полезная нагрузка данных, если $key равен null, или значение данных для данного $key. Если $key не существует, возвращается значение null.


getData()source public

getData( string|null $key null )

Доступ к данным/полезной нагрузке события.

Параметры

строка|null $key необязательно null
Элемент полезной нагрузки данных для возврата или null для возврата всех данных.

Возвращает

массив|смешанное|null

Полезная нагрузка данных, если $key равен null, или значение данных для данного $key. Если $key не существует, возвращается значение null.


getName()source public

getName( )

Возвращает имя этого события. Обычно используется в качестве идентификатора события

Возвращает

строка

getResult()source public

getResult( )

Значение результата обработки слушателями события

Возвращает

смешанное

getSubject()source public

getSubject( )

Возвращает объект-источник события

Возвращает

объект

isStopped()source public

isStopped( )

Проверка, остановлено ли событие

Возвращает

булево
True, если событие остановлено

name()source public

name( )

Возвращает имя этого события. Обычно используется в качестве идентификатора события

Устарело

3.4.0 используйте getName() вместо этого.

Возвращает

строка

result()source public

result( )

Значение результата обработки слушателями события

Устарело

3.4.0 используйте getResult() вместо этого.

Возвращает

смешанное
END_OF_DOCUMENT_MARKER

setData()source public

setData( array|string $key , mixed $value null )

Присваивает значение данным/загрузке этого события.

Параметры

массив|строка $key
Массив заменит все данные загрузки, а ключ установит только этот элемент массива.
смешанный $value необязательно null
Значение для установки.

Возвращает


$this

setResult()source public

setResult( mixed $value null )

Обработчики могут прикрепить значение результата к событию.

Параметры

смешанный $value необязательно null
Значение для установки.

Возвращает


$this

stopPropagation()source public

stopPropagation( )

Останавливает дальнейшее использование события.

subject()source public

subject( )

Возвращает объект-субъект этого события.

Устарело

3.4.0 используйте getSubject() вместо этого.

Возвращает

объект

Подробное описание свойств

$_datasource

protected массив

Дополнительные данные для метода, который получает событие.

$_namesource

protected строка

Имя события.

$_stoppedsource

protected логическое

Флаг, указывающий на остановку события (по умолчанию false).

false

$_subjectsource

protected объект

Объект, к которому относится это событие (обычно тот же объект, который генерирует событие).

$resultsource

public смешанный

Свойство, используемое для сохранения значения результата обработчиков событий.

Подробное описание магических свойств

$datasource

public массив

$namesource

public строка

$resultsource

public смешанный

$subjectsource

public объект

© 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.4/class-Cake.Event.Event.html

Spec-Zone.ru

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