Интерфейс EntityInterface
Описывает методы, которым должен соответствовать любой класс, представляющий хранилище данных.
В версии 4.x следующие методы будут официально добавлены в интерфейс:
- Cake\Datasource\EntityInterface реализует ArrayAccess, JsonSerializable
Непосредственные реализаторы
Краткое описание магических свойств
-
$idpublicПсевдоним для часто используемого первичного ключа.mixed
Краткое описание методов
- accessible() public
Хранит информацию о том, можно ли изменить или установить значение свойства в этом объекте. Специальное свойство
*также может быть помечено как доступное или защищённое, что означает, что любое другое указанное ранее свойство примет его значение. Например,$entity->accessible('*', true)означает, что любое свойство, которое ещё не указано, будет по умолчанию доступно. - clean() public
Отмечает весь объект как чистый, что означает, что он будет выглядеть так, как будто никакие свойства не были изменены или добавлены. Это полезно для первоначальной загрузки объекта.
- dirty() public
Устанавливает состояние модификации для отдельного свойства. Если вызывается без второго аргумента, возвращает, было ли свойство изменено после создания объекта.
Если вызывается без аргументов, возвращает, есть ли в объекте изменённые свойства.
Устаревшее
3.4.0 Используйте setDirty() и isDirty() вместо этого.
Параметры
- string|null
$propertyнеобязательно null - поле для установки или проверки состояния
- null|boolean
$isDirtyнеобязательно null true — свойство было изменено, false — не было изменено, null — функция вернёт текущее состояние для этого свойства
Возвращает
boolean
было ли свойство изменено
- string|null
- errors() public
Устанавливает сообщения об ошибках для поля или списка полей. Если вызывается без второго аргумента, возвращает сообщения об ошибках валидации для указанных полей. Если вызывается без аргументов, возвращает все сообщения об ошибках валидации, сохранённые в этом объекте.
При использовании в качестве установщика этот метод вернёт экземпляр этого объекта для цепочки вызовов методов.
Устаревшее
3.4.0 Используйте setErrors() и getErrors() вместо этого.
Параметры
- string|array|null
$fieldнеобязательно null - Поле для получения сообщений об ошибках.
- string|array|null
$errorsнеобязательно null - Сообщения об ошибках для поля $field
- boolean
$overwriteнеобязательно false - Перезаписывать ли существующие сообщения об ошибках для $field
Возвращает
array|Cake\Datasource\EntityInterface
- string|array|null
- extract() public
Возвращает массив с запрошенными свойствами, сохранёнными в этом объекте, индексированными по имени свойства
Параметры
- array
$properties - список свойств, которые нужно вернуть
- boolean
$onlyDirtyнеобязательно false - Возвращать запрашиваемое свойство только если оно изменено
Возвращает
array
- array
- get() publicВозвращает значение свойства по имени
- has() public
Возвращает true, если в объекте есть свойство с именем $property, независимо от того, пусто оно или нет.
Параметры
- string|array
$property - Свойство для проверки.
Возвращает
boolean
- string|array
- hiddenProperties() publicПолучить/установить скрытые свойства объекта.
- isNew() public
Возвращает true, если объект ещё не был сохранён. В случае отсутствия информации о статусе объекта метод может вернуть null.
- set() publicУстанавливает одно или несколько свойств в указанное значение
- toArray() publicВозвращает массив со всеми видимыми свойствами, установленными в этом объекте.
- unsetProperty() publicУдаляет свойство или список свойств из этого объекта
- virtualProperties() publicПолучить/установить виртуальные свойства объекта.
- visibleProperties() publicПолучить список видимых свойств.
Подробное описание методов
accessible()source public
accessible( string|array $property , boolean|null $set null )
Хранит информацию о том, можно ли изменить или установить значение свойства в этом объекте. Специальное свойство * также может быть помечено как доступное или защищённое, что означает, что любое другое указанное ранее свойство примет его значение. Например, $entity->accessible('*', true) означает, что любое свойство, которое ещё не указано, будет по умолчанию доступно.
Устаревшее
3.4.0 Используйте setAccess() и isAccessible() вместо этого.Параметры
- string|array
$property - Одно или список свойств, для изменения доступа.
- boolean|null
$setнеобязательно null true — свойство доступно, false — защищено.
Возвращает
Cake\Datasource\EntityInterface|booleanclean()source public
clean( )
Отмечает весь объект как чистый, что означает, что он будет выглядеть так, как будто никакие свойства не были изменены или добавлены. Это полезно для первоначальной загрузки объекта.
dirty()source public
dirty( string|null $property null , null|boolean $isDirty null )
Устанавливает состояние модификации для отдельного свойства. Если вызывается без второго аргумента, возвращает, было ли свойство изменено после создания объекта.
Если вызывается без аргументов, возвращает, есть ли в объекте изменённые свойства.
Устаревшее
3.4.0 Используйте setDirty() и isDirty() вместо этого.Параметры
- string|null
$propertyнеобязательно null - поле для установки или проверки состояния
- null|boolean
$isDirtyнеобязательно null true — свойство было изменено, false — не было изменено, null — функция вернёт текущее состояние для этого свойства
Возвращает
booleanбыло ли свойство изменено
errors()source public
errors( string|array|null $field null , string|array|null $errors null , boolean $overwrite false )
Устанавливает сообщения об ошибках для поля или списка полей. Если вызывается без второго аргумента, возвращает сообщения об ошибках валидации для указанных полей. Если вызывается без аргументов, возвращает все сообщения об ошибках валидации, сохранённые в этом объекте.
При использовании в качестве установщика этот метод вернёт экземпляр этого объекта для цепочки вызовов методов.
Устаревшее
3.4.0 Используйте setErrors() и getErrors() вместо этого.Параметры
- string|array|null
$fieldнеобязательно null - Поле для получения сообщений об ошибках.
- string|array|null
$errorsнеобязательно null - Сообщения об ошибках для поля $field
- boolean
$overwriteнеобязательно false - Перезаписывать ли существующие сообщения об ошибках для $field
Возвращает
array|Cake\Datasource\EntityInterfaceextract()source public
extract( array $properties , boolean $onlyDirty false )
Возвращает массив с запрошенными свойствами, сохранёнными в этом объекте, индексированными по имени свойства
Параметры
- array
$properties - список свойств, которые нужно вернуть
- boolean
$onlyDirtyнеобязательно false - Возвращать запрашиваемое свойство только если оно изменено
Возвращает
arrayget()source public
get( string $property )
Возвращает значение свойства по имени
Параметры
- string
$property - имя свойства для извлечения
Возвращает
mixedhas()source public
has( string|array $property )
Возвращает true, если в объекте есть свойство с именем $property, независимо от того, пусто оно или нет.
Параметры
- string|array
$property - Свойство для проверки.
Возвращает
booleanhiddenProperties()source public
hiddenProperties( null|array $properties null )
Получить/установить скрытые свойства объекта.
Если аргумент properties равен null, будут возвращены текущие скрытые свойства. В противном случае, скрытые свойства будут установлены.
Параметры
- null|array
$propertiesнеобязательно null - Массив свойств для скрытия или null для получения свойств
Возвращает
array|Cake\Datasource\EntityInterfaceisNew()source public
isNew( boolean|null $new null )
Возвращает, была ли сущность ранее сохранённой. Этот метод может вернуть null, если нет предварительной информации о статусе сущности.
Если вызывается с булевым значением, этот метод установит статус этого экземпляра. Использование true означает, что экземпляр не был сохранён в базе данных, false что он уже сохранён.
Параметры
- boolean|null
$newнеобязательно null - Указывает, был ли этот экземпляр сохранён.
Возвращаемое значение
booleanЕсли известно, была ли сущность ранее сохранённой, возвращает true или false. В противном случае null.
set()source public
set( string|array $property , mixed $value null , array $options [] )
Устанавливает одну или несколько свойств в указанное значение.
Параметры
- string|array
$property Имя свойства для установки или список свойств с их соответствующими значениями.
- mixed
$valueнеобязательно null Значение для установки свойства или массив, если первый аргумент также массив, в этом случае будет рассматриваться как $options.
- array
$optionsнеобязательно [] Параметры, используемые для установки свойства. Разрешённые ключи параметров —
setterиguard
Возвращаемое значение
Cake\Datasource\EntityInterfacetoArray()source public
toArray( )
Возвращает массив со всеми видимыми свойствами, установленными в этой сущности.
Примечание скрытые свойства невидимы и не будут выведены методом toArray().
Возвращаемое значение
arrayunsetProperty()source public
unsetProperty( string|array $property )
Удаляет свойство или список свойств из этой сущности.
Параметры
- string|array
$property - Свойство для удаления.
Возвращаемое значение
Cake\Datasource\EntityInterfacevirtualProperties()source public
virtualProperties( null|array $properties null )
Получить/установить виртуальные свойства в этой сущности.
Если аргумент properties равен null, будут возвращены текущие виртуальные свойства. В противном случае виртуальные свойства будут установлены.
Параметры
- null|array
$propertiesнеобязательно null - Массив свойств для обработки как виртуальных или null, чтобы получить свойства.
Возвращаемое значение
array|Cake\Datasource\EntityInterfacevisibleProperties()source public
visibleProperties( )
Получить список видимых свойств.
Возвращаемое значение
arrayСписок свойств, которые «видимы» во всех представлениях.
Краткое описание магических методов
Подробное описание магических свойств
$idsource
public mixed
© 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.Datasource.EntityInterface.html