 |
 |
 |
 |
|
|
Date: 11/28/98
- Next message: eschmid: "[PHP-DEV] CVS update: php3/doc/functions"
- Previous message: eschmid: "[PHP-DEV] CVS update: php3/doc"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Date: Saturday November 28, 1998 @ 13:17
Author: eschmid
Update of /repository/php3/doc/chapters
In directory asf:/u2/tmp/cvs-serv10920/chapters
Modified Files:
install.sgml
Log Message:
Bob Silva's Installation Guide for Windows
Index: php3/doc/chapters/install.sgml
diff -c php3/doc/chapters/install.sgml:1.31 php3/doc/chapters/install.sgml:1.32
*** php3/doc/chapters/install.sgml:1.31 Tue Nov 17 05:03:21 1998
--- php3/doc/chapters/install.sgml Sat Nov 28 13:17:45 1998
***************
*** 676,743 ****
</sect1>
<sect1 id="install-windows95-nt">
! <title>Installing PHP on Windows95/NT</title>
<sect2>
! <title>Apache/NT and Stronghold/NT</title>
!
<simpara>
! Follow the instructions for configuration under Unix.
</sect2>
<sect2>
! <title>IIS and MS-PWS</title>
! <simpara>
! You can access php scripts simply by putting the php.exe file
! into your scripts directory and using a url such as:
! <filename role=url>http://my.server/scripts/php.exe/page.php>
! <simpara>
! Redirection If you would like to use a url like:
! <filename role=url>http://my.server/page.php> you will
! have to edit your registry.
! <note><simpara>
! Disclaimer: Be sure you make a backup of your registry before
! editing it. The PHP Development Team is not responsible for
! damaged registries. If you damage your registry, you may not be
! able to restart your computer without reinstalling your OS!
! </simpara></note>
! <simpara>
! You can edit your registry by running regedit.exe. To do this,
! choose Run... from the Start menu, and type
! <command>regedit</command> then click on OK. The registry
! setting you need to edit is:
! <database>HKEY_LOCAL_MACHINE:System:CurrentControlSet:Services:W3Svc:Parameters:ScriptMap</database>.
! Add a new string value here with the extension you would like to
! use for your php scripts, and make the value data the path to the
! php executable: <literal>.phtm3 "c:\webshare\scripts\php.exe"</literal>
! <simpara>
! For the ISAPI version of PHP, use something like: <literal>.phtm
! "c:\webshare\scripts\php3_isapi.dll"</literal>
<simpara>
! You must also make any directories containing php scripts
! executable. This is done in the IIS administrator. Consult your
! IIS documentation for more information.
<simpara>
! For other servers consult your server documentation.
<simpara>
! PHP.INI File Under Windows, PHP will look for php3.ini
! automaticaly, first under the windows os directory
! (<filename>c:\windows</filename> or
! <filename>c:\winnt</filename>) then in the directory in which the
! PHP executable resides. Alternately, you can set the environment
! variable <envar>PHPRC=\pathto\php3.ini</envar>, though this does
! not work with all servers (apache for one).
</sect2>
</sect1>
--- 676,1157 ----
</sect1>
<sect1 id="install-windows95-nt">
! <title>PHP3 Installation Guide for Windows</title>
+ <simpara>
+ This install guide will help you install and configure PHP3 on
+ your Windows 9x/NT webservers. This guide was compiled by
+ &link.bob;. The latest revision can be found at <ulink
+ url="&url.win32install">&url.win32install</ulink>.
+
+ <para>
+ This guide provides installation support for:
+ <simplelist>
+ <member>Personal Web Server (Newest version recommended)</member>
+ <member>Internet Information Server 3 or 4</member>
+ <member>Apache 1.3.x</member>
+ <member>Omni HTTPd 2.0b1</member>
+ </simplelist>
+ </para>
+
<sect2>
! <title>Configuration Changes for PHP3</title>
!
! <simpara>
! All modules are now prefixed with 'php3_'. You will need to
! change your <link linkend="php3.ini">php3.ini</link> file and/or
! any scripts loading extensions with the <function>dl</function>
! function (or you could always remove the 'php3_' prefix). This
! will prevent confusion between php modules and their supporting
! libraries.
<simpara>
! The <ulink url="&url.php3.changelog;">ChangeLog</ulink>, <ulink
! url="&url.php3.faq;">FAQ</ulink> and updated documentation can
! always be found at the offical PHP website or any of its mirrors.
</sect2>
<sect2>
! <title>General Installation Steps</title>
! <para>
! The following steps should be performed on all installations
! before the server specific instructions.
!
! <itemizedlist>
! <listitem>
! <para>
! Extract the distribution file to a directory of your choice.
! "C:\PHP3\" is a good start.
! </para>
! </listitem>
! <listitem>
! <para>
! Copy the file, 'php3-dist.ini' to your '%WINDOWS%' directory
! and rename it to 'php3.ini'. Your '%WINDOWS%' directory is
! typically:
! <simplelist>
! <member>c:\windows for Windows 95/98</member>
! <member>c:\winnt or c:\winnt40 for NT servers</member>
! </simplelist>
! </para>
! </listitem>
! <listitem>
! <para>
! Edit your 'php3.ini' file:
! <itemizedlist>
! <listitem>
! <simpara>
! You will need to change the 'extension_dir' setting to
! point to your php-install-dir, or where you have placed
! your 'php3_*.dll' files. ex: c:\php3
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Set the 'doc_root' to point to your webservers
! document_root. ex: c:\apache\htdocs or c:\webroot
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Choose which modules you would like to load when PHP
! starts. You can uncomment the: 'extension=php3_*.dll' lines
! to load these modules. Some modules require you to have
! additional libraries installed on your system for the
! module to work correctly. The PHP <ulink
! url="&url.php3.faq">FAQ</ulink> has more information on
! where to get supporting libraries. You can also load a
! module dynamically in your script using:
! <command>dl("php_*.dll");</command>
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! On PWS and IIS, you can set the browscap.ini to point to:
! 'c:\windows\system\inetsrv\browscap.ini' on Windows 95/98
! und 'c:\winnt\system32\inetsrv\browscap.ini' on NT
! Server. Additional information on using the browscap
! functionality in PHP can be found at this <ulink
! url="&url.browscap;">mirror</ulink>, select the "source"
! button to see it in action.
! </simpara>
! </listitem>
! </itemizedlist>
! </para>
! </listitem>
! </itemizedlist>
! </sect2>
! <sect2>
! <title>Windows 95/98/NT and PWS/IIS 3</title>
! <simpara>
! The recommended method for configuring these servers is to use
! the INF file included with the distribution
! (php_iis_reg.inf). You may want to edit this file and make sure
! the extensions and PHP install directories match your
! configuration. Or you can follow the steps below to do it
! manually.
! </simpara>
! <simpara>
! WARNING: These steps involve working directly with the windows
! registry. One error here can leave your system in an unstable
! state. We highly recommend that you back up your registry
! first. The PHP Development team will not be held responsible if
! you damage your registry.
! </simpara>
!
! <para>
! <itemizedlist>
! <listitem>
! <simpara>
! Run Regedit.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Navigate to: <literal>HKEY_LOCAL_MACHINE /System
! /CurrentControlSet /Services /W3Svc /Parameters
! /ScriptMap</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! On the edit menu select: <literal>New->String Value</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Type in the extension you wish to use for your php
! scripts. ex: <literal>.php3</literal>
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Double click on the new string value and enter the path to
! <literal>php.exe</literal> in the value data field. ex:
! <literal>c:\php3\php.exe %s %s</literal>. The '%s %s' is VERY
! important, PHP will not work properly without it.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Repeat these steps for each extension you wish to associate
! with PHP scripts.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Now navigate to: <literal>HKEY_CLASSES_ROOT</literal>
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! On the edit menu select: <literal>New->Key</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Name the key to the extension you setup in the previous
! section. ex: <literal>.php3</literal>
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Highlight the new key and in the right side pane, double click
! the "default value" and enter <literal>phpfile</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Repeat the last step for each extension you set up in the
! previous section.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Now create another <literal>New->Key</literal> under
! <literal>HKEY_CLASSES_ROOT</literal> and name it
! <literal>phpfile</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Highlight the new key <literal>phpfile</literal> and in the
! right side pane, double click the "default value" and enter
! <literal>PHP Script</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Right click on the <literal>phpfile</literal> key and select
! <literal>New->Key</literal>, name it <literal>Shell</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Right click on the <literal>Shell</literal> key and select
! <literal>New->Key</literal>, name it <literal>open</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Right click on the <literal>open</literal> key and select
! <literal>New->Key</literal>, name it
! <literal>command</literal>.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Highlight the new key <literal>command</literal> and in the
! right side pane, double click the "default value" and enter
! the path to <literal>php.exe</literal>. ex:
! <literal>c:\php3\php.exe -q %1</literal>. (don't forget the
! <literal>%1</literal>).
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Exit Regedit.
! </simpara>
! </listitem>
! </itemizedlist>
!
! <simpara>
! PWS and IIS 3 users now have a fully operational system. IIS 3
! users can use a nifty <ulink
! url="http://www.genusa.com/iis/iiscfg.html">tool</ulink> from
! Steven Genusa to configure their script maps.
! </simpara>
! </sect2>
!
! <sect2>
! <title>Windows NT and IIS 4</title>
<simpara>
! To install PHP3 on an NT Server running IIS 4, follow these
! instructions:
! </simpara>
!
! <para>
! <itemizedlist>
! <listitem>
! <simpara>
! In Internet Service Manager (MMC), select the Web site or the
! starting point directory of an application.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Open the directory's property sheets (by right clicking and
! selecting properties), and then click the Home Directory,
! Virtual Directory, or Directory tab.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Click the Configuration button, and then click the App
! Mappings tab.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Click Add, and in the Executable box, type:
! <literal>c:\path-to-php-dir\php.exe %s %s</literal>. You MUST
! have the %s %s on the end, PHP will not function properly if
! you fail to do this.
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! In the Extension box, type the file name extension you want
! associated with PHP scripts. (You must repeat step 5 and 6 for
! each extension you want accociated with PHP
! scripts. (<literal>.php3</literal> and
! <literal>.phtml</literal> are common)
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! Set up the appropriate security. (This is done in Internet
! Service Manager), and if your NT Server uses NTFS file system,
! add execute rights for I_USR_ to the directory that contains
! <literal>php.exe</literal>.
! </simpara>
! </listitem>
! </itemizedlist>
! </para>
!
! </sect2>
+ <sect2>
+ <title>Windows 9x/NT and Apache 1.3.x</title>
+
+ <simpara>
+ You must edit your <literal>srm.conf</literal> or
+ <literal>httpd.conf</literal> to configure Apache to work with
+ the PHP CGI binary.
+ </simpara>
<simpara>
! Although there can be a few variations of configuring PHP under
! Apache, this one is simple enough to be used by the
! newcomer. Please consult the Apache Docs for further
! configuration directives.
!
! <para>
! <itemizedlist>
! <listitem>
! <simpara>
! <literal>ScriptAlias /php3/
! "c:/path-to-php-dir/php.exe"</literal>
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! <literal>AddType application/x-httpd-php3 .php3</literal>
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! <literal>AddType application/x-httpd-php3 .phtml</literal>
! </simpara>
! </listitem>
! <listitem>
! <simpara>
! <literal>Action application/x-httpd-php3 "php3/php.exe"</literal>
! </simpara>
! </listitem>
! </itemizedlist>
! </para>
<simpara>
! To use the source code highlighting feature, simply create a PHP
! script file and stick this code in: <literal><?php show_source
! ("original_php_script.php3"); ?></literal>. Substitute
! <literal>original_php_script.php3</literal> with the name of the
! file you wish to show the source of. (this is only one way of
! doing it). <emphasis>Note:</emphasis> On Win-Apache all back
! slashes in a path statement such as: "c:\directory\file.ext",
! must be converted to forward slashes.
! </simpara>
!
! </sect2>
!
! <sect2>
! <title>Omni HTTPd 2.0b1 for Windows</title>
!
! <simpara>
! This has got to be the easiest config there is:
! </simpara>
!
! <para>
! <simplelist>
! <member>Step 1: Install Omni server</member>
! <member>Step 2: Right click on the blue OmniHTTPd icon in the
! system tray and select <literal>Properties</literal></member>
! <member>Step 3: Click on <literal>Web Server Global
! Settings</literal></member>
! <member>Step 4: On the 'External' tab, enter: <literal>virtual =
! .php3 | actual = c:\path-to-php-dir\php.exe</literal></member>
! <member>Step 5: On the <literal>Mime</literal> tab, enter:
! <literal>virtual = wwwserver/stdcgi | actual =
! .php3</literal></member>
! <member>Step 6: Click <literal>OK</literal></member>
! </simplelist>
!
! <simpara>
! Repeat steps 2 - 6 for each extension you want to associate with
! PHP.
! </simpara>
</sect2>
+
+ <sect2>
+ <title>PHP Modules</title>
+
+ <para>
+ <table>
+ <title>PHP Modules</title>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>php3_calendar.dll</entry>
+ <entry>Calendar conversion functions</entry>
+ </row>
+ <row>
+ <entry>php3_crypt.dll</entry>
+ <entry>Crypt functions</entry>
+ </row>
+ <row>
+ <entry>php3_dbase.dll</entry>
+ <entry>DBase functions</entry>
+ </row>
+ <row>
+ <entry>php3_dbm.dll</entry>
+ <entry>GDBM emulation via Berkely DB2 library</entry>
+ </row>
+ <row>
+ <entry>php3_filepro.dll</entry>
+ <entry>READ ONLY access to filepro databases</entry>
+ </row>
+ <row>
+ <entry>php3_gd.dll</entry>
+ <entry>GD Library functions for gif manipulation</entry>
+ </row>
+ <row>
+ <entry>php3_hyperwave.dll</entry>
+ <entry>HyperWave functions</entry>
+ </row>
+ <row>
+ <entry>php3_imap4r2.dll</entry>
+ <entry>IMAP 4 functions</entry>
+ </row>
+ <row>
+ <entry>php3_ldap.dll</entry>
+ <entry>LDAP functions</entry>
+ </row>
+ <row>
+ <entry>php3_msql1.dll</entry>
+ <entry>mSQL 1 client</entry>
+ </row>
+ <row>
+ <entry>php3_msql2.dll</entry>
+ <entry>mSQL 2 client</entry>
+ </row>
+ <row>
+ <entry>php3_mssql.dll</entry>
+ <entry>MSSQL client (requires MSSQL DB-Libraries</entry>
+ </row>
+ <row>
+ <entry>php3_mysql.dll</entry>
+ <entry>MySQL functions</entry>
+ </row>
+ <row>
+ <entry>php3_nsmail.dll</entry>
+ <entry>Netscape mail functions</entry>
+ </row>
+ <row>
+ <entry>php3_oci73.dll</entry>
+ <entry>Oracle functions</entry>
+ </row>
+ <row>
+ <entry>php3_snmp.dll</entry>
+ <entry>SNMP get and walk functions (NT only!)</entry>
+ </row>
+ <row>
+ <entry>php3_zlib.dll</entry>
+ <entry>ZLib functions</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+
+ </sect2>
+
</sect1>
-- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe <email protected> For help: php-dev-help <email protected>
- Next message: eschmid: "[PHP-DEV] CVS update: php3/doc/functions"
- Previous message: eschmid: "[PHP-DEV] CVS update: php3/doc"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]