PHP - URL http_build_query() 函式

---

---

PHP URL http_build_query() 函式用於根據提供的關聯（或索引）陣列生成 URL 編碼的查詢字串。當您需要建立帶有查詢引數的 URL 時，此函式非常有用。

語法

以下是 PHP URL http_build_query() 函式的語法：

string http_build_query( 
   mixed $query_data [, string $numeric_prefix [, string $arg_separator [, 
      int $enc_type = PHP_QUERY_RFC1738 ]]
   ] 
)

引數

以下是 http_build_query() 函式的引數：

• $query_data − 要轉換的陣列或查詢字串。

• $numeric_prefix − 要新增到查詢字串中數字鍵的字首。

• $arg_separator − 用於在查詢字串中引數之間使用的分隔符。預設值為 "&"

• $enc_type − 編碼型別。預設值為 PHP_QUERY_RFC1738。

返回值

http_build_query() 函式返回一個 URL 編碼的字串。

PHP 版本

http_build_query() 函式首次引入到核心 PHP 5 中，並在 PHP 7 和 PHP 8 中繼續輕鬆執行。

示例 1

這是一個 PHP URL http_build_query() 函式的基本示例，用於根據給定陣列生成 URL 編碼的字串。

<?php
   $data = array(
      "foo" => "bar",
      "baz" => "boom",
      "cow" => "milk",
      "php" => "hypertext processor"
   );

   echo http_build_query($data) . "\n";
   echo http_build_query($data, '', '&');
?>

輸出

以上程式碼將產生類似以下的結果：

foo=bar&baz=boom&cow=milk&php=hypertext+processor
foo=bar&baz=boom&cow=milk&php=hypertext+processor

示例 2

此示例演示瞭如何使用 http_build_query() 方法處理同時具有數字鍵和關聯鍵的陣列。它還展示瞭如何為數字鍵新增字首。

<?php
   $data = array("foo", "bar", "baz", "boom", "cow" => "milk", "php" => "hypertext processor");

   echo http_build_query($data) . "\n";
   echo http_build_query($data, 'myvar_');
?>

輸出

執行以上程式後，它將生成以下輸出：

0=foo&1=bar&2=baz&3=boom&cow=milk&php=hypertext+processor
myvar_0=foo&myvar_1=bar&myvar_2=baz&myvar_3=boom&cow=milk&php=hypertext+processor

示例 3

此示例展示瞭如何使用巢狀陣列（表示複雜資料結構）與 http_build_query() 函式一起使用。

<?php
   $data = array(
      "user" => array(
         "name" => "Amit Sharma",
         "age"  => 47,
         "sex"  => "M",
         "dob"  => "5/12/1956"
      ),
      "pastimes" => array("golf", "opera", "poker", "rap"),
      "children" => array(
         "bobby" => array("age"=>12, "sex"=>"M"),
         "sally" => array("age"=>8, "sex"=>"F")
      ),
      "CEO"
   );
   echo http_build_query($data, "flags_");
?>

輸出

這將生成以下輸出：

user%5Bname%5D=Amit+Sharma&user%5Bage%5D=47&user%5Bsex%5D=M&user%5Bdob%5D=5%2F12%2F1956&pastimes%5B0%5D=golf&pastimes%5B1%5D=opera&pastimes%5B2%5D=poker&pastimes%5B3%5D=rap&children%5Bbobby%5D%5Bage%5D=12&children%5Bbobby%5D%5Bsex%5D=M&children%5Bsally%5D%5Bage%5D=8&children%5Bsally%5D%5Bsex%5D=F&flags_0=CEO

示例 4

這個具有挑戰性的示例展示了 http_build_query() 函式如何處理具有公有、受保護和私有屬性的物件。

<?php
   class parentClass {
      public $pub = "publicParent";
      protected $prot = "protectedParent";
      private $priv = "privateParent";
      public $pub_bar = Null;
      protected $prot_bar = Null;
      private $priv_bar = Null;

      public function __construct(){
         $this->pub_bar  = new childClass();
         $this->prot_bar = new childClass();
         $this->priv_bar = new childClass();
      }
   }
   class childClass {
      public $pub = "publicChild";
      protected $prot = "protectedChild";
      private $priv = "privateChild";
   }
   $parent = new parentClass();
   echo http_build_query($parent);
?>

輸出

執行以上程式時，它將產生以下輸出：

pub=publicParent&pub_bar%5Bpub%5D=publicChild