在 apache 中,通过 rewritemap 的 prg 类型可以调用外部脚本实现动态重写逻辑。具体做法是在 httpd.conf 或虚拟主机配置中定义映射,指定脚本路径和参数,然后在 rewriterule 中使用 ${mapname:key|default} 语法触发执行。该机制会在请求处理时启动脚本进程,传入键值并读取标准输出作为重写结果。

如何配置 prg 类型的 RewriteMap 并绑定到规则
配置过程分为两步:先声明映射,再在规则中引用。需要在 或主配置块中使用 RewriteMap 指令,设置名称、prg: 前缀和脚本绝对路径。随后在 RewriteRule 的替换部分使用 ${map_name:input} 格式。Apache 会缓存脚本进程以提高性能,首次访问时启动,后续复用。

# httpd.conf or vhost config
RewriteEngine On
RewriteMap myscript prg:/usr/local/bin/my_rewrite_script.sh
# Example rule
RewriteRule ^/api/(.*)$ ${myscript:$1} [P,L]
上述配置中,myscript 是映射名称,/usr/local/bin/my_rewrite_script.sh 是外部脚本路径。当请求匹配 /api/.* 时,Apache 将 URL 中的捕获组(如 $1)作为输入传递给脚本。脚本必须从标准输出返回目标 URL 或空值。若脚本无输出,则使用默认行为或保持原 URL。注意脚本需有执行权限,且路径必须是绝对的。
外部脚本需要遵循什么输入输出规范
外部脚本必须接受一个命令行参数作为输入键,并将处理结果写入标准输出。每行输入对应一次重写查询,脚本应逐行处理并立即输出结果。如果某个键没有对应的重写目标,脚本应输出空行或特定标记,Apache 会根据配置决定如何处理。脚本语言不限,但必须能正确解析输入并输出有效的 URL 或重定向地址。
通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。

#!/bin/bash
# /usr/local/bin/my_rewrite_script.sh
while IFS= read -r key; do
case "$key" in
user1) echo "/home/user1" ;;
user2) echo "/home/user2" ;;
*) echo "" ;;
esac
done
这个 Bash 脚本演示了基本的输入输出模式。它通过 while read 循环读取每一行输入,根据键值匹配不同的输出路径。对于未定义的键,输出空字符串,表示不进行重写。脚本必须确保输出格式正确,每行一个结果,与输入行一一对应。此外,脚本应避免产生错误信息到标准输出,以免干扰 Apache 的重写逻辑。测试时可使用 echo "user1" | /usr/local/bin/my_rewrite_script.sh 验证输出是否符合预期。
当外部脚本返回空值时 Apache 如何处理
当外部脚本对某个键返回空值时,Apache 不会执行重写,而是保留原始请求 URI。这意味着 RewriteRule 的替换部分被忽略,请求继续按原有流程处理。这种行为适用于某些键不需要重写的场景,例如白名单或静态资源。开发者可以通过检查脚本输出是否为空来判断是否触发了重写。若希望空值时执行其他操作,可以在 RewriteRule 中添加额外的条件或使用 [N] 标志进行循环处理,但需谨慎避免无限循环。










