A bit of cleaning in the install docs.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@299643 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Daniel Egeberg 2010-05-23 12:19:22 +00:00
parent ec6501cd33
commit 5179a9d3ad
6 changed files with 17 additions and 164 deletions

View file

@ -180,7 +180,7 @@ AddModule mod_perl.c
# Extra Modules
LoadModule php_module modules/mod_php.so
LoadModule php5_module modules/libphp5.so # for PHP 5
LoadModule php5_module modules/libphp5.so
LoadModule perl_module modules/libperl.so
]]>
</programlisting>
@ -264,7 +264,7 @@ AddType application/x-httpd-php .php
Some operating systems: I have installed PHP without errors,
but when I try to start Apache I get undefined symbol errors:
<programlisting role="shell">
[mybox:user /src/php4] root# apachectl configtest
[mybox:user /src/php5] root# apachectl configtest
apachectl: /usr/local/apache/bin/httpd Undefined symbols:
_compress
_uncompress
@ -287,10 +287,12 @@ AddType application/x-httpd-php .php
Windows: I have installed PHP, but when I try to access
a PHP script file via my browser, I get the error:
<screen>
<![CDATA[
cgi error:
The specified CGI application misbehaved by not
returning a complete set of HTTP headers.
The headers it did return are:
]]>
</screen>
</para>
</question>
@ -315,7 +317,7 @@ cgi error:
<listitem>
<simpara>
File permissions on your PHP script,
<filename>php.exe</filename>, <filename>php4ts.dll</filename>,
<filename>php.exe</filename>, <filename>php5ts.dll</filename>,
&php.ini; or any PHP extensions you are trying to load are such
that the anonymous internet user
<literal>ISUR_&lt;machinename&gt;</literal> cannot access them.
@ -572,11 +574,6 @@ cgi error:
.php</literal> with:
<programlisting role="apache-conf">
<![CDATA[
# PHP 4
AddHandler php-script php
AddType text/html php
# PHP 5
AddHandler php5-script php
AddType text/html php
]]>

View file

@ -68,24 +68,12 @@
side of the LoadModule statement must point to the path of the PHP
module on your system. The make install from above may have already
added this for you, but be sure to check.
For PHP 4:
LoadModule php4_module libexec/libphp4.so
For PHP 5:
LoadModule php5_module libexec/libphp5.so
15. And in the AddModule section of httpd.conf, somewhere under the
ClearModuleList, add this:
For PHP 4:
AddModule mod_php4.c
For PHP 5:
AddModule mod_php5.c
16. Tell Apache to parse certain extensions as PHP. For example,
@ -147,12 +135,6 @@
]]>
</screen>
</example>
<note>
<para>
Replace <literal>php-5</literal> by <literal>php-4</literal> and
<literal>php5</literal> by <literal>php4</literal> in PHP 4.
</para>
</note>
<para>
Depending on your Apache install and Unix variant, there are many
@ -203,10 +185,10 @@ stop and start:
</informalexample>
</para>
<para>
This will create a <filename>libphp5.so</filename> (or
<filename>libphp4.so</filename> in PHP 4) shared library that is loaded
into Apache using a LoadModule line in Apache's &httpd.conf; file. The
PostgreSQL support is embedded into this library.
This will create a <filename>libphp5.so</filename> shared library
that is loaded into Apache using a LoadModule line in Apache's
&httpd.conf; file. The PostgreSQL support is embedded into this
library.
</para>
<para>
<informalexample>
@ -218,7 +200,7 @@ stop and start:
</informalexample>
</para>
<para>
This will create a <filename>libphp4.so</filename> shared
This will create a <filename>libphp5.so</filename> shared
library for Apache, but it will also create a
<filename>pgsql.so</filename> shared library that is loaded into
PHP either by using the extension directive in
@ -242,8 +224,7 @@ stop and start:
<literal>--activate-module=src/modules/php5/libphp5.a</literal>
and the Apache build system will create
<filename>libphp5.a</filename> and link it statically into the
<filename>httpd</filename> binary (replace <literal>php5</literal> by
<literal>php4</literal> in PHP 4). The PostgreSQL support is
<filename>httpd</filename> binary. The PostgreSQL support is
included directly into this <filename>httpd</filename> binary,
so the final result here is a single <filename>httpd</filename>
binary that includes all of Apache and all of PHP.

View file

@ -1,71 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.unix.caudium" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Caudium</title>
<para>
PHP can be built as a Pike module for the
<link xlink:href="&url.caudium;">Caudium webserver</link>.
Follow the simple instructions below to install PHP for Caudium.
</para>
<example xml:id="install.unix.caudium.instructions">
<title>Caudium Installation Instructions</title>
<screen>
<![CDATA[
1. Make sure you have Caudium installed prior to attempting to
install PHP 4. For PHP 4 to work correctly, you will need Pike
7.0.268 or newer. For the sake of this example we assume that
Caudium is installed in /opt/caudium/server/.
2. Change directory to php-x.y.z (where x.y.z is the version number).
3. ./configure --with-caudium=/opt/caudium/server
4. make
5. make install
6. Restart Caudium if it's currently running.
7. Log into the graphical configuration interface and go to the
virtual server where you want to add PHP 4 support.
8. Click Add Module and locate and then add the PHP 4 Script Support module.
9. If the documentation says that the 'PHP 4 interpreter isn't
available', make sure that you restarted the server. If you did
check /opt/caudium/logs/debug/default.1 for any errors related to
PHP4.so. Also make sure that
caudium/server/lib/[pike-version]/PHP4.so
is present.
10. Configure the PHP Script Support module if needed.
]]>
</screen>
</example>
<para>
You can of course compile your Caudium module with support for the
various extensions available in PHP 4. See the reference pages
for extension specific configure options.
</para>
<note>
<para>
When compiling PHP 4 with MySQL support you must make sure that
the normal MySQL client code is used. Otherwise there might be
conflicts if your Pike already has MySQL support. You do this by
specifying a MySQL install directory the
<option role="configure">--with-mysql</option> option.
</para>
</note>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -3,23 +3,14 @@
<sect1 xml:id="install.unix.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>CGI and command line setups</title>
<para>
The default is to build PHP as a CGI program. This creates a
command line interpreter, which can be used for CGI processing, or
for non-web-related PHP scripting. If you are running a web
server PHP has module support for, you should generally go for
that solution for performance reasons. However, the CGI version
enables users to run different PHP-enabled pages under
different user-ids.
By default, PHP is built as both a <acronym>CLI</acronym> and
<acronym>CGI</acronym> program, which can be used for CGI
processing. If you are running a web server that PHP has module
support for, you should generally go for that solution for
performance reasons. However, the CGI version enables users to run
different PHP-enabled pages under different user-ids.
</para>
&warn.install.cgi;
<para>
As of PHP 4.3.0, some important additions have happened to PHP. A new
SAPI named CLI also exists and it has the same name as the CGI binary.
What is installed at <literal>{PREFIX}/bin/php</literal> depends on your
configure line and this is described in detail in the manual section
named <link linkend="features.commandline">Using PHP from the command
line</link>. For further details please read that section of the manual.
</para>
<sect2 xml:id="install.unix.commandline.testing">
<title>Testing</title>

View file

@ -1,43 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.unix.fhttpd" xmlns="http://docbook.org/ns/docbook">
<title><productname>fhttpd</productname> related notes</title>
<para>
To build PHP as an <productname>fhttpd</productname> module,
answer <literal>"yes"</literal> to <literal>"Build as an
fhttpd module?"</literal> (the <link
linkend="configure.with-fhttpd">
--with-fhttpd</link>=<replaceable>DIR</replaceable>
option to configure) and specify the <productname>fhttpd</productname> source base
directory. The default directory is <filename
class="directory">/usr/local/src/fhttpd</filename>. If you are
running <productname>fhttpd</productname>, building PHP as a module will give better
performance, more control and remote execution capability.
</para>
<note>
<simpara>
Support for <productname>fhttpd</productname> is no longer available as of PHP 4.3.0.
</simpara>
</note>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -87,8 +87,6 @@
&install.unix.apache1;
&install.unix.apache2;
&install.unix.lighttpd-14;
&install.unix.caudium;
&install.unix.fhttpd;
&install.unix.sun;
&install.unix.commandline;
<!-- operating system specific nodes -->