URL Helper

URL助手

URL帮助文件包含有助于使用URL的功能。

• 加载此助手

• 可用职能

加载此助手

使用以下代码加载此助手：

$this->load->helper('url'

可用职能

现有下列职能：

site_url([$uri = ''[, $protocol = NULL]])

• $ 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（字符串） - 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()

index_page()

anchor($uri = '', $title = '', $attributes = '')

• $ 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属性

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（字符串） - 电子邮件地址

• $ 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（字符串） - 电子邮件地址

• $ 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） - 是否创建弹出链接

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） - 是否将输出字符串转换为小写

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字符串返回类型：字符串在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时，请选择。

重要

此函数将终止脚本执行。