# http_build_url

(PECL pecl_http:0.21.0-1.5.5)

http_build_url — Build an URL

### Description

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

Build an URL.

The parts of the second URL will be merged into the first according to the flags argument.

### Parameters

`url`

  (part(s) of) an URL in form of a string or associative array like parse_url() returns

`parts`

  same as the first argument

`flags`

  a bitmask of binary or'ed HTTP_URL constants; `HTTP_URL_REPLACE` is the default

`new_url`

  if set, it will be filled with the parts of the composed url like parse_url() would return

### Return Values

Returns the new URL as string on success or `FALSE` on failure.

### Examples

Example#1 A http_build_url() example

`<?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
);
?>`

The above example will output:

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

### See Also

- parse_url()
- http_build_str()