PageRenderTime 48ms CodeModel.GetById 17ms RepoModel.GetById 1ms app.codeStats 0ms

/php/function.socket-set-option.html

https://bitbucket.org/thncr/manuals
HTML | 167 lines | 128 code | 39 blank | 0 comment | 0 complexity | b041e827f4ba3b1af72045d140d6ad87 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>Sets socket options for the socket</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.socket-set-nonblock.html">socket_set_nonblock</a></div>
    10. 

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

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

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

  13. </div><hr /><div id="function.socket-set-option" class="refentry">
    14. 

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

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

  16.   <p class="verinfo">(PHP 4 &gt;= 4.3.0, PHP 5)</p><p class="refpurpose"><span class="refname">socket_set_option</span> &mdash; <span class="dc-title">Sets socket options for the socket</span></p>
    17. 

  17. 

  18.  </div>
    19. 

  19.  
    20. 

  20.  <div class="refsect1 description" id="refsect1-function.socket-set-option-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>socket_set_option</strong></span>
    24. 

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

  25.    , <span class="methodparam"><span class="type">int</span> <code class="parameter">$level</code></span>
    26. 

  26.    , <span class="methodparam"><span class="type">int</span> <code class="parameter">$optname</code></span>
    27. 

  27.    , <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$optval</code></span>
    28. 

  28.    )</div>
    29. 

  29. 

  30.   <p class="para rdfs-comment">
    31. 

  31.    The  <span class="function"><strong>socket_set_option()</strong></span> function sets the option
    32. 

  32.    specified by the <em><code class="parameter">optname</code></em> parameter, at the
    33. 

  33.    specified protocol <em><code class="parameter">level</code></em>, to the value pointed to
    34. 

  34.    by the <em><code class="parameter">optval</code></em> parameter for the 
    35. 

  35.    <em><code class="parameter">socket</code></em>.
    36. 

  36.   </p>
    37. 

  37.  </div>
    38. 

  38. 

  39. 

  40.  <div class="refsect1 parameters" id="refsect1-function.socket-set-option-parameters">
    41. 

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

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

  43.    <dl>
    44. 

  44. 

  45.     <dt>
    46. 

  46. 

  47.      <span class="term"><em><code class="parameter">socket</code></em></span>
    48. 

  48.      <dd>
    49. 

  49. 

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

  51.        A valid socket resource created with  <span class="function"><a href="function.socket-create.html" class="function">socket_create()</a></span>
    52. 

  52.        or  <span class="function"><a href="function.socket-accept.html" class="function">socket_accept()</a></span>.
    53. 

  53.       </p>
    54. 

  54.      </dd>
    55. 

  55. 

  56.     </dt>
    57. 

  57. 

  58.     <dt>
    59. 

  59. 

  60.      <span class="term"><em><code class="parameter">level</code></em></span>
    61. 

  61.      <dd>
    62. 

  62. 

  63.       <p class="para">
    64. 

  64.        The <em><code class="parameter">level</code></em> parameter specifies the protocol
    65. 

  65.        level at which the option resides. For example, to retrieve options at
    66. 

  66.        the socket level, a <em><code class="parameter">level</code></em> parameter of
    67. 

  67.        <strong><code>SOL_SOCKET</code></strong> would be used. Other levels, such as
    68. 

  68.        TCP, can be used by specifying the protocol number of that level. 
    69. 

  69.        Protocol numbers can be found by using the 
    70. 

  70.         <span class="function"><a href="function.getprotobyname.html" class="function">getprotobyname()</a></span> function.
    71. 

  71.       </p>
    72. 

  72.      </dd>
    73. 

  73. 

  74.     </dt>
    75. 

  75. 

  76.     <dt>
    77. 

  77. 

  78.      <span class="term"><em><code class="parameter">optname</code></em></span>
    79. 

  79.      <dd>
    80. 

  80. 

  81.       <p class="para">
    82. 

  82.        The available socket options are the same as those for the
    83. 

  83.         <span class="function"><a href="function.socket-get-option.html" class="function">socket_get_option()</a></span> function.
    84. 

  84.       </p>
    85. 

  85.      </dd>
    86. 

  86. 

  87.     </dt>
    88. 

  88. 

  89.     <dt>
    90. 

  90. 

  91.      <span class="term"><em><code class="parameter">optval</code></em></span>
    92. 

  92.      <dd>
    93. 

  93. 

  94.       <p class="para">
    95. 

  95.        The option value.
    96. 

  96.       </p>
    97. 

  97.      </dd>
    98. 

  98. 

  99.     </dt>
    100. 

  100. 

  101.    </dl>
    102. 

  102. 

  103.   </p>
    104. 

  104.  </div>
    105. 

  105. 

  106. 

  107.  <div class="refsect1 returnvalues" id="refsect1-function.socket-set-option-returnvalues">
    108. 

  108.   <h3 class="title">返回值</h3>
    109. 

  109.   <p class="para">
    110. 

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

  111.   </p>
    112. 

  112.  </div>
    113. 

  113. 

  114. 

  115.  <div class="refsect1 examples" id="refsect1-function.socket-set-option-examples">
    116. 

  116.   <h3 class="title">范例</h3>
    117. 

  117.   <p class="para">
    118. 

  118.    <div class="example" id="example-4368">
    119. 

  119.     <p><strong>Example #1  <span class="function"><strong>socket_set_option()</strong></span> example</strong></p>
    120. 

  120.     <div class="example-contents">
    121. 

  121. <div class="phpcode"><code><span style="color: #000000">
    122. 

  122. <span style="color: #0000BB">&lt;?php<br />$socket&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">socket_create</span><span style="color: #007700">(</span><span style="color: #0000BB">AF_INET</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">SOCK_STREAM</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">SOL_TCP</span><span style="color: #007700">);<br /><br />if&nbsp;(!</span><span style="color: #0000BB">is_resource</span><span style="color: #007700">(</span><span style="color: #0000BB">$socket</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'Unable&nbsp;to&nbsp;create&nbsp;socket:&nbsp;'</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">socket_strerror</span><span style="color: #007700">(</span><span style="color: #0000BB">socket_last_error</span><span style="color: #007700">())&nbsp;.&nbsp;</span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />}<br /><br />if&nbsp;(!</span><span style="color: #0000BB">socket_set_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$socket</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">SOL_SOCKET</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">SO_REUSEADDR</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'Unable&nbsp;to&nbsp;set&nbsp;option&nbsp;on&nbsp;socket:&nbsp;'</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">socket_strerror</span><span style="color: #007700">(</span><span style="color: #0000BB">socket_last_error</span><span style="color: #007700">())&nbsp;.&nbsp;</span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />}<br /><br />if&nbsp;(!</span><span style="color: #0000BB">socket_bind</span><span style="color: #007700">(</span><span style="color: #0000BB">$socket</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'127.0.0.1'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1223</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'Unable&nbsp;to&nbsp;bind&nbsp;socket:&nbsp;'</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">socket_strerror</span><span style="color: #007700">(</span><span style="color: #0000BB">socket_last_error</span><span style="color: #007700">())&nbsp;.&nbsp;</span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">$rval&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">socket_get_option</span><span style="color: #007700">(</span><span style="color: #0000BB">$socket</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">SOL_SOCKET</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">SO_REUSEADDR</span><span style="color: #007700">);<br /><br />if&nbsp;(</span><span style="color: #0000BB">$rval&nbsp;</span><span style="color: #007700">===&nbsp;</span><span style="color: #0000BB">false</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'Unable&nbsp;to&nbsp;get&nbsp;socket&nbsp;option:&nbsp;'</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">socket_strerror</span><span style="color: #007700">(</span><span style="color: #0000BB">socket_last_error</span><span style="color: #007700">())&nbsp;.&nbsp;</span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />}&nbsp;else&nbsp;if&nbsp;(</span><span style="color: #0000BB">$rval&nbsp;</span><span style="color: #007700">!==&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'SO_REUSEADDR&nbsp;is&nbsp;set&nbsp;on&nbsp;socket&nbsp;!'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span>
    123. 

  123. </span>
    124. 

  124. </code></div>
    125. 

  125.     </div>
    126. 

  126. 

  127.    </div>
    128. 

  128.   </p>
    129. 

  129.  </div>
    130. 

  130. 

  131. 

  132.  <div class="refsect1 changelog" id="refsect1-function.socket-set-option-changelog">
    133. 

  133.   <h3 class="title">更新日志</h3>
    134. 

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

  135.    <table class="doctable informaltable">
    136. 

  136.     
    137. 

  137.      <thead>
    138. 

  138.       <tr>
    139. 

  139.        <th>版本</th>
    140. 

  140.        <th>说明</th>
    141. 

  141.       </tr>
    142. 

  142. 

  143.      </thead>
    144. 

  144. 

  145.      <tbody class="tbody">
    146. 

  146.       <tr>
    147. 

  147.        <td>4.3.0</td>
    148. 

  148.        <td>
    149. 

  149.         This function was renamed. It used to be called
    150. 

  150.          <span class="function"><strong>socket_setopt()</strong></span>.
    151. 

  151.        </td>
    152. 

  152.       </tr>
    153. 

  153. 

  154.      </tbody>
    155. 

  155.     
    156. 

  156.    </table>
    157. 

  157. 

  158.   </p>
    159. 

  159.  </div>
    160. 

  160. 

  161. 

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

  163.  <div class="prev" style="text-align: left; float: left;"><a href="function.socket-set-nonblock.html">socket_set_nonblock</a></div>
    164. 

  164.  <div class="next" style="text-align: right; float: right;"><a href="function.socket-shutdown.html">socket_shutdown</a></div>
    165. 

  165.  <div class="up"><a href="ref.sockets.html">Socket 函数</a></div>
    166. 

  166.  <div class="home"><a href="index.html">PHP Manual</a></div>
    167. 

  167. </div></body></html>
    168. 

  168.