Generator function execution model in PHP - Step-by-Step Execution

Concept Flow - Generator function execution model

Call generator function

↓

First iteration: Start execution until yield

↓

Yield value to caller

↓

Pause execution

↓

Caller resumes generator

↓

Continue execution until next yield or return

↓

Repeat yield or finish

↓

Generator ends, return value or stop iteration

This flow shows how a PHP generator function runs: it starts, yields values one by one pausing after each, and resumes when the caller asks for the next value until it finishes.

Execution Sample

PHP

<?php
function countToThree() {
  yield 1;
  yield 2;
  yield 3;
}
$gen = countToThree();
foreach ($gen as $value) {
  echo $value . "\n";
}

This code defines a generator that yields numbers 1 to 3, then prints each number one by one.

Execution Table

Step	Action	Generator State	Yielded Value	Output
1	Call countToThree()	Created, before first yield	none	none
2	First yield reached	Paused after yielding 1	1	1
3	Resume generator	Running, before second yield	none	1
4	Second yield reached	Paused after yielding 2	2	2
5	Resume generator	Running, before third yield	none	2
6	Third yield reached	Paused after yielding 3	3	3
7	Resume generator	No more yields, generator ends	none	3
8	Iteration ends	Generator finished	none	3

💡 Generator ends after yielding all values; foreach loop stops.

Variable Tracker

Variable	Start	After Step 2	After Step 4	After Step 6	Final
$gen	Generator object created	Paused at yield 1	Paused at yield 2	Paused at yield 3	Finished

Key Moments - 2 Insights

Why does the generator pause after each yield instead of running all at once?

Because each yield sends a value back to the caller and pauses execution, waiting for the caller to request the next value (see steps 2, 4, 6 in execution_table).

What happens when the generator finishes all yields?

The generator ends and the foreach loop stops iterating (see step 7 and 8 in execution_table).

Visual Quiz - 3 Questions

Look at the execution table, what is the generator state after the first yield?

A Finished

B Running before first yield

C Paused after yielding 1

D Not started

💡 Hint

Check the 'Generator State' column at Step 2 in the execution_table.

At which step does the generator finish all yields and end?

A Step 4

B Step 7

C Step 6

D Step 8

💡 Hint

Look for 'No more yields, generator ends' in the 'Action' column.

If we add another yield after yield 3, how would the variable tracker change after Step 6?

A It would show 'Paused at new yield 4'

B It would show 'Finished' immediately

C It would still show 'Paused at yield 3'

D It would reset to 'Start'

💡 Hint

Variable tracker shows where the generator pauses after each yield (see current Step 6).

Concept Snapshot

PHP Generator Function:
- Use 'yield' to pause and send values one by one.
- Execution pauses at each yield until resumed.
- Caller uses foreach or next() to get values.
- Generator ends when no more yields.
- Saves memory by producing values on demand.

Full Transcript

This visual execution shows how a PHP generator function works step-by-step. Calling the generator function creates and returns a Generator object without starting execution. When the foreach starts its first iteration, execution begins and runs until it hits the first yield, then it pauses and sends that value to the caller. The caller receives the value and can use it, then asks the generator to continue. The generator resumes from where it paused, runs until the next yield, and pauses again. This repeats until the generator finishes all yields and ends. The foreach loop automatically handles this process, stopping when the generator is done. Variables track the generator's state, showing it pauses after each yield and finishes at the end.