|  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #77021 Conflicting info re. PHP.INI section headings
Submitted: 2018-10-16 08:58 UTC Modified: 2018-10-16 10:25 UTC
Avg. Score:3.0 ± 0.0
Reproduced:0 of 0 (0.0%)
From: gth at example dot com Assigned:
Status: Open Package: PHP options/info functions
PHP Version: Irrelevant OS: (Not applicable)
Private report: No CVE-ID: None
Have you experienced this issue?
Rate the importance of this bug to you:

 [2018-10-16 08:58 UTC] gth at example dot com
From manual page:
Currently states, in 'Example #2' -----

; any text on a line after an unquoted semicolon (;) is ignored
[php] ; section markers (text within square brackets) are also ignored

This conflicts with the 'ini-sections' feature which *does* parse content contained in square brackets, (presumably only if the content starts with 'HOST=' or 'PATH=').  Not sure if there are other section headings that also have special meaning.


Also a separate, minor style issue: the following acronyms are mentioned on the configuration.file doco' page without explanation. It would be good if they had the same helpful mouse-over hints that are shown for 'CGI' and 'CLI' --
- SAPI (Server Application Programming Interface)
- NSAPI (Netscape (web) Server Application Programming Interface)
- THTTPD (tiny/turbo/throttling HTTP server)
- OS (this could probably just be expanded outright)


Expected result:
Suggested wording to add:

<h3>Section Markers</h3>

Section markers (text within square brackets) are generally ignored, except when they match the configuration directives listed in <a href=ini.sections.php>ini.sections</a>.  For example '[HOST=<host>]' and '[PATH=<path>]' were added in 5.3.0.


Add a Patch

Pull Requests

Add a Pull Request


AllCommentsChangesGit/SVN commitsRelated reports
 [2018-10-16 10:25 UTC] gth at example dot com
-: php at gth dot id dot au +: gth at example dot com
 [2018-10-16 10:25 UTC] gth at example dot com
Amended submitter detail
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Mon Feb 26 03:01:33 2024 UTC