http_build_query 函數如何處理複雜的嵌套數組結構？有什麼技巧？

gitbox 2025-09-20

<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 這部分是與文章內容無關的PHP代碼示例</span></span><span>
</span><span><span class="hljs-variable">$example</span></span><span> = [</span><span><span class="hljs-string">"title"</span></span><span> => </span><span><span class="hljs-string">"PHP Article"</span></span><span>, </span><span><span class="hljs-string">"date"</span></span><span> => </span><span><span class="hljs-title function_ invoke__">date</span></span><span>(</span><span><span class="hljs-string">"Y-m-d"</span></span><span>)];
</span><span><span class="hljs-title function_ invoke__">print_r</span></span><span>(</span><span><span class="hljs-variable">$example</span></span><span>);

</span><span><span class="hljs-meta">?></span></span><span>

<hr>

</span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 正文開始</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"<h1>http_build_query 函數如何處理複雜的嵌套數組結構？有什麼技巧？</h1>"</span></span><span>;

</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"<p>在 PHP 中，<code>http_build_query()

' ; echo "

2. 嵌套數組的處理方式

" ; echo "

當數組中包含嵌套數組時， http_build_query()會使用方括號表示層級關係：

" ; echo '

&#39;

; echo '```php $data = [ "user" => [ "name" => "Alice", "email" => "[email protected]" ], "tags" => ["php", "web"] ]; $query = http_build_query($data); echo $query; // 輸出: user%5Bname%5D=Alice&user%5Bemail%5D=alice%40example.com&tags%5B0%5D=php&tags%5B1%5D=web ```' ; echo ' ' ; echo

"可以看到，嵌套數組的鍵會自動轉換為user[name] 、 tags[0]這種形式，並且進行了URL 編碼。

" ; echo "

3. 使用arg_separator和numeric_prefix

" ; echo "

函數原型允許傳入第二個和第三個參數：

" ; echo '

&#39;

; echo '```php http_build_query(array $query_data, string $numeric_prefix = "", string $arg_separator = "&", int $encoding_type = PHP_QUERY_RFC1738): string ```' ; echo ' ' ; echo "

- numeric_prefix ：當數組鍵是數字時，可添加前綴。
- arg_separator ：指定不同參數之間的分隔符（默認&）。

" ; echo "

4. 避免數組嵌套過深的小技巧

" ; echo "

在生成URL 時，如果嵌套層級太深，考慮先使用json_encode()將復雜數組轉換為JSON，再傳遞給後端。
可以通過自定義函數，將多維數組扁平化後再調用http_build_query() ，以避免產生過長的查詢字符串。
使用PHP_QUERY_RFC3986作為encoding_type參數，可以生成符合RFC 3986 標準的URL 編碼，更適合某些API。

" ; echo "

5. 示例：扁平化處理嵌套數組

" ; echo '

&#39;

; echo '```php function flatten_array($array, $prefix = "") { $result = []; foreach ($array as $key => $value) { $new_key = $prefix === "" ? $key : $prefix . "[" . $key . "]"; if (is_array($value)) { $result = array_merge($result, flatten_array($value, $new_key)); } else { $result[$new_key] = $value; } } return $result; } $data = [ "user" => ["name" => "Alice", "email" => "[email protected]"], "tags" => ["php", "web"] ]; $query = http_build_query(flatten_array($data)); echo $query; // 輸出: user[name]=Alice&user[email][email protected]&tags[0]=php&tags[1]=web ```' ; echo ' ' ; echo "

通過扁平化數組，我們可以更靈活地控制最終的查詢字符串格式。

" ; echo "

總結

" ; echo "

http_build_query()是處理URL 查詢參數的強大工具，但在處理複雜嵌套數組時，需要理解它的編碼方式。必要時，可以使用扁平化、JSON 或調整編碼方式來保證數據傳遞的正確性和可讀性。

" ; ?>