PHP 컬_setopt() 튜토리얼: cURL 요청 옵션을 쉽게 구성

M66 2025-10-26

PHP 컬_setopt() 함수 소개

cURL은 HTTP 요청을 보내고 받기 위한 PHP의 강력한 확장입니다. 개발 과정에서 cur_setopt() 함수는 cURL 세션 옵션을 설정하는 핵심 함수로, 이를 통해 요청 동작과 매개변수를 유연하게 구성할 수 있습니다.

컬_setopt() 구문

컬_setopt() 함수의 기본 구문은 다음과 같습니다.

 bool cur_setopt(리소스 $ch, int $option, 혼합 $value)

매개변수 설명:

$ch: 컬_init() 함수를 통해 생성된 cURL 핸들입니다.
$option: 설정할 cURL 옵션입니다.
$value: 옵션에 해당하는 값입니다.

반환 값: 이 함수는 설정이 성공적인지 여부를 나타내는 부울 값을 반환합니다.

컬_setopt() 예

다음은 GET 요청을 보내고 응답을 받기 위해 컬_setopt()를 사용하는 예입니다.

 //cURL 세션 초기화 $ch = cur_init();

//액세스할 URL 설정
cur_setopt($ch, CURLOPT_URL, "https://api.example.com/data");

//요청 메소드를 GET으로 설정
컬_setopt($ch, CURLOPT_HTTPGET, true);

//수신된 응답 내용을 설정합니다. cur_setopt($ch, CURLOPT_RETURNTRANSFER, true);

//타임아웃 설정 cur_setopt($ch, CURLOPT_TIMEOUT, 30);

//cURL 요청 실행 $response = cur_exec($ch);

// 요청이 실패했는지 확인합니다. if ($response === FALSE) {
    echo "요청 실패: " . 컬_오류($ch);
} 또 다른 {
    // 응답 데이터 처리 echo $response;
}

// cURL 세션을 닫습니다. cur_close($ch);

예시 분석

예제에서 cURL 핸들($ch)은 먼저 컬_init()를 통해 생성됩니다. 그런 다음 컬_setopt()를 사용하여 요청 옵션을 구성합니다.

CURLOPT_URL: 요청된 URL을 지정합니다.
CURLOPT_HTTPGET: 요청 방법을 GET으로 설정합니다.
CURLOPT_RETURNTRANSFER: 응답 내용을 직접 출력하는 대신 변수에 저장하려면 true로 설정합니다.
CURLOPT_TIMEOUT: 요청 시간 초과를 30초로 설정합니다.

컬_exec()를 통해 요청을 실행합니다. 실패하면 컬_오류()를 사용하여 오류 정보를 얻을 수 있습니다. 성공하면 반환된 응답 콘텐츠를 처리할 수 있습니다. 마지막으로 컬_close()를 사용하여 cURL 세션을 닫습니다.

요약

컬_setopt()는 세션 옵션을 구성하기 위한 PHP cURL 확장의 중요한 함수입니다. 이를 통해 URL, 요청 방법, 시간 초과 등 다양한 옵션을 유연하게 설정하여 HTTP 요청의 전송 및 응답 처리를 실현할 수 있습니다. 컬_setopt()에 능숙하면 PHP의 개발 효율성과 네트워크 요청 유연성이 크게 향상될 수 있습니다.