<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Windows Installer (PHP 5.2 and later)</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="install.windows.installer.html">Windows Installer (PHP 5.1.0 and earlier)</a></div>
<div class="next" style="text-align: right; float: right;"><a href="install.windows.manual.html">Manual Installation Steps</a></div>
<div class="up"><a href="install.windows.html">Installation on Windows systems</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="install.windows.installer.msi" class="sect1">
<h2 class="title">Windows Installer (PHP 5.2 and later)</h2>
<p class="para">
The Windows PHP installer for later versions of PHP is built using MSI
technology using the Wix Toolkit (<a href="http://wix.sourceforge.net/" class="link external">» http://wix.sourceforge.net/</a>).
It will install and configure PHP and all the built-in and
<acronym title="PHP Extension and Application Repository">PECL</acronym> extensions, as well as configure many of the
popular web servers such as <acronym>IIS</acronym>, Apache, and Xitami.
</p>
<p class="simpara">
First, install your selected <acronym title="Hypertext Transfer Protocol">HTTP</acronym> (web) server on your
system, and make sure that it works. Then proceed with one of the following
install types.
</p>
<div class="sect2" id="install.windows.installer.msi.normal">
<h3 class="title">Normal Install</h3>
<p class="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.
</p>
<p class="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
option for the feature "PDO" you will install all PDO Drivers).
</p>
<div class="warning"><strong class="warning">Warning</strong>
<p class="para">
It is not recommended to install all extensions by default, since many
of them require dependencies from outside PHP in order to function
properly. Instead, use the Installation Repair Mode that can be
triggered through the 'Add/Remove Programs' control panel to
enable or disable extensions and features after installation.
</p>
</div>
<p class="para">
The installer then sets up PHP to be used in Windows and the <var class="filename">php.ini</var>
file, and configures certain web servers to use PHP. The installer will
currently configure IIS, Apache, Xitami, and Sambar
Server; if you are using a different web server you'll need to
configure it manually.
</p>
</div>
<div class="sect2" id="install.windows.installer.msi.silent">
<h3 class="title">Silent Install</h3>
<p class="para">
The installer also supports a silent mode, which is helpful for Systems
Administrators to deploy PHP easily. To use silent mode:
<div class="example-contents screen">
<div class="cdata"><pre>
msiexec.exe /i php-VERSION-win32-install.msi /q
</pre></div>
</div>
</p>
<p class="para">
You can control the install directory by passing it as a parameter to the
install. For example, to install to e:\php:
<div class="example-contents screen">
<div class="cdata"><pre>
msiexec.exe /i php-VERSION-win32-install.msi /q INSTALLDIR=e:\php
</pre></div>
</div>
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).
</p>
<p class="para">
You can also specify what features to install. For example, to install
the mysqli extension and the CGI executable:
<div class="example-contents screen">
<div class="cdata"><pre>
msiexec.exe /i php-VERSION-win32-install.msi /q ADDLOCAL=cgi,ext_php_mysqli
</pre></div>
</div>
</p>
<p class="para">
The current list of Features to install is as follows:
<div class="example-contents screen">
<div class="cdata"><pre>
MainExecutable - php.exe executable ( no longer available as of PHP 5.2.10/5.3.0; it is now included by default )
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 ISAPI module
iis4CGI - IIS CGI executable
iis4FastCGI - IIS CGI executable
NSAPI - Sun/iPlanet/Netscape server module
netserve - NetServe Web Server CGI executable
Xitami - Xitami CGI executable
Sambar - Sambar Server ISAPI module
CGI - php-cgi.exe executable
PEAR - PEAR installer
Manual - PHP Manual in CHM Format
</pre></div>
</div>
</p>
<p class="para">
For more information on installing MSI installers from the command line,
visit <a href="http://msdn.microsoft.com/en-us/library/aa367988.aspx" class="link external">» http://msdn.microsoft.com/en-us/library/aa367988.aspx</a>
</p>
</div>
<div class="sect2" id="install.windows.installer.msi.upgrade">
<h3 class="title">Upgrading PHP with the Install</h3>
<p class="para">
To upgrade, run the installer either graphically or from the command line
as normal. The installer will read your current install options, remove
your old installation, and reinstall PHP with the same options as before.
It is recommended that you use this method of keeping PHP updated instead
of manually replacing the files in the installation directory.
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="install.windows.installer.html">Windows Installer (PHP 5.1.0 and earlier)</a></div>
<div class="next" style="text-align: right; float: right;"><a href="install.windows.manual.html">Manual Installation Steps</a></div>
<div class="up"><a href="install.windows.html">Installation on Windows systems</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
