mirror of
https://github.com/sigmasternchen/php-doc-en
synced 2025-03-16 00:48:54 +00:00
examples to xml, restructering
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@133058 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Friedhelm Betz
parent
2cf32db3ac
commit
dc6882a311
1 changed files with 186 additions and 128 deletions
|
|
@ -1,5 +1,5 @@
|
|||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision: 1.1 $ -->
|
||||
<!-- $Revision: 1.2 $ -->
|
||||
<sect1 id="install.netscape-enterprise">
|
||||
<title>Servers-Netscape and iPlanet</title>
|
||||
<para>
|
||||
|
|
@ -8,153 +8,211 @@
|
|||
and <link linkend="install.netscape.windows">Windows</link> versions.
|
||||
</para>
|
||||
<para>
|
||||
You can find more information about setting up PHP for
|
||||
the Netscape Enterprise Server here:
|
||||
You can find more information about setting up PHP for the Netscape
|
||||
Enterprise Server (NES) here:
|
||||
<ulink url="&url.netscape.nsapi;">&url.netscape.nsapi;</ulink>
|
||||
</para>
|
||||
<sect2 id="install.netscape.sun">
|
||||
<title>Installing PHP with Netscape on Sun Solaris</title>
|
||||
<para>
|
||||
To build PHP with NES or iPlanet web servers, enter the proper
|
||||
install directory for the
|
||||
<link linkend="install.configure.with-nsapi">--with-nsapi</link>
|
||||
= <replaceable>DIR</replaceable> option. The default
|
||||
directory is usually <filename class="directory">/opt/netscape/suitespot/</filename>.
|
||||
To build PHP with NES or iPlanet web servers, enter the proper install
|
||||
directory for the
|
||||
<link linkend="install.configure.with-nsapi">--with-nsapi=[DIR]</link>
|
||||
option. The default directory is usually
|
||||
<filename class="directory">/opt/netscape/suitespot/</filename>.
|
||||
Please also read <filename>/php-xxx-version/sapi/nsapi/nsapi-readme.txt</filename>.
|
||||
</para>
|
||||
<note>
|
||||
<simpara>
|
||||
These instructions are written for Sun Solaris 2.6 with Netscape
|
||||
Enterprise Server 3.6, conributed by bhager at invacare dot com.
|
||||
</simpara>
|
||||
</note>
|
||||
<para>
|
||||
<example id="install.netscape-enterprise.solaris">
|
||||
<title>Installation Example for Netscape Enterprise on Solaris</title>
|
||||
<screen>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Install the following packages from <ulink url="&url.sun.freeware;">
|
||||
&url.sun.freeware;</ulink> or another download site:
|
||||
<simplelist>
|
||||
<member><filename>autoconf-2.13</filename></member>
|
||||
<member><filename>automake-1.4</filename></member>
|
||||
<member><filename>bison-1_25-sol26-sparc-local</filename></member>
|
||||
<member><filename>flex-2_5_4a-sol26-sparc-local</filename></member>
|
||||
<member><filename>gcc-2_95_2-sol26-sparc-local</filename></member>
|
||||
<member><filename>gzip-1.2.4-sol26-sparc-local</filename></member>
|
||||
<member><filename>m4-1_4-sol26-sparc-local</filename></member>
|
||||
<member><filename>make-3_76_1-sol26-sparc-local</filename></member>
|
||||
<member>
|
||||
<filename>mysql-3.23.24-beta</filename> (if you want mysql support)
|
||||
</member>
|
||||
<member><filename>perl-5_005_03-sol26-sparc-local</filename></member>
|
||||
<member><filename>tar-1.13</filename> (GNU tar)</member>
|
||||
</simplelist>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Make sure your path includes the proper directories
|
||||
<literal>PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin</literal>
|
||||
and make it available to your system <userinput>export PATH</userinput>.
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<userinput>gunzip php-x.x.x.tar.gz</userinput> (if you have a .gz dist,
|
||||
otherwise go to 4).
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<userinput>tar xvf php-x.x.x.tar</userinput>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Change to your extracted PHP directory:
|
||||
<userinput>cd ../php-x.x.x </userinput>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
For the following step, make sure
|
||||
<filename class="directory">/opt/netscape/suitespot/</filename> is
|
||||
where your netscape server is installed. Otherwise, change to the
|
||||
correct path and run:
|
||||
<programlisting role="shell">
|
||||
<![CDATA[
|
||||
Instructions for Sun Solaris 2.6 with Netscape Enterprise Server 3.6
|
||||
From: bhager@invacare.com
|
||||
|
||||
1. Install the following packages from www.sunfreeware.com or another
|
||||
download site:
|
||||
|
||||
flex-2_5_4a-sol26-sparc-local
|
||||
gcc-2_95_2-sol26-sparc-local
|
||||
gzip-1.2.4-sol26-sparc-local
|
||||
perl-5_005_03-sol26-sparc-local
|
||||
bison-1_25-sol26-sparc-local
|
||||
make-3_76_1-sol26-sparc-local
|
||||
m4-1_4-sol26-sparc-local
|
||||
autoconf-2.13
|
||||
automake-1.4
|
||||
mysql-3.23.24-beta (if you want mysql support)
|
||||
tar-1.13 (GNU tar)
|
||||
|
||||
2. Make sure your path includes the proper directories
|
||||
PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin
|
||||
export PATH
|
||||
|
||||
3. gunzip php-x.x.x.tar.gz (if you have a .gz dist, otherwise go to 4)
|
||||
4. tar xvf php-x.x.x.tar
|
||||
5. cd ../php-x.x.x
|
||||
|
||||
6. For the following step, make sure /opt/netscape/suitespot/ is where
|
||||
your netscape server is installed. Otherwise, change to correct path:
|
||||
/configure --with-mysql=/usr/local/mysql --with-nsapi=/opt/netscape/suitespot/ --enable-track-vars --enable-libgcc
|
||||
7. make
|
||||
8. make install
|
||||
./configure --with-mysql=/usr/local/mysql \
|
||||
--with-nsapi=/opt/netscape/suitespot/ \
|
||||
--enable-libgcc
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
After performing the base install and reading the appropriate
|
||||
readme file, you may need to performs some additional
|
||||
configuration steps.
|
||||
</programlisting>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Run <command>make</command> followed by <command>make install</command>.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</para>
|
||||
<para>
|
||||
Firstly you may need to add some paths to the LD_LIBRARY_PATH
|
||||
environment for Netscape to find all the shared libs. This can
|
||||
best done in the start script for your Netscape server.
|
||||
Windows users can probably skip this step. The start
|
||||
script is often located in:
|
||||
<filename
|
||||
class="directory">/path/to/server/https-servername/start</filename>
|
||||
After performing the base install and reading the appropriate readme file,
|
||||
you may need to perform some additional configuration steps.
|
||||
</para>
|
||||
<para>
|
||||
You may also need to edit the configuration files that are
|
||||
located in:<filename
|
||||
class="directory">/path/to/server/https-servername/config/</filename>.
|
||||
</para>
|
||||
|
||||
<example id="install.netscape-enterprise.configure">
|
||||
<title>
|
||||
Configuration Example for Netscape Enterprise
|
||||
</title>
|
||||
<screen>
|
||||
<formalpara>
|
||||
<title>Configuration Instructions for NES</title>
|
||||
<para>
|
||||
Firstly you may need to add some paths to the LD_LIBRARY_PATH environment
|
||||
for Netscape to find all the shared libs. This can best done in the start
|
||||
script for your Netscape server. Windows users can probably skip this
|
||||
step. The start script is often located in: <filename
|
||||
class="directory">/path/to/server/https-servername/start</filename>.
|
||||
You may also need to edit the configuration files that are
|
||||
located in: <filename
|
||||
class="directory">/path/to/server/https-servername/config/</filename>.
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Add the following line to <filename>mime.types</filename>:
|
||||
<screen>
|
||||
<![CDATA[
|
||||
Configuration Instructions for Netscape Enterprise Server
|
||||
From: bhager@invacare.com
|
||||
|
||||
1. Add the following line to mime.types:
|
||||
type=magnus-internal/x-httpd-php exts=php
|
||||
|
||||
2. Add the following to obj.conf, shlib will vary depending on
|
||||
your OS, for unix it will be something like
|
||||
/opt/netscape/suitespot/bin/libphp4.so.
|
||||
|
||||
You should place the following lines after mime types init.
|
||||
Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" shlib="/php4/nsapiPHP4.dll"
|
||||
Init fn=php4_init errorString="Failed to initialize PHP!"
|
||||
|
||||
<object name="default">
|
||||
.
|
||||
.
|
||||
.
|
||||
.#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog' lines
|
||||
Service fn="php4_execute" type="magnus-internal/x-httpd-php"
|
||||
type=magnus-internal/x-httpd-php exts=php
|
||||
]]>
|
||||
</screen>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Edit <filename>obj.conf</filename> and add the following, shlib will
|
||||
vary depending on your OS, for Unix it will be something like
|
||||
<filename>/opt/netscape/suitespot/bin/libphp4.so</filename>. You should
|
||||
place the following lines after <literal>mime types init</literal>.
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" shlib="/php4/nsapiPHP4.dll"
|
||||
Init fn=php4_init errorString="Failed to initialize PHP!"
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Configure the default object:
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<object name="default">
|
||||
.
|
||||
.
|
||||
.
|
||||
.#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog' lines
|
||||
Service fn="php4_execute" type="magnus-internal/x-httpd-php"
|
||||
.
|
||||
.
|
||||
</Object>
|
||||
|
||||
|
||||
<Object name="x-httpd-php">
|
||||
ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
|
||||
Service fn=php4_execute
|
||||
</Object>
|
||||
|
||||
|
||||
Authentication configuration
|
||||
|
||||
PHP authentication cannot be used with any other authentication. ALL AUTHENTICATION IS
|
||||
PASSED TO YOUR PHP SCRIPT. To configure PHP Authentication for the entire server, add
|
||||
the following line:
|
||||
|
||||
<Object name="default">
|
||||
AuthTrans fn=php4_auth_trans
|
||||
.
|
||||
.
|
||||
.
|
||||
.
|
||||
</Object>
|
||||
|
||||
To use PHP Authentication on a single directory, add the following:
|
||||
|
||||
<Object ppath="d:\path\to\authenticated\dir\*">
|
||||
AuthTrans fn=php4_auth_trans
|
||||
</Object>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
</programlisting>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Create a new object for the usage of PHP:
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<Object name="x-httpd-php">
|
||||
ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
|
||||
Service fn=php4_execute
|
||||
</Object>
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Setup of authentication: PHP authentication cannot be used with any
|
||||
other authentication. ALL AUTHENTICATION IS PASSED TO YOUR PHP SCRIPT.
|
||||
To configure PHP Authentication for the entire server, add the
|
||||
following line to your default object:
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<Object name="default">
|
||||
AuthTrans fn=php4_auth_trans
|
||||
.
|
||||
.
|
||||
.
|
||||
</Object>
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
To use PHP Authentication on a single directory, add the following:
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
<Object ppath="d:\path\to\authenticated\dir\*">
|
||||
AuthTrans fn=php4_auth_trans
|
||||
</Object>
|
||||
]]>
|
||||
</programlisting>
|
||||
</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</para>
|
||||
</formalpara>
|
||||
<para>
|
||||
If you are running Netscape Enterprise 4.x, then you should use the following:
|
||||
</para>
|
||||
<example>
|
||||
<title>Configuration Example for Netscape Enterprise 4.x</title>
|
||||
If you are running Netscape Enterprise 4.x, then you should use the
|
||||
following: Place these lines after the <literal>mime types init</literal>,
|
||||
and everything else is similar to the example configuration above.
|
||||
(Contributed by Graeme Hoose, GraemeHoose at BrightStation dot com).
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
Place these lines after the mime types init, and everything else is similar
|
||||
to the example configuration above.
|
||||
From: Graeme Hoose (GraemeHoose@BrightStation.com)
|
||||
|
||||
Init fn="load-modules" shlib="/path/to/server4/bin/libphp4.so" funcs="php4_init,php4_close,php4_execute,php4_auth_trans"
|
||||
Init fn="php4_init" LateInit="yes"
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</para>
|
||||
</sect2>
|
||||
<sect2 id="install.netscape.windows">
|
||||
<title>Installing PHP with Netscape on Windows</title>
|
||||
|
|
@ -166,14 +224,14 @@ Init fn="php4_init" LateInit="yes"
|
|||
<listitem>
|
||||
<simpara>
|
||||
Copy <filename>php4ts.dll</filename> to your systemroot
|
||||
(the directory where you installed windows)
|
||||
(the directory where you installed Windows)
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Make a file association from the command line.
|
||||
Type the following two lines:
|
||||
<programlisting>
|
||||
<programlisting role="shell">
|
||||
<![CDATA[
|
||||
assoc .php=PHPScript
|
||||
ftype PHPScript=c:\php\php.exe %1 %*
|
||||
|
|
@ -215,14 +273,14 @@ ftype PHPScript=c:\php\php.exe %1 %*
|
|||
<listitem>
|
||||
<simpara>
|
||||
Copy <filename>php4ts.dll</filename> to your systemroot
|
||||
(the directory where you installed windows)
|
||||
(the directory where you installed Windows)
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Make a file association from the command line.
|
||||
Type the following two lines:
|
||||
<programlisting>
|
||||
<programlisting role="shell">
|
||||
<![CDATA[
|
||||
assoc .php=PHPScript
|
||||
ftype PHPScript=c:\php\php.exe %1 %*
|
||||
|
|
@ -314,4 +372,4 @@ End:
|
|||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||||
vim: et tw=78 syn=sgml
|
||||
vi: ts=1 sw=1
|
||||
-->
|
||||
-->
|
||||
|
|
|
|||
Loading…
Reference in a new issue