php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #25120 contridictory statements in install.txt
Submitted: 2003-08-17 16:27 UTC Modified: 2004-08-07 21:01 UTC
From: kingjojo75 at hotmail dot com Assigned: nlopess (profile)
Status: Closed Package: Documentation problem
PHP Version: 4.3.2 OS: win2k
Private report: No CVE-ID: None
 [2003-08-17 16:27 UTC] kingjojo75 at hotmail dot com
Description:
------------
the install.txt doc in the windows binaries distros seem to cover several versions of php and seem to be contridictory.

first the file warns that you should not use the sapi modules, then later you are told that the sapi modules are stable and that you should not use the cgi file ("to do so is suicide") perhaps the wording needs to be retooled, but is is confusing as it is.

Reproduce code:
---------------
please note that the SAPI modules are *NOT* yet considered to be production quality.
The reason for this is that the PHP SAPI modules are using the thread-safe version of the PHP code, which is new to PHP 4, and has not yet been tested and pounded enough to be considered completely stable,.....

Now that version 4.1 introduces a safer sapi module, we recommend that you configure PHP as a module in Apache....

If you wish to install PHP as a CGI binary, read this first:
http://www.cert.org/advisories/CA-1996-11.html
and then if you are really sure, insert these lines to your conf file: 
ScriptAlias /php/ "c:/php/"
AddType application/x-httpd-php .php
Action application/x-httpd-php "/php/php.exe"
Note, we consider installing PHP like this suicidal.

Expected result:
----------------
I would hope for a straight forward install doc specific for the version its packaged with, not an entire history.


Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2004-08-07 18:29 UTC] vrana@php.net
Nuno is rewriting the install part.
 [2004-08-07 21:01 UTC] nlopess@php.net
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.


 [2020-02-07 06:11 UTC] phpdocbot@php.net
Automatic comment on behalf of nlopess
Revision: http://git.php.net/?p=doc/en.git;a=commit;h=3be560d618956b6757fceb044bc7560f1e9fcf10
Log: fix #25120: warning about CGI installs
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved.
Last updated: Wed Aug 06 18:00:03 2025 UTC