Doc #64292 [Opn->Nab]: Missing documentation details for return value of DirectoryIterator::current()

Edit report at https://bugs.php.net/bug.php?id=64292&edit=1 ID: 64292 Updated by: frozenfire@php.net Reported by: maciej dot sz at gmail dot com Summary: Missing documentation details for return value of DirectoryIterator::current() -Status: Open +Status: Not a bug Type: Documentation Problem Package: Documentation problem Operating System: irrelevant PHP Version: Irrelevant Block user comment: N Private report: N New Comment: This is not a bug. For recursively iterating directory contents, use RecursiveDirectoryIterator. DirectoryIterator is intended to give you a single level of directory contents that you can iterate. The current item is not a way to reference and iterate an item's children. Previous Comments: ------------------------------------------------------------------------ [2013-02-24 15:19:15] maciej dot sz at gmail dot com Description: ------------ Since DirectoryIterator::current() returns itself there is many confusion while using it. It can't for instance be used as an argument of recursive method. Test script: --------------- foreach ( new DirectoryIterator(__DIR__) as $Current ) { var_dump($Di === $Current); } bool(true) bool(true) bool(true) ... Expected result: ---------------- In order to use DirectoryIterator object as a function parameter you MUST clone it: function iterateDirRecursive(DirectoryIterator $Di) { foreach ( $Di as $Item ) { $Current = clone $Item; // notice the clone here if ( $Current->isDir() && ! $Current->isDot() ) { iterateDirRecursive($Current); } } } iterateDirRecursive(new DirectoryIterator(__DIR__)); Actual result: -------------- Otherwise it will fail with "out of memory" or "maximum nesting level reached" depending on your PHP compilation: function iterateDirRecursive(DirectoryIterator $Di) { foreach ( $Di as $Item ) { $Current = $Item; // clone is missing if ( $Current->isDir() && ! $Current->isDot() ) { iterateDirRecursive($Current); } } } iterateDirRecursive(new DirectoryIterator(__DIR__)); ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=64292&edit=1