update : 2015.11.03
php.shukuma.com

검색:
 
 
URL 인코드한 쿼리 문자열 생성
URL 함수 목록
PHP Manual

http_build_query

(PHP 5)

http_build_query — URL 인코드한 쿼리 문자열 생성

설명

string http_build_query ( array $formdata [, string $numeric_prefix [, string $arg_separator ]] )

주어진 연관(혹은 인덱스) 배열에서 URL 인코드한 쿼리 문자열을 생성합니다.

인수

formdata

속성을 가지는 배열이나 객체.

배열 형식은 간단한 1차원 구조나, 배열의 배열(다른 배열을 포함한 배열)일 수 있습니다.

numeric_prefix

기반 배열에 숫자 인덱스가 사용되고 이 인수가 주어지면, 이 인수가 기반 배열의 숫자 인덱스 앞에 덧붙여집니다.

이는 데이터가 PHP에서 디코드되거나 다른 CGI 어플리케이션을 사용할 때 적합한 변수명을 가지도록 해줍니다.

arg_separator

이 인수가 주어지지 않으면, arg_separator.output을 사용합니다.

반환값

URL 인코드한 문자열을 반환합니다.

변경점

버전 설명
5.1.2 arg_separator 인수 추가.
5.1.3 대괄호를 이스케이프 합니다.

예제

Example #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
echo http_build_query($data, '', '&amp;'); // foo=bar&amp;baz=boom&amp;cow=milk&amp;php=hypertext+processor
?>

Example #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
mybar_0=foo&mybar_1=bar&mybar_2=baz&mybar_3=boom&cow=milk&php=hypertext+processor

Example #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%5Bname%5D=Bob+Smith&user%5Bage%5D=47&user%5Bsex%5D=M&
user%5Bdob%5D=5%1F12%1F1956&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

Note:

기본 배열의 숫자 인덱스 요소인 "CEO"만이 전치사를 가집니다. 내부에 존재하는 다른 숫자 인덱스는, 적합한 변수명을 가지기 위한 문자열 전치사가 필요하지 않습니다.

Example #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

?>

참고

URL 함수 목록
PHP Manual