PageRenderTime 45ms CodeModel.GetById 15ms RepoModel.GetById 0ms app.codeStats 0ms

/php/function.xml-set-external-entity-ref-handler.html

https://bitbucket.org/stillzhl/manuals
HTML | 161 lines | 119 code | 42 blank | 0 comment | 0 complexity | 740640d65345db98514920fae18e9b76 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>建立外部实体指向处理器</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.xml-set-end-namespace-decl-handler.html">xml_set_end_namespace_decl_handler</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="function.xml-set-notation-decl-handler.html">xml_set_notation_decl_handler</a></div>
    11. 

  11.  <div class="up"><a href="ref.xml.html">XML 解析器函数</a></div>
    12. 

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

  13. </div><hr /><div id="function.xml-set-external-entity-ref-handler" class="refentry">
    14. 

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

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

  16.     <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">xml_set_external_entity_ref_handler</span> &mdash; <span class="dc-title">建立外部实体指向处理器</span></p>
    17. 

  17. 

  18.    </div>
    19. 

  19.    
    20. 

  20.  <div class="refsect1 description" id="refsect1-function.xml-set-external-entity-ref-handler-description">
    21. 

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

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

  23.      <span class="type">bool</span> <span class="methodname"><strong>xml_set_external_entity_ref_handler</strong></span>
    24. 

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

  25.    , <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$handler</code></span>
    26. 

  26.      )</div>
    27. 

  27. 

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

  29.      为 <em><code class="parameter">parser</code></em> 参数指定的 XML 解析器建立外部实体指向处理器函数。
    30. 

  30.     </p>
    31. 

  31.    </div>
    32. 

  32. 

  33. 

  34.  <div class="refsect1 parameters" id="refsect1-function.xml-set-external-entity-ref-handler-parameters">
    35. 

  35.   <h3 class="title">参数</h3>
    36. 

  36.   <p class="para">
    37. 

  37.    <dl>
    38. 

  38. 

  39.     <dt>
    40. 

  40. 

  41.      <span class="term"><em><code class="parameter">parser</code></em></span>
    42. 

  42.      <dd>
    43. 

  43. 

  44.       <p class="para">
    45. 

  45.        XML 解析器的引用，用于建立外部实体指向处理器。
    46. 

  46.       </p>
    47. 

  47.      </dd>
    48. 

  48. 

  49.     </dt>
    50. 

  50. 

  51.     <dt>
    52. 

  52. 

  53.      <span class="term"><em><code class="parameter">handler</code></em></span>
    54. 

  54.      <dd>
    55. 

  55. 

  56.       <p class="para">
    57. 

  57.        参数 <em><code class="parameter">handler</code></em> 为表示函数名称的字符串，函数必须在为 <em><code class="parameter">parser</code></em> 指定的解析器调用  <span class="function"><a href="function.xml-parse.html" class="function">xml_parse()</a></span> 函数时已存在。
    58. 

  58.       </p>
    59. 

  59.       <p class="para">
    60. 

  60.        由 <em><code class="parameter">handler</code></em> 参数命名的函数名必须接受五个参数，并应该返回一个整型值。如果处理器的返回值为 <strong><code>FALSE</code></strong>（这也是函数没有确定返回值时的返回值），XML 解析器将停止解析，  <span class="function"><a href="function.xml-get-error-code.html" class="function">xml_get_error_code()</a></span> 函数将返回  <strong><code>XML_ERROR_EXTERNAL_ENTITY_HANDLING</code></strong>。
    61. 

  61.        <div class="methodsynopsis dc-description">
    62. 

  62.          <span class="methodname"><span class="replaceable">handler</span></span>
    63. 

  63.          ( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$parser</code></span>
    64. 

  64.         , <span class="methodparam"><span class="type">string</span> <code class="parameter">$open_entity_names</code></span>
    65. 

  65.         , <span class="methodparam"><span class="type">string</span> <code class="parameter">$base</code></span>
    66. 

  66.         , <span class="methodparam"><span class="type">string</span> <code class="parameter">$system_id</code></span>
    67. 

  67.         , <span class="methodparam"><span class="type">string</span> <code class="parameter">$public_id</code></span>
    68. 

  68.         )</div>
    69. 

  69. 

  70.        <dl>
    71. 

  71. 

  72.         <dt>
    73. 

  73. 

  74.          <span class="term"><em><code class="parameter">parser</code></em></span>
    75. 

  75.          <dd>
    76. 

  76. 

  77.           <span class="simpara">
    78. 

  78.             第一个参数 <span class="replaceable">parser</span> 为指向要调用处理器的 XML 解析器的指针。
    79. 

  79.           </span>
    80. 

  80.          </dd>
    81. 

  81. 

  82.         </dt>
    83. 

  83. 

  84.         <dt>
    85. 

  85. 

  86.          <span class="term"><em><code class="parameter">open_entity_names</code></em></span>
    87. 

  87.          <dd>
    88. 

  88. 

  89.           <span class="simpara">
    90. 

  90.            第二个参数 <em><code class="parameter">open_entity_names</code></em> 是为该实体的解析开放的实体名列表（包括被指向的实体名），这些实体名由空格隔开。
    91. 

  91.           </span>
    92. 

  92.          </dd>
    93. 

  93. 

  94.         </dt>
    95. 

  95. 

  96.         <dt>
    97. 

  97. 

  98.          <span class="term"><em><code class="parameter">base</code></em></span>
    99. 

  99.          <dd>
    100. 

  100. 

  101.           <span class="simpara">
    102. 

  102.           这个参数是解析外部实体的系统标识符（<em><code class="parameter">system_id</code></em>）的基础。当前该参数通常都被设置为空字符串。
    103. 

  103.           </span>
    104. 

  104.          </dd>
    105. 

  105. 

  106.         </dt>
    107. 

  107. 

  108.         <dt>
    109. 

  109. 

  110.          <span class="term"><em><code class="parameter">system_id</code></em></span>
    111. 

  111.          <dd>
    112. 

  112. 

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

  114.            第四个参数 <em><code class="parameter">system_id</code></em> 是在实体定义声明中指定的系统标识符。
    115. 

  115.           </span>
    116. 

  116.          </dd>
    117. 

  117. 

  118.         </dt>
    119. 

  119. 

  120.         <dt>
    121. 

  121. 

  122.          <span class="term"><em><code class="parameter">public_id</code></em></span>
    123. 

  123.          <dd>
    124. 

  124. 

  125.           <span class="simpara">
    126. 

  126.            第五个参数 <em><code class="parameter">public_id</code></em> 是在实体定义声明中指定的公共标识符，如果未指定任何标识符，则该字符串为空。公共标识符中的空格将按照 XML 的要求被正常化。
    127. 

  127.           </span>
    128. 

  128.          </dd>
    129. 

  129. 

  130.         </dt>
    131. 

  131. 

  132.        </dl>
    133. 

  133. 

  134.       </p>
    135. 

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

  136.        如果处理器函数名被设置为空字符串或者 <strong><code>FALSE</code></strong>，则该有问题的处理器将被屏蔽。
    137. 

  137.       </p>
    138. 

  138.       <blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">除了函数名，含有对象引用的数组和方法名也可以作为参数。</span></p></blockquote>
    139. 

  139.      </dd>
    140. 

  140. 

  141.     </dt>
    142. 

  142. 

  143.    </dl>
    144. 

  144. 

  145.   </p>
    146. 

  146.  </div>
    147. 

  147. 

  148. 

  149.  <div class="refsect1 returnvalues" id="refsect1-function.xml-set-external-entity-ref-handler-returnvalues">
    150. 

  150.   <h3 class="title">返回值</h3>
    151. 

  151.   <p class="para">
    152. 

  152.    成功时返回 <strong><code>TRUE</code></strong>， 或者在失败时返回 <strong><code>FALSE</code></strong>.
    153. 

  153.   </p>
    154. 

  154.  </div>
    155. 

  155. 

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

  157.  <div class="prev" style="text-align: left; float: left;"><a href="function.xml-set-end-namespace-decl-handler.html">xml_set_end_namespace_decl_handler</a></div>
    158. 

  158.  <div class="next" style="text-align: right; float: right;"><a href="function.xml-set-notation-decl-handler.html">xml_set_notation_decl_handler</a></div>
    159. 

  159.  <div class="up"><a href="ref.xml.html">XML 解析器函数</a></div>
    160. 

  160.  <div class="home"><a href="index.html">PHP Manual</a></div>
    161. 

  161. </div></body></html>
    162. 

  162.