阅读(4629) (0)

staticuri()

2017-06-13 17:24:04 更新

作用:设置和获取额外的伪静态规则。 语法: mixed staticuri([mixed $filename][, string $staticURI])

参数

  • $filename 指定模板文件(相对于网站根目录),也可设置为一个关联数组来同时设置多条伪静态规则。
  • $staticURI 伪静态 URL 地址,必须以文件名开头(不含 .php 后缀)。

返回值: 如果未设置参数,则返回所有伪静态地址格式组成的关联数组。 如果仅提供 $filename 参数为字符串,如果对应的伪静态地址格式存在则将其返回,否则返回 null。 如果提供 $filename 参数为数组,则同时设置多条伪静态规则并返回 true。 如果同时提供 $filename(字符串)$staticURI 参数,则设置伪静态规则并始终返回 $staticURI

说明: 在配置目录中,与 staticuri() 函数相关联的是 static-uri.php 文件,在第一次调用该函数时,系统会将 static-uri.php 文件所返回的配置数组填充到 staticuri() 函数中。

自 ModPHP 2.1.7 起,该函数可以将第一个参数 $filename 设置为一个绝对路径(以 / 作为目录分隔符),函数会自动将其转换为相对于网站根目录的相对路径。这可以方便地在模板目录中使用 current_dir()template_dir() 函数来获取模板文件名并为其设置伪静态规则。

更多有关伪静态的说明,请查看《伪静态规则》。

示例

<?php
print_r(staticuri()); //打印所有伪静态规则
staticuri('template/test.php', 'test/{keyword}'); //设置一条伪静态规则
echo staticuri('template/test.pnp'); //获取伪静态规则