plugin_core

list (操作)

(Lua) 将一系列操作合并为一个操作，仅在Lua中需要

list actions;

操作

要合并的操作列表

when (操作)

(Lua) 构建一个条件块（仅在Lua中可用）

when (condition, action1, action2);

条件

一个条件；只能在Lua中构建

操作1

如果条件为真或Lua“nil”，则运行的操作

操作2

（可选）如果条件为假，则运行的操作

docroot (操作)

设置文档根目录，并为请求的文件构建物理路径

docroot patterns;

模式

用于构建文档根目录的一个或多个模式

使用 模式 来构建文档根目录（要服务的文件的基本位置）。
docroot 使用第一个生成现有目录的模式；否则，它使用最后一个条目。
您会希望 docroot 操作在 alias 操作之前！

docroot ("/var/www/vhosts/$0/htdocs", "/var/www/default/htdocs");

alias (操作)

根据匹配前缀设置文档根目录

alias mapping;

映射

将前缀映射到磁盘上的基本位置

在前缀附加到基本位置之前，会从URL路径中删除。
您会希望 docroot 操作在 alias 操作之前！

别名目标支持 模式，与 docroot 中一样。由于每个前缀只能给出一个模式，alias 不会检查目标是否存在。

前缀中的尾随斜杠曾用于指示“目录处理”并被匹配时忽略；现在“目录处理”总是启用。
这意味着URL路径仅在分隔符边界处匹配；前缀 /a（和 /a/）匹配路径 /a、/a/ 和 /a/b，但不匹配 /ab。

docroot ("/var/www/vhosts/$0/htdocs", "/var/www/default/htdocs");
alias [
	"/phpmyadmin/" => "/usr/share/phpmyadmin",
	"/pma/" => "/usr/share/phpmyadmin",
	"/.well-known/openpgpkey/" => "/var/lib/gnupg/wks/$0/",
];
alias "/favicon.ico" => "/var/www/favicon.ico";

index (操作)

目录中显示的默认文件名

index filenames;

文件名

要查找的文件名

如果物理路径是一个目录，则搜索指定的文件名；在文件名之前加上‘/’以在文档根目录中搜索。

工作方式如下

• 如果当前物理路径指向常规文件，则不执行任何操作
• 遍历要查找的文件名列表
  • 如果文件名不以‘/’开头，并且当前物理路径不指向目录，则忽略该条目
  • 如果文件名不以‘/’开头，并且URL不以‘/’结尾，则将请求重定向到附加了‘/’的URL
  • 如果文件名不以‘/’开头，则在当前物理路径（一个目录）中搜索它
  • 如果文件名以‘/’开头，则在文档根目录中搜索它

setup {
	module_load "mod_dirlist";
}

# if a directory was requested, first search for some default files
index ["index.php", "index.html", "/index.php"];
# if none of them did exists show a simple directory listing
dirlist;
# ... + handle PHP and static files

pathinfo (操作)

将物理路径拆分为现有文件/目录和剩余的PATH_INFO

pathinfo;

搜索物理路径名中最长且存在的公共前缀，仅在目录分隔符 / 处进行拆分；同时永远不会离开文档根目录（从技术上讲，文件名不能比文档根目录更短）。

docroot "/var/www";
pathinfo;
if phys.path =$ ".php" { fastcgi "unix:/var/run/lighttpd/php.sock"; }

docroot "/var/www";
pathinfo;
index ("index.php");
if phys.path =$ ".php" { fastcgi "unix:/var/run/lighttpd/php.sock"; }

static (操作)

使用磁盘上的静态文件处理GET和HEAD请求

static;

此操作会自动附加到全局配置中（除非在命令行中指定了lua配置）。

在以下情况下不执行任何操作：

• 请求已被处理
• 未设置物理路径（缺少 docroot、alias 等）
• 物理路径指向一个目录

所有其他问题都会导致错误页面，例如：

• 错误的请求方法 (405)
• 文件未找到 (404)
• 无法打开文件 (403)
• 文件名匹配 static.exclude_extensions (403)
• …

static_no_fail (操作)

使用磁盘上的静态文件处理GET和HEAD请求

static_no_fail;

与 static 相同，但不返回任何错误页面；相反，请求处理继续。

respond (操作)

返回带可选响应体的快速响应

respond (status, content);

状态

HTTP响应状态码

内容

（可选）响应体的模式

生成一个简单响应（我们最喜欢的基准测试处理程序）。
响应体被解析为 模式。

respond 403 => "Forbidden";

respond 200 => "benchmark content!";

log (操作)

覆盖所有日志级别的日志目标

log map;

映射

将日志级别（或默认级别）映射到日志目标

log [
	"error" => "/var/log/lighttpd/error.log",
	"abort" => "/var/log/lighttpd/error.log",
	"backend" => "/var/log/lighttpd/backend.log",
	default => "/var/log/lighttpd/debug.log",
];

log.write (操作)

将日志消息写入“info”日志级别

log.write message;

消息

消息模式字符串

使用 info 级别将指定消息写入日志；该消息被解析为 模式。

log.write "hello world";

env.set (操作)

设置连接环境变量

env.set (name, value);

名称

要设置的变量名称

值

要设置的模式值

该值被解析为 模式。

env.set "INFO" => "%{req.path}";

env.add (操作)

如果尚未设置，则设置连接环境变量

env.add (name, value);

名称

要设置的变量名称

值

要设置的模式值

该值被解析为 模式。env.add 不会覆盖已存在的值。

env.add "INFO" => "%{req.path}";

env.remove (操作)

移除连接环境变量

env.remove name;

名称

要移除的变量名称

env.remove "INFO";

env.clear (操作)

移除所有连接环境变量

env.clear;

env.clear;

header.add (操作)

添加新的响应头行

header.add (name, value);

名称

头名称

值

模式头值

HTTP规范要求，多个同名头可以通过使用“,”连接其值来合并。
实际操作中这并非总是有效，尤其是对于“Cookie”头；因此此操作实际上会添加一个单独的头行。

header.add "Cache-Control" => "public";

header.append (操作)

将值附加到响应头行

header.append (name, value);

名称

头名称

值

模式头值

如果头已存在，则将新值用“, “分隔后附加；否则添加新的头行。

header.overwrite (操作)

覆盖响应头行或添加新行

header.overwrite (name, value);

名称

头名称

值

模式头值

如果头已存在，则覆盖其值；否则添加新行。

header.remove (操作)

移除现有响应头

header.remove name;

名称

头名称

# ... some PHP handling
# wait for response headers to be ready
if resp.status >= 0 {
	header.remove "X-Powered-By";
}

set_status (操作)

修改HTTP状态码

set_status;

修改HTTP状态码，但不会以任何方式处理请求。
后续操作可能会覆盖状态，或者如果响应稍后被解析，后端（FastCGI、代理等）可能会覆盖它。
仅当某个操作实际处理了请求时才有效。

如果处理请求的操作未生成响应体且允许响应体，Lighttpd将生成错误页面（如果它知道该代码）。

# hide all 404s at end of config by setting 403
static;
if resp.status == 404 { set_status 403; }

req_header.add (操作)

添加新的请求头行

req_header.add (name, value);

名称

头名称

值

模式头值

与请求头的 header.add 相同。

req_header.append (操作)

将值附加到请求头行

req_header.append (name, value);

名称

头名称

值

模式头值

与请求头的 header.append 相同。

req_header.overwrite (操作)

覆盖请求头行或添加新行

req_header.overwrite (name, value);

名称

头名称

值

模式头值

与请求头的 header.overwrite 相同。

req_header.remove (操作)

移除现有请求头

req_header.remove name;

名称

头名称

与请求头的 header.remove 相同。

if request.scheme == "https" {
	# create a copy of the header value
	req_header.add "HTTPS-Accept-Encoding" => '%{req.header[Accept-Encoding]}';
	req_header.remove "Accept-Encoding";
}