Some additions. But this file needs to be rewritten completely. There is much useless and even wrong crap in it. I hope I will do that until 4.3.3 is out.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@135288 c90b9560-bf6c-de11-be94-00142212c4b1

chapters/install.iplanet.xml

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
   <sect1 id="install.netscape-enterprise">
-   <title>Servers-Netscape and iPlanet</title>
+   <title>Servers: Netscape, iPlanet and SunONE</title>
    <para>
-    This section contains notes and hints specific to Netscape and iPlanet
+    This section contains notes and hints specific to Netscape, iPlanet and SunONE webserver
     installs of PHP, both for <link linkend="install.netscape.sun">Sun Solaris</link>
     and <link linkend="install.netscape.windows">Windows</link> versions.
    </para>
@@ -15,12 +15,12 @@
    <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 
+     To build PHP with NES/iPlanet/SunONE webservers, 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>. 
+     Please also read <filename>/php-xxx-version/sapi/nsapi/nsapi-readme.txt</filename>.
     </para>
     <note>
      <simpara>
@@ -33,7 +33,7 @@
       <listitem>
        <para>
         Install the following packages from <ulink url="&url.sun.freeware;">
-        &url.sun.freeware;</ulink> or another download site: 
+        &url.sun.freeware;</ulink> or another download site:
         <simplelist>
          <member><filename>autoconf-2.13</filename></member>
          <member><filename>automake-1.4</filename></member>
@@ -131,10 +131,12 @@ type=magnus-internal/x-httpd-php exts=php
          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!"
+Init fn="load-modules" funcs="php4_init,php4_execute,php4_auth_trans" shlib="/opt/netscape/suitespot/bin/libphp4.so"
+Init fn=php4_init errorString="Failed to initialize PHP!" [php_ini="/path/to/php.ini"]
 ]]>
          </programlisting>
+         The <literal>php_ini</literal> parameter is optional but with it you can place your
+         &php.ini; in your webserver config directory.
         </para>
        </listitem>
        <listitem>
@@ -146,13 +148,16 @@ Init fn=php4_init errorString="Failed to initialize PHP!"
 .
 .
 .
-.#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog' lines 
-Service fn="php4_execute" type="magnus-internal/x-httpd-php" 
-    . 
-    . 
+.#NOTE this next line should happen after all 'ObjectType' and before all 'AddLog' lines
+Service fn="php4_execute" type="magnus-internal/x-httpd-php" [inikey=value inikey=value ...]
+    .
+    .
     </Object>
 ]]>
          </programlisting>
+         As additional parameters you can add some special &php.ini;-values, for example you
+         can set a <literal>docroot</literal> specific to the context <literal>php4_execute</literal>
+         is called.
         </para>
        </listitem>
        <listitem>
@@ -160,10 +165,10 @@ Service fn="php4_execute" type="magnus-internal/x-httpd-php"
          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> 
+<Object name="x-httpd-php">
+ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
+Service fn=php4_execute [inikey=value inikey=value ...]
+</Object>
 ]]>
          </programlisting>
         </para>
@@ -173,7 +178,7 @@ Service fn=php4_execute
          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: 
+         following line to your default object:
          <programlisting>
 <![CDATA[
 <Object name="default">
@@ -188,11 +193,11 @@ AuthTrans fn=php4_auth_trans
        </listitem>
        <listitem>
         <para>
-         To use PHP Authentication on a single directory, add the following: 
+         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 ppath="d:\path\to\authenticated\dir\*">
+AuthTrans fn=php4_auth_trans
 </Object>
 ]]>
          </programlisting>
@@ -208,8 +213,8 @@ AuthTrans fn=php4_auth_trans
      (Contributed by Graeme Hoose, GraemeHoose at BrightStation dot com).
      <programlisting>
 <![CDATA[
-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"
+Init fn="load-modules" shlib="/path/to/server4/bin/libphp4.so" funcs="php4_init,php4_execute,php4_auth_trans"
+Init fn="php4_init" LateInit="yes" [php_ini="/path/to/php.ini"]
 ]]>
      </programlisting>
     </para>
@@ -218,7 +223,7 @@ Init fn="php4_init" LateInit="yes"
     <title>Installing PHP with Netscape on Windows</title>
     <para>
       To Install PHP as CGI (for Netscape Enterprise Server,
-      iPlanet, perhaps Fastrack), do the following:
+      iPlanet, SunONE, perhaps Fastrack), do the following:
     </para>
     <itemizedlist>
      <listitem>
@@ -267,7 +272,7 @@ ftype PHPScript=c:\php\php.exe %1 %*
     </para>
     <para>
      To Install PHP as NSAPI (for Netscape Enterprise Server,
-     iPlanet, perhaps Fastrack, do the following:
+     iPlanet, SunONE, perhaps Fastrack, do the following:
     </para>
     <itemizedlist>
      <listitem>
@@ -302,10 +307,12 @@ ftype PHPScript=c:\php\php.exe %1 %*
        (necessarily after mime type init!):
        <programlisting>
 <![CDATA[
-Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" shlib="c:/php/sapi/php4nsapi.dll"
-Init fn="php4_init" errorString="Failed to initialise PHP!"
+Init fn="load-modules" funcs="php4_init,php4_execute,php4_auth_trans" shlib="c:/php/sapi/php4nsapi.dll"
+Init fn="php4_init" errorString="Failed to initialise PHP!" [php_ini="c:/path/to/php.ini"]
 ]]>
        </programlisting>
+       The <literal>php_ini</literal> parameter is optional but with it you can place your
+       &php.ini; in your webserver config directory.
       </para>
      </listitem>
      <listitem>
@@ -315,9 +322,12 @@ Init fn="php4_init" errorString="Failed to initialise PHP!"
        and before all 'AddLog' lines:
        <programlisting>
 <![CDATA[
-Service fn="php4_execute" type="magnus-internal/x-httpd-php"
+Service fn="php4_execute" type="magnus-internal/x-httpd-php" [inikey=value inikey=value ...]
 ]]>
        </programlisting>
+       As additional parameters you can add some special &php.ini;-values, for example you
+       can set a <literal>docroot</literal> specific to the context <literal>php4_execute</literal>
+       is called.
       </para>
      </listitem>
      <listitem>
@@ -328,7 +338,7 @@ Service fn="php4_execute" type="magnus-internal/x-httpd-php"
 <![CDATA[
 <Object name="x-httpd-php">
 ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
-Service fn=php4_execute
+Service fn=php4_execute [inikey=value inikey=value ...]
 </Object>
 ]]>
        </programlisting>