http_build_str
Hyperwave API
HTTP Functions
PHP Manual

# http_build_url

(PECL pecl_http >= 0.21.0)

http_build_url — Build a URL

### Description

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

Build a URL.

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

### Parameters

`url`

  (part(s) of) a 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=c

### See Also

- parse_url() - Parse a URL and return its components
- http_build_str() - Build query string

http_build_str
Hyperwave API
HTTP Functions
PHP Manual