While you cannot implement this interface, you can use it in your checks to determine if something is usable in for each. Here is what I use if I'm expecting something that must be iterable via foreach.
<?php
if( !is_array( $items ) && !$items instanceof Traversable )
//Throw exception here
?>| CARVIEW |
Select Language
HTTP/2 200
server: myracloud
date: Tue, 14 Oct 2025 00:16:59 GMT
content-type: text/html; charset=utf-8
content-language: en
permissions-policy: interest-cohort=()
x-frame-options: SAMEORIGIN
link: ; rel=shorturl
last-modified: Tue, 14 Oct 2025 00:07:58 GMT
content-encoding: gzip
vary: accept-encoding
expires: Tue, 14 Oct 2025 00:16:59 GMT
cache-control: max-age=0
PHP: Traversable - Manual
The Traversable interface
(PHP 5, PHP 7, PHP 8)
Introduction
Interface to detect if a class is traversable using foreach.
Abstract base interface that cannot be implemented alone. Instead, it must be implemented by either IteratorAggregate or Iterator.
Interface synopsis
interface Traversable {
}This interface has no methods, its only purpose is to be the base interface for all traversable classes.
Changelog
| Version | Description |
|---|---|
| 7.4.0 | The Traversable interface can now be implemented by abstract classes. Extending classes must implement Iterator or IteratorAggregate. |
Notes
Note:
Internal (built-in) classes that implement this interface can be used in a
foreachconstruct and do not need to implement IteratorAggregate or Iterator.
Note:
Prior to PHP 7.4.0, this internal engine interface couldn't be implemented in PHP scripts. Either IteratorAggregate or Iterator must be used instead.
＋add a note
User Contributed Notes 4 notes
kevinpeno at gmail dot com ¶
15 years ago
cobaltbluedw ¶
9 years ago
NOTE: While objects and arrays can be traversed by foreach, they do NOT implement "Traversable", so you CANNOT check for foreach compatibility using an instanceof check.
Example:
$myarray = array('one', 'two', 'three');
$myobj = (object)$myarray;
if ( !($myarray instanceof \Traversable) ) {
print "myarray is NOT Traversable";
}
if ( !($myobj instanceof \Traversable) ) {
print "myobj is NOT Traversable";
}
foreach ($myarray as $value) {
print $value;
}
foreach ($myobj as $value) {
print $value;
}
Output:
myarray is NOT Traversable
myobj is NOT Traversable
one
two
three
one
two
three
douglas at reith dot com dot au ¶
8 years ago
The PHP7 iterable pseudo type will match both Traversable and array. Great for return type-hinting so that you do not have to expose your Domain to Infrastructure code, e.g. instead of a Repository returning a Cursor, it can return hint 'iterable':
<?php
UserRepository::findUsers(): iterable
?>
Link: https://php.net/manual/en/migration71.new-features.php#migration71.new-features.iterable-pseudo-type
Also, instead of:
<?php
if( !is_array( $items ) && !$items instanceof Traversable )
//Throw exception here
?>
You can now do with the is_iterable() method:
<?php
if ( !is_iterable( $items ))
//Throw exception here
?>
Link: https://php.net/manual/en/function.is-iterable.php
ajf at ajf dot me ¶
10 years ago
Note that all objects can be iterated over with foreach anyway and it'll go over each property. This just describes whether or not the class implements an iterator, i.e. has custom behaviour.
↑ and ↓ to navigate •
Enter to select •
Esc to close
Press Enter without
selection to search using Google