uTools-Manuals/docs/php/curl_multi_add_handle.html
2019-04-28 19:00:34 +08:00

92 lines
7.9 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>向curl批处理会话中添加单独的curl句柄</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.curl-multi-add-handle" class="refentry">
<div class="refnamediv">
<h1 class="refname">curl_multi_add_handle</h1>
<p class="verinfo">(PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">curl_multi_add_handle</span> &mdash; <span class="dc-title">向curl批处理会话中添加单独的curl句柄</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.curl-multi-add-handle-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>curl_multi_add_handle</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$mh</code></span>
, <span class="methodparam"><span class="type">resource</span> <code class="parameter">$ch</code></span>
) : <span class="type">int</span></div>
<p class="para rdfs-comment">
增加 <code class="parameter">ch</code> 句柄到批处理会话<code class="parameter">mh</code>
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.curl-multi-add-handle-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">mh</code>
</dt>
<dd>
<p class="para"><span class="function"><a href="curl_multi_init.html" class="function">curl_multi_init()</a></span> 返回的 cURL 多个句柄。</p></dd>
<dt>
<code class="parameter">ch</code>
</dt>
<dd>
<p class="para"><span class="function"><a href="curl_init.html" class="function">curl_init()</a></span> 返回的 cURL 句柄。</p></dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.curl-multi-add-handle-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
成功时返回0失败时返回<strong><code>CURLM_XXX</code></strong>之一的错误码。
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.curl-multi-add-handle-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-5243">
<p><strong>Example #1 <span class="function"><strong>curl_multi_add_handle()</strong></span> example</strong></p>
<div class="example-contents"><p>
这个范例将会创建2个cURL句柄把它们加到批处理句柄然后并行地运行它们。
</p></div>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">//&nbsp;创建一对cURL资源<br /></span><span style="color: #0000BB">$ch1&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">curl_init</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$ch2&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">curl_init</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">//&nbsp;设置URL和相应的选项<br /></span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">CURLOPT_URL</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"http://www.example.com/"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">CURLOPT_HEADER</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch2</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">CURLOPT_URL</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"http://www.php.net/"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch2</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">CURLOPT_HEADER</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;创建批处理cURL句柄<br /></span><span style="color: #0000BB">$mh&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">curl_multi_init</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">//&nbsp;增加2个句柄<br /></span><span style="color: #0000BB">curl_multi_add_handle</span><span style="color: #007700">(</span><span style="color: #0000BB">$mh</span><span style="color: #007700">,</span><span style="color: #0000BB">$ch1</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">curl_multi_add_handle</span><span style="color: #007700">(</span><span style="color: #0000BB">$mh</span><span style="color: #007700">,</span><span style="color: #0000BB">$ch2</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$running</span><span style="color: #007700">=</span><span style="color: #0000BB">null</span><span style="color: #007700">;<br /></span><span style="color: #FF8000">//&nbsp;执行批处理句柄<br /></span><span style="color: #007700">do&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">curl_multi_exec</span><span style="color: #007700">(</span><span style="color: #0000BB">$mh</span><span style="color: #007700">,</span><span style="color: #0000BB">$running</span><span style="color: #007700">);<br />}&nbsp;while(</span><span style="color: #0000BB">$running&nbsp;</span><span style="color: #007700">&gt;&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;关闭全部句柄<br /></span><span style="color: #0000BB">curl_multi_remove_handle</span><span style="color: #007700">(</span><span style="color: #0000BB">$mh</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$ch1</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">curl_multi_remove_handle</span><span style="color: #007700">(</span><span style="color: #0000BB">$mh</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$ch2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">curl_multi_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$mh</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.curl-multi-add-handle-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="curl_multi_remove_handle.html" class="function" rel="rdfs-seeAlso">curl_multi_remove_handle()</a> - 移除cURL批处理句柄资源中的某个句柄资源</span></li>
<li class="member"><span class="function"><a href="curl_multi_init.html" class="function" rel="rdfs-seeAlso">curl_multi_init()</a> - 返回一个新cURL批处理句柄</span></li>
<li class="member"><span class="function"><a href="curl_init.html" class="function" rel="rdfs-seeAlso">curl_init()</a> - 初始化 cURL 会话</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>