Web aym.pekori.to

http_build_query

(PHP 5)

http_build_query -- URL エンコードされたクエリ文字列を生成する

説明

string http_build_query ( array formdata [, string numeric_prefix] )

与えられた連想配列 (もしくは添字配列) から URL エンコードされたクエリ文字列を生成します。formdata にはプロパティを含む配列もしくはオブジェクトを指定可能です。 formdata 配列には単純は一次元構造、 もしくは配列の配列 (言い換えると、他の配列を含む配列) を指定します。 もし数値インデックスが基底となる配列に使用されたり numeric_prefix が指定された場合、 基底となる配列の要素に対する数値インデックスの前に追加されます。 この関数はデータが後で PHP や他の CGI アプリケーションによってデコードされる際、 正当な変数名になるよう考慮します。

注意: arg_separator.output が区分のためのセパレータとして使用されます。

例 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%2F12%2F1956&
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() も参照ください。