정의 및 사용 방법

PHP 버전
4+

is_resource() 함수는 주어진 값이 리소스(resource) 타입인지 확인합니다.
매개변수로 전달된 값이 리소스 타입이면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

리소스(resource) 타입은
외부 리소스와 상호작용할 때 사용되는 데이터 타입입니다. 예를 들어, 파일, 데이터베이스 연결, 이미지, 네트워크 연결 등이 리소스에 해당합니다.

기본 예제

PHP 
/* 파일 리소스 */
$file = fopen('test.txt', 'w');
var_dump(is_resource($file)); // bool(true)

/* 데이터베이스 연결 리소스 */
$connection = mysqli_connect("localhost", "username", "password", "database");
var_dump(is_resource($connection)); // bool(true)

/* 이미지 리소스 (이미지 생성을 위한 GD 라이브러리를 사용하는 경우) */
$image = imagecreate(100, 100);
var_dump(is_resource($image)); // bool(true)

/* 네트워크 연결 리소스 */
$network = fsockopen("example.com", 80);
var_dump(is_resource($network)); // bool(true)

참고하세요!
gettype() 함수는 주어진 값의 데이터 타입을 문자열로 반환합니다.

구문

PHP 
is_resource(mixed $value): bool

매개변수

is_resource() 함수의 매개변수
$value 필수. 리소스(resource) 타입을 확인할 값입니다.

반환 값

매개변수로 전달된 값이 리소스 타입이면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

주의할 점

is_resource() 함수를 사용할 때 주의할 점이 있습니다.

닫힌 리소스 변수의 경우 false를 반환

is_resource() 함수는 엄격한 타입 검사 함수가 아닙니다. 닫힌 리소스 변수의 경우 false를 반환합니다.

닫힌 리소스(closed resource)란
외부 리소스와 상호작용하는 동안 사용되었던 리소스가 이제 닫혔음을 나타냅니다. 닫힌 리소스는 더 이상 활성화되지 않고 사용할 수 없다는 것을 의미합니다.

닫힌 리소스는 다음의 코드 예제를 통해 이해할 수 있습니다.

PHP 
/* 파일을 엽니다. */
$fp = fopen('test.txt', 'w');
var_dump(is_resource($fp)); // bool(true)

/* 파일 핸들을 닫습니다. */
fclose($fp); // 닫힌 리소스
var_dump(is_resource($fp)); // bool(false)

이 코드 예제를 통해 알 수 있듯이 닫힌 리소스 변수의 경우 false를 반환합니다.

닫힌 리소스를 확인하기 위해서는 gettype() 함수를 사용하세요. 이 함수는 닫힌 리소스의 경우 'resource (closed)'라는 문자열을 반환합니다.

PHP gettype() 함수 'resource (closed)'
PHP 
/* 파일을 엽니다. */
$fp = fopen('test.txt', 'w');

/* 파일 핸들을 닫습니다. */
fclose($fp);

echo gettype($fp); // 'resource (closed)'

메모리 누수 방지

is_resource() 함수를 사용하여 리소스의 유효성을 확인할 때, 해당 리소스를 사용한 후에는 적절하게 해제해야 합니다. 그렇지 않으면 성능 오버헤드를 발생시킬 수 있습니다. 리소스를 더 이상 사용하지 않는 경우에는 fclose()(파일 핸들의 경우), mysqli_close()(MySQL 연결의 경우) 또는 해당 리소스를 해제하는 다른 함수를 사용하여 메모리 누수를 방지해야 합니다.

활용 예제

is_resource() 함수는 다음과 같은 경우에 사용하면 편리하거나 유용합니다.

리소스 변수가 유효한지 확인

PHP에서 파일 핸들, 데이터베이스 연결, 이미지 리소스, 네트워크 연결 등과 같은 외부 리소스를 다룰 때, 해당 변수가 유효한 리소스인지 확인할 수 있습니다.

PHP 
/* 파일을 엽니다. */
$file = fopen('test.txt', 'r');

if (is_resource($file)) {
	// 파일 처리 코드
} else {
	echo '파일이 유효하지 않습니다.';
}

/* 파일 핸들을 닫습니다. */
fclose($file);

xml_parser_create()를 사용한 리소스 타입 확인

다양한 타입의 리소스를 다룰 때, is_resource() 함수를 사용하여 유효성을 검증할 수 있습니다.

PHP 
/* XML 파서 생성 */
$xml_parser = xml_parser_create();

if (is_resource($xml_parser)) {
    // XML 파서가 유효한 리소스인 경우에만 파싱을 수행할 수 있음
    xml_parse($xml_parser, "<tag>content</tag>", true);
    // 결과 처리
    xml_parser_free($xml_parser);
} else {
    echo '유효한 XML 파서 리소스가 아닙니다.';
}
  • 위 예제들은 is_resource() 함수의 기본적인 사용법을 보여줍니다.
  • 리소스 생성은 시스템 환경에 따라 실패할 가능성이 있으므로, 작업을 수행하기 전에 유효성을 검증하는 것이 안전합니다.
  • 리소스를 사용한 작업을 완료한 후에는 리소스를 닫는 것이 중요합니다.
  • 리소스를 닫지 않으면 메모리 누수가 발생할 수 있습니다.

참고문헌

같이 보기