cURL curl_multi_setopt

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

curl_multi_setopt — cURL 다중 핸들에 대한 옵션 설정


설명

curl_multi_setopt(CurlMultiHandle $multi_handle, int $option, mixed $value): bool

경고 이 함수는 현재 문서화되어 있지 않습니다. 인수 목록만 사용할 수 있습니다.


매개변수

multi_handle
option
CURLMOPT_* 상수 중 하나입니다.
value
option에 설정할 값입니다.

valueoption 매개변수의 다음 값에 대해 int여야 합니다.

Option Set value to
CURLMOPT_PIPELINING 활성화하려면 1을 전달하고 비활성화하려면 0을 전달합니다. 다중 핸들에서 파이프라이닝을 활성화하면 이 핸들을 사용하는 전송에 대해 가능한 한 HTTP 파이프라이닝을 수행하려고 합니다. 즉, 이미 존재하는 연결을 사용할 수 있는 두 번째 요청을 추가하면 두 번째 요청이 동일한 연결에서 "파이프"됩니다. cURL 7.43.0부터 값은 비트마스크이며 가능한 경우 기존 HTTP/2 연결을 통해 새 전송을 다중화하기 위해 2를 전달할 수도 있습니다. 3을 전달하면 cURL이 파이프라이닝과 멀티플렉싱을 서로 독립적으로 요청하도록 지시합니다. cURL 7.62.0부터 파이프라이닝 비트를 설정해도 효과가 없습니다. 정수 리터럴 대신 사용 가능한 경우 CURLPIPE_* 상수를 사용할 수도 있습니다.
CURLMOPT_MAXCONNECTS libcurl이 캐시할 수 있는 최대 동시 연결 연결 수로 사용할 숫자를 전달합니다. 기본적으로 크기는 curl_multi_add_handle()을 통해 추가된 핸들 수의 4배에 맞게 확대됩니다. 캐시가 가득 차면 curl은 열린 연결 수가 증가하는 것을 방지하기 위해 캐시에서 가장 오래된 것을 닫습니다.
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE 파이프라이닝을 위한 청크 길이 임계값을 바이트 단위로 지정하는 숫자를 전달하십시오.
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE 파이프라인 페널티에 대한 크기 임계값을 바이트 단위로 지정하는 숫자를 전달하십시오.
CURLMOPT_MAX_HOST_CONNECTIONS 단일 호스트에 대한 최대 연결 수를 지정하는 숫자를 전달하십시오.
CURLMOPT_MAX_PIPELINE_LENGTH 파이프라인의 최대 요청 수를 지정하는 숫자를 전달합니다.
CURLMOPT_MAX_TOTAL_CONNECTIONS 동시에 열린 연결의 최대 수를 지정하는 숫자를 전달하십시오.
CURLMOPT_PUSHFUNCTION 서버 푸시를 처리하도록 등록되고 다음 서명이 있어야 하는 callable을 전달합니다.

pushfunction(resource $parent_ch, resource $pushed_ch, array $headers): int

parent_ch
부모 cURL 핸들(클라이언트가 만든 요청).
pushed_ch
푸시된 요청에 대한 새 cURL 핸들입니다.
headers
푸시 약속 헤더.

푸시 함수는 푸시를 처리할 수 있는 경우 CURL_PUSH_OK를 반환하고 거부하려면 CURL_PUSH_DENY를 반환해야 합니다.


반환 값

성공하면 true를, 실패하면 false를 반환합니다.


변경 로그

버전 설명
8.0.0 multi_handle은 이제 CurlMultiHandle 인스턴스를 예상합니다. 이전에는 리소스가 필요했습니다.
7.1.0 CURLMOPT_PUSHFUNCTION을 도입했습니다.
7.0.7 CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE, CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE, CURLMOPT_MAX_HOST_CONNECTIONS, CURLMOPT_MAX_PIPELINE_LENGTHCURLMOPT_MAX_TOTAL_CONNECTIONS가 도입되었습니다.