-
Notifications
You must be signed in to change notification settings - Fork 73
/
curl-share-setopt.xml
194 lines (179 loc) · 6.41 KB
/
curl-share-setopt.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b7f8c11e56ff1c57a2993e2ed7e5c5ace18637fd Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.curl-share-setopt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>curl_share_setopt</refname>
<refpurpose>Устанавливает опции разделяемого cURL-дескриптора</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>curl_share_setopt</methodname>
<methodparam><type>CurlShareHandle</type><parameter>share_handle</parameter></methodparam>
<methodparam><type>int</type><parameter>option</parameter></methodparam>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Функция устанавливает опции разделяемого дескриптора модуля cURL.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
&curl.sh.description;
<varlistentry>
<term><parameter>option</parameter></term>
<listitem>
<para>
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry valign="top">Опция</entry>
<entry valign="top">Описание</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLSHOPT_SHARE</constant></entry>
<entry valign="top">
Указывает, данные какого типа будут разделяемыми.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLSHOPT_UNSHARE</constant></entry>
<entry valign="top">
Указывает, данные какого типа больше не будут разделяемыми.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry valign="top">Значение</entry>
<entry valign="top">Описание</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURL_LOCK_DATA_COOKIE</constant></entry>
<entry valign="top">
Разделяет данные cookie.
</entry>
</row>
<row>
<entry valign="top"><constant>CURL_LOCK_DATA_DNS</constant></entry>
<entry valign="top">
Разделяет кеш DNS. Обратите внимание, дескрипторы модуля cURL,
которые добавили к одному и тому же мультидескриптору,
по умолчанию будут разделять DNS-кеш.
</entry>
</row>
<row>
<entry valign="top"><constant>CURL_LOCK_DATA_SSL_SESSION</constant></entry>
<entry valign="top">
Разделяет идентификаторы SSL-сессий. Разделение идентификаторов сессий сокращает время
SSL-рукопожатия при повторном подключении к тому же серверу.
Обратите внимание, отдельный дескриптор повторно использует свои идентификаторы SSL-сессий
по умолчанию.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&curl.changelog.share-handle-param;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования функции <function>curl_share_setopt</function></title>
<para>
Пример создаёт разделяемый cURL-дескриптор, добавляет в него
два простых cURL-дескриптора и запускает простые дескрипторы с разделяемыми данными cookie.
</para>
<programlisting role="php">
<![CDATA[
<?php
// Создаём разделяемый дескриптор модуля cURL и настраиваем его на разделение данных cookie
$sh = curl_share_init();
curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE);
// Инициализируем первый cURL-дескриптор и назначаем ему разделяемый дескриптор
$ch1 = curl_init("http://example.com/");
curl_setopt($ch1, CURLOPT_SHARE, $sh);
// Запускаем первый cURL-дескриптор
curl_exec($ch1);
// Инициализируем второй cURL-дескриптор и назначаем ему разделяемый дескриптор
$ch2 = curl_init("http://php.net/");
curl_setopt($ch2, CURLOPT_SHARE, $sh);
// Запускаем второй дескриптор.
// Cookies первого дескриптора $ch1 разделяются со вторым дескриптором $ch2
curl_exec($ch2);
// Закрываем разделяемый дескриптор
curl_share_close($sh);
// Закрываем простые дескрипторы
curl_close($ch1);
curl_close($ch2);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->