Как в PHP преобразовать объект или переменную в строку? Аналог toString() из Java/.NET

Основное решение: магический метод __toString()

В PHP для преобразования объекта в строку используется магический метод __toString(). Он вызывается автоматически, когда объект используется в строковом контексте (при echo, print, конкатенации).

class User {
    public $name = 'Анна';
    public $age = 25;

    public function __toString() {
        return "Пользователь: {$this->name}, возраст: {$this->age}";
    }
}

$user = new User();
echo "Привет, " . $user; // Выведет: Привет, Пользователь: Анна, возраст: 25
echo $user;              // Просто: Пользователь: Анна, возраст: 25

Важные правила для __toString()

• Метод обязательно должен возвращать строку (string). Если вернуть число — PHP попытается преобразовать его в строку, но лучше всегда возвращать именно строку.
• Метод не должен выбрасывать исключения в PHP 7.x и ниже (в PHP 8 это разрешено, но не рекомендуется).
• Если __toString() не определён, а объект пытаются использовать как строку — возникает фатальная ошибка.

Преобразование простых типов (числа, массивы)

Для скалярных типов (int, float, bool, string) в PHP есть встроенные функции и конструкция:

• (string) $var — приведение типа (работает для int, float, bool, null).
• strval($var) — функция, аналог (string).
• print_r($var, true) — для массивов и объектов (возвращает строку, а не выводит).
• var_export($var, true) — возвращает валидный PHP-код как строку.
• json_encode($var) — для JSON-представления.

$num = 42;
echo (string)$num;          // "42"
echo strval($num);          // "42"

$arr = ['apple', 'banana'];
echo print_r($arr, true);   // Array ( [0] => apple [1] => banana )
echo json_encode($arr);     // ["apple","banana"]

Полный пример с пользовательским классом

class Product {
    private string $title;
    private float $price;
    
    public function __construct(string $title, float $price) {
        $this->title = $title;
        $this->price = $price;
    }
    
    public function __toString(): string {
        return sprintf("Товар: %s, цена: %.2f руб.", $this->title, $this->price);
    }
}

$product = new Product("Кофе", 450.50);
echo $product; // Товар: Кофе, цена: 450.50 руб.

Сравнение с Java/.NET

• В Java toString() определён у Object, в PHP — нет.
• В PHP нужно явно реализовать __toString() в каждом классе.
• Для примитивов в PHP нет методов, используются функции приведения.
• В Java String.valueOf() работает для любых типов, в PHP — strval().

interface Stringable {
    public function toString(): string;
}

class User implements Stringable {
    public function toString(): string {
        return $this->name;
    }
}

// Функция-хелпер
function stringify($value): string {
    if ($value instanceof Stringable) {
        return $value->toString();
    }
    if (is_array($value)) {
        return json_encode($value);
    }
    return (string)$value;
}

if ($obj instanceof Stringable) {
    echo $obj; // автоматически вызовет __toString()
}