<!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>