Is there a way to test a variable for "isForEachable"

Question

Using PHP, is there a function/method/way to check if a variable contains something that would be safe to put into a foreach construct? Something like

//the simple case, would probably never use it this bluntly
function foo($things)
{
    if(isForEachable($things))
    {
        foreach($things as $thing)
        {
            $thing->doSomething();
        }
    }
    else
    {
        throw new Exception("Can't foreach over variable");
    }
}

If your answer is "setup a handler to catch the PHP error", your efforts are appreciated, but I'm looking for something else.

Answer 1

Well, sort of. You can do:

if (is_array($var) || ($var instanceof Traversable)) {
    //...
}

However, this doesn't guarantee the foreach loop will be successful. It may throw an exception or fail silently. The reason is that some iterable objects, at some point, may not have any information to yield (for instance, they were already iterated and it only makes sense to iterate them once).

See Traversable. Arrays are not objects and hence cannot implement such interface (they predate it), but they can be traversed in a foreach loop.

Answer 2

PHP 7

Recent versions of PHP have is_iterable() and the iterable pseudo-type.

---

PHP 5

Since all objects and arrays are "foreachable" in PHP 5+...

function is_foreachable($var) {
  return is_array($var) || is_object($var);
}