Description:
------------
The definition of glob in the PHP documentation reports that glob() 
returns an array.  But the section on return values clearly states 
that sometimes FALSE is returned.  The function definition should 
report a mixed return value.

Also, the return values section says that glob() returns false if 
the files cannot be read.  This is not true.  glob() only returns 
false if the files cannot be read *and* safe_mode is on.


http://us2.php.net/glob



Reproduce code:
---------------
su
mkdir foobar;
touch foobar/stuff
chmod a-rx foobar/stuff
chmod a-rx foobar/
exit

php -c /etc/php.ini glob.php (with safe_mode off)

string(12) "foobar/stuff"
array(0) {
}

php -c /etc/php.ini glob.php (with safe_mode on)

string(12) "foobar/stuff"
bool(false)

Warning: Invalid argument supplied for foreach() in glob.php on line 8

glob.php
============================================
<?php

$filesToRemove = glob( dirname(__FILE__).'/foobar/stuff' );
var_dump( dirname(__FILE__).'/foobar/stuff' );

var_dump($filesToRemove);

foreach ($filesToRemove as $k => $v) {
}
?>


Expected result:
----------------
Documentation of return type "mixed".
Better note that correctly identifies "safe_mode" as the reason for 
returning false.