http_build_url

(PECL pecl_http >= 0.21.0)

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

参考