Em PHP, todo array
é iterável.
Qualquer objeto também podem ser usado no foreach
, porém o comportamento não pode ser desejado, pois todas as propriedades públicas é que são usadas na iteração. Assim, você precisa definir a interface Iterator
ou IteratorAggregate
ou RecursiveIterator
para determinar o comportamento da classe quando a instância da mesma é invocada no foreach
.
Uma informação importante é que as interfaces Iterator
ou IteratorAggregate
herdam uma outra interface, chamada Traversable
. Ela é usada para o PHP detectar internamente se a classe é iterável via foreach
. Então quando você implementa Iterator
ou IteratorAggregate
, você implementa indiretamente Traversable
. O RecursiveIterator
por sua vez herda Iterator
, portanto também indiretamente herda Traversable
.
Resumindo: Toda interface de iteração em PHP herda Traversable
. Então toda classe que implementa Iterator
, é uma instância de Traversable
.
As classes citadas no post, ArrayObject
e FileSystemIterator
possuem a implementações de Iterator
. Então por isso são iteráveis.
Veja um teste no ideone.com
O yield
que foi citado na pergunta é usado para retornar uma instância da classe Generator
. Ele também implementa Iterator
e, portanto, implementa implicitamente Traversable
.
Já o caso do stdClass
, é o primeiro exemplo citado. Por ser um objeto vazio, todas as propriedades definidas nele são públicas. Então isso explica porque ele é iterável via foreach
.
Com base nas informações obtidas acima, eu diria que a forma mais segura de verificar se um valor é iterável em PHP é :
is_array($valor) || $valor instanceof stdClass || $valor instanceof Traversable;
Você pode criar uma função para checar isso se quiser:
function is_iterable($value)
{
return is_array($value) || $value instanceof stdClass || $value instanceof Traversable;
}