mirror of
https://github.com/macintoshplus/doc-fr.git
synced 2026-03-25 17:32:07 +01:00
241 lines
8.3 KiB
XML
241 lines
8.3 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: b7f8c11e56ff1c57a2993e2ed7e5c5ace18637fd Maintainer: yannick Status: ready -->
|
|
<!-- Reviewed: no -->
|
|
<refentry xml:id="function.curl-multi-setopt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<refnamediv>
|
|
<refname>curl_multi_setopt</refname>
|
|
<refpurpose>Définit une option pour le gestionnaire multiple cURL</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsect1 role="description">
|
|
&reftitle.description;
|
|
<methodsynopsis>
|
|
<type>bool</type><methodname>curl_multi_setopt</methodname>
|
|
<methodparam><type>CurlMultiHandle</type><parameter>multi_handle</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>option</parameter></methodparam>
|
|
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
|
|
</para>
|
|
|
|
&warn.undocumented.func;
|
|
|
|
</refsect1>
|
|
|
|
<refsect1 role="parameters">
|
|
&reftitle.parameters;
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><parameter>multi_handle</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>option</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Une des constantes <constant>CURLMOPT_*</constant>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>value</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
La valeur à définir pour le paramètre
|
|
<parameter>option</parameter>.
|
|
</para>
|
|
<para>
|
|
<parameter>value</parameter> doit être un <type>int</type>
|
|
pour les valeurs suivantes du paramètres
|
|
<parameter>option</parameter> :
|
|
<informaltable>
|
|
<tgroup cols="3">
|
|
<thead>
|
|
<row>
|
|
<entry valign="top">Option</entry>
|
|
<entry valign="top">Définit le paramètre <parameter>value</parameter> à</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry valign="top"><constant>CURLMOPT_PIPELINING</constant></entry>
|
|
<entry valign="top">
|
|
1 pour activer, 0 pour désactiver. L'activation du pipelining
|
|
sur un gestionnaire multiple va faire qu'il va tenter de réaliser
|
|
un pipelining HTTP autant que possible pour les transferts utilisant
|
|
ce gestionnaire. Cela signifie que, si vous ajouter un second gestionnaire
|
|
qui peut utiliser une connexion exis
|
|
À partir de cURL 7.43.0, la valeur est un masque de bit, et il est possible de passer 2 pour tenter de multiplex
|
|
le nouveau transfert via une connexion HTTP/2 existante si possible.
|
|
Passer 3 ordonne à cURL de demander pour le pipelining et le multiplexing
|
|
indépendant l'un de l'autre.
|
|
À partir de cURL 7.62.0, définir le bit de pipelining n'a aucun effet.
|
|
Au lieu d'entier litérals, les constantes CURLPIPE_* peuvent être utilisé
|
|
si disponible.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry valign="top"><constant>CURLMOPT_MAXCONNECTS</constant></entry>
|
|
<entry valign="top">
|
|
Nombre maximal de connexions ouvertes simultanément que libcurl peut
|
|
mettre en cache.
|
|
Par défaut, la taille sera élargie pour rentrer quatre fois le nombre de
|
|
gestionnaires ajouté grâce à <function>curl_multi_add_handle</function>.
|
|
Lorsque le cache est complet, curl ferme la plus ancienne connexion du cache,
|
|
afin d'éviter que le nombre de connexions ouvertes n'augmente.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry valign="top"><constant>CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE</constant></entry>
|
|
<entry valign="top">
|
|
Passe un nombre qui définit le seuil de la longeur des tranches pour
|
|
le pipelining en octets.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry valign="top"><constant>CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE</constant></entry>
|
|
<entry valign="top">
|
|
Passe un nombre qui définit le seuil de la taille pour les pénalités
|
|
de pipelining en octets.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry valign="top"><constant>CURLMOPT_MAX_HOST_CONNECTIONS</constant></entry>
|
|
<entry valign="top">
|
|
Passe un nombre qui définit le nombre maximal de connexion à un hôte unique.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry valign="top"><constant>CURLMOPT_MAX_PIPELINE_LENGTH</constant></entry>
|
|
<entry valign="top">
|
|
Passe un nombre qui définit le nombre maximal de requête dans une pipeline.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry valign="top"><constant>CURLMOPT_MAX_TOTAL_CONNECTIONS</constant></entry>
|
|
<entry valign="top">
|
|
Passe un nombre qui définit le nombre maximal de connexions simultanées
|
|
ouvertes.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry valign="top"><constant>CURLMOPT_PUSHFUNCTION</constant></entry>
|
|
<entry valign="top">
|
|
Passe une fonction de rappel qui sera déclarée pour gérer les pushs serveurs
|
|
et devrait avoir la signature suivante :
|
|
<methodsynopsis>
|
|
<type>int</type><methodname><replaceable>pushfunction</replaceable></methodname>
|
|
<methodparam><type>resource</type><parameter>parent_ch</parameter></methodparam>
|
|
<methodparam><type>resource</type><parameter>pushed_ch</parameter></methodparam>
|
|
<methodparam><type>array</type><parameter>headers</parameter></methodparam>
|
|
</methodsynopsis>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><parameter>parent_ch</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Le gestionnaire cURL parent (la requête que le client a faite).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>pushed_ch</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Un nouveau gestionnaire cURL pour les requêtes pushées.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>headers</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Les en-têtes de promise de push.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
La fonction de push est supposé de retourner soit
|
|
<constant>CURL_PUSH_OK</constant> si il peut gérer le push, ou
|
|
<constant>CURL_PUSH_DENY</constant> pour le rejeter.
|
|
</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;
|
|
<para>
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>&Version;</entry>
|
|
<entry>&Description;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
&curl.changelog.multi-handle-param;
|
|
<row>
|
|
<entry>7.1.0</entry>
|
|
<entry>
|
|
Ajout de <constant>CURLMOPT_PUSHFUNCTION</constant>.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>7.0.7</entry>
|
|
<entry>
|
|
Ajout de <constant>CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE</constant>,
|
|
<constant>CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE</constant>,
|
|
<constant>CURLMOPT_MAX_HOST_CONNECTIONS</constant>,
|
|
<constant>CURLMOPT_MAX_PIPELINE_LENGTH</constant> et
|
|
<constant>CURLMOPT_MAX_TOTAL_CONNECTIONS</constant>.
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</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
|
|
-->
|