Cette section s'applique aux systèmes Windows 98/Me et Windows NT/2000/XP. Ne vous attendez pas à ce que PHP fonctionne sur les plateformes 16 bits, comme Windows 3.1. Parfois, on décrira les plateformes supportées sous le nom de Win32. Windows 95 n'est plus supporté à partir de la version 4.3.0 de PHP.
Il y a deux méthodes principales pour installer PHP sous Windows : soit manuellement, soit avec InstallShield.
Si vous avez Microsoft Visual Studio, vous pouvez aussi compiler PHP à partir des sources.
Une fois que PHP est installé sur votre Windows, vous pouvez aussi ajouter diverses extensions.
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.
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 le wizard. 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.
Le wizard 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.
Avertissement |
Gardez bien à l'esprit que cette installation de PHP n'est pas sécurisée. Si vous voulez avoir une installation sécurisée de PHP, vous devriez commencer par lire la documentation, et choisir toutes vos options avec soin. Cet installeur automatique vous permet de réaliser l'installation en un tour de main, mais n'est pas destinée à l'utilisation sur des serveurs de production. |
Ce guide vous permet d'installer et de configurer manuellement PHP sur vos stations Windows 9x/Me/NT/2000. Vous devrez commencer par télécharger la distribution de PHP au format compressé ZIP à http://www.php.net/downloads.php. La première version de ce guide a été compilée par Bob Silva. La version originale est disponible (en anglais) à http://www.umesd.k12.or.us/php/win32install.html.
Ce guide fournit une aide d'installation pour :
Personal Web Server (Version la plus récente recommandée)
Internet Information Server 3 ou 4
Apache 1.3.x
Omni HTTPd 2.0b1 et plus récent
Oreilly Website Pro
Xitami
Netscape Enterprise Server, iPlanet
PHP 4 pour Windows est décliné en deux versions : un exécutable CGI (php.exe), et plusieurs modules SAPI (par exemple php4isapi.dll). Cette dernière forme est nouvelle pour PHP 4 et founit des performances améliorées ainsi que des fonctionnalités supplémentaires.
Avertissement |
Les modules SAPI ont été significativement améliorés en version 4.1. Toutefois, vous pouvez rencontrer des erreurs de serveur ou des erreurs de modules tels qu'ASP, dans les anciens systèmes. |
Si vous choisissez l'un des modules SAPI et utilisez Windows 95, pensez à télécharger la mise à jour DCOM à Microsoft DCOM pages. Pour le module ISAPI, comme un serveur web compatible est nécessaire (testé avec IIS 4.0, PWS 4.0 et IIS 5.0). IIS 3.0 n'est pas supporté; vous devez télécharger et installer le Windows NT 4.0 Option Pack avec IIS 4.0 si vous voulez le support natif de PHP.
Voici les différentes étapes d'installation avant les étapes spécifiques au serveur.
Extrayez la distribution dans le dossier de votre choix. "C:\php\" est une bonne idée.
Vous devez vous assurer que les DLL que PHP utilise sont disponibles. La liste précise des DLL dépend du serveur web que vous utilisez, et de la méthode que vous utilisez pour faire exécuter vos script (CGI ou module). php4ts.dll est toujours nécessaire. Si vous utilisez PHP en module, (e.g. ISAPI or Apache), vous aurez besoin de la DLL ad hoc, dans le dossier sapi. Si vous utilisez des extensions PHP, vous aurez besoin des DLL associées. Pour être certains que les DLL sont accessibles, vous pouvez les copier dans le dossier système (i.e. winnt/system32 ou windows/system) ou vous pouvez vous assurer qu'elles sont dans le même dossier que l'exécutable PHP ou les autres DLL de votre serveur web (i.e. php.exe, ou php4apache.dll).
L'exécutable binaire PHP, les modules SAPI, et certaines extensions utilisent des DLL externes. Assurez-vous que ces DLL sont dans votre distribution, et dans un dossier qui est cité dans le PATH Windows. Le mieux à faire est de copier les fichiers ci-dessous dans votre dossier système, qui est généralement :
c:\windows\system pour Windows 9x/Me |
c:\winnt\system32 pour Windows NT/2000 |
"php4ts.dll", s'il existe, écrasez le |
Les fichiers "dlls" de votre distribution. Si vous les avez déjà installés, ne les remplacez pas, sauf si quelque chose ne fonctionne pas correctement (avant de les écraser, il est recommandé de les sauver de toute manière, au cas où quelque chose irait de travers). |
Téléchargez la dernière version de Microsoft Data Access Components (MDAC) pour votre plateforme, spécialement si vous utilisez Microsoft Windows 9x/NT4. MDAC est disponible à http://www.microsoft.com/data/.
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 focntionne parfaitement avec les configurations par défaut.
Editez votre fichier php.ini :
Vous devez changer votre option 'extension_dir' pour qu'il pointe sur votre dossier d'installation PHP, ou vers l'endroit où vous avez installé vos 'php_*.dll'. ex: c:\php\extensions
Si vous utilisez Omni Httpd, sautez l'étape suivante. Modifiez 'doc_root' pour qu'il pointe sur votre racine de serveur web. ex: c:\apache\htdocs ou c:\webroot.
Choisissez les modules que vous voulez charger lorsque PHP démarre. Voyez la section sur les extensions Windows, pour savoir comment les installer et quelles sont celles qui sont déjà inclues. Notez aussi qu'il est préférable de commencer par faire fonctionner PHP sur une nouvelle installation avant d'activer des extensions supplémentaires avec php.ini.
Sous PWS et IIS, vous pouvez configurer le fichier browscap.ini pour qu'il pointe sur c:\windows\system\inetsrv\browscap.ini sous Windows 9x/Me, c:\winnt\system32\inetsrv\browscap.ini sous NT/2000 et c:\windows\system32\inetsrv\browscap.ini sous XP.
Notez que le dossier mibs fourni avec la distribution Windows, contient des fichiers de support du protocole SNMP. Ce dpssier doit être déplacé dans le dossier DRIVE:\usr\mibs (DRIVE est le périphérique où PHP est installé.)
Si vous n'utilisez pas NTFS sous Windows NT, 2000 et XP, assurez-vous que l'utilisateur qui fait tourner le serveur web a bien les permission pour accéder à votre php.ini.
Avec PWS, donnez les droits d'exécution au webmestre :
Démarrez le PWS Web Manager
Editez les Properties du dossier "Home"
Sélectionnez la coche "execute"
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 :
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.
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.
Pour compilerl'exécutable PHP, vous avez besoin d'un Microsoft Development Environment. Microsoft Visual C++ 6.0 est recommendé. Pour éxtraire le fichier téléchargé, vous avez besoin d'un outil de décompression (e.g.: Winzip). Si vous n'avez pas encore d'utilitaire de décompression, vous pouvez en télécharger un chez InfoZip.
Avant de commencer, vous devez télécharger...
les win32 buildtools de PHP, sur http://www.php.net/extra/win32build.zip.
le code source du résolveur de noms DNS utilisé par PHP sur http://www.php.net/extra/bindlib_w32.zip. C'est un remplacement pour la librairie resolv.lib inclue dans win32build.zip.
Si vous prévoyez de compiler PHP comme module pour Apache, vous aurez aussi besion des sources d'Apache.
Finalement, vous aurez besoin des sources PHP 4 elles-mêmes!! Les dernières versions sont accessibles sur le serveur CVS anonyme. Si vous téléchargez une version intermédiaire ou la source,
Après téléchargement des paquets nécessaires, vous devez les extraire au bon endroit.
Créez un dossier où tous les fichiers seront placés après l'extraction, comme par exemple :c:\work.
Créez le dossier win32build dans votre dossier de travail (ici c:\work) et décompressez win32build.zip dedans.
Créez le dossier bindlib_w32 sous votre dossier de travail (ici c:\work) et décompressez bindlib_w32.zip dedans.
Décompressez le code source de PHP dans votre dossier de travail (c:\work).
+--c:\work | | | +--bindlib_w32 | | | | | +--arpa | | | | | +--conf | | | | | +--... | | | +--php-4.x.x | | | | | +--build | | | | | +--... | | | | | +--win32 | | | | | +--... | | | +--win32build | | | | | +--bin | | | | | +--include | | | | | +--lib |
Note : Les utilisateurs de Cygwin peuvent omettre la dernière étable. Un environnement Cygwin correctement installé fournit les fichiers obligatoires de bison.simple et bison.exe.
Lancez Microsoft Visual C++, et allez dans le menu "select Tools => Options". Dans le dialogue, sélectionnez l'onglet "directories". Modifiez les valeurs pour les items du menu Executables, Includes et Library files. Votre configuration doit alors ressembler à
Fichiers éxécutables : c:\work\win32build\bin, Utilisateurs Cygwin : cygwin\bin
Fichiers include: c:\work\win32build\include
Fichiers library : c:\work\win32build\lib
Vous devez compiler la librairie resolv.lib. Decidez si vous avez besoin des symboles de débogage (bindlib - Win32 Debug) ou non (bindlib - Win32 Release). Compilez la configuration ad hoc :
Pour les utilisateurs de l'interface graphique, lancez VC++, puis sélectionnez le menu "File => Open Workspace" et "bindlib". Puis sélectionnez "Build=>Set Active Configuration" et sélectionnez la configuration voulue. Enfin, sélectionnez "Build=>Rebuild All".
Pour les utilisateurs en ligne de commande, assurez-vous que vous avez enregistré les variables d'environnement C++, ou que vous avez exécuté vcvars.bat. Exécutez maintenant l'une des commandes suivantes :
msdev bindlib.dsp /MAKE "bindlib - Win32 Debug"
msdev bindlib.dsp /MAKE "bindlib - Win32 Release"
La meilleure façon de compiler est de commander par la version CGI/exécutable.
Pour les utilisateurs GUI, lancez VC++, puis sélectionnez le menu "File => Open Workspace" et sélectionnez "php4ts". Ensuite, sélectionnez le menu "Build=>Set Active Configuration", et sélectionnez la configuration voulue. Finalement, sélectionnez le menu "Build=>Rebuild All".
Pour les utilisateurs en ligne de commande, assurez-vous que vous avez enregistré les variables d'environnement C++, ou que vous avez exécuté vcvars.bat. Exécutez maintenant l'une des commandes suivantes :
msdev php4ts.dsp /MAKE "php4ts - Win32 Debug_TS"
msdev php4ts.dsp /MAKE "php4ts - Win32 Release_TS"
A ce stade, vous avez un exécutable php.exe utilisable, soit dans votre dossier Debug_TS soit sans le dossier Release_TS.
Il est possible de faire des modifications particulières mineures en éditant le fichier main/config.win32.h.in.
Ensuite, vous pouvez compiler la version CLI qui est conçue pour un usage en ligne de commande. Les étapes sont les mêmes que pour la compilation en mode CGI, hormis le fait que vous devez sélectionner php4ts_cli - Win32 Debug_TS ou php4ts_cli - Win32 Release_TS dans le fichier de proejt. Après une compilation réussie, vous pouvez exécuter le fichier php.exe dans l'un des dossiers Release_TS\cli\ ou Debug_TS\cli\.
Note : Si vous voulez utiliser PEAR et l'installeur en ligne de commande, la version CLI-SAPI est obligatoire. Pour plus d'informations sur le projet PEAR et l'installeur, lisez la documentation sur le site de PEAR.
Afin de compiler le module SAPI (php4isapi.dll pour l'intégrer dans Microsoft IIS, vous devez utiliser la configuration php4isapi-whatever-config et compiler la DLL nécessaire.
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.
Note : En PHP 4.0.6 le support des extensions BCMath, Calendar, COM, FTP, MySQL, ODBC, PCRE, Session, WDDX et XML est activé par défaut. Vous n'avez pas à charger d'extensions particulière pour utiliser ces fonctions. Lisez le fichier README.txt inclus dans la distribution, ou bien install.txt pour connaitre la liste des modules automatiquement activés.
Note : 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
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).
c:\windows\system pour Windows 9x/Me c:\winnt\system32 pour Windows NT/2000 c:\windows\system32 pour Windows XP
Tableau 3-1. PHP Extensions
Extension | Description | Notes |
---|---|---|
php_bz2.dll | Fonctions de compression bzip2 | Aucune |
php_calendar.dll | Fonctions de conversions calendaires Calendar | Disponible depuis PHP 4.0.3 |
php_cpdf.dll | Fonctions ClibPDF | Aucune |
php_crack.dll | Fonctions de CrackLib | Aucune |
php3_crypt.dll | Fonctions de Crypt | Inconnu |
php_ctype.dll | Fonctions ctype | Aucune |
php_curl.dll | CURL, Client URL library functions | Requiert : libeay32.dll, ssleay32.dll (fournies) |
php_cybercash.dll | Fonctions de paiement Cybercash | Aucune |
php_db.dll | Fonctions DBM | Obsolètes. Utilisez DBA à la place (php_dba.dll) |
php_dba.dll | DBA: DataBase (dbm-style) Abstraction layer functions | Aucune |
php_dbase.dll | Fonctions dBase | Aucune |
php3_dbm.dll | Fonctions Berkeley DB2 | Inconnu |
php_domxml.dll | Fonctions de DOM XML | Requiert : libxml2.dll (fournie) |
php_dotnet.dll | Fonctions .NET | Aucune |
php_exif.dll | Fonctions de lecture des entêtes JPEG Read EXIF | Aucune |
php_fbsql.dll | Fonctions de FrontBase | Aucune |
php_fdf.dll | Fonctions FDF: Forms Data Format. | Requiert : fdftk.dll (fournies) |
php_filepro.dll | Fonctions filePro | Accès en lecture seule |
php_ftp.dll | Fonctions FTP | Disponible depuis PHP 4.0.3 |
php_gd.dll | Fonctions de traitement des images GD | Aucune |
php_gettext.dll | Fonctions Gettext | Requiert : gnu_gettext.dll (fournies) |
php_hyperwave.dll | Fonctions HyperWave | Aucune |
php_iconv.dll | Fonctions de conversions de jeux de caractères ICONV | Requiert : iconv-1.3.dll (fournies) |
php_ifx.dll | Fonctions Informix | Requiert : Informix libraries |
php_iisfunc.dll | Fonctions de gestion de IIS | Aucune |
php_imap.dll | Fonctions IMAP, POP3 et NNTP | PHP 3: php3_imap4r1.dll |
php_ingres.dll | Fonctions Ingres II | Requiert : Ingres II libraries |
php_interbase.dll | Fonctions InterBase | Requiert : gds32.dll (fournies) |
php_java.dll | Extension Java | Requiert : jvm.dll (fournies) |
php_ldap.dll | Fonctions LDAP | Requiert : libsasl.dll (fournies) |
php_mhash.dll | Fonctions Mhash | Aucune |
php_ming.dll | Fonctions de générations de fichiers Flash avec Ming | Aucune |
php_msql.dll | Fonctions de mSQL | Requiert : msql.dll (fournies) |
php3_msql1.dll | mSQL 1 client | Inconnu |
php3_msql2.dll | mSQL 2 client | Inconnu |
php_mssql.dll | Fonctions MSSQL | Requiert : ntwdblib.dll (fournies) |
php3_mysql.dll | Fonctions MySQL | Built-in in PHP 4 |
php3_nsmail.dll | Fonctions de email Netscape | Inconnu |
php3_oci73.dll | Fonctions Oracle | Inconnu |
php_oci8.dll | Fonctions Oracle 8 | Requiert : librairies clientes Oracle 8 |
php_openssl.dll | Fonctions OpenSSL | Requiert : libeay32.dll (fournies) |
php_oracle.dll | Fonctions de Oracle 7 | Requiert : librairies clientes Oracle 7 |
php_pdf.dll | Fonctions de PDF | Aucune |
php_pgsql.dll | Fonctions de PostgreSQL | Aucune |
php_printer.dll | Fonctions d'impressions | Aucune |
php_xslt.dll | Fonctions XSLT | Requiert : sablot.dll (fournies) |
php_snmp.dll | Fonctions SNMP | NT only! |
php_sybase_ct.dll | Fonctions Sybase | Requiert : librairies clientes Sybase |
php_yaz.dll | Fonctions YAZ | Aucune |
php_zlib.dll | Fonctions de compression ZLib | Aucune |
Précédent | Sommaire | Suivant |
Installation sous UNIX | Niveau supérieur | CGI/ Installation pour exécution en ligne de commande |