http_build

描述

string http_build_query ( array formdata [, string numeric_prefix] )

使用給出的關聯（或下標）陣列建立一個 url-encoded 請求字串。參數 formdata 可以是陣列或包括屬性的對象。一個 formdata 陣列可以是簡單的一維結構，也可以是由陣列組成的陣列（其依次可以包括其它陣列）。若果在基礎陣列中使用了數字下標同時給出了 numeric_prefix 參數，此參數值將會作為基礎陣列中的數字下標元素的前綴。這是為了讓 PHP 或其它 CGI 程式在稍後對資料進行解碼時取得合法的變量名。

例子 1. http_build_query() 使用示例


<?php
$data = array('foo'=>'bar',
              'baz'=>'boom',
              'cow'=>'milk',
              'php'=>'hypertext processor');
              
echo http_build_query($data);
/* 輸出：
      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);
/* 輸出：
      0=foo&1=bar&2=baz&3=boom&cow=milk&php=hypertext+processor
 */
 
echo http_build_query($data, 'myvar_');
/* 輸出：
      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'=>'Bob Smith',
                            '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[name]=Bob+Smith&user[age]=47&user[sex]=M&user[dob]=5%1F12%1F1956&
      pastimes[0]=golf&pastimes[1]=opera&pastimes[2]=poker&pastimes[3]=rap&
      children[bobby][age]=12&children[bobby][sex]=M&children[sally][age]=8&
      children[sally][sex]=F&flags_0=CEO

   注意：只有基礎陣列中的數字下標元素「CEO」才取得了前綴，其它數字下標元素（如
   pastimes 下的元素）則不需要為了合法的變量名而加上前綴。
 */
?>

例子 4. http_build_query() 使用物件


<?php
class myClass {
  var $foo;
  var $baz;
  
  function myClass() {
    $this->foo = 'bar';
    $this->baz = 'boom';
  }
}

$data = new myClass();

echo http_build_query($data);
/* 輸出：
      foo=bar&baz=boom
 */
?>

參見：parse_str()、parse_url()、urlencode() 和 array_walk()