[PHP-DOC] #20267 [Fbk->Asn]: php_ini_scanned_files documentation From: philip <email protected>
Date: 11/06/02

 ID: 20267
 Updated by: philip <email protected>
 Reported By: leon <email protected>
-Status: Feedback
+Status: Assigned
 Bug Type: Documentation problem
 PHP Version: 4CVS-2002-11-05
 Assigned To: philip
 New Comment:

Okay, did some tests with the following results:

a) If --with-config-file-scan-dir was set but the directory was empty,
an empty string is returned.
b) If --with-config-file-scan-dir was not set, boolean false is
returned.
c) If a file in the path is unrecognizable, one will get a "PHP: Error
parsing /path/somefile on line 1" during both compile time and when
using this function but the file name will still exist in the returned
string so the function will not return false. This error cannot be
supressed, even with error_reporting(0) or @!

Someday (c) will require a little more testing, I'll email Rasmus (the
creator of this directive) for further details.

Also it's worth mentioning that the file names are full paths, so they
include the directory as set by --with-config-file-scan-dir

Previous Comments:
------------------------------------------------------------------------

[2002-11-06 15:20:16] philip <email protected>

> The comma-separated list has linebreaks after the
> commas, too.

Ahh, okay.

> Technically, I don't think there's a failure condition
> for this function. It returns FALSE if there were no
> additional configuration files.

Under what conditions does this function return an empty string, and
when is boolean false returned?

> BTW, your opening literal tag is mis-typed.

Doh! Thank goodness for 'make test' and keen eyes such as yours :)

------------------------------------------------------------------------

[2002-11-06 12:09:43] leon <email protected>

Yes, it looks right. The comma-separated list has linebreaks after the
commas, too.

Technically, I don't think there's a failure condition for this
function. It returns FALSE if there were no additional configuration
files.

BTW, your opening literal tag is mis-typed.

Thanks,
Leon

------------------------------------------------------------------------

[2002-11-06 01:54:39] philip <email protected>

Please confirm the following description:

<function>php_ini_scanned_files</function> returns a comma-separated
list of configuration files parsed after &php.ini;. These files are
found in a directory defined by the
<literel>--with-config-file-scan-dir</literal> option which is set
during compilation.

Returns a comma-separated string of .ini files on success or an empty
string if either no file scan directory was set, the directory was
empty, or on failure. 

--
Especially the last sentence :)

------------------------------------------------------------------------

[2002-11-05 15:52:16] leon <email protected>

We need documentation for php_ini_scanned_files()

string php_ini_scanned_files(void)
This function returns a comma-separated list of configuration files
parsed after php.ini.  These files are found in a directory defined by
the --with-config-file-scan-dir option sent to configure before
compilation.

------------------------------------------------------------------------

-- 
Edit this bug report at http://bugs.php.net/?id=20267&edit=1

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php