set_iconv
指令 `set_iconv` 使用 iconv 对指定变量执行字符集转换。
NGINX iconv module
·
location
语法set_iconv from= to=;
默认值none
上下文location
参数4
说明
NGINX iconv 模块中的 set_iconv 指令可在指定上下文中对变量进行字符编码转换。它接受四个参数：目标变量、源变量、'from' 编码和 'to' 编码。执行时，该指令读取源变量的内容，将其从指定的 'from' 编码转换为 'to' 编码，并将结果存储到目标变量中。该转换利用了 iconv 库，从而实现不同字符集之间的互通，这在多语言应用中尤为有用。
参数的指定形式为 set_iconv <destination_variable> <source_variable> from=<from_encoding> to=<to_encoding>。该指令在 location 上下文中运行，并在 rewrite 阶段执行，因此适合在请求被进一步处理前，根据请求属性动态修改变量。该指令用途广泛，是在 NGINX 提供的内容中管理字符编码的一种简便方法，能够确保当文本源自一种字符集但需要以另一种字符集显示时编码正确。
配置示例
location /example {
set $src 'Hello';
set_iconv $dst $src from=UTF-8 to=ISO-8859-1;
# Usage of $dst in further processing would now show 'Hello' in ISO-8859-1 encoding.
}⚠
确保服务器上安装的 iconv 库支持所指定的编码。
⚠
注意输出格式；不正确的转换可能导致字符丢失或损坏。
⚠
该指令必须放在适当的上下文中——不能在 location block 之外全局使用。