__toString for string representation in PHP - Step-by-Step Execution

Concept Flow - __toString for string representation

Create Object

↓

Use Object in String Context

↓

Call __toString() Method

↓

Return String Representation

↓

Print or Use String

When an object is used where a string is expected, PHP calls the __toString() method to get a string representation.

Execution Sample

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("Alice");
echo $p;
?>

This code creates a Person object and prints it, triggering __toString to show a string.

Execution Table

Step	Action	Evaluation	Result
1	Create Person object with name 'Alice'	new Person('Alice')	Object $p created with name='Alice'
2	Use object $p in echo (string context)	echo $p	__toString() method called
3	__toString() returns string	return "Person: Alice"	String 'Person: Alice' returned
4	echo prints string	print 'Person: Alice'	Output: Person: Alice

💡 Execution stops after printing the string representation of the object.

Variable Tracker

Variable	Start	After Step 1	After Step 2	Final
$p	undefined	Person object with name='Alice'	Same object, __toString called	Same object

Key Moments - 2 Insights

Why does PHP call __toString() when echoing an object?

Because echo expects a string, PHP automatically calls __toString() to get a string from the object, as shown in execution_table step 2.

What happens if __toString() is not defined and object is used as string?

PHP throws a fatal error because it cannot convert the object to string, unlike in step 3 where __toString() returns a string.

Visual Quiz - 3 Questions

Look at the execution_table, what is the output after step 4?

A Object

B Error

C Person: Alice

D Person object

💡 Hint

Check the 'Result' column in step 4 of execution_table.

At which step is __toString() method called?

A Step 1

B Step 2

C Step 3

D Step 4

💡 Hint

Look at the 'Action' column in execution_table for when __toString() is triggered.

If __toString() returned 'Hello', what would be printed?

A Hello

B Error

C Person: Alice

D Person object

💡 Hint

Refer to execution_table step 3 where __toString() return value determines output.

Concept Snapshot

__toString() method in PHP
- Used to convert object to string
- Called automatically in string context (e.g., echo)
- Must return a string
- If missing, using object as string causes error
- Helps customize object printout

Full Transcript

This visual trace shows how PHP uses the __toString() method to convert an object to a string when needed. First, a Person object is created with a name. When the object is used in echo, PHP calls __toString() automatically. The method returns a string representation, which echo prints. If __toString() was missing, PHP would error when trying to print the object. This method lets you control how your objects appear as strings.

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