Installation sous Windows

InstallShield sous Windows

L'installeur Windows de PHP disponible depuis les pages de http://www.php.net/downloads.php, installe la version CGI de PHP, et configure les serveurs web IIS, PWS, et Xitami.

Notez bien que bien que InstallShield soit une méthode simple pour installer PHP, il est limité dans son fonctionnement, puisque l'installation automatique des extensions n'est pas prise en compte. Le jeu complet des extensions PHP est disponible en téléchargeant et décompressant manuellement l'archive.

Installez votre serveur HTTP favori sur votre système et assurez-vous qu'il fonctionne.

Exécutez l'installeur et suivez les instructions fournies par l'assistant. Deux types d'installation sont fournis : standard, qui utilise toutes les configurations par défaut les plus pratiques, et avancée, qui pose un maximum de questions pour paramétrer le plus finement.

L'assistant d'installation rassemble suffisamment d'informations pour configurer php.ini et le serveur web qui utilisera PHP. Pour IIS, mais aussi PWS sous NT Workstation, une liste de l'arboresence web est affichée, et vous pouvez sélectionner les dossiers qui utiliseront PHP.

Une fois l'installation terminée, l'installeur vous informera que vous devez redémarrer. Suivez ce conseil, ou commencez à utiliser PHP immédiatement.

Installation manuelle sous Windows

Ce guide d'installation vous aide à installer manuellement et configurer PHP sur votre serveur web Windows. La version initiale de ce guide a été compilée par Bob Silva, et est disponible en anglais, à http://www.umesd.k12.or.us/php/win32install.html. Vous devrez télécharger la distribution binaire Zip sur la page http://www.php.net/downloads.php.

PHP 4 pour Windows est distribué en trois versions : exécutable CGI, un exécutable CLI (sapi/php.exe) et d'autres modules SAPI :

Voici les différentes étapes d'installation avant les étapes spécifiques au serveur.

• Extrayez la distribution dans un dossier de votre choix, comme par exemple c:\. L'archive zip devient un dossier appelé php-4.3.1-Win32 qui est supposé être renommé en php. Par sourci de clarté, nous supposerons alors que vous avez placé votre distribution dans le dossier c:\php. Vous pouvez choisir un autre dossier, mais vous serez prudents d'éviter les espaces dans le nom du chemin au dossier (comme par exemple c:\program files\php n'est pas une bonne idée). car certains serveurs web vont crasher sinon. La structure du dossier que vous avez extrait ressemble à ceci :

c:\php
   |
   +--cli
   |  |
   |  |-php.exe           -- Executable CLI - UNIQUEMENT pour la ligne de commande
   |
   |
   +--dlls                -- DLL de support des extensions  --> dossier systeme Windows
   |  |
   |  |-expat.dll
   |  |
   |  |-fdftk.dll
   |  |
   |  |-...
   |
   +--extensions          -- extensions DLL pour PHP
   |  |
   |  |-php_bz2.dll
   |  |
   |  |-php_cpdf.dll
   |  |
   |  |-..
   |
   +--mibs                -- fichiers de support de SNMP
   |
   |
   +--openssl             -- fichiers de support de Openssl
   |
   |
   +--pdf-related         -- fichiers de support de PDF
   |
   |
   +--sapi                -- DLL SAPI
   |  |
   |  |-php4apache.dll
   |  |
   |  |-php4apache2.dll
   |  |
   |  |-php4isapi.dll
   |  |
   |  |-..
   |
   |-install.txt
   |
   |-..
   |
   |-php.exe              -- executable CGI
   |
   |-..
   |
   |-php.ini-dist
   |
   |-php.ini-recommended
   | 
   |-php4ts.dll           -- DLL principale --> dossier systeme Windows
   | 
   |-...

Le binaire CGI (C:\php\php.exe), le binaire CLI (c:\php\cli\php.exe), et les modules SAPI (c:\php\sapi\*.dll) dépendent de la DLL principale c:\php\php4ts.dll. Vous devez vous assurer que cette DLL est disponible pour votre installation PHP. L'ordre des dossiers lors de la recherche est le suivant :

• La meilleure chose à faire est de rendre php4ts.dll accessible, indépendemmant de l'interface utilisée (CGI ou module SAPI). Pour cela, vous devez copier la DLL dans un dossier de votre PATH Windows. La meilleure place est alors le dossier système Windows :

  c:\windows\system pour Windows 9x/ME

  c:\winnt\system32 pour Windows NT/2000 ou c:\winnt40\system32 pour NT/2000 server

  c:\windows\system32 pour Windows XP

  Si vous voulez utiliser le module SAPI depuis c:\php\sapi et que vous ne voulez pas copier vos DLL dans le dossier système Windows, vous avez la possibilité de copier simplement php4ts.dll dans le dossier SAPI de votre archive décompressée c:\php\sapi.

• L'étape suivante est de faire un fichier de configuration valide pour PHP, c'est à dire le fichier php.ini. Il y a deux versions de ce fichier disponibles dans l'archive : php.ini-dist et php.ini-recommended. Nous vous recommandons d'utiliser php.ini-recommended, car nous avons optimisé les configurations par défaut dans ce fichier pour les performances et la sécurité. Lisez bien ce fichier documenté, et étudiez toutes les configurations, puis faites vos propres choix. Si vous voulez atteindre la meilleure sécurité, c'est la meilleure méthode. Copiez votre fichier de configuration de choix dans un dossier où PHP est capable de le lire, et renommez le php.ini. Par défaut, PHP recherche php.ini dans votre dossier Windows :

  Sur Windows 9x/ME/XP, copiez le fichier php.ini dans votre dossier %WINDIR%, qui est généralement c:\windows.

  Sur Windows NT/2000, copiez le fichier php.ini dans votre dossier %WINDIR% ou %SYSTEMROOT%, qui est typiquement c:\winnt ou c:\winnt40 pour les serveurs NT/2000.

• Si vous utilisez NTFS sur Windows NT, 2000 ou XP, assurez vous que l'utilisateur qui fait tourner le serveur web a les droits de lecture de votre fichier php.ini (e.g. rendez le lisible par tout le monde).

Les étapes suivantes sont optionnelles :

• Editez votre nouveau fichier php.ini. Si vous envisagez d'utiliser OmniHTTPd, ignorez l'étape suivante. Configurez doc_root pour qu'il pointe sur la racine de votre serveur web. Par exemple :

  doc_root = c:\inetpub // pour IIS/PWS doc_root = c:\apache\htdocs // pour Apache

• Choisissez les extensions que vous voulez que PHP démarre. Voyez la section sur les extensions Windows, pour les configurer, si elles ne sont pas intégrées. Notez que sur une nouvelle installation, il est recommandé de commencer par faire fonctionner PHP avant d'ajouter ou retirer des extensions via le php.ini.

• Sur PWS et IIS, vous pouvez utiliser la directive browscap pour qu'elle pointe sur : c:\windows\system\inetsrv\browscap.ini sur Windows 9x/Me, c:\winnt\system32\inetsrv\browscap.ini sur NT/2000, et c:\windows\system32\inetsrv\browscap.ini sur XP.

Copiez le fichier php.ini-dist dans votre dossier %WINDOWS sous Windows 95/98, ou vers votre dossier %SYSTEMROOT% sous Windows NT ou Windows 2000 et renommez-le en php.ini. Votre dossier %WINDOWS% ou %SYSTEMROOT% est généralement :

Il y a deux fichiers ini, distribués dans le fichier zip, php.ini-dist et php.ini-optimized. Nous vous recommandons d'utiliser php.ini-optimized, car nous l'avons optimisé d'un point de vue sécurité et vitesse d'exécution. Le mieux est tout de même de lire le fichier de configuration php.ini et de choisir vos options manuellement. Si vous voulez atteindre un meilleur niveau de sécurité, c'est par ce moyen que vous pourrez le faire, même si PHP fonctionne parfaitement avec les configurations par défaut.

Editez votre fichier php.ini :

• la famille des serveurs Windows, Personal Web server (PWS) 3 et 4 ou plus récents; Internet Information Server (IIS) 3 et 4 ou plus récents.

• les serveurs Apache Apache 1.3.x, et Apache 2.x.

• les serveurs Netscape/iPlanet.

• le serveur OmniHTTPd.

• le serveur Oreilly Website Pro.

• le serveur Sambar.

• le serveur Xitami.

Compilation des sources

Avant de commencer, il est bon de se poser la question suivante : "Pourquoi la compilation de PHP sous Windows est si difficile?". Deux raisons viennent immédiatement à l'esprit :

1. Windows ne dispose pas (encore) d'une grande communauté de développeurs qui partagent librement leurs sources. La conséquence directe est que les investissements nécessaires en infrastructure pour supporter ce type de développement n'ont pas été faits. Ce qui fait que le portage des utilitaires Unix a été la solution pour pallier ce manque. Ne soyez donc pas surpris de rencontrer cette parenté de temps en temps.

2. La majorité des instructions que vous allez rencontrer sont du type : "faire et oublier". Alors, asseyez-vous confortablement et suivez aussi scrupuleusement que possible les instructions.

+--c:\work
|  |
|  +--bindlib_w32
|  |  |
|  |  +--arpa
|  |  |
|  |  +--conf
|  |  |
|  |  +--...
|  |
|  +--php-4.x.x
|  |  |
|  |  +--build
|  |  |
|  |  +--...
|  |  |
|  |  +--win32
|  |  |
|  |  +--...
|  |
|  +--win32build
|  |  |
|  |  +--bin
|  |  |
|  |  +--include
|  |  |
|  |  +--lib

Installation des extensions sous Windows

Après avoir installé PHP et votre serveur web sous Windows, vous voudrez sûrement ajouter quelques extensions bien pratiques. La table suivante liste une partie des extensions disponibles. Comme indiqué dans le manuel, vous pouvez choisir quelles extensions vous voulez charger en décommentant la ligne 'extension=php_*.dll' dans le fichier php.ini. Vous pouvez aussi charger dynamiquement un module avec la fonction dl().

Les fichiers DLLs des extensions PHP sont préfixés par php_ en PHP 4, et php3_ en PHP 3. Cela évite la confusion des extensions PHP et de leurs librairies.

Editez votre fichier php.ini :

• Vous devez modifier l'option de extension_dir pour qu'elle pointe sur le dossier qui contient les extensions, là où vous avez placé vos fichiers php_*.dll. N'oubliez surtout pas l'anti-slash final. Par exemple :

  extension_dir = c:/php/extensions/

• Pour activer les extensions dans le php.ini, il suffit de décommenter les lignes extension=php_*.dll dans le php.ini. Ceci est fait en effaçant le point-virgule initial de la ligne :

  Exemple 3-4. Activer l'extension Bzip2 sous Windows // changez la ligne ... ;extension=php_bz2.dll // ... en extension=php_bz2.dll

• Certaines de ces extensions requièrent des librairies DLL supplémentaires pour fonctionner correctement. Certaines d'entre elles sont disponibles dans la distribution. dans le dossier dlls mais certaines (comme Oracle (php_oci8.dll)), demandent des dlls qui ne sont pas dans la distribution.

  Copiez les dlls fournies depuis le dossier dlls dans votre PATH Windows. Les bons emplacements sont typiquement

  c:\windows\system pour Windows 9x/Me

  c:\winnt\system32 pour Windows NT/2000

  c:\windows\system32 pour Windows XP

  Si vous les avez déjà d'installées sur votre système, ne les écrasez que si PHP ne fonctionne pas correctement (et de toutes manières, faites une sauvegarde de ces DLL, en cas de problème).