php.net |  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
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
Description:
------------
---
From manual page: http://www.php.net/configuration.file
---
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.

http://php.net/manual/en/ini.sections.php

////

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.



Patches

Add a Patch

Pull Requests

Add a Pull Request

History

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-2018 The PHP Group
All rights reserved.
Last updated: Mon Dec 10 08:01:24 2018 UTC