Doc #60239 [Opn->Wfx]: Subtle httpd.conf "include wildcard" directive worthy of note
| From: | frozenfire@php.net | Date: | Sat, 03 Dec 2011 23:14:22 +0000 |
| Subject: | Doc #60239 [Opn->Wfx]: Subtle httpd.conf "include wildcard" directive worthy of note | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-7529@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=60239&edit=1
ID: 60239
Updated by: frozenfire@php.net
Reported by: csm at forus dot com
Summary: Subtle httpd.conf "include wildcard" directive
worthy of note
-Status: Open
+Status: Wont fix
Type: Documentation Problem
Package: Documentation problem
Operating System: CentOS 6
PHP Version: Irrelevant
Block user comment: N
Private report: N
New Comment:
While I agree that some may endure a bit of confusion if they're not familiar
with CentOS's way of writing httpd.conf, I do not feel it's a good idea to
include that in the PHP manual.
The directions for setting PHP up in Apache on Unix-based systems are general to
most all systems. Since CentOS is an enterprise system by design, one should
expect that anyone administrating it will be familiar with the relevant
directives, and how CentOS does things.
To include those directions may add additional confusion for those who aren't
using CentOS.
Previous Comments:
------------------------------------------------------------------------
[2011-11-07 20:49:11] csm at forus dot com
Description:
------------
For one confused comparing systems and/or setting up a new one (and thus coming to these docs), the
subtle wildcard directive "Include conf.d/*.conf" can mislead and thus is worthy of
special note. At minimal this specific directive is employed in CentOS 6's powerful, but
mysterious, "web sever" install with PHP.
Specifically, in http://www.php.net/manual/en/install.unix.apache2.php
step 7 notes refer to changes to make in httpd.conf. When searching for something like
"php" in httpd.conf to follow your setup, one may draw false conclusions about what they
have if they are not aware of the subtle "Include conf.d/*.conf" line - which may load a
"php.conf".
Your docs are great, and very appreciated. But if you do not object I suggest that a mention of the
powerful "include wildcard" directive somehow adjunct to mention of "httpd.conf"
would be worthwhile to those arriving in need (which is most of us).
Thanks,
Cris Mooney
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=60239&edit=1