Класс PagesController

displayисходный код public

display( )

Отображает представление

Исключения

NotFoundException
Когда файл представления не найден или в режиме отладки возникает MissingViewException.

__constructисходный код public

__construct( CakeRequest $request null , CakeResponse $response null )

Конструктор.

Параметры

CakeRequest $request необязательно null

Объект запроса для данного контроллера. Может быть null для тестирования, но ожидается, что функции, использующие параметры запроса, не будут работать.

CakeResponse $response необязательно null

Объект ответа для данного контроллера.

Переопределяет

Object::__construct()

__getисходный код public

__get( string $name )

Обеспечивает обратную совместимость доступа к свойствам объекта запроса. Также предоставляет псевдоним params.

Параметры

строка $name

Имя запрашиваемого значения

Возвращает

mixed
Запрашиваемое значение для допустимых переменных/псевдонимов, иначе null

__issetисходный код public

__isset( string $name )

Обеспечивает обратную совместимость, чтобы избежать проблем с пустым и isset для свойств псевдонимов. Лениво загружает модели с помощью метода loadModel(), если объявлен в $uses

Параметры

строка $name

Имя свойства для проверки.

Возвращает

boolean
bool

__setисходный код public

__set( string $name , mixed $value )

Обеспечивает обратную совместимость доступа для установки значений в объект запроса.

Параметры

строка $name

Имя свойства для установки.

смешанный $value

Значение для установки.

_afterScaffoldSaveисходный код protected

_afterScaffoldSave( string $method )

Псевдоним для afterScaffoldSave()

Устарело

3.0.0 Будет удалено в 3.0.

Параметры

строка $method

Имя метода.

Возвращает

boolean
bool

См. также

Controller::afterScaffoldSave()

_afterScaffoldSaveErrorисходный код protected

_afterScaffoldSaveError( string $method )

Псевдоним для afterScaffoldSaveError()

Устарело

3.0.0 Будет удалено в 3.0.

Параметры

строка $method

Имя метода.

Возвращает

boolean
bool

См. также

Controller::afterScaffoldSaveError()

_beforeScaffoldисходный код protected

_beforeScaffold( string $method )

Псевдоним для beforeScaffold()

Устарело

3.0.0 Будет удалено в 3.0.

Параметры

строка $method

Имя метода.

Возвращает

boolean
bool

См. также

Controller::beforeScaffold()

_getScaffoldисходный код protected

_getScaffold( CakeRequest $request )

Возвращает объект scaffold для использования в динамически сгенерированных контроллерах.

Параметры

CakeRequest $request

Экземпляр запроса.

Возвращает

Scaffold
Scaffold

_getViewObjectисходный код protected

_getViewObject( )

Создает экземпляр класса представления на основе свойства контроллера

Возвращает

View
Представление

_isPrivateActionисходный код protected

_isPrivateAction( ReflectionMethod $method , CakeRequest $request )

Проверяет, помечен ли действие запроса как приватное, с подчеркиванием, или если запрос пытается напрямую получить доступ к префиксным действиям.

Параметры

ReflectionMethod $method

Метод, который должен быть вызван.

CakeRequest $request

Запрос для проверки.

Возвращает

boolean
bool

_mergeControllerVarsисходный код protected

_mergeControllerVars( )

Объединить переменные компонентов, хелперов и uses из Controller::$_mergeParent и PluginAppController.

_mergeUsesисходный код protected

_mergeUses( array $merge )

Вспомогательный метод для объединения свойства $uses.

Объединяет элементы, которые еще не в $this->uses, в $this->uses.

Параметры

массив $merge

Данные для объединения.

_parseBeforeRedirectисходный код protected

_parseBeforeRedirect( mixed $response , string|array $url , integer $status , boolean $exit )

Обработать ответ beforeRedirect

Параметры

смешанный $response

Ответ от обратного вызова beforeRedirect

строка|массив $url

То же значение, что и в beforeRedirect

целое число $status

То же значение, что и в beforeRedirect

логическое значение $exit

То же значение, что и в beforeRedirect

Возвращает

array
Массив с ключами url, status и exit

_scaffoldErrorисходный код protected

_scaffoldError( string $method )

Псевдоним для scaffoldError()

Устарело

3.0.0 Будет удалено в 3.0.

Параметры

строка $method

Имя метода.

Возвращает

boolean
bool

См. также

Controller::scaffoldError()

afterFilterисходный код public

afterFilter( )

Вызывается после выполнения и отображения действия контроллера.

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#request-life-cycle-callbacks

afterScaffoldSaveисходный код public

afterScaffoldSave( string $method )

Этот метод должен быть переопределен в дочерних классах.

Параметры

строка $method

Имя метода, вызываемого edit или update.

Возвращает

boolean
Успех

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#callbacks

afterScaffoldSaveErrorsource public

afterScaffoldSaveError( string $method )

Этот метод следует переопределять в дочерних классах.

Параметры

строка $method

имя метода, вызываемого либо edit, либо update.

Возвращает

boolean
Успех

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#callbacks

beforeFiltersource public

beforeFilter( )

Вызывается перед выполнением действия контроллера. Вы можете использовать этот метод для настройки и настройки компонентов или выполнения логики, которая должна выполняться перед каждым действием контроллера.

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#request-life-cycle-callbacks

beforeRedirectsource public

beforeRedirect( string|array $url , integer $status null , boolean $exit true )

Метод beforeRedirect вызывается при вызове метода redirect контроллера, но перед любыми дальнейшими действиями.

Если этот метод возвращает false, контроллер не будет продолжать перенаправление запроса. Переменные $url, $status и $exit имеют то же значение, что и для метода контроллера. Вы также можете вернуть строку, которая будет интерпретироваться как URL для перенаправления, или вернуть ассоциативный массив с ключом 'url' и необязательными 'status' и 'exit'.

Параметры

строка|массив $url

Строковый или массивный URL, указывающий на другое местоположение в приложении, или абсолютный URL

целое число $status необязательно null

Необязательный HTTP-код состояния (например: 404)

логическое значение $exit необязательно true

Если true, вызов exit() будет выполнен после перенаправления

Возвращает

mixed
false для остановки события перенаправления, строка controllers для нового URL перенаправления или массив с ключами url, status и exit, используемые методом redirect.

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#request-life-cycle-callbacks

beforeRendersource public

beforeRender( )

Вызывается после выполнения действия контроллера, но перед рендерингом представления. Вы можете использовать этот метод для выполнения логики или установки переменных представления, необходимых для каждого запроса.

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#request-life-cycle-callbacks

beforeScaffoldsource public

beforeScaffold( string $method )

Этот метод следует переопределять в дочерних классах.

Параметры

строка $method

имя метода, вызываемого, например, index, edit и т.д.

Возвращает

boolean
Успех

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#callbacks

constructClassessource public

constructClasses( )

Загружает классы модели на основе свойства uses, см. Controller::loadModel(); для получения дополнительной информации. Загружает компоненты и подготавливает их к инициализации.

Возвращает

mixed
true, если модели найдены и экземпляр создан.

Выбрасывает

MissingModelException
MissingModelException

См. также

Controller::loadModel()

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#Controller::constructClasses

disableCachesource public

disableCache( )

Принудительно запрещает кеширование результатов текущего запроса браузером пользователя.

Устарело

3.0.0 Будет удалено в 3.0. Используйте CakeResponse::disableCache().

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#Controller::disableCache

flashsource public

flash( string $message , string|array $url , integer $pause 1 , string $layout 'flash' )

Отображает сообщение пользователю в течение $pause секунд, затем перенаправляет на $url. Использует flash.ctp в качестве шаблона по умолчанию для сообщения. Не работает, если текущий уровень отладки выше 0.

Устарело

3.0.0 Будет удалено в 3.0. Используйте Session::setFlash().

Параметры

строка $message

Сообщение, которое нужно отобразить пользователю

строка|массив $url

Относительный строковый или массивно-базированный URL для перенаправления после истечения времени

целое число $pause необязательно 1

Время отображения сообщения

строка $layout необязательно 'flash'

Шаблон, который вы хотите использовать, по умолчанию 'flash'

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#Controller::flash

getEventManagersource public

getEventManager( )

Возвращает экземпляр менеджера CakeEventManager, обрабатывающий все коллбеки. Вы можете использовать этот экземпляр для регистрации новых слушателей или коллбеков к событиям контроллера или для создания собственных событий и их вызова.

Возвращает

CakeEventManager
CakeEventManager

headersource public

header( string $status )

Метод-обертка для удобства и работы с объектами CakeResponse::header().

Устарело

3.0.0 Будет удалено в 3.0. Используйте CakeResponse::header().

Параметры

строка $status

Сообщение заголовка, которое задаётся.

httpCodessource public

httpCodes( integer|array $code null )

Запрашивает и задаёт допустимые HTTP-коды ответов и сообщения.

Устарело

3.0.0 С версии 2.4. Будет удалено в 3.0. Используйте CakeResponse::httpCodes().

Параметры

целое число|массив $code необязательно null

Если $code — целое число, возвращается соответствующий код/сообщение, если он существует; null, если он не существует. Если $code — массив, ключи 'code' и 'message' каждого вложенного массива добавляются к стандартным HTTP-кодам. Пример: httpCodes(404); // возвращает массив(404 => 'Not Found') httpCodes(array( 701 => 'Unicorn Moved', 800 => 'Unexpected Minotaur' )); // задаёт эти новые значения и возвращает true

Возвращает

array
Ассоциативный массив с HTTP-кодами в качестве ключей и строками сообщений в качестве значений или null, если заданный $code не существует.

implementedEventssource public

implementedEvents( )

Возвращает список всех событий, которые будут срабатывать в контроллере во время его жизненного цикла. Вы можете переопределить эту функцию, чтобы добавить свои собственные коллбеки-слушатели

Возвращает

array
массив

Реализация

CakeEventListener::implementedEvents()

invokeActionsource public

invokeAction( CakeRequest $request )

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

Параметры

CakeRequest $request

Экземпляр запроса.

Возвращает

mixed
Результат ответа.

Выбрасывает

PrivateActionException
Когда действия не являются общедоступными или имеют префикс _
MissingActionException
Когда действия не определены, и scaffolding не включен.

loadModelsource public

loadModel( string $modelClass null , integer|string $id null )

Загружает и инициализирует модели, необходимые для этого контроллера. Если модель не существует, будет выброшено исключение об отсутствии таблицы базы данных, так как CakePHP временно генерирует динамические модели.

Параметры

строка $modelClass необязательно null

Имя класса модели для загрузки

целое число/строка $id необязательно null

Начальный идентификатор, который должна иметь экземпляризованный класс модели

Возвращает

boolean
Истина, если модель найдена

Выбрасывает

MissingModelException
если класс модели не может быть найден.

paginatesource public

paginate( Model|string $object null , string|array $scope array() , array $whitelist array() )

Обрабатывает автоматическую постраничную навигацию записей модели.

Параметры

Model|строка $object необязательно null

Модель для постраничной навигации (например: экземпляр модели, или 'Модель', или 'Модель.ВложеннаяМодель')

строка|массив $scope необязательно массив()

Условия для использования при постраничной навигации

массив $whitelist необязательно массив()

Список разрешенных опций для постраничной навигации

Возвращает

array
Результаты запроса модели

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#Controller::paginate

postConditionssource public

postConditions( array $data array() , string|array $op null , string $bool 'AND' , boolean $exclusive false )

Преобразует данные формы POST в массив условий модели, пригодный для использования в вызове Model::find().

Устаревший

3.0.0 Будет удален в версии 3.0.

Параметры

массив $data необязательно массив()

Данные POST, организованные по модели и полю

строка|массив $op необязательно null

Строка, содержащая оператор SQL сравнения, или массив, соответствующий операторам для полей

строка $bool необязательно 'И'

Оператор булевой логики SQL: И, ИЛИ, ИСКЛЮЧАЮЩЕЕ ИЛИ и т.д.

логический $exclusive необязательно false

Если true, и $op является массивом, поля, не включенные в $op, не будут включены в возвращаемые условия

Возвращает

array|null
Массив условий модели

redirectsource public

redirect( string|array $url , integer|array|null $status null , boolean $exit true )

Перенаправляет на заданный $url, после отключения $this->autoRender. После перенаправления выполнение сценария прерывается.

Параметры

строка|массив $url

Строка или массив, представляющий URL, указывающий на другую локацию в приложении, или абсолютный URL

целое число|массив|null $status необязательно null

Код HTTP-статуса (например: 301). По умолчанию 302, когда передается null.

логический $exit необязательно true

Если true, после перенаправления будет вызван exit()

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#Controller::redirect

Срабатывает

Controller.beforeRedirect $this, массив($url, $status, $exit)

referersource public

referer( string $default null , boolean $local false )

Возвращает URL, по которому был выполнен запрос.

Параметры

строка $default необязательно null

URL по умолчанию, используемый, если HTTP_REFERER не может быть прочитан из заголовков

логический $local необязательно false

Если true, ссылки на другие страницы ограничены локальным сервером

Возвращает

string
Ссылка на предыдущую страницу

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#Controller::referer

rendersource public

render( string $view null , string $layout null )

Инициализирует правильный класс представления, передает ему данные и использует его для рендеринга вывода представления.

Параметры

строка $view необязательно null

Представление для рендеринга

строка $layout необязательно null

Макет для использования

Возвращает

CakeResponse
Объект ответа, содержащий рендеренное представление.

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#Controller::render

Срабатывает

Controller.beforeRender $this

scaffoldErrorsource public

scaffoldError( string $method )

Этот метод следует переопределять в дочерних классах. В противном случае он будет рендерить ошибку scaffold. Метод ДОЛЖЕН возвращать true в дочерних классах

Параметры

строка $method

Имя вызываемого метода (например, index, edit и т. д.).

Возвращает

boolean
Успех

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#callbacks

setsource public

set( string|array $one , string|array $two null )

Сохраняет переменную для использования внутри шаблона представления.

Параметры

строка|массив $one

Строка или массив данных.

строка|массив $two необязательно null

Значение в случае, если $one является строкой (тогда она работает как ключ). Не используется, если $one является ассоциативным массивом, в противном случае служит значениями для ключей $one.

Ссылка

http://book.cakephp.org/2.0/ru/controllers.html#interacting-with-views

setActionsource public

setAction( string $action )

Внутренне перенаправляет один действие на другое. Не выполняет другой HTTP-запрос в отличие от Controller::redirect()

Примеры:

setAction('another_action');
setAction('action_with_parameters', $parameter1);

Параметры

строка $action

Новое действие, к которому производится 'перенаправление'. Любые другие параметры, переданные в этот метод, будут переданы как параметры новому действию.

Возвращает

mixed
Возвращает значение результата вызываемого действия

setRequestsource public

setRequest( CakeRequest $request )

Устанавливает объекты запроса и настраивает ряд свойств контроллера на основе содержимого запроса. Свойства, которые устанавливаются:

• $this->request - В объект $request
• $this->plugin - В $request->params['plugin']
• $this->view - В $request->params['action']
• $this->autoLayout - В false, если установлен $request->params['bare'];
• $this->autoRender - В false, если $request->params['return'] == 1
• $this->passedArgs - В объединенный результат params['named'] и params['pass]

Параметры

CakeRequest $request

Экземпляр запроса.

shutdownProcesssource public

shutdownProcess( )

Выполняет различные завершающие процессы для этого контроллера. Вызывает компоненты и обратные вызовы контроллера в правильном порядке.

• вызывает обратный вызов компонента shutdown.
• вызывает метод контроллера afterFilter.

Срабатывает

Controller.shutdown $this

startupProcesssource public

startupProcess( )

Выполняет начальный процесс для этого контроллера. Вызывает компоненты и обратные вызовы контроллера в правильном порядке.

• Инициализирует компоненты, вызывая их обратный вызов initialize.
• Вызывает метод контроллера beforeFilter.
• вызывает методы компонента startup.

Срабатывает

Controller.initialize $this
Controller.startup $this

validatesource public

validate( )

Возвращает количество ошибок в отправленной форме.

Устаревший

3.0.0 Этот метод будет удалён в версии 3.0

Возвращает

integer
Количество ошибок

validateErrorssource public

validateErrors( )

Проверяет модели, переданные в качестве параметров. Принимает список моделей в качестве переменного аргумента. Пример:

$errors = $this->validateErrors($this->Article, $this->User);

Устаревший

3.0.0 Этот метод будет удалён в версии 3.0

Возвращает

array
Ошибки валидации или false, если ошибок нет

_mergeVarssource protected

_mergeVars( array $properties , string $class , boolean $normalize true )

Объединяет свойства текущего объекта $property со свойством в определении $class. Значение свойства этого класса будет объединено поверх значения $class.

Это обеспечивает некоторую магию DRY, предоставляемую CakePHP. Если вы хотите отключить её, переопределите этот метод как пустую функцию.

Параметры

массив $properties

Имя свойств для объединения.

строка $class

Класс для объединения свойства с.

логическое значение $normalize необязательно true

Установите в значение true, чтобы выполнить свойства через Hash::normalize() перед объединением.

_setsource protected

_set( array $properties array() )

Позволяет устанавливать несколько свойств объекта в одной строке кода. Будут установлены только свойства, которые являются частью объявления класса.

Параметры

массив $properties необязательно array()

Ассоциативный массив, содержащий свойства и соответствующие значения.

_stopsource protected

_stop( integer|string $status 0 )

Останавливает выполнение текущего сценария. Оборачивает exit(), что облегчает тестирование.

Параметры

целое число или строка $status необязательно 0

см. http://php.net/exit для значений

dispatchMethodsource public

dispatchMethod( string $method , array $params array() )

Вызывает метод этого объекта с заданными параметрами. Предоставляет ОО оболочку для call_user_func_array

Параметры

строка $method

Имя вызываемого метода

массив $params необязательно array()

Список параметров для использования при вызове $method

Возвращает

mixed
Возвращает результат вызова метода

logsource public

log( string $msg , integer $type LOG_ERR , null|string|array $scope null )

Удобный метод для записи сообщения в CakeLog. Для получения дополнительной информации о записи в журналы, см. CakeLog::write().

Параметры

строка $msg

Сообщение журнала

целое число $type необязательно LOG_ERR

Константа типа ошибки. Определена в app/Config/core.php.

null|строка|массив $scope необязательно null

Область(и), в которой создается сообщение журнала. Для получения дополнительной информации о областях ведения журналов, см. CakeLog::config().

Возвращает

boolean
Успех записи в журнал

requestActionsource 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.

Параметры

строка|массив $url

Строка или массивный URL. В отличие от других массивов URL в CakePHP, этот URL не будет автоматически обрабатывать переданные и именованные аргументы в параметре $url.

массив $extra необязательно array()

Если массив включает ключ "return", он устанавливает AutoRender в значение true. Также может использоваться для отправки данных GET/POST и именованных/переданных аргументов.

Возвращает

mixed
Логическое значение true или false об успехе/неудачи или содержимое отрисованного действия, если в $extra установлен ключ 'return'.

toStringsource public

toString( )

Преобразование объекта в строку. Каждый класс может переопределить этот метод по мере необходимости.

Возвращает

string
Имя этого класса

array()

null

null

'AppController'

'CakeResponse'

true

true

public $cacheAction = array(
        'view/23/' => 21600,
        'recalled/' => 86400
);

false

array('Session', 'Flash')

'.ctp'

array()

'default'

null

array()

null

null

null

array()

null

false

null

null

'View'

null

array()