정의 및 사용 방법

PHP 버전
4+

print_r()은
주어진 변수나 값의 정보를 사람이 읽기 쉬운 형태로 출력(Prints human-readable)하는 디버깅용 함수입니다.

주로 배열이나 객체와 같은 변수의 구조와 값을 읽기 쉽게 확인할 때 사용합니다.

특징

  • 값을 반환하지 않고, 정보를 브라우저나 CLI 같은 표준 출력으로 즉시 기록합니다.
  • $return 매개변수를 true로 설정하면 출력 대신 문자열로 반환할 수 있습니다.
  • 배열과 객체 같은 복잡한 구조를 좀 더 직관적으로 확인할 수 있습니다.
  • 출력 내용이 간결하며, 타입이나 길이 정보는 기본적으로 표시되지 않습니다.
  • 디버깅과 로그 확인 등 가볍게 구조를 살펴볼 때 주로 사용됩니다.

반면에 var_dump()는
주어진 변수나 값의 타입·길이·값을 가공하지 않은(원시, raw) 구조화된 정보로 상세하게 출력하는 디버깅용 함수입니다.

구문

PHP 
print_r(mixed $value, bool $return = false): string|true

매개변수

print_r() 함수의 매개변수
$value 정보를 출력할 대상 변수 또는 값입니다. mixed는 PHP의 모든 데이터 타입을 받을 수 있음을 의미합니다.
$return 옵션.
출력 방식을 결정합니다.
  • false (기본값): 출력을 화면에 표시합니다.
  • true: 함수는 출력을 화면에 표시하는 대신, 해당 내용을 문자열로 반환합니다.

반환 값

반환 값은 $return 매개변수의 설정에 따라 달라집니다.

  • $return이 false로 설정된 경우
    변수의 정보을 화면에 출력하고, true를 반환합니다.
  • $return이 true로 설정된 경우
    변수의 정보을 화면에 출력하지 않고, 대신 해당 정보를 문자열로 반환합니다.

변경 이력

print_r() 함수의 변경 이력
PHP 8.4.0부터 반환 값 유형이 sring|bool에서 string|true로 변경되었습니다.

주의할 점

print_r()은 스칼라 값(정수, 문자열, 실수 등)의 타입 정보를 출력하지 않습니다.
예를 들어 123(정수)과 '123'(문자열)은 동일하게 123으로 보여지며, 12.3(실수)과 '12.3'(문자열)은 동일하게 12.3으로 보여집니다.

예제

print_r()은 주어진 변수나 값의 정보를 사람이 읽기 쉬운 형태로 출력하는 디버깅용 함수입니다. 이 예제에서는 다양한 데이터 타입별로 print_r()이 어떻게 출력되는지 직접 살펴보겠습니다.

스칼라 타입(Scalar Types)

정수(int)
PHP 
$int = 123;
print_r($int);
출력 값 자체만을 보여줍니다.
실수(float/double)
PHP 
$float = 3.14;
print_r($float);
출력 값 자체만을 보여줍니다.
문자열(string)
PHP 
$str = 'Hello';
print_r($str);
출력 값 자체만을 보여줍니다.
문자열(string) 숫자
PHP 
$str_num_1 = '123';
print_r($str_num_1); 

$str_num_2 = '12.3';
print_r($str_num_2);
출력 값 자체만을 보여줍니다.
부울(boolean)
PHP 
$bool_true = true;
print_r($bool_true); 

$bool_false = false;
print_r($bool_false);
출력 print_r()은 불리언 값에 대해 true는 1로 출력하지만, false는 아무것도 출력하지 않습니다(빈 문자열).

배열(array)

단순 배열(인덱스 배열)
PHP 
$arr = [1, 2, 3];
print_r($arr);
출력
연관 배열
PHP 
$assoc = ['a' => 1, 'b' => 2, 'c' => 3];
print_r($assoc);
출력
혼합 배열
PHP 
$complex = ['a' => 1, 'b' => [2, 3], 'c' => 4];
print_r($complex);
출력

객체(object)

PHP 
class Person {
    public $name = "John";
    private $age = 30;
}

$p = new Person();
print_r($p);
출력

객체의 출력에 대한 상세 설명입니다.

  • Person Object
    객체의 클래스 이름이 Person임을 나타냅니다.
  • 속성별 표시
    [name]=> John → 공개(public) 속성
    [age:Person:private] => 30 → 비공개(private) 속성. Person은 속성이 정의된 클래스 이름을 나타냄

NULL

PHP 
$n = null;
print_r($n);
출력 print_r()은 null 값에 대해 아무것도 출력하지 않습니다(빈 문자열).

리소스(resource)

PHP 
$fp = fopen("php://temp", "r");
print_r($fp); // resource(5) of type (stream)
fclose($fp);
출력 리소스 타입과 ID를 출력합니다.

리소스의 출력에 대한 상세 설명입니다.

  • resource
    리소스(resource) 타입임을 나타냅니다.
  • #2
    현재 실행 중인 스크립트에서 생성된 리소스 ID입니다.
    새로운 리소스를 생성하면 #3, #4 … 식으로 증가합니다.

참고문헌

같이 보기