使用PHP cURL与Cloudant执行范围查询时出现Bad Request错误

你遇到的问题核心是URL中的特殊字符没有进行编码，方括号[、]和空格都是URL的保留字符，直接拼接在请求URL里会导致Cloudant无法正确解析你的查询参数，从而返回Bad Request错误。单个日期值没有特殊字符，所以能正常工作。

下面是具体的解决步骤和优化后的代码：

1. 对查询参数进行URL编码 #

PHP中可以使用urlencode()函数对包含特殊字符的查询字符串进行编码，确保所有保留字符都被转换成URL安全的格式。

2. 修正后的代码示例 #

<?php
// 定义范围查询字符串
$urlstuff = "[20180110 TO 20180119]";
// 对查询参数进行URL编码
$encodedQuery = urlencode($urlstuff);

// 拼接完整URL，使用编码后的查询参数（注意移除认证部分多余的点）
$url = "https://user:pass@user.cloudant.com/db/_design/date/_search/by_date?q=" . $encodedQuery . "&include_docs=true&limit=200";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
// 添加这个选项，让curl_exec返回结果而非直接输出到浏览器
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 可选：开启错误捕获，方便排查问题
curl_setopt($ch, CURLOPT_FAILONERROR, true);

$output = curl_exec($ch);

// 检查请求是否成功
if ($output === false) {
    echo "cURL Error: " . curl_error($ch);
} else {
    // 处理返回的JSON结果
    $result = json_decode($output, true);
    print_r($result);
}

curl_close($ch);
?>

额外注意事项 #

• 确认你的Cloudant搜索索引by_date中，doc.datequery字段的格式是可排序的（你用的YYYYMMDD字符串格式完全没问题，因为字符串排序逻辑和日期排序逻辑一致）。
• 注意URL认证部分的格式，你原来的URL里多了一个.，正确格式应该是https://user:pass@user.cloudant.com，不要写成pass.@。

内容的提问来源于stack exchange，提问作者Eric Mitjans