__toString for string representation in PHP

Introduction

The __toString method lets you decide how an object turns into a string. This helps when you want to print or show an object in a simple way.

When you want to print an object directly with <code>echo</code> or <code>print</code>.

When you want to convert an object to a string for logging or debugging.

When you want to customize how an object looks as text in messages or UI.

When you want to avoid errors from printing objects without string form.

Syntax

PHP

public function __toString(): string {
    // return a string representation of the object
}

The method must be public and return a string.

It is called automatically when the object is used as a string.

Examples

This example shows a Person class that returns the person's name when printed.

PHP

<?php
class Person {
    private string $name;
    public function __construct(string $name) {
        $this->name = $name;
    }
    public function __toString(): string {
        return "Person: " . $this->name;
    }
}

$p = new Person("Anna");
echo $p;

This example shows a Product class that returns a string with the product title and price.

PHP

<?php
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 "$this->title costs {$this->price}";
    }
}

$product = new Product("Book", 12.99);
echo $product;

Sample Program

This program creates a Car object and prints it. The __toString method defines how the car looks as a string.

PHP

<?php
class Car {
    private string $make;
    private string $model;

    public function __construct(string $make, string $model) {
        $this->make = $make;
        $this->model = $model;
    }

    public function __toString(): string {
        return "Car: $this->make $this->model";
    }
}

$car = new Car("Toyota", "Corolla");
echo $car;

Important Notes

If you try to print an object without __toString, PHP will give an error.

Use __toString to make objects easier to read and debug.

Summary

__toString lets you control how an object turns into a string.

It is called automatically when printing or converting an object to string.

Always return a string from __toString.

Practice

1.

What is the main purpose of the __toString method in a PHP class?

easy

A. To initialize object properties

B. To define how an object is converted to a string automatically

C. To handle errors in the class

D. To create a new instance of the class

Solution

1. Step 1: Understand the role of __toString

   The __toString method is a special function in PHP that defines how an object should be represented as a string.

2. Step 2: Identify its automatic use

   This method is called automatically when you try to print or convert an object to a string.

3. Final Answer:

   To define how an object is converted to a string automatically -> Option B

4. Quick Check:

   __toString controls string conversion [OK]

Hint: Remember: __toString controls object-to-string conversion [OK]

Common Mistakes:

• Confusing __toString with constructor
• Thinking it handles errors
• Assuming it creates new objects

2.

Which of the following is the correct syntax to declare the __toString method inside a PHP class?

class Example {
    ?
}

easy

A. public function __toString() : string { return "Example"; }

B. function toString() { return "Example"; }

C. public function __toString() { echo "Example"; }

D. private function __toString() : int { return 1; }

Solution

1. Step 1: Check method name and visibility

   The method must be named exactly __toString and usually declared public.

2. Step 2: Verify return type and return value

   It must return a string, so the return type : string is correct, and the return value must be a string.

3. Final Answer:

   public function __toString() : string { return "Example"; } -> Option A

4. Quick Check:

   Correct syntax includes public, __toString, returns string [OK]

Hint: Use public function __toString() returning a string [OK]

Common Mistakes:

• Omitting public visibility
• Using wrong method name like toString
• Returning non-string values
• Using echo instead of return

3.

What will be the output of the following PHP code?

class Person {
    private string $name;
    public function __construct(string $name) {
        $this->name = $name;
    }
    public function __toString() : string {
        return "Person: " . $this->name;
    }
}

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

medium

A. Error: Cannot convert object to string

B. Object of class Person

C. Person: Alice

D. Alice

Solution

1. Step 1: Understand the __toString method

   The __toString method returns the string "Person: " concatenated with the name property.

2. Step 2: Check the echo statement

   When echoing the object, PHP calls __toString automatically, so it prints the returned string.

3. Final Answer:

   Person: Alice -> Option C

4. Quick Check:

   echo object calls __toString, prints combined string [OK]

Hint: echo object calls __toString, prints returned string [OK]

Common Mistakes:

• Expecting default object print
• Forgetting __toString is called automatically
• Confusing property access with direct print

4.

Identify the error in the following PHP class that implements __toString:

class Product {
    private string $name;
    public function __construct(string $name) {
        $this->name = $name;
    }
    public function __toString() {
        echo $this->name;
    }
}

$p = new Product("Book");
echo $p;

medium

A. The __toString method should return a string, not echo it

B. The constructor is missing a return type

C. The property $name should be public

D. The echo statement outside the class is incorrect

Solution

1. Step 1: Check __toString method implementation

   The __toString method must return a string, but here it uses echo which outputs directly and returns nothing.

2. Step 2: Understand consequences of echo inside __toString

   Using echo causes a fatal error because PHP expects a string return from __toString.

3. Final Answer:

   The __toString method should return a string, not echo it -> Option A

4. Quick Check:

   __toString must return string, not echo [OK]

Hint: Always return string in __toString, never echo [OK]

Common Mistakes:

• Using echo instead of return in __toString
• Ignoring return type requirements
• Assuming echo works inside __toString

5.

You want to create a PHP class Book that stores a title and author. When printing the object, it should show "Title by Author". Which implementation of __toString correctly achieves this?

class Book {
    private string $title;
    private string $author;
    public function __construct(string $title, string $author) {
        $this->title = $title;
        $this->author = $author;
    }
    public function __toString() : string {
        ?
    }
}

hard

A. return '$this->title by $this->author';

B. echo "$this->title by $this->author";

C. return $this->title + ' by ' + $this->author;

D. return $this->title . ' by ' . $this->author;

Solution

1. Step 1: Understand string concatenation in PHP

   PHP uses the dot operator . to join strings, not plus +.

2. Step 2: Check return vs echo

   The __toString method must return a string, so return is correct, not echo.

3. Step 3: Choose correct concatenation and return

   return $this->title . ' by ' . $this->author; correctly returns the concatenated string using dots.

4. Final Answer:

   return $this->title . ' by ' . $this->author; -> Option D

5. Quick Check:

   Use return with dot concatenation in __toString [OK]

Hint: Use return and dot (.) to join strings in __toString [OK]

Common Mistakes:

• Using echo instead of return
• Using + for string concatenation
• Forgetting to return a string