PHP: parse_url - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

rawurldecode http_build_query

Last updated: Sat, 27 Jan 2007

view this page in

# parse_url

(PHP 3, PHP 4, PHP 5)

parse_url -- Parse a URL and return its components

## Описание

mixed parse_url ( string url [, int component] )

This function parses a URL and returns an associative array containing any of the various components of the URL that are present.

This function is not meant to validate the given URL, it only breaks it up into the above listed parts. Partial URLs are also accepted, parse_url() tries its best to parse them correctly.

## Список параметров

`url`

  The URL to parse

`component`

  Specify one of `PHP_URL_SCHEME`, `PHP_URL_HOST`, `PHP_URL_PORT`, `PHP_URL_USER`, `PHP_URL_PASS`, `PHP_URL_PATH`, `PHP_URL_QUERY` or `PHP_URL_FRAGMENT` to retrieve just a specific URL component as a string.

## Возвращаемые значения

On seriously malformed URLs, parse_url() may return `FALSE` and emit a `E_WARNING`. Otherwise an associative array is returned, whose components may be (at least one):

- `scheme` - e.g. http

- `host`

- `port`

- `user`

- `pass`

- `path`

- `query` - after the question mark `?`

- `fragment` - after the hashmark `#`

If the `component` parameter is specified a string is returned instead of an array.

## Список изменений

Версия | Описание
--- | ---
5.1.2 | Added the `component` parameter

## Примеры

Пример 1. A parse_url() example

`<?php $url = 'http://username:password@hostname/path?arg=value#anchor'; print_r(parse_url($url)); echo parse_url($url, PHP_URL_PATH); ?>`

Результат выполнения данного примера:

    Array
    (
        [scheme] => http
        [host] => hostname
        [user] => username
        [pass] => password
        [path] => /path
        [query] => arg=value
        [fragment] => anchor
    )
    /path

## Примечания

> Замечание: This function doesn't work with relative URLs.

> Замечание: parse_url() is intended specifically for the purpose of parsing URLs and not URIs. However, to comply with PHP's backwards compatibility requirements it makes an exception for the file:// scheme where tripple slashes (file:///...) are allowed. For any other scheme this is invalid.

## Смотрите также

pathinfo()
parse_str()
http_build_query()
dirname()
basename()

add a note User Contributed Notes
parse_url
alistair at 21degrees dot com dot au
23-Oct-2006 07:21
`Heres a simple function to add the $component option in for PHP4. Haven't done exhaustive testing, but should work ok.
<?php
## Defines only available in PHP 5, created for PHP4
if(!defined('PHP_URL_SCHEME')) define('PHP_URL_SCHEME', 1);
if(!defined('PHP_URL_HOST')) define('PHP_URL_HOST', 2);
if(!defined('PHP_URL_PORT')) define('PHP_URL_PORT', 3);
if(!defined('PHP_URL_USER')) define('PHP_URL_USER', 4);
if(!defined('PHP_URL_PASS')) define('PHP_URL_PASS', 5);
if(!defined('PHP_URL_PATH')) define('PHP_URL_PATH', 6);
if(!defined('PHP_URL_QUERY')) define('PHP_URL_QUERY', 7);
if(!defined('PHP_URL_FRAGMENT')) define('PHP_URL_FRAGMENT', 8);
function parse_url_compat($url, $component=NULL){
if(!$component) return parse_url($url);
## PHP 5
if(phpversion() >= 5)
return parse_url($url, $component);
## PHP 4
$bits = parse_url($url);
switch($component){
case PHP_URL_SCHEME: return $bits['scheme'];
case PHP_URL_HOST: return $bits['host'];
case PHP_URL_PORT: return $bits['port'];
case PHP_URL_USER: return $bits['user'];
case PHP_URL_PASS: return $bits['pass'];
case PHP_URL_PATH: return $bits['path'];
case PHP_URL_QUERY: return $bits['query'];
case PHP_URL_FRAGMENT: return $bits['fragment'];
}
}
?>`
dawalama at gmail dot com
04-Oct-2006 09:48
`With few modifications
/**
* source: http://us2.php.net/manual/en/function.parse-url.php#60237
* Edit the Query portion of an url
*
* @param string $action ethier a "+" or a "-" depending on what action you want to perform
* @param mixed $var array (+) or string (-)
* @param string $uri the URL to use. if this is left out, it uses $_SERVER['PHP_SELF']
* @version 1.0.0
*/
function change_query($action, $var = NULL, $uri = NULL) {
if (($action == "+" && !is_array($var)) || ($action == "-" && $var == "") || $var == NULL) {
return FALSE;
}
if (is_null($uri)) { //Piece together uri string
$beginning = $_SERVER['PHP_SELF'];
$ending = (isset ($_SERVER['QUERY_STRING'])) ? $_SERVER['QUERY_STRING'] : '';
} else {
$qstart = strpos($uri, '?');
if ($qstart === false) {
$beginning = $uri; //$ending is '' anyway
$ending = "";
} else {
$beginning = substr($uri, 0, $qstart);
$ending = substr($uri, $qstart);
}
}
$vals = array ();
$ending = str_replace('?', '', $ending);
parse_str($ending, $vals);
switch ($action) {
case '+' :
$vals[$var[0]] = $var[1];
break;
case '-' :
if (isset ($vals[$var])) {
unset ($vals[$var]);
}
break;
default :
break;
}
$params = array();
foreach ($vals as $k => $value) {
$params[] = $k."=".urlencode($value);
}
$result = $beginning . (count($params) ? '?' . implode("&", $params) : '');
return $result;
}`
kjensen at nospam dot iaff106 dot com
26-Sep-2006 04:21
`Here is a simple extended version of ParseURL().
I needed to make a link that will be saved off site but point to different file
than the one creating the link.
So I needed to get the path without the file name so I could change the
file name.
Here it is:
<?php
function ParseURLplus($url){
$URLpcs = (parse_url($url));
$PathPcs = explode("/",$URLpcs['path']);
$URLpcs['file'] = end($PathPcs);
unset($PathPcs[key($PathPcs)]);
$URLpcs['dir'] = implode("/",$PathPcs);
return ($URLpcs);
}
$url = 'http://username:password@hostname/path/directory/file.php?arg=
value#anchor';
$URLpcs = ParseURLplus($url);
print_r($URLpcs);
?>
Now I can change the $URLpcs['file'] and then glue itback together to make
a new url.`
corgilabs at SPAM_NO_THANK_YOUgmail dot com
13-Jul-2006 11:59
`I hope this is helpful! Cheers!
-eo
<?
# Author: Eric O
# Date: July 13, 2006
# Go Zizou!! :O)
# Creating Automatic Self-Redirect To Secure Version
# of Website as Seen on Paypal and other secure sites
# Changes HTTP to HTTPS
#gets the URI of the script
$url = $_SERVER['SCRIPT_URI'];
#chops URI into bits BORK BORK BORK
$chopped = parse_url($url);
#HOST and PATH portions of your final destination
$destination = $chopped[host].$chopped[path];
#if you are not HTTPS, then do something about it
if($chopped[scheme] != "https"){
#forwards to HTTP version of URI with secure certificate
header("Location: https://$destination");
exit();
}
?>`
php dot net at NOSPAM dot juamei dot com
09-May-2006 04:18
`Modfied version of glue_url to avoid error messages if the error_reporting is set high.
function glue_url($parsed)
{
if (! is_array($parsed)) return false;
$uri = isset($parsed['scheme']) ? $parsed['scheme'].':'.((strtolower($parsed['scheme']) == 'mailto') ? '':'//'): '';
$uri .= isset($parsed['user']) ? $parsed['user'].($parsed['pass']? ':'.$parsed['pass']:'').'@':'';
$uri .= isset($parsed['host']) ? $parsed['host'] : '';
$uri .= isset($parsed['port']) ? ':'.$parsed['port'] : '';
$uri .= isset($parsed['path']) ? $parsed['path'] : '';
$uri .= isset($parsed['query']) ? '?'.$parsed['query'] : '';
$uri .= isset($parsed['fragment']) ? '#'.$parsed['fragment'] : '';
return $uri;
}`
TheShadow
30-Dec-2004 12:36
`You may want to check out the PEAR NET_URL class. It provides easy means to manipulate URL strings.
http://pear.php.net/package/Net_URL`
matt at cryptography dot com
09-May-2004 01:36
`Modified version of glue_url()
Cox's,Anonimous fucntion
<?php
function glue_url($parsed) {
if (! is_array($parsed)) return false;
$uri = $parsed['scheme'] ? $parsed['scheme'].':'.((strtolower($parsed['scheme']) == 'mailto') ? '':'//'): '';
$uri .= $parsed['user'] ? $parsed['user'].($parsed['pass']? ':'.$parsed['pass']:'').'@':'';
$uri .= $parsed['host'] ? $parsed['host'] : '';
$uri .= $parsed['port'] ? ':'.$parsed['port'] : '';
$uri .= $parsed['path'] ? $parsed['path'] : '';
$uri .= $parsed['query'] ? '?'.$parsed['query'] : '';
$uri .= $parsed['fragment'] ? '#'.$parsed['fragment'] : '';
return $uri;
}
?>`
add a note
rawurldecode http_build_query

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 10:36:09 2007 PST