PageRenderTime 40ms CodeModel.GetById 10ms RepoModel.GetById 0ms app.codeStats 0ms

/php/function.parse-url.html

https://bitbucket.org/stillzhl/manuals
HTML | 277 lines | 237 code | 40 blank | 0 comment | 0 complexity | 6f02683a6c88425fd039d1b6e576e20c MD5 | raw file
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3.  <head>
    4. 

  4.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    5. 

  5.   <title>解析 URL，返回其组成部分</title>
    6. 

  6. 

  7.  </head>
    8. 

  8.  <body><div class="manualnavbar" style="text-align: center;">
    9. 

  9.  <div class="prev" style="text-align: left; float: left;"><a href="function.http-build-query.html">http_build_query</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="function.rawurldecode.html">rawurldecode</a></div>
    11. 

  11.  <div class="up"><a href="ref.url.html">URL 函数</a></div>
    12. 

  12.  <div class="home"><a href="index.html">PHP Manual</a></div>
    13. 

  13. </div><hr /><div id="function.parse-url" class="refentry">
    14. 

  14.  <div class="refnamediv">
    15. 

  15.   <h1 class="refname">parse_url</h1>
    16. 

  16.   <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">parse_url</span> &mdash; <span class="dc-title">解析 URL，返回其组成部分</span></p>
    17. 

  17. 

  18.  </div>
    19. 

  19.  
    20. 

  20.  <div class="refsect1 description" id="refsect1-function.parse-url-description">
    21. 

  21.   <h3 class="title">说明</h3>
    22. 

  22.   <div class="methodsynopsis dc-description">
    23. 

  23.    <span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <span class="methodname"><strong>parse_url</strong></span>
    24. 

  24.     ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$url</code></span>
    25. 

  25.    [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$component</code><span class="initializer"> = -1</span></span>
    26. 

  26.   ] )</div>
    27. 

  27. 

  28.   <p class="para rdfs-comment">
    29. 

  29.    本函数解析一个 URL 并返回一个关联数组，包含在 URL 中出现的各种组成部分。
    30. 

  30.   </p>
    31. 

  31.   <p class="para">
    32. 

  32.    本函数<em class="emphasis">不是</em>用来验证给定 URL
    33. 

  33.    的合法性的，只是将其分解为下面列出的部分。不完整的 URL
    34. 

  34.    也被接受， <span class="function"><strong>parse_url()</strong></span> 会尝试尽量正确地将其解析。
    35. 

  35.   </p>
    36. 

  36.  </div>
    37. 

  37. 

  38. 

  39.  <div class="refsect1 parameters" id="refsect1-function.parse-url-parameters">
    40. 

  40.   <h3 class="title">参数</h3>
    41. 

  41.   <p class="para">
    42. 

  42.    <dl>
    43. 

  43. 

  44.     <dt>
    45. 

  45. 

  46.      <span class="term"><em><code class="parameter">url</code></em></span>
    47. 

  47.      <dd>
    48. 

  48. 

  49.       <p class="para">
    50. 

  50.        要解析的 URL。无效字符将使用
    51. 

  51.        <em>_</em> 来替换。
    52. 

  52.       </p>
    53. 

  53.      </dd>
    54. 

  54. 

  55.     </dt>
    56. 

  56. 

  57.    </dl>
    58. 

  58. 

  59.    <dl>
    60. 

  60. 

  61.     <dt>
    62. 

  62. 

  63.      <span class="term"><em><code class="parameter">component</code></em></span>
    64. 

  64.      <dd>
    65. 

  65. 

  66.       <p class="para">
    67. 

  67.        指定 <strong><code>PHP_URL_SCHEME</code></strong>、
    68. 

  68.        <strong><code>PHP_URL_HOST</code></strong>、 <strong><code>PHP_URL_PORT</code></strong>、
    69. 

  69.        <strong><code>PHP_URL_USER</code></strong>、 <strong><code>PHP_URL_PASS</code></strong>、
    70. 

  70.        <strong><code>PHP_URL_PATH</code></strong>、 <strong><code>PHP_URL_QUERY</code></strong>
    71. 

  71.        或 <strong><code>PHP_URL_FRAGMENT</code></strong> 的其中一个来获取 URL 中指定的部分的 <span class="type"><a href="language.types.string.html" class="type string">string</a></span>。 （除了指定为 <strong><code>PHP_URL_PORT</code></strong> 后，将返回一个 <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span> 的值）。
    72. 

  72.       </p>
    73. 

  73.      </dd>
    74. 

  74. 

  75.     </dt>
    76. 

  76. 

  77.    </dl>
    78. 

  78. 

  79.   </p>
    80. 

  80.  </div>
    81. 

  81. 

  82. 

  83.  <div class="refsect1 returnvalues" id="refsect1-function.parse-url-returnvalues">
    84. 

  84.   <h3 class="title">返回值</h3>
    85. 

  85.   <p class="para">
    86. 

  86.    对严重不合格的 URL， <span class="function"><strong>parse_url()</strong></span> 可能会返回
    87. 

  87.    <strong><code>FALSE</code></strong>。 
    88. 

  88.   </p>  
    89. 

  89.    <p class="para">
    90. 

  90.     如果省略了 <em><code class="parameter">component</code></em> 参数，将返回一个关联数组 <span class="type"><a href="language.types.array.html" class="type array">array</a></span>，在目前至少会有一个元素在该数组中。数组中可能的键有以下几种：
    91. 

  91.    <ul class="itemizedlist">
    92. 

  92.     <li class="listitem">
    93. 

  93.      <span class="simpara">
    94. 

  94.       <var class="varname"><var class="varname">scheme</var></var> - 如 http
    95. 

  95.      </span>
    96. 

  96.     </li>
    97. 

  97.     <li class="listitem">
    98. 

  98.      <span class="simpara">
    99. 

  99.       <var class="varname"><var class="varname">host</var></var> 
    100. 

  100.      </span>
    101. 

  101.     </li>
    102. 

  102.     <li class="listitem">
    103. 

  103.      <span class="simpara">
    104. 

  104.       <var class="varname"><var class="varname">port</var></var>
    105. 

  105.      </span>
    106. 

  106.     </li>
    107. 

  107.     <li class="listitem">
    108. 

  108.      <span class="simpara">
    109. 

  109.       <var class="varname"><var class="varname">user</var></var>
    110. 

  110.      </span>
    111. 

  111.     </li>
    112. 

  112.     <li class="listitem">
    113. 

  113.      <span class="simpara">
    114. 

  114.       <var class="varname"><var class="varname">pass</var></var>
    115. 

  115.      </span>
    116. 

  116.     </li>
    117. 

  117.     <li class="listitem">
    118. 

  118.      <span class="simpara">
    119. 

  119.       <var class="varname"><var class="varname">path</var></var>
    120. 

  120.      </span>
    121. 

  121.     </li>
    122. 

  122.     <li class="listitem">
    123. 

  123.      <span class="simpara">
    124. 

  124.       <var class="varname"><var class="varname">query</var></var>  - 在问号 <em>?</em> 之后
    125. 

  125.      </span>
    126. 

  126.     </li>
    127. 

  127.     <li class="listitem">
    128. 

  128.      <span class="simpara">
    129. 

  129.       <var class="varname"><var class="varname">fragment</var></var> -  在散列符号 <em>#</em> 之后
    130. 

  130.      </span>
    131. 

  131.     </li>
    132. 

  132.    </ul>
    133. 

  133.   </p>
    134. 

  134.   <p class="para">
    135. 

  135.    如果指定了 <em><code class="parameter">component</code></em> 参数，
    136. 

  136.     <span class="function"><strong>parse_url()</strong></span> 返回一个 <span class="type"><a href="language.types.string.html" class="type string">string</a></span> （或在指定为 <strong><code>PHP_URL_PORT</code></strong> 时返回一个 <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>）而不是 <span class="type"><a href="language.types.array.html" class="type array">array</a></span>。如果 URL 中指定的组成部分不存在，将会返回 <strong><code>NULL</code></strong>。
    137. 

  137.   </p>
    138. 

  138.  </div>
    139. 

  139. 

  140. 

  141. 

  142.  <div class="refsect1 changelog" id="refsect1-function.parse-url-changelog">
    143. 

  143.   <h3 class="title">更新日志</h3>
    144. 

  144.   <p class="para">
    145. 

  145.    <table class="doctable informaltable">
    146. 

  146.     
    147. 

  147.      <thead>
    148. 

  148.       <tr>
    149. 

  149.        <th>版本</th>
    150. 

  150.        <th>说明</th>
    151. 

  151.       </tr>
    152. 

  152. 

  153.      </thead>
    154. 

  154. 

  155.      <tbody class="tbody">
    156. 

  156.       <tr>
    157. 

  157.        <td>5.4.7</td>
    158. 

  158.        <td>
    159. 

  159.         修复了 <em class="emphasis">host</em> 在 <em class="emphasis">协议</em> 省略时的识别。
    160. 

  160.        </td>
    161. 

  161.       </tr>
    162. 

  162. 

  163.       <tr>
    164. 

  164.        <td>5.3.3</td>
    165. 

  165.        <td>
    166. 

  166.         在 URL 解析失败时将不会产生 <strong><code>E_WARNING</code></strong> 级别的错误。
    167. 

  167.        </td>
    168. 

  168.       </tr>
    169. 

  169. 

  170.       <tr>
    171. 

  171.        <td>5.1.2</td>
    172. 

  172.        <td>增加了参数 <em><code class="parameter">component</code></em>。</td>
    173. 

  173.       </tr>
    174. 

  174. 

  175.      </tbody>
    176. 

  176.     
    177. 

  177.    </table>
    178. 

  178. 

  179.   </p>
    180. 

  180.  </div>
    181. 

  181. 

  182. 

  183.  <div class="refsect1 examples" id="refsect1-function.parse-url-examples">
    184. 

  184.   <h3 class="title">范例</h3>
    185. 

  185.   <p class="para">
    186. 

  186.   <div class="example" id="example-3878">
    187. 

  187.    <p><strong>Example #1  <span class="function"><strong>parse_url()</strong></span> 例子</strong></p>
    188. 

  188.    <div class="example-contents">
    189. 

  189. <div class="phpcode"><code><span style="color: #000000">
    190. 

  190. <span style="color: #0000BB">&lt;?php<br />$url&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'http://username:password@hostname/path?arg=value#anchor'</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">parse_url</span><span style="color: #007700">(</span><span style="color: #0000BB">$url</span><span style="color: #007700">));<br /><br />echo&nbsp;</span><span style="color: #0000BB">parse_url</span><span style="color: #007700">(</span><span style="color: #0000BB">$url</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">PHP_URL_PATH</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
    191. 

  191. </span>
    192. 

  192. </code></div>
    193. 

  193.     </div>
    194. 

  194. 

  195.     <div class="example-contents"><p>以上例程会输出：</p></div>
    196. 

  196.    <div class="example-contents screen">
    197. 

  197. <div class="cdata"><pre>
    198. 

  198. Array
    199. 

  199. (
    200. 

  200.     [scheme] =&gt; http
    201. 

  201.     [host] =&gt; hostname
    202. 

  202.     [user] =&gt; username
    203. 

  203.     [pass] =&gt; password
    204. 

  204.     [path] =&gt; /path
    205. 

  205.     [query] =&gt; arg=value
    206. 

  206.     [fragment] =&gt; anchor
    207. 

  207. )
    208. 

  208. /path
    209. 

  209. </pre></div>
    210. 

  210.    </div>
    211. 

  211.   </div>
    212. 

  212.  </p>
    213. 

  213.    <p class="para">
    214. 

  214.    <div class="example" id="example-3879">
    215. 

  215.     <p><strong>Example #2  <span class="function"><strong>parse_url()</strong></span> 解析丢失协议的例子</strong></p>
    216. 

  216.     <div class="example-contents">
    217. 

  217. <div class="phpcode"><code><span style="color: #000000">
    218. 

  218. <span style="color: #0000BB">&lt;?php<br />$url&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'//www.example.com/path?googleguy=googley'</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">//&nbsp;在&nbsp;5.4.7&nbsp;之前这会输出路径&nbsp;"//www.example.com/path"<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">parse_url</span><span style="color: #007700">(</span><span style="color: #0000BB">$url</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span>
    219. 

  219. </span>
    220. 

  220. </code></div>
    221. 

  221.     </div>
    222. 

  222. 

  223.     <div class="example-contents"><p>以上例程会输出：</p></div>
    224. 

  224.     <div class="example-contents screen">
    225. 

  225. <div class="cdata"><pre>
    226. 

  226. array(3) {
    227. 

  227.   [&quot;host&quot;]=&gt;
    228. 

  228.   string(15) &quot;www.example.com&quot;
    229. 

  229.   [&quot;path&quot;]=&gt;
    230. 

  230.   string(5) &quot;/path&quot;
    231. 

  231.   [&quot;query&quot;]=&gt;
    232. 

  232.   string(17) &quot;googleguy=googley&quot;
    233. 

  233. }
    234. 

  234. </pre></div>
    235. 

  235.     </div>
    236. 

  236.    </div>
    237. 

  237.   </p>
    238. 

  238.  </div>
    239. 

  239. 

  240. 

  241.  <div class="refsect1 notes" id="refsect1-function.parse-url-notes">
    242. 

  242.   <h3 class="title">注释</h3>
    243. 

  243.   <blockquote class="note"><p><strong class="note">Note</strong>: 
    244. 

  244.    <p class="para">
    245. 

  245.     本函数不能用于相对 URL。
    246. 

  246.    </p>
    247. 

  247.   </p></blockquote>
    248. 

  248.   <blockquote class="note"><p><strong class="note">Note</strong>: 
    249. 

  249.    <p class="para">
    250. 

  250.      <span class="function"><strong>parse_url()</strong></span> 是专门用来解析 URL 而不是 URI 的。不过为遵从 PHP
    251. 

  251.     向后兼容的需要有个例外，对 file:// 协议允许三个斜线（file:///...）。其它任何协议都不能这样。
    252. 

  252.    </p>
    253. 

  253.   </p></blockquote>
    254. 

  254.  </div>
    255. 

  255. 

  256. 

  257.  <div class="refsect1 seealso" id="refsect1-function.parse-url-seealso">
    258. 

  258.   <h3 class="title">参见</h3>
    259. 

  259.   <p class="para">
    260. 

  260.    <ul class="simplelist">
    261. 

  261.     <li class="member"> <span class="function"><a href="function.pathinfo.html" class="function" rel="rdfs-seeAlso">pathinfo()</a> - 返回文件路径的信息</span></li>
    262. 

  262.     <li class="member"> <span class="function"><a href="function.parse-str.html" class="function" rel="rdfs-seeAlso">parse_str()</a> - 将字符串解析成多个变量</span></li>
    263. 

  263.     <li class="member"> <span class="function"><a href="function.http-build-query.html" class="function" rel="rdfs-seeAlso">http_build_query()</a> - 生成 URL-encode 之后的请求字符串</span></li>
    264. 

  264.     <li class="member"> <span class="function"><a href="function.http-build-url.html" class="function" rel="rdfs-seeAlso">http_build_url()</a> - 产生一个 URL</span></li>
    265. 

  265.     <li class="member"> <span class="function"><a href="function.dirname.html" class="function" rel="rdfs-seeAlso">dirname()</a> - 返回路径中的目录部分</span></li>
    266. 

  266.     <li class="member"> <span class="function"><a href="function.basename.html" class="function" rel="rdfs-seeAlso">basename()</a> - 返回路径中的文件名部分</span></li>
    267. 

  267.     <li class="member"><a href="http://www.faqs.org/rfcs/rfc3986" class="link external">&raquo;&nbsp;RFC 3986</a></li>
    268. 

  268.    </ul>
    269. 

  269.   </p>
    270. 

  270.  </div>
    271. 

  271. 

  272. </div><hr /><div class="manualnavbar" style="text-align: center;">
    273. 

  273.  <div class="prev" style="text-align: left; float: left;"><a href="function.http-build-query.html">http_build_query</a></div>
    274. 

  274.  <div class="next" style="text-align: right; float: right;"><a href="function.rawurldecode.html">rawurldecode</a></div>
    275. 

  275.  <div class="up"><a href="ref.url.html">URL 函数</a></div>
    276. 

  276.  <div class="home"><a href="index.html">PHP Manual</a></div>
    277. 

  277. </div></body></html>
    278. 

  278.