Directory operations in PHP - Step-by-Step Execution

Concept Flow - Directory operations

Open Directory

↓

Read Entry

↓

Is Entry valid?

No→Close Directory

Yes↓

Process Entry

↓

Read Next Entry

↩Back to Is Entry valid?

This flow shows how PHP opens a directory, reads each entry one by one, processes it, and finally closes the directory.

Execution Sample

PHP

<?php
$dir = opendir('testdir');
while (($file = readdir($dir)) !== false) {
  echo "$file\n";
}
closedir($dir);
?>

This code opens a directory named 'testdir', reads each file or folder inside it, prints their names, and then closes the directory.

Execution Table

Step	Action	Function Call	Returned Value	Output/Effect
1	Open directory 'testdir'	opendir('testdir')	resource (directory handle)	Directory handle stored in $dir
2	Read first entry	readdir($dir)	'file1.txt'	Output: file1.txt
3	Read second entry	readdir($dir)	'file2.txt'	Output: file2.txt
4	Read third entry	readdir($dir)	'.'	Output: . (current directory)
5	Read fourth entry	readdir($dir)	'..'	Output: .. (parent directory)
6	Read fifth entry	readdir($dir)	false	No more entries, loop ends
7	Close directory	closedir($dir)	true	Directory closed

💡 readdir returns false when no more entries are left, ending the loop

Variable Tracker

Variable	Start	After 1	After 2	After 3	After 4	After 5	Final
$dir	null	resource	resource	resource	resource	resource	resource
$file	null	'file1.txt'	'file2.txt'	'.'	'..'	false	false

Key Moments - 3 Insights

Why does readdir return '.' and '..' entries?

These represent the current directory ('.') and the parent directory ('..'). They are normal entries in every directory and appear in the execution_table rows 4 and 5.

What happens when readdir returns false?

It means there are no more entries to read, so the while loop stops. This is shown in execution_table row 6.

Why do we need to call closedir?

closedir frees the resource and closes the directory handle. It is good practice to call it after finishing reading, as shown in execution_table row 7.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of $file at step 3?

A '.'

B 'file2.txt'

C 'file1.txt'

D '..'

💡 Hint

Check the 'Returned Value' column at step 3 in the execution_table.

At which step does the loop stop reading entries?

A Step 6

B Step 4

C Step 5

D Step 7

💡 Hint

Look for when readdir returns false in the execution_table.

If we forget to call closedir, what happens?

A The program will crash immediately.

B The directory entries won't be read.

C The directory handle remains open, possibly wasting resources.

D The loop will never end.

💡 Hint

Refer to the explanation in key_moments about closedir and execution_table step 7.

Concept Snapshot

PHP Directory Operations:
- Use opendir('path') to open a directory.
- Use readdir(handle) in a loop to read entries.
- readdir returns '.' and '..' for current and parent dirs.
- Loop ends when readdir returns false.
- Always call closedir(handle) to free resources.

Full Transcript

This visual trace shows how PHP handles directory operations step-by-step. First, opendir opens the directory and returns a handle. Then, readdir reads each entry one by one, including special entries '.' and '..'. Each entry is printed. When no more entries exist, readdir returns false, ending the loop. Finally, closedir closes the directory handle to free resources. Variables $dir and $file change as the program runs, with $file holding each entry name or false when done. Remember to close directories to avoid resource leaks.