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
Votes:1
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
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: gth at example dot com
New email:
PHP Version: OS:

 

 [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

Pull Requests

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-2024 The PHP Group
All rights reserved.
Last updated: Thu Nov 21 17:01:32 2024 UTC