资产类
用于生成资产 URL 的类。
属性摘要
-
$inflectionType protected static
字符串词形变化类型。
方法摘要
-
assetTimestamp() public static
根据 Configure 中
Asset.timestamp的值，向基于文件的资源添加时间戳。如果 Asset.timestamp 为 true 且 debug 为 true，或者 Asset.timestamp === 'force'，则会添加时间戳。 -
cssUrl() public static
为给定的 CSS 文件生成 URL。
-
encodeUrl() protected static
使用 rawurlencode() 编码 URL 部分。
-
imageUrl() public static
为给定的图像文件生成 URL。
-
inflectString() protected static
使用
Asset::setInflectionType()将主题/插件名称词形变化为类型集。 -
pluginSplit() protected static
将点语法插件名称拆分为其插件和文件名。如果 $name 没有点，则索引 0 将为 null。它检查插件是否已加载，否则文件名将保持不变，以用于包含点的文件名。
-
requestWebroot() protected static
从请求中获取 webroot。
-
scriptUrl() public static
为给定的 JavaScript 文件生成 URL。
-
setInflectionType() public static
设置词形变化类型，在词形变化插件/主题名称时使用。
-
url() public static
为给定的资产文件生成 URL。
-
webroot() public static
检查使用主题时文件是否存在，如果找不到文件，则返回默认位置。
方法详细
assetTimestamp() ¶ public static
assetTimestamp(string $path, string|bool $timestamp = null): string根据 Configure 中 Asset.timestamp 的值，向基于文件的资源添加时间戳。如果 Asset.timestamp 为 true 且 debug 为 true，或者 Asset.timestamp === 'force'，则会添加时间戳。
参数
-
string$path 要添加时间戳的文件路径，路径必须位于 Configure 中的
App.wwwRoot内。-
string|bool$timestamp 可选 如果设置，将覆盖 Configure 中
Asset.timestamp的值。
返回
字符串cssUrl() ¶ public static
cssUrl(string $path, array<string, mixed> $options = []): string为给定的 CSS 文件生成 URL。
根据传递的选项提供带有域名完整 URL。还会调用 Asset::assetTimestamp() 向本地文件添加时间戳。
参数
-
string$path 路径字符串。
-
array<string, mixed>$options 可选 选项数组。可能的键：
fullBase返回带有域名完整 URLpathPrefix相对 URL 的路径前缀ext要附加的资产扩展名pluginFalse 值将阻止将路径解析为插件timestamp覆盖 Configure 中Asset.timestamp的值。设置为 false 以跳过时间戳生成。设置为 true 以在 debug 为 true 时应用时间戳。设置为 'force' 以始终启用时间戳，无论 debug 值如何。
返回
字符串encodeUrl() ¶ protected static
encodeUrl(string $url): string使用 rawurlencode() 编码 URL 部分。
参数
-
string$url 要编码的 URL。
返回
字符串imageUrl() ¶ public static
imageUrl(string $path, array<string, mixed> $options = []): string为给定的图像文件生成 URL。
根据传递的选项提供带有域名完整 URL。还会调用 Asset::assetTimestamp() 向本地文件添加时间戳。
参数
-
string$path 路径字符串。
-
array<string, mixed>$options 可选 选项数组。可能的键：
fullBase返回带有域名完整 URLpathPrefix相对 URL 的路径前缀pluginFalse 值将阻止将路径解析为插件timestamp覆盖 Configure 中Asset.timestamp的值。设置为 false 以跳过时间戳生成。设置为 true 以在 debug 为 true 时应用时间戳。设置为 'force' 以始终启用时间戳，无论 debug 值如何。
返回
字符串inflectString() ¶ protected static
inflectString(string $string): string使用 Asset::setInflectionType() 将主题/插件名称词形变化为类型集。
参数
-
string$string 词形变化后的字符串。
返回
字符串pluginSplit() ¶ protected static
pluginSplit(string $name): array将点语法插件名称拆分为其插件和文件名。如果 $name 没有点，则索引 0 将为 null。它检查插件是否已加载，否则文件名将保持不变，以用于包含点的文件名。
参数
-
string$name 要插件拆分的名称。
返回
数组scriptUrl() ¶ public static
scriptUrl(string $path, array<string, mixed> $options = []): string为给定的 JavaScript 文件生成 URL。
根据传递的选项提供带有域名完整 URL。还会调用 Asset::assetTimestamp() 向本地文件添加时间戳。
参数
-
string$path 路径字符串。
-
array<string, mixed>$options 可选 选项数组。可能的键：
fullBase返回带有域名完整 URLpathPrefix相对 URL 的路径前缀ext要附加的资产扩展名pluginFalse 值将阻止将路径解析为插件timestamp覆盖 Configure 中Asset.timestamp的值。设置为 false 以跳过时间戳生成。设置为 true 以在 debug 为 true 时应用时间戳。设置为 'force' 以始终启用时间戳，无论 debug 值如何。
返回
字符串setInflectionType() ¶ public static
setInflectionType(string $inflectionType): void设置词形变化类型，在词形变化插件/主题名称时使用。
参数
-
string$inflectionType 词形变化类型。值应为
Inflector类的有效方法名称，例如'dasherize'或'underscore'`。
返回
空url() ¶ public static
url(string $path, array<string, mixed> $options = []): string为给定的资产文件生成 URL。
根据传递的选项提供带有域名完整 URL。还会调用 Asset::assetTimestamp() 向本地文件添加时间戳。
选项
fullBase布尔值 true 或字符串（例如 https://example）以返回带有协议和域名完整 URL。pathPrefix相对 URL 的路径前缀ext要附加的资产扩展名pluginFalse 值将阻止将路径解析为插件theme可选的主题名称timestamp覆盖 Configure 中Asset.timestamp的值。设置为 false 以跳过时间戳生成。设置为 true 以在 debug 为 true 时应用时间戳。设置为 'force' 以始终启用时间戳，无论 debug 值如何。
参数
-
string$path 路径字符串或 URL 数组
-
array<string, mixed>$options 可选 选项数组。
返回
字符串webroot() ¶ public static
webroot(string $file, array<string, mixed> $options = []): string检查使用主题时文件是否存在，如果找不到文件，则返回默认位置。
选项
theme可选的主题名称
参数
-
string$file 要创建 webroot 路径的文件。
-
array<string, mixed>$options 可选 选项数组。
返回
字符串