Класс Event
Представляет класс транспортировки событий по системе. Получает имя, объект-источник и необязательную полезную нагрузку. Имя может быть любой строкой, уникально идентифицирующей событие в приложении, в то время как объект-источник представляет объект, к которому относится событие.
Краткое описание свойств
-
$_dataprotectedДополнительные данные для метода, получающего событиеarray -
$_nameprotectedИмя событияstring -
$_stoppedprotectedФлаг, обозначающий остановку события (по умолчанию false)boolean -
$_subjectprotectedОбъект, к которому относится событие (обычно тот же объект, который генерирует событие)object -
$resultpublicСвойство для хранения результата обработки слушателями событийmixed
Краткое описание магических свойств
-
$datapublic(устаревшее) Дополнительные данные для метода, получающего событиеarray -
$namepublic(устаревшее) Имя событияstring -
$resultpublic(устаревшее) Свойство для хранения результата обработки слушателями событийmixed -
$subjectpublic(устаревшее) Объект, к которому относится событие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( )
Значение результата обработки слушателями события
Возвращает
смешанноеisStopped()source public
isStopped( )
Проверка, остановлено ли событие
Возвращает
булевоTrue, если событие остановлено
name()source public
name( )
Возвращает имя этого события. Обычно используется в качестве идентификатора события
Устарело
3.4.0 используйте getName() вместо этого.Возвращает
строкаresult()source public
result( )
Значение результата обработки слушателями события
Устарело
3.4.0 используйте getResult() вместо этого.Возвращает
смешанноеsetData()source public
setData( array|string $key , mixed $value null )
Присваивает значение данным/загрузке этого события.
Параметры
- массив|строка
$key - Массив заменит все данные загрузки, а ключ установит только этот элемент массива.
- смешанный
$valueнеобязательно null - Значение для установки.
Возвращает
$this
setResult()source public
setResult( mixed $value null )
Обработчики могут прикрепить значение результата к событию.
Параметры
- смешанный
$valueнеобязательно null - Значение для установки.
Возвращает
$this
subject()source public
subject( )
Возвращает объект-субъект этого события.
Устарело
3.4.0 используйте getSubject() вместо этого.Возвращает
объектПодробное описание свойств
$_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