Класс 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 )
Привести имя темы к нижнему подчеркиванию.
Параметры
- string
$name - Имя темы, которое нужно привести к нижнему подчеркиванию.
Возвращаемые значения
stringИмя темы в формате нижнего подчеркивания
assetTimestamp()source public
assetTimestamp( string $path )
Добавляет отметку времени к файловому ресурсу на основе значения Asset.timestamp в Configure. Если Asset.timestamp имеет значение true и debug имеет значение true, или Asset.timestamp равно 'force', отметка времени будет добавлена.
Параметры
- string
$path - Путь к файлу, к которому нужно добавить отметку времени. Путь должен находиться внутри WWW_ROOT
Возвращаемые значения
stringПуть с добавленной отметкой времени или без неё.
assetUrl()source public
assetUrl( string|array $path , array $options [] )
Генерирует URL для данного файла ресурса.
В зависимости от переданных опций предоставляет полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- string|array
$path - Строка пути или массив URL
- array
$optionsoptional [] Массив опций. Возможные ключи:
fullBaseВозвращает полный URL с доменным именемpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЛожное значение предотвратит обработку пути как плагина
Возвращаемые значения
stringСгенерированный URL
build()source public
build( string|array|null $url null , array|boolean $options false )
Возвращает URL на основе предоставленных параметров.
Опции:
-
escape: Если false, URL будет возвращён без экранирования, используйте только если он будет экранирован вручную перед отображением. -
fullBase: Если true, к результату будет добавлен полный базовый URL
Параметры
- string|array|null
$urloptional null Относительный строковый URL, например
/products/view/23, или массив параметров URL. Использование массива для URL позволит вам использовать возможности обратной маршрутизации CakePHP.- array|boolean
$optionsoptional false - Массив опций; bool
fullдля совместимости.
Возвращаемые значения
stringПолный переведённый URL с базовым путём.
css()source public
css( string|array $path , array $options [] )
Генерирует URL для данного файла CSS.
В зависимости от переданных опций предоставляет полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- string|array
$path - Строка пути или массив URL
- array
$optionsoptional [] Массив опций. Возможные ключи:
fullBaseВозвращает полный URL с доменным именемpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЛожное значение предотвратит обработку пути как плагина
Возвращаемые значения
stringСгенерированный URL
image()source public
image( string|array $path , array $options [] )
Генерирует URL для данного файла изображения.
В зависимости от переданных опций предоставляет полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- string|array
$path - Строка пути или массив URL
- array
$optionsoptional [] Массив опций. Возможные ключи:
fullBaseВозвращает полный URL с доменным именемpathPrefixПрефикс пути для относительных URLpluginЛожное значение предотвратит обработку пути как плагина
Возвращаемые значения
stringСгенерированный URL
implementedEvents()source public
implementedEvents( )
Обработчики событий.
Возвращаемые значения
arrayПереопределяет
Cake\View\Helper::implementedEvents() script()source public
script( string|array $path , array $options [] )
Генерирует URL для данного файла JavaScript.
В зависимости от переданных опций предоставляет полный URL с доменным именем. Также вызывает Helper::assetTimestamp() для добавления отметки времени к локальным файлам.
Параметры
- string|array
$path - Строка пути или массив URL
- array
$optionsoptional [] Массив опций. Возможные ключи:
fullBaseВозвращает полный URL с доменным именемpathPrefixПрефикс пути для относительных URLextРасширение ресурса для добавленияpluginЛожное значение предотвратит обработку пути как плагина
Возвращаемые значения
stringСгенерированный URL
webroot()source public
webroot( string $file )
Проверяет существование файла, когда используется тема, если файл не найден, возвращается стандартное расположение.
Параметры
- string
$file - Файл, для которого необходимо создать путь webroot.
Возвращаемые значения
stringВеб-доступный путь к файлу.
Методы, унаследованные от 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 - Код, который должен быть выполнен после выбора пользователем 'ОК'
- строка
$cancelCodeнеобязательно '' - Код, который должен быть выполнен после выбора пользователем 'Отмена'
- массив
$optionsнеобязательно [] - Массив опций
Возвращает
строкакод JS onclick
addClass()source public
addClass( array $options [] , string|null $class null , string $key 'class' )
Добавляет указанный класс к опциям элемента
Параметры
- массив
$optionsнеобязательно [] - Массив опций/атрибутов, к которым нужно добавить класс
- строка|null
$classнеобязательно null - Имя добавляемого класса.
- строка
$keyнеобязательно 'class' - ключ для использования класса.
Возвращает
массивМассив опций со значением $key.
getView()source public
getView( )
Получение экземпляра представления, к которому привязан помощник.
Возвращает
Cake\View\ViewЭкземпляр привязанного представления.
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 Истина для рекурсивного слияния, 'поверхностное' для простого слияния, ложь для перезаписи, по умолчанию ложь.
Выбрасывает
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']);
Устарело
3.4.0 используйте setConfig()/getConfig() вместо.Параметры
- строка|массив|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->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигураций.
- смешанное|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key null , mixed $default null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определенного значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- строка|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- смешанное
$defaultнеобязательно null - Значение возврата, когда ключ не существует.
Возвращает
смешанноеЗначение конфигурации, которое читается.
setConfig()source public
setConfig( string|array $key , mixed|null $value null , boolean $merge true )
Устанавливает конфигурацию.
Использование
Установка определенного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигураций.
- смешанное|null
$valueнеобязательно null - Значение для установки.
- булево
$mergeнеобязательно true - Выполнять рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию истина.
Возвращает
$this
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
© 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.4/class-Cake.View.Helper.UrlHelper.html