PHP Velho Oeste 2024

http_build_url

(PECL pecl_http >= 0.21.0)

http_build_urlURL を組み立てる

説明

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=c

参考

add a note add a note

User Contributed Notes 3 notes

up
12
zlatko dot zlatev at gmail dot com
9 years ago
pecl_http 2+ won't provide http_ functions any more. They moved to Http namespace, sadly no backwards compat.

To sum it up - As of pecl_http >=2.0.0 this is no longed available. Also pecl_http 1.7.6 will work only for PHP <=5.5. For PHP 5.6 we are forced to use version pecl_http 2.0.6+
up
4
pasafama at gmail dot com
9 years ago
It seems to me that the return value must always have a protocol, a host and a path. If they are not provided in the input, default values are added.

From what I saw, the default value for the protocol is 'http://', for the host is the hostname (if running from cli) or the variable $_SERVER['HTTP_HOST'], for the path is the variable $_SERVER['SCRIPT_NAME']
up
1
Jaguar
6 years ago
The class that replaces the functionality of this function is "http\Url".

The official decomentation can be found at: https://mdref.m6w6.name/http/Url
To Top