WebSVN – Applications.framework – Diff – /trunk/framework/Net_URL2.php


<?php
// +-----------------------------------------------------------------------+
// | Copyright (c) 2007-2008, Christian Schmidt, Peytz & Co. A/S           |
// | All rights reserved.                                                  |
// |                                                                       |
// | Redistribution and use in source and binary forms, with or without    |
// | modification, are permitted provided that the following conditions    |
// | are met:                                                              |
// |                                                                       |
// | o Redistributions of source code must retain the above copyright      |
// |   notice, this list of conditions and the following disclaimer.       |
// | o Redistributions in binary form must reproduce the above copyright   |
// |   notice, this list of conditions and the following disclaimer in the |
// |   documentation and/or other materials provided with the distribution.|
// | o The names of the authors may not be used to endorse or promote      |
// |   products derived from this software without specific prior written  |
// |   permission.                                                         |
// |                                                                       |
// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS   |
// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT     |
// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
// | A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT  |
// | OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
// | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT      |
// | LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
// | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
// | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT   |
// | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
// | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.  |
// |                                                                       |
// +-----------------------------------------------------------------------+
// | Author: Christian Schmidt <schmidt at php dot net>                    |
// +-----------------------------------------------------------------------+
//
// $Id: Net_URL2.php 80 2009-08-27 07:30:42Z jpm $
//
// Net_URL2 Class (PHP5 Only)
 
// This code is released under the BSD License - http://www.opensource.org/licenses/bsd-license.php
/**
 * @license BSD License
 */
class Net_URL2
{
    /**
     * Do strict parsing in resolve() (see RFC 3986, section 5.2.2). Default
     * is true.
     */
    const OPTION_STRICT           = 'strict';
 
    /**
     * Represent arrays in query using PHP's [] notation. Default is true.
     */
    const OPTION_USE_BRACKETS     = 'use_brackets';
 
    /**
     * URL-encode query variable keys. Default is true.
     */
    const OPTION_ENCODE_KEYS      = 'encode_keys';
 
    /**
     * Query variable separators when parsing the query string. Every character
     * is considered a separator. Default is specified by the
     * arg_separator.input php.ini setting (this defaults to "&").
     */
    const OPTION_SEPARATOR_INPUT  = 'input_separator';
 
    /**
     * Query variable separator used when generating the query string. Default
     * is specified by the arg_separator.output php.ini setting (this defaults
     * to "&").
     */
    const OPTION_SEPARATOR_OUTPUT = 'output_separator';
 
    /**
     * Default options corresponds to how PHP handles $_GET.
     */
    private $options = array(
        self::OPTION_STRICT           => true,
        self::OPTION_USE_BRACKETS     => true,
        self::OPTION_ENCODE_KEYS      => true,
        self::OPTION_SEPARATOR_INPUT  => 'x&',
        self::OPTION_SEPARATOR_OUTPUT => 'x&',
        );
 
    /**
     * @var  string|bool
     */
    private $scheme = false;
 
    /**
     * @var  string|bool
     */
    private $userinfo = false;
 
    /**
     * @var  string|bool
     */
    private $host = false;
 
    /**
     * @var  int|bool
     */
    private $port = false;
 
    /**
     * @var  string
     */
    private $path = '';
 
    /**
     * @var  string|bool
     */
    private $query = false;
 
    /**
     * @var  string|bool
     */
    private $fragment = false;
 
    /**
     * @param string $url     an absolute or relative URL
     * @param array  $options
     */
    public function __construct($url, $options = null)
    {
        $this->setOption(self::OPTION_SEPARATOR_INPUT,
                         ini_get('arg_separator.input'));
        $this->setOption(self::OPTION_SEPARATOR_OUTPUT,
                         ini_get('arg_separator.output'));
        if (is_array($options)) {
            foreach ($options as $optionName => $value) {
                $this->setOption($optionName);
            }
        }
 
        if (preg_match('@^([a-z][a-z0-9.+-]*):@i', $url, $reg)) {
            $this->scheme = $reg[1];
            $url = substr($url, strlen($reg[0]));
        }
 
        if (preg_match('@^//([^/#?]+)@', $url, $reg)) {
            $this->setAuthority($reg[1]);
            $url = substr($url, strlen($reg[0]));
        }
 
        $i = strcspn($url, '?#');
        $this->path = substr($url, 0, $i);
        $url = substr($url, $i);
 
        if (preg_match('@^\?([^#]*)@', $url, $reg)) {
            $this->query = $reg[1];
            $url = substr($url, strlen($reg[0]));
        }
 
        if ($url) {
            $this->fragment = substr($url, 1);
        }
    }
 
    /**
     * Returns the scheme, e.g. "http" or "urn", or false if there is no
     * scheme specified, i.e. if this is a relative URL.
     *
     * @return  string|bool
     */
    public function getScheme()
    {
        return $this->scheme;
    }
 
    /**
     * @param string|bool $scheme
     *
     * @return void
     * @see    getScheme()
     */
    public function setScheme($scheme)
    {
        $this->scheme = $scheme;
    }
 
    /**
     * Returns the user part of the userinfo part (the part preceding the first
     *  ":"), or false if there is no userinfo part.
     *
     * @return  string|bool
     */
    public function getUser()
    {
        return $this->userinfo !== false ? preg_replace('@:.*$@', '', $this->userinfo) : false;
    }
 
    /**
     * Returns the password part of the userinfo part (the part after the first
     *  ":"), or false if there is no userinfo part (i.e. the URL does not
     * contain "@" in front of the hostname) or the userinfo part does not
     * contain ":".
     *
     * @return  string|bool
     */
    public function getPassword()
    {
        return $this->userinfo !== false ? substr(strstr($this->userinfo, ':'), 1) : false;
    }
 
    /**
     * Returns the userinfo part, or false if there is none, i.e. if the
     * authority part does not contain "@".
     *
     * @return  string|bool
     */
    public function getUserinfo()
    {
        return $this->userinfo;
    }
 
    /**
     * Sets the userinfo part. If two arguments are passed, they are combined
     * in the userinfo part as username ":" password.
     *
     * @param string|bool $userinfo userinfo or username
     * @param string|bool $password
     *
     * @return void
     */
    public function setUserinfo($userinfo, $password = false)
    {
        $this->userinfo = $userinfo;
        if ($password !== false) {
            $this->userinfo .= ':' . $password;
        }
    }
 
    /**
     * Returns the host part, or false if there is no authority part, e.g.
     * relative URLs.
     *
     * @return  string|bool
     */
    public function getHost()
    {
        return $this->host;
    }
 
    /**
     * @param string|bool $host
     *
     * @return void
     */
    public function setHost($host)
    {
        $this->host = $host;
    }
 
    /**
     * Returns the port number, or false if there is no port number specified,
     * i.e. if the default port is to be used.
     *
     * @return  int|bool
     */
    public function getPort()
    {
        return $this->port;
    }
 
    /**
     * @param int|bool $port
     *
     * @return void
     */
    public function setPort($port)
    {
        $this->port = intval($port);
    }
 
    /**
     * Returns the authority part, i.e. [ userinfo "@" ] host [ ":" port ], or
     * false if there is no authority none.
     *
     * @return string|bool
     */
    public function getAuthority()
    {
        if (!$this->host) {
            return false;
        }
 
        $authority = '';
 
        if ($this->userinfo !== false) {
            $authority .= $this->userinfo . '@';
        }
 
        $authority .= $this->host;
 
        if ($this->port !== false) {
            $authority .= ':' . $this->port;
        }
 
        return $authority;
    }
 
    /**
     * @param string|false $authority
     *
     * @return void
     */
    public function setAuthority($authority)
    {
        $this->user = false;
        $this->pass = false;
        $this->host = false;
        $this->port = false;
        if (preg_match('@^(([^\@]+)\@)?([^:]+)(:(\d*))?$@', $authority, $reg)) {
            if ($reg[1]) {
                $this->userinfo = $reg[2];
            }
 
            $this->host = $reg[3];
            if (isset($reg[5])) {
                $this->port = intval($reg[5]);
            }
        }
    }
 
    /**
     * Returns the path part (possibly an empty string).
     *
     * @return string
     */
    public function getPath()
    {
        return $this->path;
    }
 
    /**
     * @param string $path
     *
     * @return void
     */
    public function setPath($path)
    {
        $this->path = $path;
    }
 
    /**
     * Returns the query string (excluding the leading "?"), or false if "?"
     * isn't present in the URL.
     *
     * @return  string|bool
     * @see     self::getQueryVariables()
     */
    public function getQuery()
    {
        return $this->query;
    }
 
    /**
     * @param string|bool $query
     *
     * @return void
     * @see   self::setQueryVariables()
     */
    public function setQuery($query)
    {
        $this->query = $query;
    }
 
    /**
     * Returns the fragment name, or false if "#" isn't present in the URL.
     *
     * @return  string|bool
     */
    public function getFragment()
    {
        return $this->fragment;
    }
 
    /**
     * @param string|bool $fragment
     *
     * @return void
     */
    public function setFragment($fragment)
    {
        $this->fragment = $fragment;
    }
 
    /**
     * Returns the query string like an array as the variables would appear in
     * $_GET in a PHP script.
     *
     * @return  array
     */
    public function getQueryVariables()
    {
        $pattern = '/[' .
                   preg_quote($this->getOption(self::OPTION_SEPARATOR_INPUT), '/') .
                   ']/';
        $parts   = preg_split($pattern, $this->query, -1, PREG_SPLIT_NO_EMPTY);
        $return  = array();
 
        foreach ($parts as $part) {
            if (strpos($part, '=') !== false) {
                list($key, $value) = explode('=', $part, 2);
            } else {
                $key   = $part;
                $value = null;
            }
 
            if ($this->getOption(self::OPTION_ENCODE_KEYS)) {
                $key = rawurldecode($key);
            }
            $value = rawurldecode($value);
 
            if ($this->getOption(self::OPTION_USE_BRACKETS) &&
                preg_match('#^(.*)\[([0-9a-z_-]*)\]#i', $key, $matches)) {
 
                $key = $matches[1];
                $idx = $matches[2];
 
                // Ensure is an array
                if (empty($return[$key]) || !is_array($return[$key])) {
                    $return[$key] = array();
                }
 
                // Add data
                if ($idx === '') {
                    $return[$key][] = $value;
                } else {
                    $return[$key][$idx] = $value;
                }
            } elseif (!$this->getOption(self::OPTION_USE_BRACKETS)
                      && !empty($return[$key])
            ) {
                $return[$key]   = (array) $return[$key];
                $return[$key][] = $value;
            } else {
                $return[$key] = $value;
            }
        }
 
        return $return;
    }
 
    /**
     * @param array $array (name => value) array
     *
     * @return void
     */
    public function setQueryVariables(array $array)
    {
        if (!$array) {
            $this->query = false;
        } else {
            foreach ($array as $name => $value) {
                if ($this->getOption(self::OPTION_ENCODE_KEYS)) {
                    $name = rawurlencode($name);
                }
 
                if (is_array($value)) {
                    foreach ($value as $k => $v) {
                        $parts[] = $this->getOption(self::OPTION_USE_BRACKETS)
                            ? sprintf('%s[%s]=%s', $name, $k, $v)
                            : ($name . '=' . $v);
                    }
                } elseif (!is_null($value)) {
                    $parts[] = $name . '=' . $value;
                } else {
                    $parts[] = $name;
                }
            }
            $this->query = implode($this->getOption(self::OPTION_SEPARATOR_OUTPUT),
                                   $parts);
        }
    }
 
    /**
     * @param string $name
     * @param mixed  $value
     *
     * @return  array
     */
    public function setQueryVariable($name, $value)
    {
        $array = $this->getQueryVariables();
        $array[$name] = $value;
        $this->setQueryVariables($array);
    }
 
    /**
     * @param string $name
     *
     * @return void
     */
    public function unsetQueryVariable($name)
    {
        $array = $this->getQueryVariables();
        unset($array[$name]);
        $this->setQueryVariables($array);
    }
 
    /**
     * Returns a string representation of this URL.
     *
     * @return  string
     */
    public function getURL()
    {
        // See RFC 3986, section 5.3
        $url = "";
 
        if ($this->scheme !== false) {
            $url .= $this->scheme . ':';
        }
 
        $authority = $this->getAuthority();
        if ($authority !== false) {
            $url .= '//' . $authority;
        }
        $url .= $this->path;
 
        if ($this->query !== false) {
            $url .= '?' . $this->query;
        }
 
        if ($this->fragment !== false) {
            $url .= '#' . $this->fragment;
        }
    
        return $url;
    }
 
    /** 
     * Returns a normalized string representation of this URL. This is useful
     * for comparison of URLs.
     *
     * @return  string
     */
    public function getNormalizedURL()
    {
        $url = clone $this;
        $url->normalize();
        return $url->getUrl();
    }
 
    /** 
     * Returns a normalized Net_URL2 instance.
     *
     * @return  Net_URL2
     */
    public function normalize()
    {
        // See RFC 3886, section 6
 
        // Schemes are case-insensitive
        if ($this->scheme) {
            $this->scheme = strtolower($this->scheme);
        }
 
        // Hostnames are case-insensitive
        if ($this->host) {
            $this->host = strtolower($this->host);
        }
 
        // Remove default port number for known schemes (RFC 3986, section 6.2.3)
        if ($this->port &&
            $this->scheme &&
            $this->port == getservbyname($this->scheme, 'tcp')) {
 
            $this->port = false;
        }
 
        // Normalize case of %XX percentage-encodings (RFC 3986, section 6.2.2.1)
        foreach (array('userinfo', 'host', 'path') as $part) {
            if ($this->$part) {
                $this->$part  = preg_replace('/%[0-9a-f]{2}/ie', 'strtoupper("\0")', $this->$part);
            }
        }
 
        // Path segment normalization (RFC 3986, section 6.2.2.3)
        $this->path = self::removeDotSegments($this->path);
 
        // Scheme based normalization (RFC 3986, section 6.2.3)
        if ($this->host && !$this->path) {
            $this->path = '/';
        }
    }
 
    /**
     * Returns whether this instance represents an absolute URL.
     *
     * @return  bool
     */
    public function isAbsolute()
    {
        return (bool) $this->scheme;
    }
 
    /**
     * Returns an Net_URL2 instance representing an absolute URL relative to
     * this URL.
     *
     * @param Net_URL2|string $reference relative URL
     *
     * @return Net_URL2
     */
    public function resolve($reference)
    {
        if (is_string($reference)) {
            $reference = new self($reference);
        }
        if (!$this->isAbsolute()) {
            throw new Exception('Base-URL must be absolute');
        }
 
        // A non-strict parser may ignore a scheme in the reference if it is
        // identical to the base URI's scheme.
        if (!$this->getOption(self::OPTION_STRICT) && $reference->scheme == $this->scheme) {
            $reference->scheme = false;
        }
 
        $target = new self('');
        if ($reference->scheme !== false) {
            $target->scheme = $reference->scheme;
            $target->setAuthority($reference->getAuthority());
            $target->path  = self::removeDotSegments($reference->path);
            $target->query = $reference->query;
        } else {
            $authority = $reference->getAuthority();
            if ($authority !== false) {
                $target->setAuthority($authority);
                $target->path  = self::removeDotSegments($reference->path);
                $target->query = $reference->query;
            } else {
                if ($reference->path == '') {
                    $target->path = $this->path;
                    if ($reference->query !== false) {
                        $target->query = $reference->query;
                    } else {
                        $target->query = $this->query;
                    }
                } else {
                    if (substr($reference->path, 0, 1) == '/') {
                        $target->path = self::removeDotSegments($reference->path);
                    } else {
                        // Merge paths (RFC 3986, section 5.2.3)
                        if ($this->host !== false && $this->path == '') {
                            $target->path = '/' . $this->path;
                        } else {
                            $i = strrpos($this->path, '/');
                            if ($i !== false) {
                                $target->path = substr($this->path, 0, $i + 1);
                            }
                            $target->path .= $reference->path;
                        }
                        $target->path = self::removeDotSegments($target->path);
                    }
                    $target->query = $reference->query;
                }
                $target->setAuthority($this->getAuthority());
            }
            $target->scheme = $this->scheme;
        }
 
        $target->fragment = $reference->fragment;
 
        return $target;
    }
 
    /**
     * Removes dots as described in RFC 3986, section 5.2.4, e.g.
     * "/foo/../bar/baz" => "/bar/baz"
     *
     * @param string $path a path
     *
     * @return string a path
     */
    private static function removeDotSegments($path)
    {
        $output = '';
 
        // Make sure not to be trapped in an infinite loop due to a bug in this
        // method
        $j = 0; 
        while ($path && $j++ < 100) {
            // Step A
            if (substr($path, 0, 2) == './') {
                $path = substr($path, 2);
            } elseif (substr($path, 0, 3) == '../') {
                $path = substr($path, 3);
 
            // Step B
            } elseif (substr($path, 0, 3) == '/./' || $path == '/.') {
                $path = '/' . substr($path, 3);
 
            // Step C
            } elseif (substr($path, 0, 4) == '/../' || $path == '/..') {
                $path = '/' . substr($path, 4);
                $i = strrpos($output, '/');
                $output = $i === false ? '' : substr($output, 0, $i);
 
            // Step D
            } elseif ($path == '.' || $path == '..') {
                $path = '';
 
            // Step E
            } else {
                $i = strpos($path, '/');
                if ($i === 0) {
                    $i = strpos($path, '/', 1);
                }
                if ($i === false) {
                    $i = strlen($path);
                }
                $output .= substr($path, 0, $i);
                $path = substr($path, $i);
            }
        }
 
        return $output;
    }
 
    /**
     * Returns a Net_URL2 instance representing the canonical URL of the
     * currently executing PHP script.
     * 
     * @return  string
     */
    public static function getCanonical()
    {
        if (!isset($_SERVER['REQUEST_METHOD'])) {
            // ALERT - no current URL
            throw new Exception('Script was not called through a webserver');
        }
 
        // Begin with a relative URL
        $url = new self($_SERVER['PHP_SELF']);
        $url->scheme = isset($_SERVER['HTTPS']) ? 'https' : 'http';
        $url->host = $_SERVER['SERVER_NAME'];
        $port = intval($_SERVER['SERVER_PORT']);
        if ($url->scheme == 'http' && $port != 80 ||
            $url->scheme == 'https' && $port != 443) {
 
            $url->port = $port;
        }
        return $url;
    }
 
    /**
     * Returns the URL used to retrieve the current request.
     *
     * @return  string
     */
    public static function getRequestedURL()
    {
        return self::getRequested()->getUrl();
    }
 
    /**
     * Returns a Net_URL2 instance representing the URL used to retrieve the
     * current request.
     *
     * @return  Net_URL2
     */
    public static function getRequested()
    {
        if (!isset($_SERVER['REQUEST_METHOD'])) {
            // ALERT - no current URL
            throw new Exception('Script was not called through a webserver');
        }
 
        // Begin with a relative URL
        $url = new self($_SERVER['REQUEST_URI']);
        $url->scheme = isset($_SERVER['HTTPS']) ? 'https' : 'http';
        // Set host and possibly port
        $url->setAuthority($_SERVER['HTTP_HOST']);
        return $url;
    }
 
    /**
     * Sets the specified option.
     *
     * @param string $optionName a self::OPTION_ constant
     * @param mixed  $value      option value  
     *
     * @return void
     * @see  self::OPTION_STRICT
     * @see  self::OPTION_USE_BRACKETS
     * @see  self::OPTION_ENCODE_KEYS
     */
    function setOption($optionName, $value)
    {
        if (!array_key_exists($optionName, $this->options)) {
            return false;
        }
        $this->options[$optionName] = $value;
    }
 
    /**
     * Returns the value of the specified option.
     *
     * @param string $optionName The name of the option to retrieve
     *
     * @return  mixed
     */
    function getOption($optionName)
    {
        return isset($this->options[$optionName])
            ? $this->options[$optionName] : false;
    }
    
    public function __toString() {
    	return $this->getURL();
    }
}

Rev 79	Rev 80
1	`<?php`	1	`<?php`
2	`// +-----------------------------------------------------------------------+`	2	`// +-----------------------------------------------------------------------+`
3	`// \| Copyright (c) 2007-2008, Christian Schmidt, Peytz & Co. A/S \|`	3	`// \| Copyright (c) 2007-2008, Christian Schmidt, Peytz & Co. A/S \|`
4	`// \| All rights reserved. \|`	4	`// \| All rights reserved. \|`
5	`// \| \|`	5	`// \| \|`
6	`// \| Redistribution and use in source and binary forms, with or without \|`	6	`// \| Redistribution and use in source and binary forms, with or without \|`
7	`// \| modification, are permitted provided that the following conditions \|`	7	`// \| modification, are permitted provided that the following conditions \|`
8	`// \| are met: \|`	8	`// \| are met: \|`
9	`// \| \|`	9	`// \| \|`
10	`// \| o Redistributions of source code must retain the above copyright \|`	10	`// \| o Redistributions of source code must retain the above copyright \|`
11	`// \| notice, this list of conditions and the following disclaimer. \|`	11	`// \| notice, this list of conditions and the following disclaimer. \|`
12	`// \| o Redistributions in binary form must reproduce the above copyright \|`	12	`// \| o Redistributions in binary form must reproduce the above copyright \|`
13	`// \| notice, this list of conditions and the following disclaimer in the \|`	13	`// \| notice, this list of conditions and the following disclaimer in the \|`
14	`// \| documentation and/or other materials provided with the distribution.\|`	14	`// \| documentation and/or other materials provided with the distribution.\|`
15	`// \| o The names of the authors may not be used to endorse or promote \|`	15	`// \| o The names of the authors may not be used to endorse or promote \|`
16	`// \| products derived from this software without specific prior written \|`	16	`// \| products derived from this software without specific prior written \|`
17	`// \| permission. \|`	17	`// \| permission. \|`
18	`// \| \|`	18	`// \| \|`
19	`// \| THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \|`	19	`// \| THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \|`
20	`// \| "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT \|`	20	`// \| "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT \|`
21	`// \| LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR \|`	21	`// \| LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR \|`
22	`// \| A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT \|`	22	`// \| A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT \|`
23	`// \| OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, \|`	23	`// \| OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, \|`
24	`// \| SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT \|`	24	`// \| SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT \|`
25	`// \| LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, \|`	25	`// \| LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, \|`
26	`// \| DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY \|`	26	`// \| DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY \|`
27	`// \| THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT \|`	27	`// \| THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT \|`
28	`// \| (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE \|`	28	`// \| (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE \|`
29	`// \| OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \|`	29	`// \| OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \|`
30	`// \| \|`	30	`// \| \|`
31	`// +-----------------------------------------------------------------------+`	31	`// +-----------------------------------------------------------------------+`
32	`// \| Author: Christian Schmidt <schmidt at php dot net> \|`	32	`// \| Author: Christian Schmidt <schmidt at php dot net> \|`
33	`// +-----------------------------------------------------------------------+`	33	`// +-----------------------------------------------------------------------+`
34	`//`	34	`//`
35	`// $Id: Net_URL2.php 34 2009-04-09 07:34:39Z aurelien $`	35	`// $Id: Net_URL2.php 80 2009-08-27 07:30:42Z jpm $`
36	`//`	36	`//`
37	`// Net_URL2 Class (PHP5 Only)`	37	`// Net_URL2 Class (PHP5 Only)`
38		38
39	`// This code is released under the BSD License - http://www.opensource.org/licenses/bsd-license.php`	39	`// This code is released under the BSD License - http://www.opensource.org/licenses/bsd-license.php`
40	`/**`	40	`/**`
41	`* @license BSD License`	41	`* @license BSD License`
42	`*/`	42	`*/`
43	`class Net_URL2`	43	`class Net_URL2`
44	`{`	44	`{`
45	`/**`	45	`/**`
46	`* Do strict parsing in resolve() (see RFC 3986, section 5.2.2). Default`	46	`* Do strict parsing in resolve() (see RFC 3986, section 5.2.2). Default`
47	`* is true.`	47	`* is true.`
48	`*/`	48	`*/`
49	`const OPTION_STRICT = 'strict';`	49	`const OPTION_STRICT = 'strict';`
50		50
51	`/**`	51	`/**`
52	`* Represent arrays in query using PHP's [] notation. Default is true.`	52	`* Represent arrays in query using PHP's [] notation. Default is true.`
53	`*/`	53	`*/`
54	`const OPTION_USE_BRACKETS = 'use_brackets';`	54	`const OPTION_USE_BRACKETS = 'use_brackets';`
55		55
56	`/**`	56	`/**`
57	`* URL-encode query variable keys. Default is true.`	57	`* URL-encode query variable keys. Default is true.`
58	`*/`	58	`*/`
59	`const OPTION_ENCODE_KEYS = 'encode_keys';`	59	`const OPTION_ENCODE_KEYS = 'encode_keys';`
60		60
61	`/**`	61	`/**`
62	`* Query variable separators when parsing the query string. Every character`	62	`* Query variable separators when parsing the query string. Every character`
63	`* is considered a separator. Default is specified by the`	63	`* is considered a separator. Default is specified by the`
64	`* arg_separator.input php.ini setting (this defaults to "&").`	64	`* arg_separator.input php.ini setting (this defaults to "&").`
65	`*/`	65	`*/`
66	`const OPTION_SEPARATOR_INPUT = 'input_separator';`	66	`const OPTION_SEPARATOR_INPUT = 'input_separator';`
67		67
68	`/**`	68	`/**`
69	`* Query variable separator used when generating the query string. Default`	69	`* Query variable separator used when generating the query string. Default`
70	`* is specified by the arg_separator.output php.ini setting (this defaults`	70	`* is specified by the arg_separator.output php.ini setting (this defaults`
71	`* to "&").`	71	`* to "&").`
72	`*/`	72	`*/`
73	`const OPTION_SEPARATOR_OUTPUT = 'output_separator';`	73	`const OPTION_SEPARATOR_OUTPUT = 'output_separator';`
74		74
75	`/**`	75	`/**`
76	`* Default options corresponds to how PHP handles $_GET.`	76	`* Default options corresponds to how PHP handles $_GET.`
77	`*/`	77	`*/`
78	`private $options = array(`	78	`private $options = array(`
79	`self::OPTION_STRICT => true,`	79	`self::OPTION_STRICT => true,`
80	`self::OPTION_USE_BRACKETS => true,`	80	`self::OPTION_USE_BRACKETS => true,`
81	`self::OPTION_ENCODE_KEYS => true,`	81	`self::OPTION_ENCODE_KEYS => true,`
82	`self::OPTION_SEPARATOR_INPUT => 'x&',`	82	`self::OPTION_SEPARATOR_INPUT => 'x&',`
83	`self::OPTION_SEPARATOR_OUTPUT => 'x&',`	83	`self::OPTION_SEPARATOR_OUTPUT => 'x&',`
84	`);`	84	`);`
85		85
86	`/**`	86	`/**`
87	`* @var string\|bool`	87	`* @var string\|bool`
88	`*/`	88	`*/`
89	`private $scheme = false;`	89	`private $scheme = false;`
90		90
91	`/**`	91	`/**`
92	`* @var string\|bool`	92	`* @var string\|bool`
93	`*/`	93	`*/`
94	`private $userinfo = false;`	94	`private $userinfo = false;`
95		95
96	`/**`	96	`/**`
97	`* @var string\|bool`	97	`* @var string\|bool`
98	`*/`	98	`*/`
99	`private $host = false;`	99	`private $host = false;`
100		100
101	`/**`	101	`/**`
102	`* @var int\|bool`	102	`* @var int\|bool`
103	`*/`	103	`*/`
104	`private $port = false;`	104	`private $port = false;`
105		105
106	`/**`	106	`/**`
107	`* @var string`	107	`* @var string`
108	`*/`	108	`*/`
109	`private $path = '';`	109	`private $path = '';`
110		110
111	`/**`	111	`/**`
112	`* @var string\|bool`	112	`* @var string\|bool`
113	`*/`	113	`*/`
114	`private $query = false;`	114	`private $query = false;`
115		115
116	`/**`	116	`/**`
117	`* @var string\|bool`	117	`* @var string\|bool`
118	`*/`	118	`*/`
119	`private $fragment = false;`	119	`private $fragment = false;`
120		120
121	`/**`	121	`/**`
122	`* @param string $url an absolute or relative URL`	122	`* @param string $url an absolute or relative URL`
123	`* @param array $options`	123	`* @param array $options`
124	`*/`	124	`*/`
125	`public function __construct($url, $options = null)`	125	`public function __construct($url, $options = null)`
126	`{`	126	`{`
127	`$this->setOption(self::OPTION_SEPARATOR_INPUT,`	127	`$this->setOption(self::OPTION_SEPARATOR_INPUT,`
128	`ini_get('arg_separator.input'));`	128	`ini_get('arg_separator.input'));`
129	`$this->setOption(self::OPTION_SEPARATOR_OUTPUT,`	129	`$this->setOption(self::OPTION_SEPARATOR_OUTPUT,`
130	`ini_get('arg_separator.output'));`	130	`ini_get('arg_separator.output'));`
131	`if (is_array($options)) {`	131	`if (is_array($options)) {`
132	`foreach ($options as $optionName => $value) {`	132	`foreach ($options as $optionName => $value) {`
133	`$this->setOption($optionName);`	133	`$this->setOption($optionName);`
134	`}`	134	`}`
135	`}`	135	`}`
136		136
137	`if (preg_match('@^([a-z][a-z0-9.+-]*):@i', $url, $reg)) {`	137	`if (preg_match('@^([a-z][a-z0-9.+-]*):@i', $url, $reg)) {`
138	`$this->scheme = $reg[1];`	138	`$this->scheme = $reg[1];`
139	`$url = substr($url, strlen($reg[0]));`	139	`$url = substr($url, strlen($reg[0]));`
140	`}`	140	`}`
141		141
142	`if (preg_match('@^//([^/#?]+)@', $url, $reg)) {`	142	`if (preg_match('@^//([^/#?]+)@', $url, $reg)) {`
143	`$this->setAuthority($reg[1]);`	143	`$this->setAuthority($reg[1]);`
144	`$url = substr($url, strlen($reg[0]));`	144	`$url = substr($url, strlen($reg[0]));`
145	`}`	145	`}`
146		146
147	`$i = strcspn($url, '?#');`	147	`$i = strcspn($url, '?#');`
148	`$this->path = substr($url, 0, $i);`	148	`$this->path = substr($url, 0, $i);`
149	`$url = substr($url, $i);`	149	`$url = substr($url, $i);`
150		150
151	`if (preg_match('@^\?([^#]*)@', $url, $reg)) {`	151	`if (preg_match('@^\?([^#]*)@', $url, $reg)) {`
152	`$this->query = $reg[1];`	152	`$this->query = $reg[1];`
153	`$url = substr($url, strlen($reg[0]));`	153	`$url = substr($url, strlen($reg[0]));`
154	`}`	154	`}`
155		155
156	`if ($url) {`	156	`if ($url) {`
157	`$this->fragment = substr($url, 1);`	157	`$this->fragment = substr($url, 1);`
158	`}`	158	`}`
159	`}`	159	`}`
160		160
161	`/**`	161	`/**`
162	`* Returns the scheme, e.g. "http" or "urn", or false if there is no`	162	`* Returns the scheme, e.g. "http" or "urn", or false if there is no`
163	`* scheme specified, i.e. if this is a relative URL.`	163	`* scheme specified, i.e. if this is a relative URL.`
164	`*`	164	`*`
165	`* @return string\|bool`	165	`* @return string\|bool`
166	`*/`	166	`*/`
167	`public function getScheme()`	167	`public function getScheme()`
168	`{`	168	`{`
169	`return $this->scheme;`	169	`return $this->scheme;`
170	`}`	170	`}`
171		171
172	`/**`	172	`/**`
173	`* @param string\|bool $scheme`	173	`* @param string\|bool $scheme`
174	`*`	174	`*`
175	`* @return void`	175	`* @return void`
176	`* @see getScheme()`	176	`* @see getScheme()`
177	`*/`	177	`*/`
178	`public function setScheme($scheme)`	178	`public function setScheme($scheme)`
179	`{`	179	`{`
180	`$this->scheme = $scheme;`	180	`$this->scheme = $scheme;`
181	`}`	181	`}`
182		182
183	`/**`	183	`/**`
184	`* Returns the user part of the userinfo part (the part preceding the first`	184	`* Returns the user part of the userinfo part (the part preceding the first`
185	`* ":"), or false if there is no userinfo part.`	185	`* ":"), or false if there is no userinfo part.`
186	`*`	186	`*`
187	`* @return string\|bool`	187	`* @return string\|bool`
188	`*/`	188	`*/`
189	`public function getUser()`	189	`public function getUser()`
190	`{`	190	`{`
191	`return $this->userinfo !== false ? preg_replace('@:.*$@', '', $this->userinfo) : false;`	191	`return $this->userinfo !== false ? preg_replace('@:.*$@', '', $this->userinfo) : false;`
192	`}`	192	`}`
193		193
194	`/**`	194	`/**`
195	`* Returns the password part of the userinfo part (the part after the first`	195	`* Returns the password part of the userinfo part (the part after the first`
196	`* ":"), or false if there is no userinfo part (i.e. the URL does not`	196	`* ":"), or false if there is no userinfo part (i.e. the URL does not`
197	`* contain "@" in front of the hostname) or the userinfo part does not`	197	`* contain "@" in front of the hostname) or the userinfo part does not`
198	`* contain ":".`	198	`* contain ":".`
199	`*`	199	`*`
200	`* @return string\|bool`	200	`* @return string\|bool`
201	`*/`	201	`*/`
202	`public function getPassword()`	202	`public function getPassword()`
203	`{`	203	`{`
204	`return $this->userinfo !== false ? substr(strstr($this->userinfo, ':'), 1) : false;`	204	`return $this->userinfo !== false ? substr(strstr($this->userinfo, ':'), 1) : false;`
205	`}`	205	`}`
206		206
207	`/**`	207	`/**`
208	`* Returns the userinfo part, or false if there is none, i.e. if the`	208	`* Returns the userinfo part, or false if there is none, i.e. if the`
209	`* authority part does not contain "@".`	209	`* authority part does not contain "@".`
210	`*`	210	`*`
211	`* @return string\|bool`	211	`* @return string\|bool`
212	`*/`	212	`*/`
213	`public function getUserinfo()`	213	`public function getUserinfo()`
214	`{`	214	`{`
215	`return $this->userinfo;`	215	`return $this->userinfo;`
216	`}`	216	`}`
217		217
218	`/**`	218	`/**`
219	`* Sets the userinfo part. If two arguments are passed, they are combined`	219	`* Sets the userinfo part. If two arguments are passed, they are combined`
220	`* in the userinfo part as username ":" password.`	220	`* in the userinfo part as username ":" password.`
221	`*`	221	`*`
222	`* @param string\|bool $userinfo userinfo or username`	222	`* @param string\|bool $userinfo userinfo or username`
223	`* @param string\|bool $password`	223	`* @param string\|bool $password`
224	`*`	224	`*`
225	`* @return void`	225	`* @return void`
226	`*/`	226	`*/`
227	`public function setUserinfo($userinfo, $password = false)`	227	`public function setUserinfo($userinfo, $password = false)`
228	`{`	228	`{`
229	`$this->userinfo = $userinfo;`	229	`$this->userinfo = $userinfo;`
230	`if ($password !== false) {`	230	`if ($password !== false) {`
231	`$this->userinfo .= ':' . $password;`	231	`$this->userinfo .= ':' . $password;`
232	`}`	232	`}`
233	`}`	233	`}`
234		234
235	`/**`	235	`/**`
236	`* Returns the host part, or false if there is no authority part, e.g.`	236	`* Returns the host part, or false if there is no authority part, e.g.`
237	`* relative URLs.`	237	`* relative URLs.`
238	`*`	238	`*`
239	`* @return string\|bool`	239	`* @return string\|bool`
240	`*/`	240	`*/`
241	`public function getHost()`	241	`public function getHost()`
242	`{`	242	`{`
243	`return $this->host;`	243	`return $this->host;`
244	`}`	244	`}`
245		245
246	`/**`	246	`/**`
247	`* @param string\|bool $host`	247	`* @param string\|bool $host`
248	`*`	248	`*`
249	`* @return void`	249	`* @return void`
250	`*/`	250	`*/`
251	`public function setHost($host)`	251	`public function setHost($host)`
252	`{`	252	`{`
253	`$this->host = $host;`	253	`$this->host = $host;`
254	`}`	254	`}`
255		255
256	`/**`	256	`/**`
257	`* Returns the port number, or false if there is no port number specified,`	257	`* Returns the port number, or false if there is no port number specified,`
258	`* i.e. if the default port is to be used.`	258	`* i.e. if the default port is to be used.`
259	`*`	259	`*`
260	`* @return int\|bool`	260	`* @return int\|bool`
261	`*/`	261	`*/`
262	`public function getPort()`	262	`public function getPort()`
263	`{`	263	`{`
264	`return $this->port;`	264	`return $this->port;`
265	`}`	265	`}`
266		266
267	`/**`	267	`/**`
268	`* @param int\|bool $port`	268	`* @param int\|bool $port`
269	`*`	269	`*`
270	`* @return void`	270	`* @return void`
271	`*/`	271	`*/`
272	`public function setPort($port)`	272	`public function setPort($port)`
273	`{`	273	`{`
274	`$this->port = intval($port);`	274	`$this->port = intval($port);`
275	`}`	275	`}`
276		276
277	`/**`	277	`/**`
278	`* Returns the authority part, i.e. [ userinfo "@" ] host [ ":" port ], or`	278	`* Returns the authority part, i.e. [ userinfo "@" ] host [ ":" port ], or`
279	`* false if there is no authority none.`	279	`* false if there is no authority none.`
280	`*`	280	`*`
281	`* @return string\|bool`	281	`* @return string\|bool`
282	`*/`	282	`*/`
283	`public function getAuthority()`	283	`public function getAuthority()`
284	`{`	284	`{`
285	`if (!$this->host) {`	285	`if (!$this->host) {`
286	`return false;`	286	`return false;`
287	`}`	287	`}`
288		288
289	`$authority = '';`	289	`$authority = '';`
290		290
291	`if ($this->userinfo !== false) {`	291	`if ($this->userinfo !== false) {`
292	`$authority .= $this->userinfo . '@';`	292	`$authority .= $this->userinfo . '@';`
293	`}`	293	`}`
294		294
295	`$authority .= $this->host;`	295	`$authority .= $this->host;`
296		296
297	`if ($this->port !== false) {`	297	`if ($this->port !== false) {`
298	`$authority .= ':' . $this->port;`	298	`$authority .= ':' . $this->port;`
299	`}`	299	`}`
300		300
301	`return $authority;`	301	`return $authority;`
302	`}`	302	`}`
303		303
304	`/**`	304	`/**`
305	`* @param string\|false $authority`	305	`* @param string\|false $authority`
306	`*`	306	`*`
307	`* @return void`	307	`* @return void`
308	`*/`	308	`*/`
309	`public function setAuthority($authority)`	309	`public function setAuthority($authority)`
310	`{`	310	`{`
311	`$this->user = false;`	311	`$this->user = false;`
312	`$this->pass = false;`	312	`$this->pass = false;`
313	`$this->host = false;`	313	`$this->host = false;`
314	`$this->port = false;`	314	`$this->port = false;`
315	`if (preg_match('@^(([^\@]+)\@)?([^:]+)(:(\d*))?$@', $authority, $reg)) {`	315	`if (preg_match('@^(([^\@]+)\@)?([^:]+)(:(\d*))?$@', $authority, $reg)) {`
316	`if ($reg[1]) {`	316	`if ($reg[1]) {`
317	`$this->userinfo = $reg[2];`	317	`$this->userinfo = $reg[2];`
318	`}`	318	`}`
319		319
320	`$this->host = $reg[3];`	320	`$this->host = $reg[3];`
321	`if (isset($reg[5])) {`	321	`if (isset($reg[5])) {`
322	`$this->port = intval($reg[5]);`	322	`$this->port = intval($reg[5]);`
323	`}`	323	`}`
324	`}`	324	`}`
325	`}`	325	`}`
326		326
327	`/**`	327	`/**`
328	`* Returns the path part (possibly an empty string).`	328	`* Returns the path part (possibly an empty string).`
329	`*`	329	`*`
330	`* @return string`	330	`* @return string`
331	`*/`	331	`*/`
332	`public function getPath()`	332	`public function getPath()`
333	`{`	333	`{`
334	`return $this->path;`	334	`return $this->path;`
335	`}`	335	`}`
336		336
337	`/**`	337	`/**`
338	`* @param string $path`	338	`* @param string $path`
339	`*`	339	`*`
340	`* @return void`	340	`* @return void`
341	`*/`	341	`*/`
342	`public function setPath($path)`	342	`public function setPath($path)`
343	`{`	343	`{`
344	`$this->path = $path;`	344	`$this->path = $path;`
345	`}`	345	`}`
346		346
347	`/**`	347	`/**`
348	`* Returns the query string (excluding the leading "?"), or false if "?"`	348	`* Returns the query string (excluding the leading "?"), or false if "?"`
349	`* isn't present in the URL.`	349	`* isn't present in the URL.`
350	`*`	350	`*`
351	`* @return string\|bool`	351	`* @return string\|bool`
352	`* @see self::getQueryVariables()`	352	`* @see self::getQueryVariables()`
353	`*/`	353	`*/`
354	`public function getQuery()`	354	`public function getQuery()`
355	`{`	355	`{`
356	`return $this->query;`	356	`return $this->query;`
357	`}`	357	`}`
358		358
359	`/**`	359	`/**`
360	`* @param string\|bool $query`	360	`* @param string\|bool $query`
361	`*`	361	`*`
362	`* @return void`	362	`* @return void`
363	`* @see self::setQueryVariables()`	363	`* @see self::setQueryVariables()`
364	`*/`	364	`*/`
365	`public function setQuery($query)`	365	`public function setQuery($query)`
366	`{`	366	`{`
367	`$this->query = $query;`	367	`$this->query = $query;`
368	`}`	368	`}`
369		369
370	`/**`	370	`/**`
371	`* Returns the fragment name, or false if "#" isn't present in the URL.`	371	`* Returns the fragment name, or false if "#" isn't present in the URL.`
372	`*`	372	`*`
373	`* @return string\|bool`	373	`* @return string\|bool`
374	`*/`	374	`*/`
375	`public function getFragment()`	375	`public function getFragment()`
376	`{`	376	`{`
377	`return $this->fragment;`	377	`return $this->fragment;`
378	`}`	378	`}`
379		379
380	`/**`	380	`/**`
381	`* @param string\|bool $fragment`	381	`* @param string\|bool $fragment`
382	`*`	382	`*`
383	`* @return void`	383	`* @return void`
384	`*/`	384	`*/`
385	`public function setFragment($fragment)`	385	`public function setFragment($fragment)`
386	`{`	386	`{`
387	`$this->fragment = $fragment;`	387	`$this->fragment = $fragment;`
388	`}`	388	`}`
389		389
390	`/**`	390	`/**`
391	`* Returns the query string like an array as the variables would appear in`	391	`* Returns the query string like an array as the variables would appear in`
392	`* $_GET in a PHP script.`	392	`* $_GET in a PHP script.`
393	`*`	393	`*`
394	`* @return array`	394	`* @return array`
395	`*/`	395	`*/`
396	`public function getQueryVariables()`	396	`public function getQueryVariables()`
397	`{`	397	`{`
398	`$pattern = '/[' .`	398	`$pattern = '/[' .`
399	`preg_quote($this->getOption(self::OPTION_SEPARATOR_INPUT), '/') .`	399	`preg_quote($this->getOption(self::OPTION_SEPARATOR_INPUT), '/') .`
400	`']/';`	400	`']/';`
401	`$parts = preg_split($pattern, $this->query, -1, PREG_SPLIT_NO_EMPTY);`	401	`$parts = preg_split($pattern, $this->query, -1, PREG_SPLIT_NO_EMPTY);`
402	`$return = array();`	402	`$return = array();`
403		403
404	`foreach ($parts as $part) {`	404	`foreach ($parts as $part) {`
405	`if (strpos($part, '=') !== false) {`	405	`if (strpos($part, '=') !== false) {`
406	`list($key, $value) = explode('=', $part, 2);`	406	`list($key, $value) = explode('=', $part, 2);`
407	`} else {`	407	`} else {`
408	`$key = $part;`	408	`$key = $part;`
409	`$value = null;`	409	`$value = null;`
410	`}`	410	`}`
411		411
412	`if ($this->getOption(self::OPTION_ENCODE_KEYS)) {`	412	`if ($this->getOption(self::OPTION_ENCODE_KEYS)) {`
413	`$key = rawurldecode($key);`	413	`$key = rawurldecode($key);`
414	`}`	414	`}`
415	`$value = rawurldecode($value);`	415	`$value = rawurldecode($value);`
416		416
417	`if ($this->getOption(self::OPTION_USE_BRACKETS) &&`	417	`if ($this->getOption(self::OPTION_USE_BRACKETS) &&`
418	`preg_match('#^(.)\[([0-9a-z_-])\]#i', $key, $matches)) {`	418	`preg_match('#^(.)\[([0-9a-z_-])\]#i', $key, $matches)) {`
419		419
420	`$key = $matches[1];`	420	`$key = $matches[1];`
421	`$idx = $matches[2];`	421	`$idx = $matches[2];`
422		422
423	`// Ensure is an array`	423	`// Ensure is an array`
424	`if (empty($return[$key]) \|\| !is_array($return[$key])) {`	424	`if (empty($return[$key]) \|\| !is_array($return[$key])) {`
425	`$return[$key] = array();`	425	`$return[$key] = array();`
426	`}`	426	`}`
427		427
428	`// Add data`	428	`// Add data`
429	`if ($idx === '') {`	429	`if ($idx === '') {`
430	`$return[$key][] = $value;`	430	`$return[$key][] = $value;`
431	`} else {`	431	`} else {`
432	`$return[$key][$idx] = $value;`	432	`$return[$key][$idx] = $value;`
433	`}`	433	`}`
434	`} elseif (!$this->getOption(self::OPTION_USE_BRACKETS)`	434	`} elseif (!$this->getOption(self::OPTION_USE_BRACKETS)`
435	`&& !empty($return[$key])`	435	`&& !empty($return[$key])`
436	`) {`	436	`) {`
437	`$return[$key] = (array) $return[$key];`	437	`$return[$key] = (array) $return[$key];`
438	`$return[$key][] = $value;`	438	`$return[$key][] = $value;`
439	`} else {`	439	`} else {`
440	`$return[$key] = $value;`	440	`$return[$key] = $value;`
441	`}`	441	`}`
442	`}`	442	`}`
443		443
444	`return $return;`	444	`return $return;`
445	`}`	445	`}`
446		446
447	`/**`	447	`/**`
448	`* @param array $array (name => value) array`	448	`* @param array $array (name => value) array`
449	`*`	449	`*`
450	`* @return void`	450	`* @return void`
451	`*/`	451	`*/`
452	`public function setQueryVariables(array $array)`	452	`public function setQueryVariables(array $array)`
453	`{`	453	`{`
454	`if (!$array) {`	454	`if (!$array) {`
455	`$this->query = false;`	455	`$this->query = false;`
456	`} else {`	456	`} else {`
457	`foreach ($array as $name => $value) {`	457	`foreach ($array as $name => $value) {`
458	`if ($this->getOption(self::OPTION_ENCODE_KEYS)) {`	458	`if ($this->getOption(self::OPTION_ENCODE_KEYS)) {`
459	`$name = rawurlencode($name);`	459	`$name = rawurlencode($name);`
460	`}`	460	`}`
461		461
462	`if (is_array($value)) {`	462	`if (is_array($value)) {`
463	`foreach ($value as $k => $v) {`	463	`foreach ($value as $k => $v) {`
464	`$parts[] = $this->getOption(self::OPTION_USE_BRACKETS)`	464	`$parts[] = $this->getOption(self::OPTION_USE_BRACKETS)`
465	`? sprintf('%s[%s]=%s', $name, $k, $v)`	465	`? sprintf('%s[%s]=%s', $name, $k, $v)`
466	`: ($name . '=' . $v);`	466	`: ($name . '=' . $v);`
467	`}`	467	`}`
468	`} elseif (!is_null($value)) {`	468	`} elseif (!is_null($value)) {`
469	`$parts[] = $name . '=' . $value;`	469	`$parts[] = $name . '=' . $value;`
470	`} else {`	470	`} else {`
471	`$parts[] = $name;`	471	`$parts[] = $name;`
472	`}`	472	`}`
473	`}`	473	`}`
474	`$this->query = implode($this->getOption(self::OPTION_SEPARATOR_OUTPUT),`	474	`$this->query = implode($this->getOption(self::OPTION_SEPARATOR_OUTPUT),`
475	`$parts);`	475	`$parts);`
476	`}`	476	`}`
477	`}`	477	`}`
478		478
479	`/**`	479	`/**`
480	`* @param string $name`	480	`* @param string $name`
481	`* @param mixed $value`	481	`* @param mixed $value`
482	`*`	482	`*`
483	`* @return array`	483	`* @return array`
484	`*/`	484	`*/`
485	`public function setQueryVariable($name, $value)`	485	`public function setQueryVariable($name, $value)`
486	`{`	486	`{`
487	`$array = $this->getQueryVariables();`	487	`$array = $this->getQueryVariables();`
488	`$array[$name] = $value;`	488	`$array[$name] = $value;`
489	`$this->setQueryVariables($array);`	489	`$this->setQueryVariables($array);`
490	`}`	490	`}`
491		491
492	`/**`	492	`/**`
493	`* @param string $name`	493	`* @param string $name`
494	`*`	494	`*`
495	`* @return void`	495	`* @return void`
496	`*/`	496	`*/`
497	`public function unsetQueryVariable($name)`	497	`public function unsetQueryVariable($name)`
498	`{`	498	`{`
499	`$array = $this->getQueryVariables();`	499	`$array = $this->getQueryVariables();`
500	`unset($array[$name]);`	500	`unset($array[$name]);`

Subversion Repositories Applications.framework

(root)/trunk/framework/Net_URL2.php – Rev 79 → 80