3.3.9.2 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 :

• php4apache.dll - module Apache 1.3.x.
• php4apache2.dll - module Apache 2.0.x.
• php4isapi.dll - module ISAPI compatible avec les serveurs comme IIS 4.0/PWS 4.0 ou plus récents.
• php4nsapi.dll - module Netscape/iPlanet.

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 :

• Le dossier d'où php.exe est appelé. Lorsque vous utilisez le module SAPI, c'est le dossier d'où le serveur web charge la DLL (i.e. php4apache.dll ).
• Tout dossier dans la variable d'environnement Windows PATH .

• 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 :

• c:\windows pour Windows 9x/Me
• c:\winnt ou c:\winnt40 pour les serveurs NT/2000

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 .