× 警告!旧版文档已经暂停维护,请查看新版文档。点击前往新版文档

static_handler_locations

设置静态处理器的路径。类型为数组,默认不启用。在4.4.0或更高版本可用。

$server->set([
    "static_handler_locations" => ['/static', '/app/images'],
]);

类似于Nginxlocation指令,可以指定一个或多个路径为静态路径。只有URL在指定路径下才会启用静态文件处理器,否则会视为动态请求。

  • location项必须以/开头
  • 支持多级路径,如/app/images

启用static_handler_locations后,如果请求对应的文件不存在,将直接返回404错误

例如/static/test.jpg会判断是否存在$document_root/static/test.jpg,如果存在则发送文件内容,不存在返回404错误。

使用示例

如上述配置,约定了/static是静态目录。并且static目录在存在test.jpg

  • /static/test.jpg:发送test.jpg文件内容
  • /static/test2.jpg:返回404错误页面
  • /app/test.html:进入onRequest动态请求处理逻辑