Spec-Zone.ru › CakePHP 3.4

Интерфейс EntityInterface

Описывает методы, которым должен соответствовать любой класс, представляющий хранилище данных.

В версии 4.x следующие методы будут официально добавлены в интерфейс:

Cake\Datasource\EntityInterface реализует ArrayAccess, JsonSerializable

Прямые реализаторы

  • Cake\ORM\Entity
Пространство имен: Cake\Datasource
Расположение: Datasource/EntityInterface.php

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

  • $id public
    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
    было ли свойство изменено или нет
  • 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
  • extract() public

    Возвращает массив с запрошенными свойствами, хранящимися в этом объекте, индексированными по имени свойства

    Параметры

    array $properties
    список свойств, которые нужно вернуть
    boolean $onlyDirty необязательно false
    Возвращать запрошенное свойство только если оно изменено

    Возвращает

    array
  • get() public

    Возвращает значение свойства по имени

    Параметры

    string $property
    имя свойства для извлечения

    Возвращает

    mixed
  • has() public

    Возвращает true, если в объекте существует свойство с именем $property, независимо от того, пусто оно или нет.

    Параметры

    string $property
    Проверяемое свойство.

    Возвращает

    boolean
  • hiddenProperties() public

    Получить/установить скрытые свойства в этом объекте.

    Если аргумент properties равен null, возвращаются текущие скрытые свойства. В противном случае, скрытые свойства устанавливаются.

    Параметры

    null|array $properties необязательно null
    Массив свойств для скрытия или null для получения свойств

    Возвращает

    array|Cake\Datasource\EntityInterface
  • 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|boolean

clean()source public

clean( )

dirty()source public

dirty( string|null $property null , null|boolean $isDirty null )

errors()source public

errors( string|array|null $field null , string|array|null $errors null , boolean $overwrite false )

extract()source public

extract( array $properties , boolean $onlyDirty false )

get()source public

get( string $property )

has()source public

has( string $property )

hiddenProperties()source public

hiddenProperties( null|array $properties null )
END_OF_DOCUMENT_MARKER

isNew()source public

isNew( boolean|null $new null )

Возвращает, был ли этот сущность сохранён ранее. Данный метод может возвращать null, если нет информации о статусе этой сущности.

Если вызван с булевым значением, этот метод установит статус этого экземпляра. Использование true означает, что экземпляр ещё не сохранён в базе данных, false что он уже сохранён.

Параметры

boolean|null $new необязательный null
Указывает, был ли этот экземпляр сохранён.

Возвращает

boolean

Если известно, была ли сущность уже сохранена, 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\EntityInterface

toArray()source public

toArray( )

Возвращает массив со всеми видимыми свойствами, установленные в этой сущности.

Примечание скрытые свойства не видны и не будут выведены методом toArray().

Возвращает

array

unsetProperty()source public

unsetProperty( string|array $property )

Удаляет свойство или список свойств из этой сущности

Параметры

string|array $property
Свойство для удаления.

Возвращает

Cake\Datasource\EntityInterface

virtualProperties()source public

virtualProperties( null|array $properties null )

Получение/Установка виртуальных свойств этой сущности.

Если аргумент properties равен null, будут возвращены текущие виртуальные свойства. В противном случае виртуальные свойства будут установлены.

Параметры

null|array $properties необязательный null
Массив свойств, которые нужно считать виртуальными, или null для получения свойств

Возвращает

array|Cake\Datasource\EntityInterface

visibleProperties()source public

visibleProperties( )

Получение списка видимых свойств.

Возвращает

array
Список свойств, которые «видимы» во всех представлениях.

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

extractOriginal()source public

extractOriginal( array $properties )

Параметры

array $properties

Возвращает

array

extractOriginalChanged()source public

extractOriginalChanged( array $properties )

Параметры

array $properties

Возвращает

array

getError()source public

getError( $field )

Параметры

$field

Возвращает

array

getErrors()source public

getErrors( )

Возвращает

array

getHidden()source public

getHidden( )

Возвращает

array

getSource()source public

getSource( )

Возвращает

array

getVirtual()source public

getVirtual( )

Возвращает

array

isAccessible()source public

isAccessible( $property )

Параметры

$property

Возвращает

boolean

isDirty()source public

isDirty( $property )

Параметры

$property необязательный

Возвращает

boolean

setError()source public

setError( $field , $errors , $overwrite )

Параметры

$field
$errors
$overwrite необязательный

Возвращает

array

setErrors()source public

setErrors( array $fields , $overwrite )

Параметры

array $fields
$overwrite необязательный

Возвращает

array

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

$idsource

public mixed

© 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.Datasource.EntityInterface.html

Spec-Zone.ru

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