Класс Event
Представляет класс транспорта событий в системе. Получает имя, предмет и необязательную полезную нагрузку. Имя может быть любой строкой, уникально идентифицирующей событие в приложении, в то время как предмет представляет собой объект, к которому относится событие.
Краткое описание свойств
-
$_dataprotectedПользовательские данные для метода, получающего событиеarray -
$_nameprotectedИмя событияstring -
$_stoppedprotectedФлаг, отмечающий событие как остановленное или нет, по умолчанию falseboolean -
$_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); Параметры
- string
$name - Имя события
- object|null
$subjectнеобязательно null - объект, к которому относится это событие (обычно объект, генерирующий событие)
- array|ArrayAccess|null
$dataнеобязательно null - любое значение, которое вы хотите передать вместе с этим событием, чтобы его могли прочитать обработчики
__get()source public
__get( string $attribute )
Обеспечивает чтение только для свойств name и subject.
Устарело
3.4.0 Свойства public будут удалены.Параметры
- string
$attribute - Имя атрибута.
Возвращает
mixed__set()source public
__set( string $attribute , mixed $value )
Обеспечивает обратную совместимость для записи данных и свойств результата.
Устарело
3.4.0 Свойства public будут удалены.Параметры
- string
$attribute - Имя атрибута.
- mixed
$value - Значение для установки.
data()source public
data( string|null $key null )
Доступ к данным/полезной нагрузке события.
Устарело
3.4.0 Используйте getData() вместо этого.Параметры
- string|null
$keyнеобязательно null - Элемент полезной нагрузки данных для возврата, или null для возврата всех данных.
Возвращает
array|mixed|nullПолезная нагрузка данных, если $key равен null, или значение данных для заданного $key. Если $key не существует, возвращается null.
getData()source public
getData( string|null $key null )
Доступ к данным/полезной нагрузке события.
Параметры
- string|null
$keyнеобязательно null - Элемент полезной нагрузки данных для возврата, или null для возврата всех данных.
Возвращает
array|mixed|nullПолезная нагрузка данных, если $key равен null, или значение данных для заданного $key. Если $key не существует, возвращается null.
getName()source public
getName( )
Возвращает имя этого события. Обычно используется в качестве идентификатора события
Возвращает
stringisStopped()source public
isStopped( )
Проверяет, остановлено ли событие
Возвращает
booleanTrue, если событие остановлено
name()source public
name( )
Возвращает имя этого события. Обычно используется в качестве идентификатора события
Устарело
3.4.0 Используйте getName() вместо этого.Возвращает
stringresult()source public
result( )
Значение результата обработчиков события
Устарело
3.4.0 Используйте getResult() вместо этого.Возвращает
mixedsetData()source public
setData( array|string $key , mixed $value null )
Присваивает значение данным/загрузке этого события.
Параметры
- array|string
$key - Массив заменит все данные загрузки, а ключ установит только этот элемент массива.
- mixed
$valueнеобязательно null - Значение для установки.
Возвращаемое значение
$this
setResult()source public
setResult( mixed $value null )
Обработчики могут прикрепить значение результата к событию.
Параметры
- mixed
$valueнеобязательно null - Значение для установки.
Возвращаемое значение
$this
subject()source public
subject( )
Возвращает предмет этого события.
Устарело
3.4.0 используйте getSubject() вместо этого.Возвращаемое значение
объектПодробное описание свойств
$_subjectsource
protected object
Объект, к которому относится это событие (обычно тот же объект, который генерирует событие).
$resultsource
public mixed
Свойство, используемое для сохранения значения результата обработчиков события.
Подробное описание магических свойств
$datasource
public array
$namesource
public string
$resultsource
public mixed
$subjectsource
public object
© 2005–2018 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.5/class-Cake.Event.Event.html