raoyc
/
codeigniter_user_guide_chs


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218
							<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="utf-8" lang="utf-8">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=0" />
<title>User-Agent 类 - CodeIgniter 中文手册|用户手册|用户指南|Wiki文档</title>
<link rel="shortcut icon" href="http://codeigniter.org.cn/user_guide/../images/design/favicon.ico" type="image/x-icon" />
<link rel="stylesheet" type="text/css" media="all" href="../userguide.css" />
<link rel="search" href="http://codeigniter.org.cn/user_guide/../CodeIgniterSearch.xml" type="application/opensearchdescription+xml" title="CodeIgniter 搜索"/>
<link rel="canonical" href="http://codeigniter.org.cn/user_guide/libraries/user_agent.html" />
<script type="text/javascript" src="../nav/mootools.js-ver=20130324.js"></script>
<script type="text/javascript" src="../nav/mootools-more.js-ver=20130324.js"></script>
<script type="text/javascript" src="../nav/nav.js-ver=20130324.js"></script>
<script type="text/javascript" src="../nav/user_guide_menu.js-ver=20130324.js"></script>
<meta name="robots" content="all" />
<meta name="author" content="ExpressionEngine Dev Team" />
<meta name="description" content="CodeIgniter 中文手册, CodeIgniter 用户指南, CodeIgniter User Guide, Wiki 文档" />
</head>
<body>
<!-- START NAVIGATION -->
<div id="nav">
  <div id="nav_inner">
    <script type="text/javascript">create_menu('../');</script>
  </div>
</div>
<script type="text/javascript">_setNavigation();</script>
<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="切换目录" alt="切换目录" /></a></div>
<div id="masthead" class="clearfix">
    <div class="topbar-hd"><h1>CodeIgniter 用户指南 版本 2.2.0</h1></div>
<div class="topbar-tip">编辑文档、查看近期更改请 <a href="#">登录</a> 或 <a href="#">注册</a> 　<a href="#">找回密码</a></div>      <div id="breadcrumb_right"><a href="../toc.html">目录页</a></div>
</div>
<!-- END NAVIGATION -->
<!-- START BREADCRUMB -->
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
  <tr>
    <td id="breadcrumb">
        <a href="#" target="_blank">CodeIgniter 中国首页</a>&nbsp;&#8250;&nbsp;
<a href="../index.html">用户指南首页</a>&nbsp;&#8250;&nbsp;User-Agent 类    </td>
    <td id="searchbox">
        <form method="get" action="http://www.google.com.hk/search" target="google_window">
        <input type="hidden" name="client" value="pub-0176846097796333"></input>
        <input type="hidden" name="forid" value="1"></input>
        <input type="hidden" name="ie" value="UTF-8"></input>
        <input type="hidden" name="oe" value="UTF-8"></input>
        <input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.org.cn/user_guide/" />
        搜索用户指南&nbsp;
        <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />
        &nbsp;
        <input type="submit" class="submit" name="sa" value="Go" />
      </form>
    </td>
  </tr>
</table>
<!-- END BREADCRUMB -->
<div style="clear:both;text-align:right;padding: 6px 40px 0 0;">
<a href="#" target="_blank">查看原文</a>
</div>
<!--<br clear="all" />--><!-- START CONTENT -->
<div id="content">
<h1>User-Agent 类</h1>

<p>用户代理类提供的功能是，帮助识别是浏览器，还是移动设备或是机器人访问你的站点。另外，你可以得到referrer信息（译注：referrer信息就是访客来源信息，可以参照一般的统计系统来理解），以及语言，和支持的字符集信息。</p>

<h2>初始化类</h2>

<p>和大多数其他CI类一样，User Agent类也是在你的控制器里使用<dfn>$this-&gt;load-&gt;library</dfn> 方法完成初始化工作</p>

<code>$this-&gt;load-&gt;library('user_agent');</code>
<p>一旦加载, 对象就可以使用了: <dfn>$this-&gt;agent</dfn></p>

<h2>用户代理定义</h2>

<p>用户代理名称的定义，位于一个配置文件: <dfn>application/config/user_agents.php</dfn>.  如果你需要你可以添加项目到user agent数组</p>

<h2>示例</h2>

<p>当User Agent 类初始化后，它会判断浏览你的网站是Web浏览器，还是移动设备，还是机器人。它还收集相关的操作系统信息</p>


<code>
$this-&gt;load-&gt;library('user_agent');<br />
<br />
if ($this-&gt;agent-&gt;is_browser())<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;$agent  = $this-&gt;agent-&gt;browser().' '.$this-&gt;agent-&gt;version();<br />
&#125;<br />

elseif ($this-&gt;agent-&gt;is_robot())<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;$agent = $this-&gt;agent-&gt;robot();<br />
&#125;<br />
elseif ($this-&gt;agent-&gt;is_mobile())<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;$agent = $this-&gt;agent-&gt;mobile();<br />
&#125;<br />
else<br />

&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;$agent = 'Unidentified User Agent';<br />
&#125;<br />
<br />
echo $agent;<br />
<br />
echo $this-&gt;agent-&gt;platform(); // Platform info (Windows, Linux, Mac, etc.)
</code>


<h1>函数参考</h1>

<h2>$this-&gt;agent-&gt;is_browser()</h2>
<p>根据用户代理是否是一个已知的web浏览器，返回 TRUE/FALSE (boolean)</p>

<code> if ($this-&gt;agent-&gt;is_browser('Safari'))<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;echo 'You are using Safari.';<br />
&#125;<br />
else if ($this-&gt;agent-&gt;is_browser())<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;echo 'You are using a browser.';<br />
&#125;</code>

<p class="important"><strong>Note:</strong>&nbsp; The string "Safari" in this example is an array key in the list of browser definitions.
You can find this list in <dfn>application/config/user_agents.php</dfn> if you want to add new browsers or change the stings.</p>

<h2>$this-&gt;agent-&gt;is_mobile()</h2>
<p>根据用户代理是否是一个已知的移动设备，返回 TRUE/FALSE (boolean) </p>

<code> if ($this-&gt;agent-&gt;is_mobile('iphone'))<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;$this-&gt;load-&gt;view('iphone/home');<br />
&#125;<br />
else if ($this-&gt;agent-&gt;is_mobile())<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;$this-&gt;load-&gt;view('mobile/home');<br />
&#125;<br/>
else<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;$this-&gt;load-&gt;view('web/home');<br />
&#125;</code>

<h2>$this-&gt;agent-&gt;is_robot()</h2>
<p>根据用户代理是否是机器人，返回 TRUE/FALSE (boolean)</p>

<p class="important"><strong>注意:</strong>&nbsp; 用户代理类仅包含了最常见的机器人定义。它不是一个完整的机器人清单。如果你觉得有些经常访问你的网站的机器人不在名单中，你可以将它们添加到你的<dfn>application/config/user_agents.php</dfn> 文件中.</p>

<h2>$this-&gt;agent-&gt;is_referral()</h2>
<p>根据用户代理是否是从另一网站链接过来，返回 TRUE/FALSE (boolean) </p>


<h2>$this-&gt;agent-&gt;browser()</h2>
<p>返回一个字符串，就是浏览你的网站的浏览器名称</p>

<h2>$this-&gt;agent-&gt;version()</h2>

<p>返回浏览器的版本号</p>

<h2>$this-&gt;agent-&gt;mobile()</h2>
<p>返回访问你的站点的移动设备名称</p>

<h2>$this-&gt;agent-&gt;robot()</h2>
<p>返回访问你的站点的机器人名称</p>

<h2>$this-&gt;agent-&gt;platform()</h2>
<p>返回访问你的站点的操作系统(Linux, Windows, OS X, 等等).</p>

<h2>$this-&gt;agent-&gt;referrer()</h2>
<p>如果用户代理是从其他站点链接过来的，你可以做如下判断</p>

<code> if ($this-&gt;agent-&gt;is_referral())<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;echo $this-&gt;agent-&gt;referrer();<br />
&#125;</code>


<h2>$this-&gt;agent-&gt;agent_string()</h2>
<p>返回一个字符串包含所有用户代理信息。通常它会是这样的:</p>

<code>Mozilla/5.0 (Macintosh; U; Intel Mac OS X; en-US; rv:1.8.0.4) Gecko/20060613 Camino/1.0.2</code>


<h2>$this-&gt;agent-&gt;accept_lang()</h2>
<p>让你确认，用户代理是否包含一种特定的语言。例:</p>

<code>if ($this-&gt;agent-&gt;accept_lang('en'))<br />
&#123;<br />

&nbsp;&nbsp;&nbsp;&nbsp;echo 'You accept English!';<br />
&#125;</code>

<p class="important"><strong>注意:</strong> 这一功能通常不是很可靠，因为有些浏览器不提供语言信息，即使提供了，也不一定准确 </p>


<h2>$this-&gt;agent-&gt;accept_charset()</h2>
<p>让你确认，用户代理是否包含一种特定的字符集。例:</p>

<code>if ($this-&gt;agent-&gt;accept_charset('utf-8'))<br />
&#123;<br />
&nbsp;&nbsp;&nbsp;&nbsp;echo 'You browser supports UTF-8!';<br />
&#125;</code>

<p class="important"><strong>注意:</strong> 这一功能通常不是很可靠，因为有些浏览器不提供字符集信息，或是提供的信息不一定正确 </p><p>&nbsp;</p>
<div id="Contributors">
翻译贡献者:
Hex, kissmumu</div>
<div id="DocDate">
最后修改: 2011-02-01 02:11:44</div>
</div>
<!-- END CONTENT -->
<div id="footer">
  <p>
上一个主题:&nbsp;&nbsp;<a href="uri.html">URI 类</a>&nbsp;&nbsp;&middot;&nbsp;&nbsp;<a href="#top">页首</a>
&nbsp;&middot;&nbsp;&nbsp;<a href="../index.html">用户指南首页</a>&nbsp;&nbsp;&middot;&nbsp;&nbsp;下一个主题:&nbsp;&nbsp;<a href="xmlrpc.html">XML-RPC 类</a>  </p>
  <p><a href="#">CodeIgniter</a> &nbsp;&middot;&nbsp; 版权所有 &#169; 2006-2013 &nbsp;&middot;&nbsp; <a href="#">Ellislab, Inc.</a></p>
  <p>中文化: <a href="#">CodeIgniter 中国</a> &nbsp;&middot;&nbsp; 制作: Hex &nbsp;&middot;&nbsp; 版本: 1.30 &nbsp;&middot;&nbsp; 鸣谢: 子非鱼</p>
</div>
</body>
</html>