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
에 설정할 값입니다.value
은option
매개변수의 다음 값에 대해 int여야 합니다.Option Set value
toCURLMOPT_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
): intparent_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_LENGTH 및 CURLMOPT_MAX_TOTAL_CONNECTIONS 가 도입되었습니다. |