diff --git a/reference/curl/constants.xml b/reference/curl/constants.xml index 51535e2f3..bae90431e 100644 --- a/reference/curl/constants.xml +++ b/reference/curl/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; @@ -3295,105 +3295,6 @@ - - - CURLMOPT_PIPELINING - (int) - - - - 自 cURL 7.16.0 起可用。 - - - - - - CURLMOPT_MAXCONNECTS - (int) - - - - 自 cURL 7.16.3 起可用。 - - - - - - CURLMOPT_MAX_CONCURRENT_STREAMS - (int) - - - - 自 PHP 8.2.0 和 cURL 7.67.0 起可用 - - - - - - CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE - (int) - - - - 自 PHP 7.0.7 和 cURL 7.30.0 起可用 - - - - - - CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE - (int) - - - - 自 PHP 7.0.7 和 cURL 7.30.0 起可用 - - - - - - CURLMOPT_MAX_HOST_CONNECTIONS - (int) - - - - 自 PHP 7.0.7 和 cURL 7.30.0 起可用 - - - - - - CURLMOPT_MAX_PIPELINE_LENGTH - (int) - - - - 自 PHP 7.0.7 和 cURL 7.30.0 起可用 - - - - - - CURLMOPT_MAX_TOTAL_CONNECTIONS - (int) - - - - 自 PHP 7.0.7 和 cURL 7.30.0 起可用 - - - - - - CURLMOPT_PUSHFUNCTION - (int) - - - - 自 PHP 7.1.0 和 cURL 7.44.0 起可用 - - - CURLSSH_AUTH_AGENT @@ -4211,6 +4112,7 @@ &reference.curl.constants-curl-share-setopt; &reference.curl.constants-curl-getinfo; + &reference.curl.constants-curl-multi-setopt; &reference.curl.constants-curlproto; &reference.curl.constants-curl-error; &reference.curl.constants-curl-multi; diff --git a/reference/curl/constants_curl_multi.xml b/reference/curl/constants_curl_multi.xml index 5bd061555..c8c6ca99b 100644 --- a/reference/curl/constants_curl_multi.xml +++ b/reference/curl/constants_curl_multi.xml @@ -1,5 +1,5 @@ - + curl_multi_<replaceable>*</replaceable> 状态常量 diff --git a/reference/curl/constants_curl_multi_setopt.xml b/reference/curl/constants_curl_multi_setopt.xml new file mode 100644 index 000000000..0c0635e74 --- /dev/null +++ b/reference/curl/constants_curl_multi_setopt.xml @@ -0,0 +1,145 @@ + + + + <function>curl_multi_setopt</function> + + + CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE + (int) + + + + 指定用于管道处理的块长度阈值（以字节为单位）。自 PHP 7.0.7 和 cURL 7.30.0 起可用 + + + + + + CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE + (int) + + + + 指定用于管道惩罚（pipelining penalty）的长度阈值（以字节为单位）。自 PHP 7.0.7 和 cURL 7.30.0 起可用 + + + + + + CURLMOPT_MAXCONNECTS + (int) + + + + 指定 libcurl 可以缓存的最大同时打开的连接数。默认情况下，这个大小会自动扩展到通过 curl_multi_add_handle + 添加的句柄数的四倍。当缓存已满时，cURL 会关闭缓存中最旧的一个连接，以防止打开的连接数继续增加。自 cURL 7.16.3 起可用 + + + + + + CURLMOPT_MAX_CONCURRENT_STREAMS + (int) + + + + 指定 cURL 在使用 HTTP/2 连接中应支持的最大并发流数量。有效值范围是从 1 到 + 2147483647（2^31 - 1）。这里设置的值将根据其他系统资源属性来确定是否执行。默认值是 + 100。自 PHP 8.2.0 和 cURL 7.67.0 起可用。 + + + + + + CURLMOPT_MAX_HOST_CONNECTIONS + (int) + + + + 指定单个主机的最大连接数。自 PHP 7.0.7 和 cURL 7.30.0 起可用 + + + + + + CURLMOPT_MAX_PIPELINE_LENGTH + (int) + + + + 指定管道中的最大请求数。自 PHP 7.0.7 和 cURL 7.30.0 起可用 + + + + + + CURLMOPT_MAX_TOTAL_CONNECTIONS + (int) + + + + 指定同时打开的最大连接数。自 PHP 7.0.7 和 cURL 7.30.0 起可用 + + + + + + CURLMOPT_PIPELINING + (int) + + + + 传递 1 启用或传递 0 禁用。在多句柄上启用管道将使其尝试对使用此句柄的传输尽可能执行 HTTP + 管道操作。这意味着如果添加的第二个请求可以使用已有连接，则第二个请求将在同一连接上使用“管道”。自 + cURL 7.43.0 起，该值是位掩码，传递 2 将尝试在现有的 HTTP/2 连接上多路复用新传输。传递 + 3 指示 cURL 请求彼此独立的管道和多路复用。自 cURL 7.62.0 起，设置管道 bit 没有效果。除了整数文字，还可以使用 + CURLPIPE_* 常量。自 cURL 7.16.0 起可用。 + + + + + + CURLMOPT_PUSHFUNCTION + (int) + + + + 传递 callable 以注册处理服务器推送且应具有以下签名： + + intpushfunction + resourceparent_ch + resourcepushed_ch + arrayheaders + + + + parent_ch + + + 父级 cURL 句柄（客户端发出的请求）。 + + + + + pushed_ch + + + 推送请求的新 cURL 句柄。 + + + + + headers + + + 推送 promise header。 + + + + + 推送函数如果可以处理推送应该返回 CURL_PUSH_OK，或者返回 + CURL_PUSH_DENY 拒绝。自 PHP 7.1.0 和 cURL 7.44.0 起可用。 + + + + diff --git a/reference/curl/functions/curl-multi-setopt.xml b/reference/curl/functions/curl-multi-setopt.xml index b7e4c1884..342c112de 100644 --- a/reference/curl/functions/curl-multi-setopt.xml +++ b/reference/curl/functions/curl-multi-setopt.xml @@ -55,10 +55,10 @@ CURLMOPT_PIPELINING 传递 1 启用或传递 0 禁用。在多句柄上启用管道将使其尝试对使用此句柄的传输尽可能执行 HTTP - 管道操作。这意味着如果添加的第二个请求可以使用已有连接，则第二个请求将在同一连接上使用“管道”。 - 从 cURL 7.43.0 开始，该值是位掩码，如果可能，您还可以传递 2 以尝试在已有的 HTTP/2 连接上复用多路新传输。传递 - 3 指示 cURL 请求彼此独立的管道和多路复用。 - 从 cURL 7.62.0 开始，设置管道位没有效果。除了整数文字，还可以使用 CURLPIPE_* 常量（如果可用）。 + 管道操作。这意味着如果添加的第二个请求可以使用已有连接，则第二个请求将在同一连接上使用“管道”。自 + cURL 7.43.0 起，该值是位掩码，如果可能，传递 2 将尝试在现有的 HTTP/2 连接上多路复用新传输。传递 + 3 指示 cURL 请求彼此独立的管道和多路复用。自 cURL 7.62.0 起，设置管道 bit 没有效果。除了整数文字，还可以使用 + CURLPIPE_* 常量（如果可用）。 @@ -71,24 +71,21 @@ CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE - 传递数字，以字节为单位指定管道的块（chunk）长度阈值。 + 传递数字，用于指定用于管道处理的块长度阈值（以字节为单位）。 CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE - Pass a number that specifies the size threshold for pipelining - penalty in bytes. + 传递数字，指定用于管道惩罚（pipelining penalty）的长度阈值（以字节为单位）。 CURLMOPT_MAX_CONCURRENT_STREAMS - The set number will be used as the maximum number of concurrent streams for a connections that cURL - should support on connections done using HTTP/2. Valid values range from - 1 to 2147483647 (2^31 - 1). - The value passed here would be honored based on other system resources properties. - Default is 100. + 设置的数字将用作 cURL 在使用 HTTP/2 连接中应支持的最大并发流数量。有效值范围是从 1 到 + 2147483647（2^31 - 1）。这里设置的值将根据其他系统资源属性来确定是否执行。默认值是 + 100。 @@ -141,7 +138,7 @@ headers - The push promise headers. + 推送 promise header。