Attached is a patch and an additional file ( to be added under phpdoc\en\install\windows ) for instructions on how to use the new MSI-based PHP Windows Installer that I contributed for PHP 5.2.
If I could have the karma to make these changes ( and keep them
up-to-date ) that would be great.
Thanks,
--
John Mertic "Explaining a joke
is like dissecting a frog: you
[EMAIL PROTECTED] understand it better,
but the frog dies in the
process."
-Mark Twain
windows.patch
Description: Binary data
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<sect1 id="install.windows.installer.msi">
<title>Windows Installer (PHP 5.2 and later)</title>
<para>
The Windows PHP installer for later versions of PHP is built using MSI
technology using the Wix Toolkit (<ulink url="http://wix.sourceforge.net/";>
http://wix.sourceforge.net</ulink>). It will install and configure PHP and
all the built-in and <acronym>PECL</acronym> extensions, as well as
configure many of the popular web servers such as <acronym>IIS</acronym>,
Apache, and Xitami.
</para>
<simpara>
First, install your selected <acronym>HTTP</acronym> (web) server on your
system, and make sure that it works. Then proceed with one of the following
install types.
</simpara>
<sect2 id="install.windows.installer.msi.normal">
<title>Normal Install</title>
<para>
Run the MSI installer and follow the instructions provided by the
installation wizard. You will be prompted to select the Web Server you
wish to configure first, along with any configuration details needed.
</para>
<para>
You will then be prompted to select which features and extensions you
wish to install and enable. By selecting "Will be installed on local
hard drive" in the drop-down menu for each item you can trigger whether
to install the feature or not. By selecting "Entire feature will be
installed on local hard drive", you will be able to install all
sub-features of the included feature ( for example by selecting this
options for the feature "PDO" you will install all PDO Drivers ).
</para>
<warning>
<para>
It is not recommended to install all extensions by default, since many
other them require dependencies from outside PHP in order to function
properly. Instead, use the Installation Repair Mode that can be
triggered thru the 'Add/Remove Programs' control panel to
enable or disable extensions and features after installation.
</para>
</warning>
<para>
The installer then sets up PHP to be used in Windows and the &php.ini;
file, and configures certain web servers to use PHP. The installer will
currently configure IIS (CGI mode only), Apache, Xitami, and Sambar
Server; if you are using a different web server you'll need to
configure it manually.
</para>
</sect2>
<sect2 id="install.windows.installer.msi.silent">
<title>Silent Install</title>
<para>
The installer also supports a silent mode, which is helpful for Systems
Administrators to deploy PHP easily. To use silent mode:
<screen>
<![CDATA[
msiexec.exe /i php-VERSION-win32-install.msi /q
]]>
</screen>
</para>
<para>
You can control the install directory by passing it as a parameter to the
install. For example, to install to e:\php:
<screen>
<![CDATA[
msiexec.exe /i php-VERSION-win32-install.msi /q INSTALLDIR=e:\php
]]>
</screen>
You can also use the same syntax to specify the Apache Configuration
Directory (APACHEDIR), the Sambar Server directory (SAMBARDIR), and the
Xitami Server directory (XITAMIDIR).
</para>
<para>
You can also specify what features to install. For example, to install
the mysqli extension and the CGI executable:
<screen>
<![CDATA[
msiexec.exe /i php-VERSION-win32-install.msi /q ADDLOCAL=cgi,ext_php_mysqli
]]>
</screen>
</para>
<para>
The current list of Features to install is as follows:
<screen>
<![CDATA[
MainExecutable - php.exe executable
ScriptExecutable - php-win.exe executable
ext_php_* - the various extensions ( for example: ext_php_mysql for MySQL )
apache13 - Apache 1.3 module
apache20 - Apache 2.0 module
apache22 - Apache 2,2 module
apacheCGI - Apache CGI executable
iis4ISAPI - IIS 4+ ISAPI module
iis4CGI - IIS 4+ CGI executable
pws4 - PWS 4 CGI executable
iis3 - IIS/PWS 3 CGI executable
NSAPI - Sun/iPlanet/Netscape server module
Xitami - Xitami CGI executable
Sambar - Sambar Server ISAPI module
CGI - php-cgi.exe executable
PEAR - PEAR installer
Manual - PHP Manual in CHM Format
]]>
</screen>
</para>
<para>
For more information on installing MSI installers from the command line,
visit <ulink url="msdn.microsoft.com/library/en-us/msi/setup/command_line_options.asp">
http://msdn.microsoft.com/library/en-us/msi/setup/command_line_options.asp
</ulink>
</para>
</sect2>
</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:"../../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
-->
