Description:
------------
---
From manual page: http://php.net/manual/en/pharfileinfo.construct.php
---

Spent two hours banging my head against the wall to find out 'foreach' does not loop over 'pharfileinfo' objects.

Please update the documentation and explain this limitation.


Test script:
---------------
    $p = new Phar('/path/to/my.phar', 0, 'my.phar');
    $p['testfile.txt'] = "hi\nthere\ndude";
    $file = $p['testfile.txt'];
    foreach ($file as $line => $text) {
        echo "line number $line: $text";
    }
    // this also works
    $file = new PharFileInfo('phar:///path/to/my.phar/testfile.txt');
    foreach ($file as $line => $text) {
        echo "line number $line: $text";
    }

Expected result:
----------------
line number 1: hi
line number 2: there
line number 3: dude
line number 1: hi
line number 2: there
line number 3: dude

Actual result:
--------------
A blank screen is displayed.