PHPの__toStringメソッド｜オブジェクトを文字列に変換する方法

<?php
class User {
    public function __construct(
        private string $name,
        private int $age
    ) {}

    public function __toString(): string {
        return "{$this->name}（{$this->age}歳）";
    }
}

$user = new User("田中", 30);

// echoで自動的に__toString()が呼ばれる
echo $user . "\n";

// 文字列結合でも呼ばれる
echo "ユーザー: " . $user . "\n";

// (string)キャストでも呼ばれる
$str = (string)$user;
echo "変換結果: {$str}\n";

田中（30歳）
ユーザー: 田中（30歳）
変換結果: 田中（30歳）

<?php
class Money {
    public function __construct(
        private int $amount,
        private string $currency = "JPY"
    ) {}

    public function add(Money $other): Money {
        return new Money($this->amount + $other->amount, $this->currency);
    }

    public function __toString(): string {
        if ($this->currency === "JPY") {
            return number_format($this->amount) . "円";
        }
        return "$" . number_format($this->amount / 100, 2);
    }
}

$price1 = new Money(1500);
$price2 = new Money(2300);
$total = $price1->add($price2);

echo "商品A: {$price1}\n";
echo "商品B: {$price2}\n";
echo "合計: {$total}\n";

$usd = new Money(1999, "USD");
echo "ドル: {$usd}\n";

商品A: 1,500円
商品B: 2,300円
合計: 3,800円
ドル: $19.99

<?php
class Product {
    public function __construct(
        private string $name,
        private int $price,
        private int $stock
    ) {}

    public function __toString(): string {
        $status = $this->stock > 0 ? "在庫あり" : "在庫なし";
        return "[{$this->name}] {$this->price}円（{$status}）";
    }
}

$products = [
    new Product("PHP入門書", 2980, 50),
    new Product("JavaScript大全", 3500, 0),
    new Product("Pythonガイド", 2200, 12),
];

echo "=== 商品一覧 ===\n";
foreach ($products as $i => $product) {
    echo ($i + 1) . ". {$product}\n";
}

// implodeでも使える
echo "\n全商品: " . implode(" / ", $products) . "\n";

=== 商品一覧 ===
1. [PHP入門書] 2980円（在庫あり）
2. [JavaScript大全] 3500円（在庫なし）
3. [Pythonガイド] 2200円（在庫あり）

全商品: [PHP入門書] 2980円（在庫あり） / [JavaScript大全] 3500円（在庫なし） / [Pythonガイド] 2200円（在庫あり）

<?php
class Color {
    public function __construct(
        private int $r,
        private int $g,
        private int $b
    ) {}

    public function __toString(): string {
        return sprintf("#%02x%02x%02x", $this->r, $this->g, $this->b);
    }

    public static function fromHex(string $hex): self {
        $hex = ltrim($hex, "#");
        return new self(
            hexdec(substr($hex, 0, 2)),
            hexdec(substr($hex, 2, 2)),
            hexdec(substr($hex, 4, 2))
        );
    }
}

$red = new Color(255, 0, 0);
$green = Color::fromHex("#00ff00");
$blue = new Color(0, 0, 255);

echo "赤: {$red}\n";
echo "緑: {$green}\n";
echo "青: {$blue}\n";

赤: #ff0000
緑: #00ff00
青: #0000ff