PHP调用Strapi API遇方括号编码500错误，无需CURL如何解决？

不用CURL的可行方案 #

1. 手动拼接查询字符串 #

直接构造包含原生方括号的查询参数，仅对参数值做URL编码，完全绕过http_build_query的自动编码逻辑：

$baseUrl = 'https://你的Strapi实例地址/api/users';
$filterParams = [
    'filters[username][$eq]' => 'John',
    'filters[age][$gte]' => 18
];

// 手动拼接键值对，仅编码参数值
$queryParts = [];
foreach ($filterParams as $key => $value) {
    $queryParts[] = $key . '=' . urlencode($value);
}
$queryString = implode('&', $queryParts);

// 拼接完整URL后发起请求
$fullUrl = $baseUrl . '?' . $queryString;

$client = new \GuzzleHttp\Client();
$response = $client->get($fullUrl);

2. 直接给Guzzle传递已构造好的查询字符串 #

Guzzle的withQuery方法可以直接设置完整的查询字符串，不会再对其进行编码，完美适配Strapi的语法要求：

use GuzzleHttp\Psr7\Uri;

$baseUri = new Uri('https://你的Strapi实例地址/api/users');
// 直接编写原生的Strapi过滤语法
$queryString = 'filters[username][$eq]=John&filters[age][$gte]=18';

// 将查询字符串合并到目标URI
$targetUri = $baseUri->withQuery($queryString);

$client = new \GuzzleHttp\Client();
$response = $client->get($targetUri);

3. 改造strapi-php-client库 #

如果不想放弃官方推荐的库，找到库中调用http_build_query的代码位置，把自动编码逻辑替换成上面的手动拼接方式。比如把原代码里的：

$encodedQuery = http_build_query($params);

替换为自定义的拼接逻辑，仅编码参数值，保留键里的方括号结构。

为什么相关问题很少见？ #

1. Strapi的主力对接场景是Node.js生态，PHP开发者占比低，遇到这类问题的人数少；
2. 很多PHP开发者习惯手动构造URL，避开了库的自动编码坑，没把问题公开出来；
3. 部分人会误以为是Strapi配置错误，而非编码问题，排查方向出现偏差。

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