|  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #67389 document PHP_INI_SCAN_DIR
Submitted: 2014-06-05 18:03 UTC Modified: 2020-06-04 11:04 UTC
Avg. Score:3.0 ± 0.0
Reproduced:1 of 1 (100.0%)
Same Version:0 (0.0%)
Same OS:0 (0.0%)
From: Assigned:
Status: Open Package: *Configuration Issues
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If this is not your bug, you can add a comment by following this link.
If this is your bug, but you forgot your password, you can retrieve your password here.
Bug Type:
New email:
PHP Version: OS:


 [2014-06-05 18:03 UTC]
we should document that the additionally loaded ini files directory(which can be set via --with-config-file-scan-dir when compiling) can be changed by the PHP_INI_SCAN_DIR environment variable (maybe mention the stuff like SetEnv PHP_INI_SCAN_DIR /tmp won't work, but exporting the PHP_INI_SCAN_DIR env var from the apache startup script will).
we should also mention that listing multiple directories is supported since 5.5.10:


Add a Patch

Pull Requests

Add a Pull Request


AllCommentsChangesGit/SVN commitsRelated reports
 [2016-02-15 01:33 UTC] dzuelke at gmail dot com
Also worth documenting: the variable can contain an empty part (e.g. `:/extra/dir` or `/extra/dir:`), in which case the default value will be used.

This can then be used to load a bunch of additional INI files at runtime, while preserving all globally configured INIs.
 [2016-02-21 16:05 UTC] dzuelke at gmail dot com
Looks like this is already documented at
 [2016-05-25 22:29 UTC] aneece at gmail dot com
While the general behavior is indeed documented at that link (, it does not mention that the capability to handle multiple directories is only available from 5.5.10, as tyrael requested.

Instead, the text makes it sound like any version after PHP 5.2.0 can accomplish this, since that is the only time a version is mentioned in that block. It would be great if that page could get a slight update. Or you could even just add it to the Changelog section of that page.

Either way, it'd be a big help. Thanks!
 [2020-06-04 11:04 UTC]
-Type: Bug +Type: Documentation Problem
PHP Copyright © 2001-2023 The PHP Group
All rights reserved.
Last updated: Sat Dec 09 16:01:27 2023 UTC