Класс UrlHelper
Класс UrlHelper для генерации URL.
- Cake\View\Helper реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait
-
Cake\View\Helper\UrlHelper
Унаследованные свойства
-
_View,_defaultConfig,_helperMap,fieldset,helpers,plugin,request,tags,theme_config,_configInitialized
Краткое описание методов
- _encodeUrl() protectedКодирует URL для использования в атрибутах HTML.
- _inflectThemeName() protectedИзменяет имя темы на подчеркнутое.
- assetTimestamp() public
Добавляет отметку времени к ресурсу файла на основе значения
Asset.timestampв Configure. Если Asset.timestamp — true и debug — true, или Asset.timestamp === 'force', отметка времени будет добавлена. - assetUrl() publicГенерирует URL для заданного файла ресурса.
- build() publicВозвращает URL на основе предоставленных параметров.
- css() publicГенерирует URL для заданного файла CSS.
- image() publicГенерирует URL для заданного файла изображения.
- implementedEvents() publicОбработчики событий.
- script() publicГенерирует URL для заданного файла javascript.
- webroot() publicПроверяет, существует ли файл, когда используется тема; если файл не найден, возвращается стандартное расположение.
Подробное описание методов
_encodeUrl()source protected
_encodeUrl( string $url )
Кодирует URL для использования в атрибутах HTML.
Параметры
- строка
$url - URL для кодирования.
Возвращает
строкаURL, закодированный для контекстов URL и HTML.
_inflectThemeName()source protected
_inflectThemeName( string $name )
Изменяет имя темы на подчеркнутое.
Параметры
- строка
$name - Имя темы, которое должно быть изменено.
Возвращает
строкаИзменённое имя темы
assetTimestamp()source public
assetTimestamp( string $path )
Добавляет отметку времени к ресурсу файла на основе значения Asset.timestamp в Configure. Если Asset.timestamp — true и debug — true, или Asset.timestamp === 'force', отметка времени будет добавлена.
Параметры
- строка
$path - Путь к файлу для добавления отметки времени, путь должен быть внутри WWW_ROOT
Возвращает
строкаПуть с добавленной отметкой времени или без.
assetUrl()source public
assetUrl( string|array $path , array $options [] )
Генерирует URL для заданного файла ресурса.
В зависимости от переданных параметров предоставляет полный URL с именем домена. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка или массив
$path - Строка пути или массив URL
- массив
$optionsнеобязательно [] Массив параметров. Возможные ключи:
fullBaseВернуть полный URL с именем доменаpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЛожное значение предотвратит разбор пути как плагина
Возвращает
строкаСгенерированный URL
build()source public
build( string|array|null $url null , boolean $full false )
Возвращает URL на основе предоставленных параметров.
Параметры
- строка, массив или null
$urlнеобязательно null Относительный строковый URL, например
/products/view/23, или массив параметров URL. Использование массива для URL позволит вам использовать функции обратного маршрутизирования CakePHP.- boolean
$fullнеобязательно false - Если true, полный базовый URL будет добавлен к результату
Возвращает
строкаПолный преобразованный URL с базовым путем.
css()source public
css( string|array $path , array $options [] )
Генерирует URL для заданного файла CSS.
В зависимости от переданных параметров предоставляет полный URL с именем домена. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка или массив
$path - Строка пути или массив URL
- массив
$optionsнеобязательно [] Массив параметров. Возможные ключи:
fullBaseВернуть полный URL с именем доменаpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЛожное значение предотвратит разбор пути как плагина
Возвращает
строкаСгенерированный URL
image()source public
image( string|array $path , array $options [] )
Генерирует URL для заданного файла изображения.
В зависимости от переданных параметров предоставляет полный URL с именем домена. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка или массив
$path - Строка пути или массив URL
- массив
$optionsнеобязательно [] Массив параметров. Возможные ключи:
fullBaseВернуть полный URL с именем доменаpathPrefixПрефикс пути для относительных URLpluginЛожное значение предотвратит разбор пути как плагина
Возвращает
строкаСгенерированный URL
implementedEvents()source public
implementedEvents( )
Обработчики событий.
Возвращает
массивПереопределяет
Cake\View\Helper::implementedEvents() script()source public
script( string|array $path , array $options [] )
Генерирует URL для заданного файла javascript.
В зависимости от переданных параметров предоставляет полный URL с именем домена. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка или массив
$path - Строка пути или массив URL
- массив
$optionsнеобязательно [] Массив параметров. Возможные ключи:
fullBaseВернуть полный URL с именем доменаpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЛожное значение предотвратит разбор пути как плагина
Возвращает
строкаСгенерированный URL
webroot()source public
webroot( string $file )
Проверяет, существует ли файл, когда используется тема; если файл не найден, возвращается стандартное расположение
Параметры
- строка
$file - Файл, для которого нужно создать путь webroot.
Возвращает
строкаДоступный по веб-протоколу путь к файлу.
Наследованные методы от Cake\View\Helper
__call()source public
__call( string $method , array $params )
Предоставление сообщений об ошибках при отсутствии вызываемых методов.
Параметры
- строка
$method - Метод для вызова
- массив
$params - Массив параметров для метода.
__construct()source public
__construct( Cake\View\View $View , array $config [] )
Конструктор по умолчанию
Параметры
-
Cake\View\View$View - Представление, к которому прикреплен помощник.
- массив
$configнеобязательно [] - Настройки конфигурации помощника.
__debugInfo()source public
__debugInfo( )
Возвращает массив, который может быть использован для описания внутреннего состояния объекта.
Возвращает
массив__get()source public
__get( string $name )
Ленично загружает помощников.
Параметры
- строка
$name - Имя свойства, к которому осуществляется доступ.
Возвращает
Cake\View\Helper|nullЭкземпляр помощника, если помощник с заданным именем существует
_confirm()source protected
_confirm( string $message , string $okCode , string $cancelCode '' , array $options [] )
Возвращает строку, используемую в качестве обработчика onclick для диалогов подтверждения.
Параметры
- строка
$message - Сообщение, которое должно быть отображено
- строка
$okCode - Код, который должен быть выполнен после выбора пользователем 'OK'
- строка
$cancelCodeнеобязательно '' - Код, который должен быть выполнен после выбора пользователем 'Отмена'
- массив
$optionsнеобязательно [] - Массив опций
Возвращает
строкаJS код onclick
addClass()source public
addClass( array $options [] , string|null $class null , string $key 'class' )
Добавляет указанный класс к опциям элемента.
Параметры
- массив
$optionsнеобязательно [] - Массив опций/атрибутов, к которым нужно добавить класс.
- строка|null
$classнеобязательно null - Имя добавляемого класса.
- строка
$keyнеобязательно 'class' - Ключ, используемый для класса.
Возвращает
массивМассив опций со свойством $key.
initialize()source public
initialize( array $config )
Метод-обработчик конструктора.
Реализуйте этот метод, чтобы избежать необходимости переопределения конструктора и вызова родительского.
Параметры
- массив
$config - Настройки конфигурации, предоставленные данному помощнику.
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаление одного ключа конфигурации
Параметры
- строка
$key - Ключ для удаления.
Исключение
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
_configRead()source protected
_configRead( string|null $key )
Чтение переменной конфигурации
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
смешанный_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Запись переменной конфигурации
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный
$value - Значение для записи.
- boolean|строка
$mergeнеобязательно false Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.
Исключение
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
config()source 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']);
Параметры
- строка|массив|null
$keyнеобязательно null - Ключ для получения/установки или полный массив конфигураций.
- смешанный|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Необходимо ли рекурсивно сливать или перезаписывать существующую конфигурацию, по умолчанию истина.
Возвращает
смешанныйЗначение конфигурации, которое читается, или сам объект при операциях записи.
Исключение
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
configShallow()source 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']);
Параметры
- строка|массив
$key - Ключ для установки, или полный массив конфигураций.
- смешанный|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this Объект самого себя.
© 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.2/class-Cake.View.Helper.UrlHelper.html