Класс UrlHelper
Класс UrlHelper для генерации URL-адресов.
- Cake\View\Helper реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait
-
Cake\View\Helper\UrlHelper
Подробное описание методов
_encodeUrlисходный код защищённый
_encodeUrl( string $url )
Кодирует URL для использования в атрибутах HTML.
Параметры
- строка
$url - URL для кодирования.
Возвращает
stringURL, закодированный для контекстов URL и HTML.
_inflectThemeNameисходный код защищённый
_inflectThemeName( string $name )
Преобразует имя темы в нижний регистр, разделённое нижними подчёркиваниями.
Параметры
- строка
$name - Имя темы, которое нужно преобразовать.
Возвращает
stringПреобразованное имя темы
assetTimestampисходный код публичный
assetTimestamp( string $path )
Добавляет отметку времени к ресурсу файла на основе значения Asset.timestamp в Configure. Если Asset.timestamp имеет значение true и debug имеет значение true, или Asset.timestamp равно 'force', будет добавлена отметка времени.
Параметры
- строка
$path - Путь к файлу, которому нужно добавить отметку времени; путь должен находиться внутри WWW_ROOT
Возвращает
stringПуть с добавленной отметкой времени или без неё.
assetUrlисходный код публичный
assetUrl( string|array $path , array $options [] )
Генерирует URL для заданного файла ресурса. В зависимости от переданных параметров возвращает полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам
Параметры
- строка|массив
$path - Строка пути или массив URL
- массив
$optionsнеобязательно [] - Массив параметров. Возможные ключи:
fullBaseВернуть полный URL с доменным именемpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЗначение False предотвратит обработку пути как плагина
Возвращает
stringСгенерированный URL
buildисходный код публичный
build( string|array $url null , boolean $full false )
Возвращает URL на основе предоставленных параметров.
Параметры
- строка|массив
$urlнеобязательно null - Относительный строковый URL, например,
/products/view/23или массив параметров URL. Использование массива для URL позволит использовать функции обратного маршрутизирования CakePHP. - boolean
$fullнеобязательно false - Если true, к результату будет добавлен полный базовый URL
Возвращает
stringПолный переведённый URL с базовым путём.
implementedEventsисходный код публичный
implementedEvents( )
Обработчики событий.
Возвращает
arrayмассив
Переопределяет
Cake\View\Helper::implementedEvents() webrootисходный код публичный
webroot( string $file )
Проверяет существование файла при использовании темы; если файл не найден, возвращается стандартное расположение.
Параметры
- строка
$file - Файл, для которого нужно создать путь webroot.
Возвращает
stringПуть к файлу, доступный через веб.
Методы, унаследованные от Cake\View\Helper
__callисходный код публичный
__call( string $method , array $params )
Предоставляет некритичные ошибки при вызовах отсутствующих методов.
Параметры
- строка
$method - Метод для вызова
- массив
$params - Массив параметров для метода.
__constructисходный код публичный
__construct( Cake\View\View $View , array $config [] )
Конструктор по умолчанию
Параметры
-
Cake\View\View$View - Просмотр, к которому подключается помощник.
- массив
$configнеобязательно [] - Параметры конфигурации для помощника.
__debugInfoисходный код публичный
__debugInfo( )
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
Возвращает
arrayмассив
__getисходный код публичный
__get( string $name )
Лениво загружает помощников.
Параметры
- строка
$name - Имя свойства, к которому осуществляется доступ.
Возвращает
Cake\View\Helper|nullЭкземпляр помощника, если помощник с указанным именем существует
_confirmисходный код защищённый
_confirm( string $message , string $okCode , string $cancelCode '' , array $options [] )
Возвращает строку, используемую в качестве обработчика onclick для диалогов подтверждения.
Параметры
- строка
$message - Сообщение для отображения
- строка
$okCode - Код, который будет выполнен после выбора пользователем «ОК»
- строка
$cancelCodeнеобязательно '' - Код, который будет выполнен после выбора пользователем «Отмена»
- массив
$optionsнеобязательно [] - Массив опций
Возвращает
stringJS-код onclick
addClassисходный код публичный
addClass( array $options [] , string $class null , string $key 'class' )
Добавляет заданный класс к опциям элемента.
Параметры
- массив
$optionsнеобязательно [] - Массив опций/атрибутов для добавления класса
- строка
$classнеобязательно null - Имя добавляемого класса.
- строка
$keyнеобязательно 'class' - Ключ для использования с классом.
Возвращает
arrayМассив опций со значением $key.
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDeleteисходный код защищённый
_configDelete( string $key )
Удаляет отдельный ключ конфигурации.
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionесли происходит попытка перезаписи существующей конфигурации
_configReadисходный код защищённый
_configRead( string|null $key )
Чтение переменной конфигурации.
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
mixedсмешанный тип
_configWritesource protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записать переменную конфигурации
Параметры
- string|array
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean|string
$mergeнеобязательно false - Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
configsource public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Использование
Чтение всей конфигурации:
$this->config();
Чтение определённого значения:
$this->config('key');
Чтение вложенного значения:
$this->config('some.nested.key');
Установка определённого значения:
$this->config('key', $value);
Установка вложенного значения:
$this->config('some.nested.key', $value);
Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- string|array|null
$keyнеобязательно null - Ключ для получения/установки или полный массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Флаг рекурсивного слияния или перезаписи существующей конфигурации, по умолчанию истина.
Возвращаемое значение
mixedЗначение конфигурации, которое считывается, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить неверный ключ.
configShallowsource public
configShallow( string|array $key , mixed|null $value null )
Объединить предоставленную конфигурацию с существующей. В отличие от config() , которая выполняет рекурсивное слияние вложенных ключей, этот метод выполняет простое слияние.
Установка определённого значения:
$this->config('key', $value);
Установка вложенного значения:
$this->config('some.nested.key', $value);
Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или полный массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
Возвращаемое значение
mixed$this Сам объект.
Наследуемые свойства из Cake\View\Helper
$_helperMapsource
protected array
Таблица поиска хелперов, используемая для ленивой загрузки объектов хелперов.
[]
$fieldsetsource
public array
Хранит поля ['имя_поля' => ['тип' => 'строка', 'длина' => 100]], первичный ключ и валидаторы ['имя_поля']
[]
Свойства, используемые из Cake\Core\InstanceConfigTrait
$_configInitializedsource
protected boolean
Содержит ли свойство config уже значения по умолчанию
false
© 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/3.1/class-Cake.View.Helper.UrlHelper.html