Класс SessionHelper
Помощник сессии.
Чтение сессии из представления.
- Объект
-
Помощник -
AppHelper -
SessionHelper
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: Лицензия MIT
Ссылка: http://book.cakephp.org/2.0/ru/core-libraries/helpers/session.html
Расположен в Cake/View/Helper/SessionHelper.php
Подробное описание методов
checkисходный код public
check( string $name )
Проверяет, установлена ли ключевая сессия.
В вашем представлении: $this->Session->check('Controller.sessKey');
Параметры
- строка
$name - Ключ сессии для проверки.
Возвращает
booleanbool
Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/session.html#SessionHelper::checkconsumeисходный код public
consume( string $name )
Читает и удаляет значение сессии для ключа.
В вашем представлении: $this->Session->consume('Controller.sessKey');
Параметры
- строка
$name - название ключа сессии, которое вы хотите прочитать
Возвращает
mixedзначения из переменных сессии
errorисходный код public
error( )
Возвращает последнюю ошибку, возникшую в сессии
В вашем представлении: $this->Session->error();
Возвращает
stringпоследняя ошибка
Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/session.html#displaying-notifications-or-flash-messagesflashисходный код public
flash( string $key 'flash' , array $attrs array() )
Используется для отображения сообщения, установленного в Controller::Session::setFlash()
В вашем представлении: $this->Session->flash('somekey'); По умолчанию будет отображаться flash, если параметр не указан
Вы можете передать дополнительную информацию в создание сообщения всплывающего окна. Это позволяет объединить все параметры для данного типа сообщения всплывающего окна в представлении.
echo $this->Session->flash('flash', array('params' => array('class' => 'new-flash')));
Выше приведён пример создания сообщения всплывающего окна с пользовательским именем класса. Используя $attrs['params'], вы можете передавать дополнительные данные в отображение элемента, которые будут доступны в качестве локальных переменных, когда элемент будет отображен:
echo $this->Session->flash('flash', array('params' => array('name' => $user['User']['name'])));
Это передаст имя текущего пользователя в сообщение всплывающего окна, так что вы сможете создавать персонализированные сообщения без необходимости доступа к этим данным в контроллере.
Наконец, вы можете выбрать элемент, который будет отображён при создании сообщения всплывающего окна. Использование пользовательских элементов позволяет полностью настроить создание сообщений всплывающего окна.
echo $this->Session->flash('flash', array('element' => 'my_custom_element'));
Если вы хотите использовать элемент из плагина для отображения сообщения всплывающего окна, вы можете сделать это, используя параметр плагина:
echo $this->Session->flash('flash', array( 'element' => 'my_custom_element', 'params' => array('plugin' => 'my_plugin') ));
Устаревшее
3.0.0 С версии 2.7, используйте FlashHelper::render() вместо этого.Параметры
- строка
$keyнеобязательно 'flash' - Ключ сообщения, которое вы отображаете в представлении.
- массив
$attrsнеобязательно массив() - Дополнительные атрибуты для создания этого сообщения всплывающего окна. Поддерживает ключи 'params' и 'element', которые используются в помощнике.
Возвращает
stringстрока
Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/session.html#SessionHelper::flashreadисходный код public
read( string $name null )
Читает значение сессии для ключа или возвращает значения для всех ключей.
В вашем представлении: $this->Session->read('Controller.sessKey'); Вызов метода без параметра вернёт все переменные сессии
Параметры
- строка
$nameнеобязательно null - название ключа сессии, который вы хотите прочитать
Возвращает
mixedзначения из переменных сессии
Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/session.html#SessionHelper::readvalidисходный код public
valid( )
Используется для проверки валидности сессии в представлении
Возвращает
booleanbool
Ссылка
http://book.cakephp.org/2.0/ru/core-libraries/helpers/session.html#SessionHelper::validМетоды, унаследованные от Помощник
__callисходный код public
__call( string $method , array $params )
Обеспечивает некритические ошибки при вызовах отсутствующих методов.
Параметры
- строка
$method - Метод для вызова
- массив
$params - Массив параметров для метода.
__constructисходный код public
__construct( View $View , array $settings array() )
Конструктор по умолчанию
Параметры
-
View$View - Представление, к которому прикреплён помощник.
- массив
$settingsнеобязательно массив() - Настройки конфигурации помощника.
Переопределяет
Object::__construct() __getисходный код public
__get( string $name )
Лениво загружает помощников. Предоставляет доступ к устаревшим свойствам запроса также.
Устаревшее
3.0.0 Доступ к свойствам запроса через этот метод устарел и будет удален в 3.0.Параметры
- строка
$name - Имя свойства, к которому осуществляется доступ.
Возвращает
mixedПомощник или найденное свойство в $name
__setисходный код public
__set( string $name , mixed $value )
Обеспечивает обратную совместимость для установки значений в объект запроса.
Устаревшее
3.0.0 Этот метод будет удалён в 3.0Параметры
- строка
$name - Имя свойства, к которому осуществляется доступ.
- смешанный
$value - Значение для установки.
_confirmисходный код protected
_confirm( string $message , string $okCode , string $cancelCode '' , array $options array() )
Возвращает строку, используемую как обработчик onclick для диалогов подтверждения.
Параметры
- строка
$message - Сообщение, которое должно отображаться
- строка
$okCode - Код, который должен выполняться после того, как пользователь нажал «OK»
- строка
$cancelCodeнеобязательно '' - Код, который должен выполняться после того, как пользователь нажал «Отмена»
- массив
$optionsнеобязательно массив() - Массив параметров
Возвращает
stringJS код onclick
_encodeUrlисходный код protected
_encodeUrl( string $url )
Кодирует URL для использования в атрибутах HTML.
Параметры
- строка
$url - URL для кодирования.
Возвращает
stringURL закодированный для URL и контекстов HTML.
_formatAttributesource protected
_formatAttribute( string $key , string $value , boolean $escape true )
Форматирует отдельный атрибут и возвращает строковое значение составного атрибута. Работает с минимизированными атрибутами, которые имеют такое же значение, как и их имя, например, 'disabled' и 'checked'
Устаревший
3.0.0 Этот метод будет перенесен в HtmlHelper в версии 3.0Параметры
- строка
$key - Имя атрибута для создания
- строка
$value - Значение атрибута для создания.
- логическое значение
$escapeнеобязательный true - Определяет, должно ли значение быть экранировано
Возвращает
stringСоставной атрибут.
_initInputFieldsource protected
_initInputField( string $field , array $options array() )
Устанавливает значения по умолчанию для тега input. Установит атрибуты name, value и id для массива html атрибутов.
Параметры
- строка
$field - Имя поля для инициализации.
- массив
$optionsнеобязательный array() - Массив опций для использования при инициализации поля ввода.
Возвращает
arrayМассив опций для поля формы.
_namesource protected
_name( array|string $options array() , string $field null , string $key 'name' )
Получает имя поля ввода для текущего тега. Создаёт атрибут имени ввода с использованием форматирования CakePHP data[Model][field].
Параметры
- массив или строка
$optionsнеобязательный array() - Если массив, должен быть массивом атрибутов, к которым нужно добавить $key. Если строка или null, будет использоваться как сущность View.
- строка
$fieldнеобязательный null - Имя поля.
- строка
$keyнеобязательный 'name' - Имя атрибута для установки, по умолчанию 'name'
Возвращает
mixedЕсли для $options был задан массив, будет возвращён массив с установленным $key. Если была передана строка, будет возвращена строка.
_parseAttributessource protected
_parseAttributes( array $options , array $exclude null , string $insertBefore ' ' , string $insertAfter null )
Возвращает строку, разделённую пробелами, с элементами массива $options. Если ключ массива $options совпадает с одним из перечисленных в Helper::$_minimizedAttributes,
И его значение равно:
- '1' (строка)
- 1 (целое число)
- true (логическое значение)
- 'true' (строка)
Тогда значение будет переопределено, чтобы быть идентичным имени ключа. Если значение не является одним из этих 3, параметр не выводится.
'escape' — специальная опция, которая управляет преобразованием атрибутов в их эквиваленты с кодировкой html-сущностей. Установите в значение false, чтобы отключить кодирование html.
Если значение для любого ключа опции установлено в null или false, эта опция будет исключена из вывода.
Устаревший
3.0.0 Этот метод будет перенесён в HtmlHelper в версии 3.0Параметры
- массив
$options - Массив опций.
- массив
$excludeнеобязательный null - Массив опций, которые нужно исключить, эти опции не будут частью возвращаемого значения.
- строка
$insertBeforeнеобязательный ' ' - Строка, которая будет вставлена перед опциями.
- строка
$insertAfterнеобязательный null - Строка, которая будет вставлена после опций.
Возвращает
stringСоставные атрибуты.
_selectedArraysource protected
_selectedArray( string|array $data , string $key 'id' )
Преобразует набор записей из ассоциации hasAndBelongsToMany в список выбранных опций для элемента множественного выбора
Параметры
- строка или массив
$data - Массив данных или имя модели.
- строка
$keyнеобязательный 'id' - Имя поля.
Возвращает
arrayмассив
addClasssource public
addClass( array $options array() , string $class null , string $key 'class' )
Добавляет заданный класс к опциям элемента.
Параметры
- массив
$optionsнеобязательный array() - Массив опций/атрибутов, к которому нужно добавить класс
- строка
$classнеобязательный null - Имя добавляемого класса.
- строка
$keyнеобязательный 'class' - Ключ для использования для класса.
Возвращает
arrayМассив опций с установленным $key.
afterLayoutsource public
afterLayout( string $layoutFile )
Обработчик после макета. afterLayout вызывается после отрисовки макета.
Переопределяется в подклассах.
Параметры
- строка
$layoutFile - Файл макета, который был отрисован.
afterRendersource public
afterRender( string $viewFile )
Обработчик после рендеринга. afterRender вызывается после отрисовки файла представления, но перед отрисовкой макета.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл представления, который был отрисован.
afterRenderFilesource public
afterRenderFile( string $viewFile , string $content )
Обработчик после рендеринга файла. Вызывается после отрисовки любого фрагмента представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Только что отрисованный файл.
- строка
$content - Содержимое, которое было отрисовано.
assetTimestampsource public
assetTimestamp( string $path )
Добавляет отметку времени к ресурсу файла на основе значения Asset.timestamp в Configure. Если Asset.timestamp имеет значение true и debug > 0, или Asset.timestamp === 'force', будет добавлена отметка времени.
Параметры
- строка
$path - Путь к файлу для добавления отметки времени, путь должен быть внутри WWW_ROOT
Возвращает
stringПуть с добавленной отметкой времени или без.
assetUrlsource public
assetUrl( string|array $path , array $options array() )
Генерирует URL для заданного файла ресурса. В зависимости от переданных опций предоставляет полный URL с именем домена. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам
Параметры
- строка или массив
$path - Строка пути или массив URL
- массив
$optionsнеобязательный array() - Массив опций. Возможные ключи:
fullBaseВозвращает полный URL с именем доменаpathPrefixПрефикс пути для относительных URLextРасширение ассета для добавленияpluginЗначение False предотвратит обработку пути как плагина
Возвращает
stringСгенерированный URL
beforeLayoutsource public
beforeLayout( string $layoutFile )
Обработчик перед макетом. beforeLayout вызывается перед отрисовкой макета.
Переопределяется в подклассах.
Параметры
- строка
$layoutFile - Макет, который собирается быть отрисован.
beforeRendersource public
beforeRender( string $viewFile )
Обработчик перед рендерингом. beforeRender вызывается перед отрисовкой файла представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл представления, который собирается быть отрисован
beforeRenderFilesource public
beforeRenderFile( string $viewFile )
Обработчик перед рендерингом файла. Вызывается перед рендерингом любого фрагмента представления.
Переопределяется в подклассах.
Параметры
- строка
$viewFile - Файл, который собирается рендериться.
cleansource public
clean( string|array $output )
Используется для удаления вредных тегов из содержимого. Удаляет ряд известных атак XSS из содержимого. Однако, не гарантирует удаление всех возможных атак. Лучшим способом предотвращения всех возможных атак является экранирование содержимого.
Устарело
3.0.0 Этот метод будет удалён в версии 3.0Параметры
- строка|массив
$output - Либо массив строк для очистки, либо одна строка для очистки.
Возвращает
string|array|nullОчищенное содержимое для вывода
domIdsource public
domId( array|string $options null , string $id 'id' )
Генерирует идентификатор DOM для выбранного элемента, если он не задан. Использует текущие настройки View::entity() для генерации идентификатора атрибута CamelCased.
Параметры
- массив|строка
$optionsнеобязательно null - Либо массив HTML атрибутов, в который добавить $id, либо строка с путём к сущности представления для получения domId.
- строка
$idнеобязательно 'id' - Имя атрибута 'id'.
Возвращает
mixedЕсли $options был массивом, будет возвращён массив с установленным $id. Если была передана строка, будет возвращена строка.
entitysource public
entity( )
Возвращает ссылку на сущность текущего контекста в виде массива частей идентификатора.
Возвращает
arrayМассив, содержащий элементы идентификации сущности
fieldsource public
field( )
Возвращает поле модели, используемое в текущем контексте рендеринга. Удаляет суффиксы полей, такие как год, месяц, день, час, минута, полуденный знак, когда текущая сущность содержит более 2 элементов.
Возвращает
stringстрока
outputsource public
output( string $str )
Возвращает строку, сгенерированную методом помощника.
Этот метод можно переопределить в подклассах для обобщённой пост-обработки вывода.
Устарело
3.0.0 Этот метод будет удалён в будущих версиях.Параметры
- строка
$str - Строка для вывода.
Возвращает
stringстрока
setEntitysource public
setEntity( string $entity , boolean $setScope false )
Устанавливает свойства модели и поля помощника на пары значений, разделённые точкой в $entity.
Параметры
- строка
$entity - Имя поля, например "ModelName.fieldName" или "ModelName.ID.fieldName"
- логическое
$setScopeнеобязательно false - Устанавливает область представления в модель, указанную в $tagValue
urlsource public
url( string|array $url null , boolean $full false )
Находит URL для указанного действия.
Возвращает URL, указывающий на предоставленные параметры.
Параметры
- строка|массив
$urlнеобязательно null - Либо относительный строковый URL, например
/products/view/23, либо массив параметров URL. Использование массива для URL позволит использовать функции обратного маршрутизирования CakePHP. - логическое
$fullнеобязательно false - Если true, к результату будет добавлен полный базовый URL.
Возвращает
stringПолный переведённый URL с базовым путём.
Ссылка
http://book.cakephp.org/2.0/ru/views/helpers.htmlvaluesource public
value( array|string $options array() , string $field null , string $key 'value' )
Получает данные для текущего тега.
Параметры
- массив|строка
$optionsнеобязательно array() - Если массив, должен быть массивом атрибутов, к которым необходимо добавить $key. Если строка или null, будет использоваться как сущность представления.
- строка
$fieldнеобязательно null - Имя поля.
- строка
$keyнеобязательно 'value' - Имя атрибута, который нужно установить, по умолчанию 'value'.
Возвращает
mixedЕсли для $options был передан массив, будет возвращён массив с установленным $key. Если была передана строка, будет возвращена строка.
webrootsource public
webroot( string $file )
Проверяет существование файла при использовании темы; если файл не найден, возвращает расположение по умолчанию.
Параметры
- строка
$file - Файл для создания пути к файлу webroot.
Возвращает
stringВеб-доступный путь к файлу.
Методы, унаследованные от Объекта
_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Имя этого класса
Свойства, унаследованные от Helper
$_associationsource
protected строка
Имя текущей модели, в области которой находятся сущности ассоциации.
См. также
Helper::setEntity()$_entityPathsource
protected строка
Список элементов, разделенных точками, для которых предназначена текущая сущность поля.
См. также
Helper::setEntity()$_fieldSuffixessource
protected массив
Список строк, которые должны рассматриваться как суффиксы или вложенные входы для родительского ввода. В основном используется для вводов даты/времени.
array( 'year', 'month', 'day', 'hour', 'min', 'second', 'meridian' )
$_helperMapsource
protected массив
Таблица поиска помощников, используемая для отложенной загрузки объектов помощников.
array() $_minimizedAttributessource
protected массив
Минимизированные атрибуты
array( 'allowfullscreen', 'async', 'autofocus', 'autoplay', 'checked', 'compact', 'controls', 'declare', 'default', 'defaultchecked', 'defaultmuted', 'defaultselected', 'defer', 'disabled', 'enabled', 'formnovalidate', 'hidden', 'indeterminate', 'inert', 'ismap', 'itemscope', 'loop', 'multiple', 'muted', 'nohref', 'noresize', 'noshade', 'novalidate', 'nowrap', 'open', 'pauseonexit', 'readonly', 'required', 'reversed', 'scoped', 'seamless', 'selected', 'sortable', 'spellcheck', 'truespeed', 'typemustmatch', 'visible' )
$_modelScopesource
protected строка
Имя текущей модели, в области которой находятся сущности.
См. также
Helper::setEntity()$fieldsetsource
public массив
Содержит массив полей ('имя_поля' => массив('тип' => 'строка', 'длина' => 100), первичный ключ и валидации (массив('имя_поля')))
array()
© 2005–2016 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.
http://api.cakephp.org/2.7/class-SessionHelper.html