http_build_url

(no version information, might be only in CVS)

http_build_url -- URL を組み立てる

説明

string http_build_url ( [mixed url [, mixed parts [, int flags = HTTP_URL_REPLACE [, array &new_url]]]] )

URL を組み立てます。

引数 flag の設定によっては、二番目の URL の一部が最初の URL に統合されます。

パラメータ

url

文字列形式、あるいは parse_url() の返すような連想配列形式で表した、URL (の一部)。

parts

最初の引数と同じ。

flags

HTTP_URL 定数 の論理和からなるビットマスク。デフォルトは HTTP_URL_REPLACE です。

new_url

設定されている場合は、parse_url() が返すような構築された URL の一部が格納されます。

返り値

成功した場合に新しい URL を表す文字列、失敗した場合に FALSE を返します。

例 1. http_build_url() の例

<?php
echo http_build_url("http://user@www.example.com/pub/index.php?a=b#files",
    array(
        
"scheme" => "ftp",
        
"host" => "ftp.example.com",
        
"path" => "files/current/",
        
"query" => "a=c"
    
),
    
HTTP_URL_STRIP_AUTH | HTTP_URL_JOIN_PATH | HTTP_URL_JOIN_QUERY | HTTP_URL_STRIP_FRAGMENT
);
?>

上の例の出力は以下となります。

ftp://ftp.example.com/pub/files/current/?a=b&a=c