©
本文档使用
php中文网手册 发布
URL帮助文件包含有助于使用URL的功能。
加载此助手
可用职能
使用以下代码加载此助手：
$this->load->helper('url');现有下列职能：
site_url([$uri = ''[, $protocol = NULL]])
参数： | $ uri（string） - URI字符串$ protocol（string） - 协议，例如'http'或'https' |
|---|---|
返回： | 网站网址 |
返回类型： | 串 |
$ uri（字符串） - URI字符串
$ protocol（string） - 协议，例如'http'或'https'
Returns: Site URL
Return type: string
按照配置文件中的指定返回您的站点URL。index.php文件（或者你在你的配置文件中设置为你的站点**索引\ _page **的文件）将被添加到URL中，你传递给函数的任何URI段以及** url \ _suffix **在你的配置文件中设置。
我们鼓励您在需要生成本地URL时使用此函数，以便在URL更改时页面变得更可移植。
可以选择将段作为字符串或数组传递给函数。下面是一个字符串示例：
echo site_url（'news / local / 123'）;
上面的示例将返回如下内容：http：//example.com/index.php/news/local/123
下面是作为数组传递的段的示例：
$ segments = array（'news'，'local'，'123'）; echo site_url（$ segments）;
此函数是CI_Config::site_url()有关更多信息，请参见配置库文件。
base_url($uri = '', $protocol = NULL)
参数： | $ uri（string） - URI字符串$ protocol（string） - 协议，例如'http'或'https' |
|---|---|
返回： | 基本网址 |
返回类型： | 串 |
$ uri（字符串） - URI字符串
$ protocol（string） - 协议，例如'http'或'https'
Returns: Base URL
Return type: string
按照配置文件中的规定返回您的网站基础URL。例：
echo base_url（）;
此函数返回与site_url()，没有指数[医]页或URL[医]后缀被追加。
也像site_url()，可以将段作为字符串或数组提供。下面是一个字符串示例：
echo base_url（“blog / post / 123”）;
上面的示例将返回如下内容：http：//example.com/blog/post/123
这是有用的，因为不像site_url()，您可以向文件(如图像或样式表)提供字符串。例如：
echo base_url（“images / icons / edit.png”）;
这会给你这样的东西：http：//example.com/映像/图标/ed.png
此函数是CI_Config::base_url()有关更多信息，请参见配置库文件。
current_url()
返回： | 当前的网址 |
|---|---|
返回类型： | 串 |
uri_string()
返回： | 一个URI字符串 |
|---|---|
返回类型： | 串 |
index_page()
返回： | 'index_page'值 |
|---|---|
返回类型： | mixed |
anchor($uri = '', $title = '', $attributes = '')
参数： | $ uri（字符串） - URI字符串$ title（字符串） - 锚定标题$ attributes（mixed） - HTML属性 |
|---|---|
返回： | HTML超链接（锚标签） |
返回类型： | 串 |
$ uri（字符串） - URI字符串
$ title（字符串） - 锚定标题
$ attributes（mixed） - HTML属性
Returns: HTML hyperlink (anchor tag)
Return type: string
根据您的本地网站URL创建标准的HTML定位链接。
第一个参数可以包含您希望附加到URL的任何段。就像site_url()函数，段可以是字符串，也可以是数组。
注
如果您正在构建应用程序内部的链接，请不要包含基本URL（http：// ...）。这将从您的配置文件中指定的信息自动添加。仅包含您希望附加到URL的URI段。
第二部分是你想要链接的文本。如果将其保留为空白，则将使用URL。
第三个参数可以包含要添加到链接中的属性列表。属性可以是简单的字符串或关联数组。
以下是一些例子：
echo anchor('news/local/123', 'My News', 'title="News title"'); // Prints: <a href="http://example.com/index.php/news/local/123" title="News title">My News</a> echo anchor('news/local/123', 'My News', array('title' => 'The best news!')); // Prints: <a href="http://example.com/index.php/news/local/123" title="The best news!">My News</a> echo anchor('', 'Click here'); // Prints: <a href="http://example.com">Click Here</a>
anchor_popup($uri = '', $title = '', $attributes = FALSE)
参数： | $ uri（字符串） - URI字符串$ title（字符串） - 锚定标题$ attributes（mixed） - HTML属性 |
|---|---|
返回： | 弹出超链接 |
返回类型： | 串 |
$ uri（字符串） - URI字符串
$ title（字符串） - 锚定标题
$ attributes（mixed） - HTML属性
Returns: Pop-up hyperlink
Return type: string
Nearly identical to the [`anchor()`](about:blank#anchor) function except that it opens the URL in a new window. You can specify JavaScript window attributes in the third parameter to control how the window is opened. If the third parameter is not set it will simply open a new window with your own browser settings.
下面是一个具有属性的示例：
$atts = array( 'width' => 800, 'height' => 600, 'scrollbars' => 'yes', 'status' => 'yes', 'resizable' => 'yes', 'screenx' => 0, 'screeny' => 0, 'window_name' => '_blank' ); echo anchor_popup('news/local/123', 'Click Me!', $atts);
注
上述属性是函数的默认值，所以你只需要设置与你需要的不同。如果您希望函数使用其所有默认值，只需在第三个参数中传递一个空数组：| | echo anchor_popup（'news / local / 123'，'Click Me！'，array（））;
注
该window_name是不是一个真正的属性，但参数给JavaScript window.open() <http://www.w3schools.com/jsref/met_win_open.asp>方法，它可以接受窗口名称或窗目标。
注
上面列出的任何其他属性都将被解析为锚标记的HTML属性。
mailto($email, $title = '', $attributes = '')
参数： | $ email（string） - 电子邮件地址$ title（字符串） - 定位标题$ attributes（mixed） - HTML属性 |
|---|---|
返回： | “邮件到”超链接 |
返回类型： | 串 |
$ email（字符串） - 电子邮件地址
$ title（字符串） - 锚定标题
$ attributes（mixed） - HTML属性
Returns: A “mail to” hyperlink
Return type: string
创建一个标准的HTML电子邮件链接。用法示例：
echo mailto（'email protected'，'点击这里与我联系'）;
就像anchor()选项卡上，您可以使用第三个参数设置属性：
$ attributes = array（'title'=>'Mail me'）; echo mailto（'email protected'，'联系我'，$ attributes）;
safe_mailto($email, $title = '', $attributes = '')
参数： | $ email（string） - 电子邮件地址$ title（字符串） - 定位标题$ attributes（mixed） - HTML属性 |
|---|---|
返回： | 垃圾邮件安全的“邮件至”超链接 |
返回类型： | 串 |
$ email（字符串） - 电子邮件地址
$ title（字符串） - 锚定标题
$ attributes（mixed） - HTML属性
Returns: A spam-safe “mail to” hyperlink
Return type: string
Identical to the [`mailto()`](about:blank#mailto) function except it writes an obfuscated version of the _mailto_ tag using ordinal numbers written with JavaScript to help prevent the e-mail address from being harvested by spam bots.
auto_link($str, $type = 'both', $popup = FALSE)
参数： | $ str（string） - 输入字符串$ type（string） - 链接类型（'email'，'url'或'both'）$ popup（bool） - 是否创建弹出链接 |
|---|---|
返回： | 链接的字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串
$ type（string） - 链接类型（'email'，'url'或'both'）
$ popup（bool） - 是否创建弹出链接
Returns: Linkified string
Return type: string
自动将包含在字符串中的URL和电子邮件地址转换为链接。例：
$ string = auto_link（$ string）;
第二个参数决定URL和电子邮件是否被转换，或者仅仅是其中一个.。如果未指定参数，则为默认行为。电子邮件链接被编码为safe_mailto()如上文所示。
仅转换URL：
$ string = auto_link（$ string，'url'）;
只转换电子邮件地址：
$ string = auto_link（$ string，'email'）;
第三个参数确定链接是否显示在新窗口中。该值可以是TRUE或FALSE（布尔值）：
$ string = auto_link（$ string，'both'，TRUE）;
url_title($str, $separator = '-', $lowercase = FALSE)
参数： | $ str（string） - 输入字符串$ separator（string） - 字符分隔符$ lowercase（bool） - 是否将输出字符串转换为小写 |
|---|---|
返回： | URL格式的字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串
$ separator（string） - 单词分隔符
$ lowercase（bool） - 是否将输出字符串转换为小写
Returns: URL-formatted string
Return type: string
Takes a string as input and creates a human-friendly URL string. This is useful if, for example, you have a blog in which you’d like to use the title of your entries in the URL. Example:
$ title =“CSS有什么问题？”; $ url_title = url_title（$ title）; //产生：CSS错误
第二个参数确定单词分隔符。默认使用破折号。首选选项是：-（短划线）或_（下划线）
例子：
$ title =“CSS有什么问题？”; $ url_title = url_title（$ title，'underscore'）; //产生：Whats_wrong_with_CSS
注
旧用法‘破折号’和‘下划线’作为第二个参数被废弃。
第三个参数确定是否强制使用小写字符。默认情况下他们不是。选项是布尔值TRUE / FALSE。
例子：
$ title =“CSS有什么问题？”; $ url_title = url_title（$ title，'underscore'，TRUE）; //产生：whats_wrong_with_css
prep_url($str = '')
参数： | $ str（string） - URL字符串 |
|---|---|
返回： | 协议前缀的URL字符串 |
返回类型： | 串 |
$ str（string） - URL字符串返回：协议加前缀的URL字符串返回类型：字符串在URL中缺少协议前缀的情况下，此函数将添加http：//。将URL字符串传递给像这样的函数：$ url = prep_url（'example.com'）; redirect($uri = '', $method = 'auto', $code = NULL)参数：$ uri（字符串） - URI字符串$方法（字符串） - 重定向方法（'auto'，'location'或'refresh'）$ code（字符串） - HTTP响应代码（通常为302或303）返回类型：void
$ uri（字符串） - URI字符串
$ method（string） - 重定向方法（'auto'，'location'或'refresh'）
$ code（字符串） - HTTP响应代码（通常为302或303）
Return type: void
“标题重定向到”指定的URI。如果指定将构建链接的完整网站URL，但对于本地链接，只需将URI段提供给要指向的控制器即可创建链接。该函数将根据您的配置文件值构建URL。
可选的第二个参数允许您强制使用特定的重定向方法。可用的方法是自动，位置和刷新，在IIS服务器上位置更快但可靠性更低。缺省值为auto，它将尝试基于服务器环境智能地选择方法。
可选的第三个参数允许您发送特定的HTTP响应代码--例如，这可以用于创建301重定向以用于搜索引擎。默认响应代码为302。第三个参数是只可与位置重定向，而不是刷新.例子：
if（$ logged_in == FALSE）{redirect（'/ login / form /'）; } // 301重定向重定向（'/ article / 13'，'location'，301）;
注
为了使此功能起作用，必须在将任何内容输出到浏览器之前使用它，因为它使用服务器标题。
注
对于对头的非常细粒度的控制，您应该使用输出库set_header()方法。
注
对于IIS用户：如果您隐藏Serverhttp标头，汽车方法不会检测到IIS，在这种情况下，建议您显式使用刷新方法。
注
当位置方法时，HTTPStatus代码为303自动当前通过POST访问页面并使用HTTP/1.1时，请选择。