Doc #60239 [Opn->Wfx]: Subtle httpd.conf "include wildcard" directive worthy of note

From: 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

« previous php.doc.bugs (#7529) next »