echo_foreach_split
The `echo_foreach_split` 指令对拆分后的输入字符串中的每一项迭代地执行一系列命令。
nginx Echo module
·
locationif in location
语法echo_foreach_split string delimiter;
默认值none
上下文location, if in location
参数2+
说明
echo_foreach_split 指令是 NGINX Echo 模块的一部分，允许基于拆分的输入字符串在多次迭代中执行命令。当调用此指令时，输入字符串会根据指定的分隔符被分割成独立的元素；对于每个元素，echo_foreach_split 之后定义的后续命令将按顺序执行。当重复任务的具体操作可能随拆分后字符串的内容而变化时，这一点尤其有用。
该指令至少需要两个参数：第一个参数是要拆分的输入字符串，第二个参数是分隔该字符串元素的分隔符。字符串被拆分后，跟在该指令之后的命令可以动态地使用当前元素，从而实现工作流自动化并简化对多个项的处理。
echo_foreach_split 的一个常见用例是读取以逗号分隔的值列表，然后遍历该列表，为每个值执行指定命令。这种方法有助于日志记录、生成响应，或处理比标准单值指令允许的更复杂的输入。
配置示例
location /process_items {
echo_foreach_split "item1,item2,item3" ",";
echo "Current item: $echo_it";
}⚠
确保输入字符串不为空；否则将不会进行任何迭代。
⚠
在选择分隔符时请谨慎，以避免非预期的分割。对于特殊字符，可能需要进行转义。
⚠
在 echo_foreach_split 之后定义的命令必须有效，并且正确处理当前项。