static_handler_locations
设置静态处理器的路径。类型为数组,默认不启用。在4.4.0
或更高版本可用。
$server->set([
"static_handler_locations" => ['/static', '/app/images'],
]);
类似于Nginx
的location
指令,可以指定一个或多个路径为静态路径。只有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
动态请求处理逻辑