Caddy服务器新增prefixed_query占位符支持带问号的完整查询字符串

在Caddy服务器的开发过程中，社区成员提出了一个实用的功能需求：希望能够获取包含前导问号(?)的完整查询字符串。这个功能在2024年12月2日通过PR#6714被正式实现并合并到主分支中。

功能背景

在Web服务器配置中，经常需要处理URL重定向时保留原始查询字符串的场景。传统的{query}占位符只能获取查询参数部分，而不包含前导的问号。这在某些重定向配置中会导致不够优雅的URL结构。

例如，当需要将domain.tld/path重定向到anotherdomain.tld并保留查询字符串时：

• 使用{query}会丢失问号
• 直接添加?会导致在没有查询参数时也显示问号

解决方案

Caddy团队新增了{prefixed_query}占位符来解决这个问题。这个占位符的行为特点是：

1. 当存在查询字符串时，返回带前导问号的完整查询部分（如?key=value）
2. 当查询字符串不存在时，返回空字符串

技术实现细节

在Caddy的HTTP模块中，这个功能是通过扩展现有的占位符系统实现的。核心逻辑包括：

1. 检查请求URI中是否存在查询部分
2. 如果存在，则返回带问号的完整查询字符串
3. 如果不存在，则返回空字符串

使用场景示例

这个功能特别适用于以下场景：

1. 跨域重定向时保留完整查询参数
2. 构建包含查询参数的完整URL
3. 日志记录完整的请求信息

配置示例

在Caddyfile中使用这个新占位符非常简单：

example.com {
    redir /oldpath http://newdomain.com{prefixed_query}
}

这个配置会将example.com/oldpath?param=value重定向到http://newdomain.com?param=value，而如果没有查询参数，则只会重定向到http://newdomain.com。

兼容性考虑

新占位符与现有{query}占位符完全兼容，开发者可以根据具体需求选择使用哪个占位符。对于只需要参数部分的情况，继续使用{query}；需要完整查询字符串时，使用{prefixed_query}。

这个功能的添加体现了Caddy团队对开发者体验的重视，通过提供更灵活的占位符来简化常见配置场景。