Класс UrlHelper
Класс UrlHelper для генерации URL-адресов.
- Cake\View\Helper implements Cake\Event\EventListenerInterface uses 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 истинно и debug истинно, или 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 истинно и debug истинно, или Asset.timestamp равно 'force', будет добавлена отметка времени.
Параметры
- строка
$path - Путь к файлу для добавления отметки времени, путь должен находиться внутри WWW_ROOT
Возвращает
строкаПуть с добавленной отметкой времени или без неё.
assetUrl()source public
assetUrl( string|array $path , array $options [] )
Генерирует URL для заданного файла ресурса.
В зависимости от переданных опций предоставляет полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка|массив
$path - Строка пути или массив URL
- массив
$optionsoptional [] Массив опций. Возможные ключи:
fullBaseВозвратить полный URL с доменным именемpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЗначение False предотвратит обработку пути как плагина
Возвращает
строкаСгенерированный URL
build()source public
build( string|array|null $url null , array|boolean $options false )
Возвращает URL на основе предоставленных параметров.
Опции:
-
escape: Если ложь, URL будет возвращён необработанным, используйте только в том случае, если он вручную обработается перед отображением. -
fullBase: Если истинно, полный базовый URL будет добавлен к результату
Параметры
- строка|массив|null
$urloptional null Относительный строковый URL, например,
/products/view/23или массив параметров URL. Использование массива для URL позволит использовать возможности обратного маршрутизирования CakePHP.- массив|булево
$optionsoptional false - Массив опций; булево значение
fullдля обратной совместимости.
Возвращает
строкаПолный переведённый URL с базовым путём.
css()source public
css( string|array $path , array $options [] )
Генерирует URL для заданного файла CSS.
В зависимости от переданных опций предоставляет полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка|массив
$path - Строка пути или массив URL
- массив
$optionsoptional [] Массив опций. Возможные ключи:
fullBaseВозвратить полный URL с доменным именемpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЗначение False предотвратит обработку пути как плагина
Возвращает
строкаСгенерированный URL
image()source public
image( string|array $path , array $options [] )
Генерирует URL для заданного файла изображения.
В зависимости от переданных опций предоставляет полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- строка|массив
$path - Строка пути или массив URL
- массив
$optionsoptional [] Массив опций. Возможные ключи:
fullBaseВозвратить полный URL с доменным именемpathPrefixПрефикс пути для относительных URLpluginЗначение False предотвратит обработку пути как плагина
Возвращает
строкаСгенерированный 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
- массив
$optionsoptional [] Массив опций. Возможные ключи:
fullBaseВозвратить полный URL с доменным именемpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЗначение False предотвратит обработку пути как плагина
Возвращает
строкаСгенерированный 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 - Значение для записи.
- булево|строка
$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 - Значение для установки.
- булево
$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–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/3.3/class-Cake.View.Helper.UrlHelper.html