__toString in PHP: What It Is and How to Use It

In PHP, __toString is a magic method that lets an object decide how it should be converted to a string. When you try to print or echo an object, PHP calls this method automatically to get a string representation.

How It Works

The __toString method is like giving your object a way to describe itself in words. Imagine you have a toy robot, and when someone asks it to introduce itself, it says its name and function. Similarly, when PHP needs to turn an object into text, it looks for the __toString method to get that description.

This method must return a string. If you try to print an object without this method, PHP will give an error because it doesn't know how to show the object as text. By defining __toString, you control what appears when the object is printed or echoed.

Example

This example shows a simple class with a __toString method that returns a friendly message about the object.

php

<?php
class Person {
    private string $name;

    public function __construct(string $name) {
        $this->name = $name;
    }

    public function __toString(): string {
        return "Person's name is: " . $this->name;
    }
}

$person = new Person("Alice");
echo $person;

Output

Person's name is: Alice

When to Use

Use __toString when you want your objects to be easily readable as text. This is helpful for debugging, logging, or displaying object information in user interfaces. For example, if you have a class representing a product, you can use __toString to show the product name and price when printed.

It also makes your code cleaner because you can directly echo objects without manually calling a method to get their string form.

Key Points

• __toString must return a string.
• It is called automatically when an object is used in a string context.
• Helps make objects easier to read and debug.
• Without it, printing an object causes an error.

Key Takeaways

__toString lets an object define how it converts to a string automatically.

Always return a string from __toString to avoid errors.

Use it to make objects easy to print and debug.

It is called when you echo or print an object.