#20267 [Asn->Csd]: php_ini_scanned_files documentation

ID: 20267 Updated by: philip@php.net Reported By: leon@leonatkinson.com -Status: Assigned +Status: Closed Bug Type: Documentation problem PHP Version: 4CVS-2002-11-05 Assigned To: philip New Comment: The commit: http://cvs.php.net/co.php/phpdoc/en/reference/info/functions/php-ini-scanned-files.xml Previous Comments: ------------------------------------------------------------------------ [2002-11-06 20:52:15] philip@php.net 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 ------------------------------------------------------------------------ [2002-11-06 15:20:16] philip@php.net > 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@leonatkinson.com 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@php.net 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@leonatkinson.com 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