PHP var_dump()와 print_r(): 배열 출력과 디버깅

print_r($array)는 배열이나 객체를 키와 값과 함께 읽기 쉬운 형태로 출력합니다. var_dump($value)는 같은 구조에 모든 값의 타입과 길이를 더해 출력합니다. 배열에 무엇이 있는지 볼 때는 print_r를, 값이 "1"인지 1인지 알아야 할 때는 var_dump를 쓰세요.

<?php
$user = ["name" => "Ada", "age" => 36, "admin" => false, "tags" => ["math", "code"]];

print_r($user);
echo "\n";
var_dump($user);

admin에 대한 두 출력을 비교해 보세요. print_r는 화살표 뒤에 아무것도 출력하지 않았고, var_dump는 bool(false)를 출력했습니다. 디버깅할 때 var_dump를 쓰는 주된 이유가 이 차이입니다.

print_r, var_dump, var_export 비교

세 함수는 같은 데이터를 서로 다른 상세함으로 보여 줍니다.

<?php
$values = [0, "0", "", null, false, 1.5];

echo "print_r:\n";
print_r($values);

echo "\nvar_dump:\n";
var_dump($values);

echo "\nvar_export:\n";
var_export($values);
echo "\n";

print_r는 가장 읽기 쉽고, var_dump는 가장 정확하며, var_export는 파일에 다시 붙여 넣을 수 있는 코드를 줍니다.

print_r 출력을 문자열로 얻기

두 번째 인수로 true를 넘기면 print_r는 출력하는 대신 텍스트를 반환합니다. 배열을 로그 파일에 쓰거나 더 큰 메시지 안에 넣는 방법입니다.

<?php
$order = ["id" => 1042, "items" => ["book", "pen"], "total" => 18.5];

$text = print_r($order, true);

echo "Order received:\n" . $text;
echo "That was " . strlen($text) . " characters\n";

file_put_contents("debug.log", date("H:i:s") . " " . $text, FILE_APPEND);
echo "Log size: " . filesize("debug.log") . " bytes\n";

var_export($value, true)도 같은 방식으로 문자열을 반환합니다. var_dump는 항상 출력하므로 캡처하려면 출력 버퍼링이 필요합니다: ob_start(); var_dump($x); $text = ob_get_clean();.

HTML에서 pre로 배열 보기 좋게 출력하기

브라우저에서는 HTML이 공백을 무시하므로 print_r의 줄바꿈과 공백이 긴 한 줄로 합쳐집니다. 레이아웃을 유지하려면 출력을 <pre>로 감싸세요. 실행하고 Page 탭을 보세요.

<?php
$menu = [
    "Starters" => ["Soup" => 6, "Salad" => 7],
    "Mains" => ["Pasta" => 14, "Risotto" => 15],
];

echo "<h3>Without pre</h3>\n";
print_r($menu);

echo "<h3>With pre</h3>\n";
echo "<pre>" . htmlspecialchars(print_r($menu, true)) . "</pre>\n";

echo "<h3>As JSON</h3>\n";
echo "<pre>" . htmlspecialchars(json_encode($menu, JSON_PRETTY_PRINT)) . "</pre>\n";

사용자 입력처럼 데이터에 <나 &가 들어갈 수 있다면 htmlspecialchars가 중요합니다. 없으면 브라우저가 그 텍스트를 HTML로 취급합니다. JavaScript나 API로 보내는 데이터라면 json_encode 형태가 가장 유용한 경우가 많습니다.

여러 값을 한 번에 덤프하기

var_dump는 인수를 몇 개든 받아 차례로 출력하므로 두 값을 나란히 비교할 때 빠릅니다.

<?php
$fromForm = "42";
$fromDb = 42;

var_dump($fromForm, $fromDb, $fromForm == $fromDb, $fromForm === $fromDb);

출력을 보면 ==는 같다고 하고 ===는 아니라고 하는 이유가 보입니다. 하나는 string(2) "42"이고 다른 하나는 int(42)입니다.

객체 출력하기

세 함수 모두 객체도 출력합니다. var_dump와 print_r는 private과 protected 속성을 표시하므로([label:Point:private]) 속성이 없어진 것처럼 보일 때 도움이 됩니다.

<?php
class Point
{
    public function __construct(
        public int $x,
        public int $y,
        private string $label = "origin",
    ) {}
}

$p = new Point(3, 4);

print_r($p);
echo "\n";
var_dump($p);

var_dump 출력의 #1은 객체의 id입니다. 같은 id를 보여 주는 두 변수는 같은 객체를 가리킵니다.

흔한 실수: 배열을 echo하기

echo는 인수를 문자열로 바꿉니다. 배열에는 문자열 형태가 없으므로 PHP는 Array라는 단어를 출력하고 경고를 냅니다.

<?php
$colors = ["red", "green", "blue"];
echo $colors;

PHP는 다음을 출력합니다.

Warning: Array to string conversion in /home/index.php on line 3
Array

위의 함수 중 하나로 내용을 출력하거나 값을 직접 합치세요.

<?php
$colors = ["red", "green", "blue"];

echo implode(", ", $colors), "\n";
echo json_encode($colors), "\n";
print_r($colors);

implode는 사용자에게 목록을 보여 줄 때, json_encode는 로그와 API에, print_r나 var_dump는 직접 디버깅할 때 쓰세요.