/system/helpers/url_helper.php CI URL助手
<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed'); /** * CodeIgniter * * An open source application development framework for PHP 5.1.6 or newer * * @package CodeIgniter * @author ExpressionEngine Dev Team * @copyright Copyright (c) 2008 - 2011, EllisLab, Inc. * @license http://codeigniter.com/user_guide/license.html * @link http://codeigniter.com * @since Version 1.0 * @filesource */ // ------------------------------------------------------------------------ /** * CodeIgniter URL Helpers * CI URL助手 * * @package CodeIgniter * @subpackage Helpers * @category Helpers * @author ExpressionEngine Dev Team * @link http://codeigniter.com/user_guide/helpers/url_helper.html */ // ------------------------------------------------------------------------ /** * Site URL * 网站网址 * * Create a local URL based on your basepath. Segments can be passed via the * first parameter either as a string or an array. * * 您的basepath的基础上创建一个本地的URL。段可以通过传递 * 无论是作为一个字符串或数组的第一个参数。 * * * @access public * @param string * @return string */ if ( ! function_exists('site_url')) { function site_url($uri = '') { $CI =& get_instance(); return $CI->config->site_url($uri); } } // ------------------------------------------------------------------------ /** * Base URL * 基本URL * * Create a local URL based on your basepath. * Segments can be passed in as a string or an array, same as site_url * or a URL to a file can be passed in, e.g. to an image file. * 您的basepath的基础上创建一个本地的URL。 * 段可以通过一个字符串或数组,一样SITE_URL * 例如,可以通过*或文件网址到图像文件。 * @access public * @param string * @return string */ if ( ! function_exists('base_url')) { function base_url($uri = '') { $CI =& get_instance(); return $CI->config->base_url($uri); } } // ------------------------------------------------------------------------ /** * Current URL * 当前的URL * Returns the full URL (including segments) of the page where this * function is placed * 返回完整的URL(包括分部)的页面所在今功能被放置 * @access public * @return string */ if ( ! function_exists('current_url')) { function current_url() { $CI =& get_instance(); return $CI->config->site_url($CI->uri->uri_string()); } } // ------------------------------------------------------------------------ /** * URL String * url字符串 * * Returns the URI segments. * 返回的URI分部。 * @access public * @return string */ if ( ! function_exists('uri_string')) { function uri_string() { $CI =& get_instance(); return $CI->uri->uri_string(); } } // ------------------------------------------------------------------------ /** * Index page * 首页的page * * Returns the "index_page" from your config file * 从你的配置文件返回的“index_page” * @access public * @return string */ if ( ! function_exists('index_page')) { function index_page() { $CI =& get_instance(); return $CI->config->item('index_page'); } } // ------------------------------------------------------------------------ /** * Anchor Link * 锚链接 * Creates an anchor based on the local URL. * 创建一个基于本地URL的锚。 * @access public * @param string the URL * @param string the link title * @param mixed any attributes * @return string */ if ( ! function_exists('anchor')) { function anchor($uri = '', $title = '', $attributes = '') { //转为字符串 $title = (string) $title; //不为数组 $uri if ( ! is_array($uri)) { //preg_match('!^\w+://! i', $uri) 如果没有 http://这个开头的等方面,site_url一下 $site_url = ( ! preg_match('!^\w+://! i', $uri)) ? site_url($uri) : $uri; } else { $site_url = site_url($uri); } if ($title == '') { $title = $site_url; } if ($attributes != '') { //进行属性分析 _parse_attributes($attributes); $attributes = _parse_attributes($attributes); } return '<a href="'.$site_url.'"'.$attributes.'>'.$title.'</a>'; } } // ------------------------------------------------------------------------ /** * Anchor Link - Pop-up version * 锚链接 - pop-up版 * * Creates an anchor based on the local URL. The link * opens a new window based on the attributes specified. * 创建一个基于本地URL的锚。的链接根据所指定的属性打开一个新窗口。 * @access public * @param string the URL * @param string the link title * @param mixed any attributes * @return string */ if ( ! function_exists('anchor_popup')) { function anchor_popup($uri = '', $title = '', $attributes = FALSE) { $title = (string) $title; $site_url = ( ! preg_match('!^\w+://! i', $uri)) ? site_url($uri) : $uri; if ($title == '') { $title = $site_url; } //如果$attributes 为false 用window.open进行打开 if ($attributes === FALSE) { return "<a href='javascript:void(0);' onclick=\"window.open('".$site_url."', '_blank');\">".$title."</a>"; } //如果不为数组,重新赋值为数组 if ( ! is_array($attributes)) { $attributes = array(); } foreach (array('width' => '800', 'height' => '600', 'scrollbars' => 'yes', 'status' => 'yes', 'resizable' => 'yes', 'screenx' => '0', 'screeny' => '0', ) as $key => $val) { $atts[$key] = ( ! isset($attributes[$key])) ? $val : $attributes[$key]; unset($attributes[$key]); } if ($attributes != '') { $attributes = _parse_attributes($attributes); } //window.open()还有第三个元素 哦,第三个参数是宽高 return "<a href='javascript:void(0);' onclick=\"window.open('".$site_url."', '_blank', '"._parse_attributes($atts, TRUE)."');\"$attributes>".$title."</a>"; } } // ------------------------------------------------------------------------ /** * Mailto Link * 邮寄地址链接 * @access public * @param string the email address * @param string the link title * @param mixed any attributes * @return string */ if ( ! function_exists('mailto')) { //$email 邮箱地址 //$title 标题 //$attributes 参数 function mailto($email, $title = '', $attributes = '') { $title = (string) $title; if ($title == "") { $title = $email; } $attributes = _parse_attributes($attributes); return '<a href="mailto:'.$email.'"'.$attributes.'>'.$title.'</a>'; } } // ------------------------------------------------------------------------ /** * Encoded Mailto Link * 编码mailto链接 * Create a spam-protected mailto link written in Javascript * 创建Javascript编写的垃圾邮件保护mailto链接 * @access public * @param string the email address * @param string the link title * @param mixed any attributes * @return string */ //感觉不出来什么 if ( ! function_exists('safe_mailto')) { function safe_mailto($email, $title = '', $attributes = '') { //字符串 $title = (string) $title; //标题为空时,用email来填 if ($title == "") { $title = $email; } //开始循环 for ($i = 0; $i < 16; $i++) { $x[] = substr('<a href="mailto:', $i, 1); } for ($i = 0; $i < strlen($email); $i++) { $x[] = "|".ord(substr($email, $i, 1)); } $x[] = '"'; if ($attributes != '') { if (is_array($attributes)) { foreach ($attributes as $key => $val) { $x[] = ' '.$key.'="'; for ($i = 0; $i < strlen($val); $i++) { $x[] = "|".ord(substr($val, $i, 1)); } $x[] = '"'; } } else { for ($i = 0; $i < strlen($attributes); $i++) { $x[] = substr($attributes, $i, 1); } } } $x[] = '>'; $temp = array(); for ($i = 0; $i < strlen($title); $i++) { $ordinal = ord($title[$i]); if ($ordinal < 128) { $x[] = "|".$ordinal; } else { if (count($temp) == 0) { $count = ($ordinal < 224) ? 2 : 3; } $temp[] = $ordinal; if (count($temp) == $count) { $number = ($count == 3) ? (($temp['0'] % 16) * 4096) + (($temp['1'] % 64) * 64) + ($temp['2'] % 64) : (($temp['0'] % 32) * 64) + ($temp['1'] % 64); $x[] = "|".$number; $count = 1; $temp = array(); } } } $x[] = '<'; $x[] = '/'; $x[] = 'a'; $x[] = '>'; $x = array_reverse($x); ob_start(); ?><script type="text/javascript"> //<![CDATA[ var l=new Array(); <?php $i = 0; foreach ($x as $val){ ?>l[<?php echo $i++; ?>]='<?php echo $val; ?>';<?php } ?> for (var i = l.length-1; i >= 0; i=i-1){ if (l[i].substring(0, 1) == '|') document.write("&#"+unescape(l[i].substring(1))+";"); else document.write(unescape(l[i]));} //]]> </script><?php $buffer = ob_get_contents(); ob_end_clean(); return $buffer; } } // ------------------------------------------------------------------------ /** * Auto-linker * 自动连接器 * * Automatically links URL and Email addresses. * Note: There's a bit of extra code here to deal with * URLs or emails that end in a period. We'll strip these * off and add them after the link. * 自动链接URL和电子邮件地址。 * 注意:这里有一个额外的代码位处理 * URL或电子邮件,在一个时期结束。我们会去除这些 * 关闭,并把它们添加链接后。 * @access public * @param string the string * @param string the type: email, url, or both * @param bool whether to create pop-up links * @return string */ if ( ! function_exists('auto_link')) { function auto_link($str, $type = 'both', $popup = FALSE) { if ($type != 'email') { if (preg_match_all("#(^|\s|\()((http(s?)://)|(www\.))(\w+[^\s\)\<]+)#i", $str, $matches)) { $pop = ($popup == TRUE) ? " target=\"_blank\" " : ""; for ($i = 0; $i < count($matches['0']); $i++) { $period = ''; if (preg_match("|\.$|", $matches['6'][$i])) { $period = '.'; $matches['6'][$i] = substr($matches['6'][$i], 0, -1); } $str = str_replace($matches['0'][$i], $matches['1'][$i].'<a href="http'. $matches['4'][$i].'://'. $matches['5'][$i]. $matches['6'][$i].'"'.$pop.'>http'. $matches['4'][$i].'://'. $matches['5'][$i]. $matches['6'][$i].'</a>'. $period, $str); } } } if ($type != 'url') { if (preg_match_all("/([a-zA-Z0-9_\.\-\+]+)@([a-zA-Z0-9\-]+)\.([a-zA-Z0-9\-\.]*)/i", $str, $matches)) { for ($i = 0; $i < count($matches['0']); $i++) { $period = ''; if (preg_match("|\.$|", $matches['3'][$i])) { $period = '.'; $matches['3'][$i] = substr($matches['3'][$i], 0, -1); } $str = str_replace($matches['0'][$i], safe_mailto($matches['1'][$i].'@'.$matches['2'][$i].'.'.$matches['3'][$i]).$period, $str); } } } return $str; } } // ------------------------------------------------------------------------ /** * Prep URL * 准备网址 * Simply adds the http:// part if no scheme is included * 只需添加http://部分如果没有计划包括, * @access public * @param string the URL * @return string */ if ( ! function_exists('prep_url')) { function prep_url($str = '') { if ($str == 'http://' OR $str == '') { return ''; } $url = parse_url($str); if ( ! $url OR ! isset($url['scheme'])) { $str = 'http://'.$str; } return $str; } } // ------------------------------------------------------------------------ /** * Create URL Title * 创建URL标题 * * Takes a "title" string as input and creates a * human-friendly URL string with a "separator" string * as the word separator. * *拍摄“标题”字符串作为输入, * 并创建一个人性化的“分隔符”字符串的URL字符串单词分隔符。 * @access public * @param string the string * @param string the separator * @return string */ if ( ! function_exists('url_title')) { function url_title($str, $separator = '-', $lowercase = FALSE) { // if ($separator == 'dash') { $separator = '-'; } else if ($separator == 'underscore') { $separator = '_'; } //preg_quote() 转义正则表达式字符 //preg_quote() 需要参数str并向其中每个正则表式语法中的字符前增加一个反斜线,这通常用于你有一些运行时字符串,需要作为正则表达式进行匹配的时候 //正则表达式特殊字符有: . \ + * ? [ ^ ] $ ( ) { } = ! < > | : - $q_separator = preg_quote($separator); $trans = array( '&.+?;' => '', '[^a-z0-9 _-]' => '', '\s+' => $separator, '('.$q_separator.')+' => $separator ); $str = strip_tags($str); foreach ($trans as $key => $val) { $str = preg_replace("#".$key."#i", $val, $str); } if ($lowercase === TRUE) { $str = strtolower($str); } return trim($str, $separator); } } // ------------------------------------------------------------------------ /** * Header Redirect * 头重定向 * * Header redirect in two flavors * For very fine grained control over headers, you could use the Output * Library's set_header() function. * 头重定向两种口味 * 头非常细粒度的控制,你可以使用输出 * 图书馆set_header()函数。 * @access public * @param string the URL * @param string the method: location or redirect * @return string */ if ( ! function_exists('redirect')) { function redirect($uri = '', $method = 'location', $http_response_code = 302) { //如果不是以https?开头的话 if ( ! preg_match('#^https?://#i', $uri)) { $uri = site_url($uri); } //refresh switch($method) { //1.隔5秒种自动刷新页面: //<meta http-equiv="refresh" content="5" /> //2.隔5秒种自动转到链接地址的页面: //<meta http-equiv="refresh" content="5; url=链接地址" /> case 'refresh' : header("Refresh:0;url=".$uri); break; default : header("Location: ".$uri, TRUE, $http_response_code); break; } exit; } } // ------------------------------------------------------------------------ /** * Parse out the attributes * 解析出的属性 * Some of the functions use this * 有些功能使用此 * @access private * @param array * @param bool * @return string */ if ( ! function_exists('_parse_attributes')) { function _parse_attributes($attributes, $javascript = FALSE) { //如果为字符串 直接返回 if (is_string($attributes)) { return ($attributes != '') ? ' '.$attributes : ''; } $att = ''; //开始循环 foreach ($attributes as $key => $val) { //如果为$javascript 为true if ($javascript == TRUE) { // $att .= $key . '=' . $val . ','; } else { $att .= ' ' . $key . '="' . $val . '"'; } } if ($javascript == TRUE AND $att != '') { $att = substr($att, 0, -1); } return $att; } } /* End of file url_helper.php */ /* Location: ./system/helpers/url_helper.php */