Método __debugInfo

O método __debugInfo é chamado quando informações sobre um objeto são exibidas pelas funções var_dump e print_r. Ele deve retornar um array com as propriedades que devem ser exibidas. Isso permite ocultar dados confidenciais ou adicionar informações de depuração adicionais.

Sintaxe

phppublic function __debugInfo(): array

Exemplo

Ocultando dados confidenciais ao fazer dump de um objeto:

php<?php
  class User {
    private $password;
    public $name;
    
    public function __construct($name, $password) {
      $this->name = $name;
      $this->password = $password;
    }
    
    public function __debugInfo() {
      return [
        'name' => $this->name,
        'password' => '******'
      ];
    }
  }
  
  $user = new User('John', 'secret123');
  var_dump($user);
?>

Resultado da execução do código:

phpobject(User)#1 (2) {
  ["name"]=> string(4) "John"
  ["password"]=> string(6) "******"
}

Exemplo

Adicionando informações de depuração adicionais:

php<?php
  class Product {
    public $id;
    public $price;
    
    public function __construct($id, $price) {
      $this->id = $id;
      $this->price = $price;
    }
    
    public function __debugInfo() {
      return [
        'id' => $this->id,
        'price' => $this->price,
        'price_with_tax' => $this->price * 1.2
      ];
    }
  }
  
  $product = new Product(101, 100);
  var_dump($product);
?>

Resultado da execução do código:

phpobject(Product)#1 (3) {
  ["id"]=> int(101)
  ["price"]=> int(100)
  ["price_with_tax"]=> float(120)
}

Exemplo

Filtrando propriedades para exibição:

php<?php
  class Config {
    private $dbHost = 'localhost';
    private $dbUser = 'admin';
    private $cacheEnabled = true;
    
    public function __debugInfo() {
      return [
        'cacheEnabled' => $this->cacheEnabled
      ];
    }
  }
  
  $config = new Config();
  print_r($config);
?>

Resultado da execução do código:

phpConfig Object (
  [cacheEnabled] => 1
)

Veja também