Upgraded to KH 3.3.0
This commit is contained in:
Deon George
213
includes/kohana/system/classes/Kohana/URL.php
Normal file
213
includes/kohana/system/classes/Kohana/URL.php
Normal file
@@ -0,0 +1,213 @@
|
||||
<?php defined('SYSPATH') OR die('No direct script access.');
|
||||
/**
|
||||
* URL helper class.
|
||||
*
|
||||
* @package Kohana
|
||||
* @category Helpers
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2007-2012 Kohana Team
|
||||
* @license http://kohanaframework.org/license
|
||||
*/
|
||||
class Kohana_URL {
|
||||
|
||||
/**
|
||||
* Gets the base URL to the application.
|
||||
* To specify a protocol, provide the protocol as a string or request object.
|
||||
* If a protocol is used, a complete URL will be generated using the
|
||||
* `$_SERVER['HTTP_HOST']` variable.
|
||||
*
|
||||
* // Absolute URL path with no host or protocol
|
||||
* echo URL::base();
|
||||
*
|
||||
* // Absolute URL path with host, https protocol and index.php if set
|
||||
* echo URL::base('https', TRUE);
|
||||
*
|
||||
* // Absolute URL path with host and protocol from $request
|
||||
* echo URL::base($request);
|
||||
*
|
||||
* @param mixed $protocol Protocol string, [Request], or boolean
|
||||
* @param boolean $index Add index file to URL?
|
||||
* @return string
|
||||
* @uses Kohana::$index_file
|
||||
* @uses Request::protocol()
|
||||
*/
|
||||
public static function base($protocol = NULL, $index = FALSE)
|
||||
{
|
||||
// Start with the configured base URL
|
||||
$base_url = Kohana::$base_url;
|
||||
|
||||
if ($protocol === TRUE)
|
||||
{
|
||||
// Use the initial request to get the protocol
|
||||
$protocol = Request::$initial;
|
||||
}
|
||||
|
||||
if ($protocol instanceof Request)
|
||||
{
|
||||
if ( ! $protocol->secure())
|
||||
{
|
||||
// Use the current protocol
|
||||
list($protocol) = explode('/', strtolower($protocol->protocol()));
|
||||
}
|
||||
else
|
||||
{
|
||||
$protocol = 'https';
|
||||
}
|
||||
}
|
||||
|
||||
if ( ! $protocol)
|
||||
{
|
||||
// Use the configured default protocol
|
||||
$protocol = parse_url($base_url, PHP_URL_SCHEME);
|
||||
}
|
||||
|
||||
if ($index === TRUE AND ! empty(Kohana::$index_file))
|
||||
{
|
||||
// Add the index file to the URL
|
||||
$base_url .= Kohana::$index_file.'/';
|
||||
}
|
||||
|
||||
if (is_string($protocol))
|
||||
{
|
||||
if ($port = parse_url($base_url, PHP_URL_PORT))
|
||||
{
|
||||
// Found a port, make it usable for the URL
|
||||
$port = ':'.$port;
|
||||
}
|
||||
|
||||
if ($domain = parse_url($base_url, PHP_URL_HOST))
|
||||
{
|
||||
// Remove everything but the path from the URL
|
||||
$base_url = parse_url($base_url, PHP_URL_PATH);
|
||||
}
|
||||
else
|
||||
{
|
||||
// Attempt to use HTTP_HOST and fallback to SERVER_NAME
|
||||
$domain = isset($_SERVER['HTTP_HOST']) ? $_SERVER['HTTP_HOST'] : $_SERVER['SERVER_NAME'];
|
||||
}
|
||||
|
||||
// Add the protocol and domain to the base URL
|
||||
$base_url = $protocol.'://'.$domain.$port.$base_url;
|
||||
}
|
||||
|
||||
return $base_url;
|
||||
}
|
||||
|
||||
/**
|
||||
* Fetches an absolute site URL based on a URI segment.
|
||||
*
|
||||
* echo URL::site('foo/bar');
|
||||
*
|
||||
* @param string $uri Site URI to convert
|
||||
* @param mixed $protocol Protocol string or [Request] class to use protocol from
|
||||
* @param boolean $index Include the index_page in the URL
|
||||
* @return string
|
||||
* @uses URL::base
|
||||
*/
|
||||
public static function site($uri = '', $protocol = NULL, $index = TRUE)
|
||||
{
|
||||
// Chop off possible scheme, host, port, user and pass parts
|
||||
$path = preg_replace('~^[-a-z0-9+.]++://[^/]++/?~', '', trim($uri, '/'));
|
||||
|
||||
if ( ! UTF8::is_ascii($path))
|
||||
{
|
||||
// Encode all non-ASCII characters, as per RFC 1738
|
||||
$path = preg_replace_callback('~([^/]+)~', 'URL::_rawurlencode_callback', $path);
|
||||
}
|
||||
|
||||
// Concat the URL
|
||||
return URL::base($protocol, $index).$path;
|
||||
}
|
||||
|
||||
/**
|
||||
* Callback used for encoding all non-ASCII characters, as per RFC 1738
|
||||
* Used by URL::site()
|
||||
*
|
||||
* @param array $matches Array of matches from preg_replace_callback()
|
||||
* @return string Encoded string
|
||||
*/
|
||||
protected static function _rawurlencode_callback($matches)
|
||||
{
|
||||
return rawurlencode($matches[0]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Merges the current GET parameters with an array of new or overloaded
|
||||
* parameters and returns the resulting query string.
|
||||
*
|
||||
* // Returns "?sort=title&limit=10" combined with any existing GET values
|
||||
* $query = URL::query(array('sort' => 'title', 'limit' => 10));
|
||||
*
|
||||
* Typically you would use this when you are sorting query results,
|
||||
* or something similar.
|
||||
*
|
||||
* [!!] Parameters with a NULL value are left out.
|
||||
*
|
||||
* @param array $params Array of GET parameters
|
||||
* @param boolean $use_get Include current request GET parameters
|
||||
* @return string
|
||||
*/
|
||||
public static function query(array $params = NULL, $use_get = TRUE)
|
||||
{
|
||||
if ($use_get)
|
||||
{
|
||||
if ($params === NULL)
|
||||
{
|
||||
// Use only the current parameters
|
||||
$params = $_GET;
|
||||
}
|
||||
else
|
||||
{
|
||||
// Merge the current and new parameters
|
||||
$params = Arr::merge($_GET, $params);
|
||||
}
|
||||
}
|
||||
|
||||
if (empty($params))
|
||||
{
|
||||
// No query parameters
|
||||
return '';
|
||||
}
|
||||
|
||||
// Note: http_build_query returns an empty string for a params array with only NULL values
|
||||
$query = http_build_query($params, '', '&');
|
||||
|
||||
// Don't prepend '?' to an empty string
|
||||
return ($query === '') ? '' : ('?'.$query);
|
||||
}
|
||||
|
||||
/**
|
||||
* Convert a phrase to a URL-safe title.
|
||||
*
|
||||
* echo URL::title('My Blog Post'); // "my-blog-post"
|
||||
*
|
||||
* @param string $title Phrase to convert
|
||||
* @param string $separator Word separator (any single character)
|
||||
* @param boolean $ascii_only Transliterate to ASCII?
|
||||
* @return string
|
||||
* @uses UTF8::transliterate_to_ascii
|
||||
*/
|
||||
public static function title($title, $separator = '-', $ascii_only = FALSE)
|
||||
{
|
||||
if ($ascii_only === TRUE)
|
||||
{
|
||||
// Transliterate non-ASCII characters
|
||||
$title = UTF8::transliterate_to_ascii($title);
|
||||
|
||||
// Remove all characters that are not the separator, a-z, 0-9, or whitespace
|
||||
$title = preg_replace('![^'.preg_quote($separator).'a-z0-9\s]+!', '', strtolower($title));
|
||||
}
|
||||
else
|
||||
{
|
||||
// Remove all characters that are not the separator, letters, numbers, or whitespace
|
||||
$title = preg_replace('![^'.preg_quote($separator).'\pL\pN\s]+!u', '', UTF8::strtolower($title));
|
||||
}
|
||||
|
||||
// Replace all separator characters and whitespace by a single separator
|
||||
$title = preg_replace('!['.preg_quote($separator).'\s]+!u', $separator, $title);
|
||||
|
||||
// Trim separators from the beginning and end
|
||||
return trim($title, $separator);
|
||||
}
|
||||
|
||||
} // End url
|
||||
Reference in New Issue
Block a user