Что такое stdClass в PHP и зачем он нужен?

Что такое stdClass?

stdClass — это встроенный пустой класс в PHP, который используется как универсальный контейнер для создания объектов "на лету". Думайте о нём как о "пустом холсте" для объекта, у которого нет своих методов, но можно динамически добавлять свойства.

Почему он появляется?

Вы уже заметили, что json_decode() возвращает stdClass по умолчанию. Это происходит потому, что JSON — это не массив, а структура данных с ключами и значениями, и PHP представляет её как объект. Если передать вторым параметром true, получите ассоциативный массив:

// По умолчанию — объект
$obj = json_decode('{"name":"John"}');
echo get_class($obj); // stdClass

// С флагом true — массив
$arr = json_decode('{"name":"John"}', true);
print_r($arr); // Array ( [name] => John )

Чем stdClass отличается от массива?

• Синтаксис доступа: объект использует ->, массив — [].
• Строгость типов: объекты в PHP более строгие — вы не можете обратиться к несуществующему свойству без ошибки (если не включена магия __get).
• Наследование: stdClass — это конечный класс, от него нельзя наследовать (он не final, но это не рекомендуется).
• Использование в функциях: некоторые функции ожидают объект, а не массив (например, PDO, шаблонизаторы).

Как создавать и использовать?

Вот несколько типичных сценариев:

// 1. Простое создание
$user = new stdClass();
$user->name = 'Alice';
$user->age = 25;
echo $user->name; // Alice

// 2. Преобразование массива в объект (cast)
$array = ['city' => 'Moscow', 'country' => 'Russia'];
$obj = (object) $array;
echo $obj->city; // Moscow

// 3. Использование в функции, которая ожидает объект
function greet($person) {
    if (is_object($person)) {
        echo "Hello, " . $person->name;
    }
}
$data = (object) ['name' => 'Bob'];
greet($data); // Hello, Bob

Когда использовать stdClass?

• Временные структуры данных: когда вам нужно быстро создать объект для передачи в функцию, не создавая отдельный класс.
• Работа с JSON API: если вы получаете данные от внешнего сервиса и не хотите писать для них классы.
• Прототипирование: на этапе разработки, когда структура данных ещё нестабильна.

Когда НЕ стоит использовать?

• Для сложной логики: если у объекта есть методы или жёсткая структура — создайте свой класс.
• Для строгой типизации: stdClass позволяет добавлять любые свойства динамически, что может привести к ошибкам.
• Для больших проектов: лучше использовать DTO (Data Transfer Objects) с чёткой структурой.

Важный нюанс

stdClass — это не "особый" класс. Это обычный класс, который существует в PHP с самого начала. Вы даже можете проверить его существование:

var_dump(class_exists('stdClass')); // true
var_dump(get_parent_class('stdClass')); // false (нет родителя)

Итог: stdClass — это удобный инструмент для быстрой работы с объектами, но для серьёзных проектов лучше создавать свои классы с явной структурой.

$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
$stmt = $pdo->query('SELECT id, name FROM users');
$users = $stmt->fetchAll(PDO::FETCH_OBJ); // массив stdClass
foreach ($users as $user) {
    echo $user->name;
}