Класс ContainableBehavior
Поведение, позволяющее динамично и атомарно управлять ассоциациями модели, используемыми для вызова find. Наиболее полезно для ограничения количества ассоциаций и возвращаемых данных.
- CakeObject
-
ModelBehavior
-
ContainableBehavior
Ссылка: https://book.cakephp.org/2.0/ru/core-libraries/behaviors/containable.html
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Model/Behavior/ContainableBehavior.php
Краткое описание свойств
-
$runtimepublicКонфигурация выполнения для данного поведенияarray -
$typespublicТипы доступных для моделей отношенийarray
Наследованные свойства
Краткое описание методов
- beforeFind() public
Вызывается перед операцией find(). Используется для разрешения параметра 'contain' в вызове find, например:
- contain() public
Отменяет все отношения модели, кроме указанных. Вызов этой функции без параметров отменяет все связанные модели.
- containments() publicОбработка ограничений для модели.
- containmentsMap() publicСоздание карты ограничений
- fieldDependencies() publicВычисление необходимых полей для извлечения требуемых связей для данной модели.
- resetBindings() public
Постоянно восстанавливает исходные настройки связей данной модели, что полезно для восстановления связей после использования 'reset' => false в вызове contain.
- setup() publicИнициализация поведения для модели с использованием указанных настроек.
Подробное описание методов
beforeFind()source public
beforeFind( Model $Model , array $query )
Вызывается перед операцией find(). Используется для разрешения параметра 'contain' в вызове find, например:
Model->find('all', array('contain' => array('Model1', 'Model2')));
Model->find('all', array('contain' => array(
'Model1' => array('Model11', 'Model12'),
'Model2',
'Model3' => array(
'Model31' => 'Model311',
'Model32',
'Model33' => array('Model331', 'Model332')
))); Параметры
-
Model$Model - Модель, использующая поведение
- массив
$query - Параметры запроса, заданные cake
Возвращаемое значение
массивПереопределяет
ModelBehavior::beforeFind() contain()source public
contain( Model $Model )
Отменяет все отношения модели, кроме указанных. Вызов этой функции без параметров отменяет все связанные модели.
Параметры
-
Model$Model - Модель, на которую накладывается ограничение связей
Ссылка
https://book.cakephp.org/2.0/ru/core-libraries/behaviors/containable.html#using-containablecontainments()source public
containments( Model $Model , array $contain , array $containments array() , boolean $throwErrors null )
Обработка ограничений для модели.
Параметры
-
Model$Model - Модель, на которую накладывается ограничение связей
- массив
$contain - Параметры для ограничения этой модели
- массив
$containmentsoptional array() - Текущий набор ограничений
- логическое
$throwErrorsoptional null - Показывать ли ошибки для несуществующих связей
Возвращаемое значение
массивОграничения
containmentsMap()source public
containmentsMap( array $containments )
Создание карты ограничений
Параметры
- массив
$containments - Ограничения
Возвращаемое значение
массивСозданные ограничения
fieldDependencies()source public
fieldDependencies( Model $Model , array $map , array|boolean $fields array() )
Вычисление необходимых полей для извлечения требуемых связей для данной модели.
Параметры
-
Model$Model - Модель
- массив
$map - Карта отношений для данной модели
- массив|логическое
$fieldsoptional array() - Если массив, поля для начальной загрузки, если false, использовать $Model в качестве основной модели
Возвращаемое значение
массивПоля
resetBindings()source public
resetBindings( Model $Model )
Постоянно восстанавливает исходные настройки связей данной модели, что полезно для восстановления связей после использования 'reset' => false в вызове contain.
Параметры
-
Model$Model - Модель, для которой нужно сбросить связи
setup()source public
setup( Model $Model , array $settings array() )
Инициализация поведения для модели с использованием указанных настроек.
Доступные настройки:
- recursive: (логическое, необязательно) установить в true, чтобы containable автоматически определял необходимый уровень рекурсии для извлечения указанных моделей и устанавливал уровень рекурсии модели на этот уровень. Установка в false отключает эту функцию. ПО УМОЛЧАНИЮ: true
- notices: (логическое, необязательно) выводит E_NOTICES для связей, указанных в вызове containable, которые не являются допустимыми. ПО УМОЛЧАНИЮ: true
- autoFields: (логическое, необязательно) автоматически добавляет необходимые поля для извлечения запрошенных связей. ПО УМОЛЧАНИЮ: true
Параметры
-
Model$Model - Модель, использующая поведение
- массив
$settingsoptional array() - Настройки для переопределения модели.
Переопределяет
ModelBehavior::setup() Наследованные методы из ModelBehavior
_addToWhitelist()source protected
_addToWhitelist( Model $model , string $field )
Если свойство whitelist модели $model не пустое, $field будет добавлен в него. Примечание: этот метод следует использовать только в beforeValidate или beforeSave, чтобы гарантировать, что он изменяет whitelist только для текущей операции сохранения. Также убедитесь, что вы явно устанавливаете значение поля, которое вы разрешаете.
Параметры
-
Model$model - Модель, использующая это поведение
- строка
$field - Поле, которое необходимо добавить в whitelist модели $model
afterDelete()source public
afterDelete( Model $model )
Метод afterDelete вызывается после удаления прикреплённой модели.
Параметры
-
Model$model - Модель, использующая это поведение
afterFind()source public
afterFind( Model $model , mixed $results , boolean $primary false )
Обработчик после find. Может использоваться для изменения результатов, возвращаемых find.
Параметры
-
Model$model - Модель, использующая это поведение
- смешанное
$results - Результаты операции find
- логическое
$primaryoptional false - Является ли эта модель запрошенной напрямую (в отличие от запроса как ассоциации)
Возвращаемое значение
смешанноеЗначение массива заменит значение $results – любое другое значение будет проигнорировано.
afterSave()source public
afterSave( Model $model , boolean $created , array $options array() )
Метод afterSave вызывается после сохранения модели.
Параметры
-
Model$model - Модель, использующая этот метод.
- boolean
$created - Истина, если это сохранение создало новую запись.
- array
$optionsопционально array() - Опции, переданные из Model::save().
Возвращает
booleanСм. также
Model::save()afterValidate()source public
afterValidate( Model $model )
afterValidate вызывается сразу после валидации данных модели. Вы можете использовать этот обратный вызов для выполнения любых необходимых очисток или подготовки данных.
Параметры
-
Model$model - Модель, использующая этот метод.
Возвращает
mixedFalse остановит распространение этого события другим методам.
beforeDelete()source public
beforeDelete( Model $model , boolean $cascade true )
beforeDelete вызывается перед любым удалением присоединенной модели, но после вызова beforeDelete модели. Возвращение false из beforeDelete прервет удаление.
Параметры
-
Model$model - Модель, использующая этот метод.
- boolean
$cascadeопционально true - Если true, записи, зависящие от этой записи, также будут удалены.
Возвращает
mixedFalse, если операция должна быть прервана. Любой другой результат будет продолжен.
beforeSave()source public
beforeSave( Model $model , array $options array() )
beforeSave вызывается перед сохранением модели. Возвращение false из beforeSave прервет операцию сохранения.
Параметры
-
Model$model - Модель, использующая этот метод.
- array
$optionsопционально array() - Опции, переданные из Model::save().
Возвращает
mixedFalse, если операция должна быть прервана. Любой другой результат будет продолжен.
См. также
Model::save()beforeValidate()source public
beforeValidate( Model $model , array $options array() )
beforeValidate вызывается перед валидацией модели. Вы можете использовать этот обратный вызов для добавления правил валидации в массив validate модели. Возвращение false позволит вам заставить валидацию завершиться неудачей.
Параметры
-
Model$model - Модель, использующая этот метод.
- array
$optionsопционально array() - Опции, переданные из Model::save().
Возвращает
mixedFalse или null прервут операцию. Любой другой результат будет продолжен.
См. также
Model::save()cleanup()source public
cleanup( Model $model )
Очистка любых инициализаций, выполненных этим методом для модели. Вызывается при динамической отвязке метода от модели с помощью Model::detach().
Параметры
-
Model$model - Модель, использующая этот метод.
См. также
BehaviorCollection::detach()onError()source public
onError( Model $model , string $error )
Обработчик ошибок источника данных.
Параметры
-
Model$model - Модель, использующая этот метод.
- string
$error - Ошибка, сгенерированная в источнике данных.
Методы, унаследованные от CakeObject
_mergeVars()source protected
_mergeVars( array $properties , string $class , boolean $normalize true )
Объединяет свойство $property этого объекта со свойством в определении $class. Значение этого класса для свойства будет объединено поверх $class'.
Это обеспечивает некоторую магию DRY, предоставляемую CakePHP. Если вы хотите отключить ее, переопределите этот метод как пустую функцию.
Параметры
- array
$properties - Имя свойств для объединения.
- string
$class - Класс для объединения свойства с.
- boolean
$normalizeопционально true - Установите в значение true, чтобы выполнить свойства через Hash::normalize() перед объединением.
_set()source protected
_set( array $properties array() )
Позволяет устанавливать несколько свойств объекта в одной строке кода. Будут установлены только свойства, которые являются частью объявления класса.
Параметры
- array
$propertiesопционально array() - Ассоциативный массив, содержащий свойства и соответствующие значения.
_stop()source protected
_stop( integer|string $status 0 )
Остановка выполнения текущего скрипта. Оборачивает exit(), что упрощает тестирование.
Параметры
- integer|string
$statusопционально 0 - см. http://php.net/exit для значений
dispatchMethod()source public
dispatchMethod( string $method , array $params array() )
Вызывает метод этого объекта с заданными параметрами. Предоставляет объектно-ориентированную оболочку для call_user_func_array.
Параметры
- string
$method - Имя вызываемого метода
- array
$paramsопционально array() - Список параметров для использования при вызове $method
Возвращает
mixedРезультат вызова метода
log()source public
log( string $msg , integer $type LOG_ERR , null|string|array $scope null )
Удобный метод для записи сообщения в CakeLog. См. CakeLog::write() для получения дополнительной информации о записи в журналы.
Параметры
- string
$msg - Сообщение журнала
- integer
$typeопционально LOG_ERR - Константа типа ошибки. Определена в app/Config/core.php.
- null|string|array
$scopeопционально null Область(и), в которой создается сообщение журнала. См. CakeLog::config() для получения дополнительной информации о областях ведения журналов.
Возвращает
booleanУспех записи в журнал
requestAction()source public
requestAction( string|array $url , array $extra array() )
Вызывает метод контроллера из любой точки. Может использоваться для соединения контроллеров или привязки плагинов к основному приложению. requestAction может использоваться для возврата отрендеренных представлений или получения возвращаемого значения действий контроллера.
Внутри этот метод использует Router::reverse() для преобразования параметра $url в строковый URL. Вы должны использовать форматы URL, совместимые с Router::reverse().
Передача данных POST и GET
Данные POST и GET могут быть смоделированы в requestAction. Используйте $extra['url'] для данных GET. Параметр $extra['data'] позволяет моделировать данные POST.
Параметры
- string|array
$url Строка или массив-URL. В отличие от других массивов URL в CakePHP, этот URL не будет автоматически обрабатывать переданные и именованные аргументы в параметре $url.
- array
$extraопционально array() Если массив включает ключ "return", он устанавливает AutoRender в значение true. Также может использоваться для отправки данных GET/POST и именованных/переданных аргументов.
Возвращает
mixedБулево значение true или false при успехе/неудачи или содержимое отрендеренного действия, если в $extra установлен ключ 'return'.
toString()source public
toString( )
Преобразование CakeObject в строку. Каждый класс может переопределить этот метод по необходимости.
Возвращает
stringИмя этого класса
Подробное описание свойств
$typessource
public массив
Типы отношений, доступные для моделей
array('belongsTo', 'hasOne', 'hasMany', 'hasAndBelongsToMany')
© 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/2.10/class-ContainableBehavior.html