Sommaire
- 1 Préface 1.1 A propos de ce manuel
- 2 Préface 2.1 Les auteurs 2.2 Copyright
- 3 Copyright, distribution, historique
- 4 Installation
4.1 Télécharger la dernière version
4.2 Installation sous UNIX
4.3 Installation sous Windows 95/98/NT
4.4 Problèmes?
- 5 Introduction
5.1 Qu'est ce que PHP?
5.2 Que peut faire PHP pour vous?
5.3 La genèse du PHP
- 6 Sécurité 6.1 CGI binary 6.2 Module Apache
- 7 Configuration
7.1 Le fichier de configuration
- 8 Caractéristiques
8.1 Gestion des connexions
8.2 Cookies
8.3 Gestion des erreurs
8.4 Gestion des chargements de fichier
8.5 Authentification HTTP avec PHP
8.6 Création d'images
8.7 Connexions persistantes aux bases de données
8.8 Utilisation des fichiers à distance
- 9 Langage
9.1 La syntaxe de base
9.2 Les constantes
9.3 Les structures de contrôle
9.4 Les expressions
9.5 Fonctions
9.6 Classes et objets
9.7 Les opérateurs
9.8 Types
9.9 Les variables
9.10 Les références
- 10 Fonctions
10.1 spécifiques à Apache
10.2 Tableaux
10.3 Aspell
10.4 mathématiques sur des nombres de taille arbitraire
10.5 de calendrier
10.6 API CCVS
10.7 Classe/Objet
10.8 Support COM pour Windows
10.9 ClibPDF
10.10 CURL
10.11 de paiement Cybercash
10.12 de dates et heures
10.13 dbm
10.14 dBase
10.15 dbm
10.16 Accès aux dossiers
10.17 Chargement dynamique de fonctions
10.18 DOM XML
10.19 Fonction d'exécution de programmes
10.20 Forms Data Format
10.21 filePr
10.22 Système de fichiers
10.23 FTP
10.24 Fonctions GNU Gettext
10.25 HTTP
10.26 Hyperwave
10.27 InterBase
10.28 ICAP
10.29 Informix
10.30 sur les images
10.31 IMAP
10.32 Options PHP & informations
10.33 LDAP
10.34 Fonction mail
10.35 mathématiques
10.36 MCAL
10.37 de cryptage
10.38 Hash
10.39 diverses
10.40 functions mSQL
10.41 Microsoft SQL Server
10.42 MySQL
10.43 réseau
10.44 NIS
10.45 Oracle 8 functions
10.46 Oracle
10.47 Expressions régulières compatibles Perl
10.48 PDF
10.49 Fonctions de paiement Verisign
10.50 PostgreSQL
10.51 POSIX
10.52 Pspell
10.53 GNU Readline
10.54 Fonction GNU Recode
10.55 Expressions régulières
10.56 Sémaphores et gestion de la mémoire partagée
10.57 Gestion des sessions
10.58 SNMP functions
10.59 de chaîne de caractères
10.60 Shockwave Flash
10.61 d'accès à Sybase
10.62 ODBC
10.63 URL
10.64 sur les variables
10.65 Vmailmgr
10.66 WDDX functions
10.67 Analyseur syntaxique XML
10.68 YAZ
10.69 Compression
- A Débuggeur PHP A.1 Utiliser le débuggeur PHP A.2 Debugger Protocol
- B Migration de PHP/FI 2.0 à PHP 3.0 B.1 A propos des incompatibilités en 3.0
B.2 Start/end tags
B.3 if..endif syntax
B.4 while syntax
B.5 Types d'expression
B.6 Les messages d'erreur ont changé
B.7 Evaluation rapide des booléens
B.8 La valeur true/false comme retour de fonctions B.9 Diverses incompatibilités
- C Développement PHP C.1 Adding functions t PHP3 C.2 Appeler des fonctions utilisateurs C.3 Rapport d'erreurs
- Index des fonctions
- Index des concepts
Copyright (C) 1997, 1998, 1999, 2000 par le PHP Documentation Group. Traduction française par
PHP, signifie "PHP: Hypertext Preprocessor" (Preprocesseur HyperTexte), est un langage de script HTML La plupart de sa syntaxe est empruntée aux langages C, Java et Perl, mais y ajoute plusieurs fonctionnalités uniques. Le but de ce langage est de permettre aux développeurs web de concevoir rapidement des sites, aux pages dynamiques.
1.1 A propos de ce manuel
Ce manuel est écrit en SGML en utilisant DocBook DTD, avec DSSSL (Document Style and Semantics Specification Language) pour le formattage. Les utilitaires utilisés pour générer le format HTML, TeX et RTF
sont Jade, écrit James Clark et The Modular DocBook Stylesheets écrit par Norman
Walsh. La documentation PHP a été assemblée par texi.
Ce manuel a été traduit en Français par Il a été généré à partir de la documentation en Anglais originale du PHP documentation Group, au format XML, grâce à une version adaptée de texi.
Le code source ainsi que des binaires pour certaines plates-formes (notamment Windows), sont disponibles à l'adresse suivante: .
Ce chapitre va vous aider lors de la configuration et de l'installation du PHP. Les connaissances requises sont les suivantes :
- Connaissances basiques d'UNIX (savoir faire un "make" et utiliser un compilateur C)
- Avoir un compilateur C ANSI installé
- Avoir installé un serveur web
A la place de cette étape, vous pouvez simplement écraser le binaire httpd. Assurez-vous d'avoir bien arrêté le démon d'abord.
Vous pouvez éditer le fichier de configuration .
Si vous préférez installer le fichier dans un autre répertoire, il faut utiliser l'option de configuration --with-configfile-path=/path à l'étape 8.
AddType application/x-httpd-php3 .php3
Ici, il faut choisir l'extension que vous souhaitez donner au fichier php.
.php est simplement celle que nous suggérons.
4.2.2 Configuration
Il y a deux moyens de configurer PHP.
- Utilisation du script "setup" qui est fourni avec la distribution PHP. Ce script vous pose une série de questions (comme le script d'installation de PHP/FI 2.0) et lance le script "configure" à la fin. Afin de lancer le script, tapez ./setup.
Ce script va aussi créer un fichier appelé "do-conf", qui contient les options de configuration. Vous pouvez éditer ce fichier afin de modifier certaines options sans avoir à réexécuter la totalité du script "setup". Dans ce cas là, tapez ./do-conf afin de lancer le script "configure" avec les nouvelles options.
- Lancez le script "configure" manuellement. Pour voir toutes les options de configuration disponibles, tapez ./configure --help.
Tous les détails à propos des différentes options de configuration sont regroupés ici:
4.2.3 Module Apache
Pour compiler PHP comme un module Apache, répondre "yes" à la question "Build as an Apache module ?"
(cela correspond à l'option de configuration 4.2.3 Module Apache=DIR) et spécifie la racine de la distribution Apache. Si vous avez décompressé Apache dans le répertoire `/usr/local/www/apache_1.2.4', c'est la racine de la distribution Apache. Le répertoire par défaut est : `/usr/local/etc/httpd'.
4.2.4 Module fhttpd
Pour compiler PHP comme un module fhttpd, répondre "yes" à la question "Build as an fhttpd module ?"
(cela correspond à l'option de configuration 4.2.4 Module fhttpd=DIR et spécifier la racine de la distribution fhttpd. Le répertoire par défaut est: `/usr/local/src/fhttpd'. Si vous utilisez fhttpd, compiler PHP en module vous permettra d'obtenir des performances supérieures, plus de contrôle et la possibilité d'exécution à distance.
4.2.5 `/usr/local/src/fhttpd'
Par défaut, PHP est compilé comme une CGI. Si vous voulez que votre serveur web supporte le PHP, compiler le PHP comme une CGI permet d'obtenir de meilleures performances. Cependant, la version CGI permet aux utilisateurs de lancer des scripts PHP sous leur UID respectives. Lisez attentivement le chapitre consacré à la 6 Sécurité si vous souhaitez utiliser cette solution.
4.2.6 Configuration pour le support des bases de données
PHP supporte de nombreuses bases de données (et aussi ODBC):
4.2.6.1 Adabas D
--with-adabas=DIR Configure PHP pour le support des bases de données Adabas D. Le paramètre est le répertoire d'installation de la base de données et par défaut `/usr/local/adabasd'.
Adabas home page
4.2.6.2 dBase
--with-dbase Configure PHP pour le support des bases de données dbase. Aucune librairie n'est nécessaire.
4.2.6.3 filePro
--with-filepr Configure PHP pour le support des bases de données filePro. Aucune librairie supplémentaire n'est nécessaire.
4.2.6.4 mSQL
--with-msql=DIR Compile PHP pour le support des bases de données mSQL. Le paramètre est le répertoire d'installation de la base de données et par défaut c'est `/usr/local/Hughes', c'est à dire, le répertoire par défaut oú est installé mSQL 2.0. configure détecte automatiquement quelle version de mSQL est installée.
PHP supporte aussi bien la version 1.0 que la version 2.0, mais si vous compilez PHP avec mSQL 1.0, vous pourrez ne accéder qu'à mSQL 1.0, et vice-versa.
Voir aussi 7.1.7 Directives de configuration mSQL au chapitre 7.1 Le fichier de configuration. mSQL home page
4.2.6.5 MySQL
--with-mysql=DIR Compile PHP pour le support des bases de données MySQL. Le paramètre est le répertoire d'installation de la base de données et par défaut `/usr/local'. C'est le répertoire par défaut oú est installé
MySQL.
Voir aussi 7.1.6 MySQL Configuration Directives au chapitre 7.1 Le fichier de configuration.
Home page MySQL
4.2.6.6 iODBC
--with-iodbc=DIR Compile PHP pour le support des bases de données iODBC. Cette fonction a été développée au départ pour supporter "iODBC Driver Manager", un pilote ODBC qui fonctionne sous la plupart des versions d'UNIX. Le paramètre est le répertoire d'installation de la base de données et par défaut : `/usr/local'.
Home page FreeODBC ou home page iODBC
4.2.6.7 OpenLink ODBC
--with-openlink=DIR Compile PHP pour le support des bases de données OpenLink ODBC. Le paramètre est le répertoire d'installation de la base de données et par défaut `/usr/local/openlink'.
Home page OpenLink Software
4.2.6.8 Oracle
--with-oracle=DIR Compile PHP pour le support des bases de données Oracle. Cette option fonctionne avec les versions 7.0 à 7.3 d'Oracle. Le paramètre est le répertoire d'installation de la base de données et par défaut : ORACLE_HOME. Vous n'avez pas à spécifier ce paramètre si votre base de données Oracle est déjà installée.
Home page Oracle
4.2.6.9 PostgreSQL
--with-pgsql=DIR Compile PHP pour le support des bases de données PostgreSQL. Le paramètre est le répertoire d'installation de la base de données PostgreSQL et par défaut`/usr/local/pgsql'.
Voir aussi 7.1.8 Directives de configuration Postgres dans le fichier 7.1 Le fichier de configuration.
Home page PostgreSQL
4.2.6.10 Solid
--with-solid=DIR Compile PHP pour le support des bases de données Solid. Le paramètre est le répertoire d'installation de la base de données et par défaut `/usr/local/solid'.
Home page Solid
4.2.6.11 Sybase
--with-sybase=DIR Compile PHP pour le support des bases de données Sybase. Le paramètre est le répertoire d'installation de la base de données et par défaut `/home/sybase'.
Voir aussi 7.1.9 Directives de configuration Sybase dans le fichier 7.1 Le fichier de configuration.
Home page Sybase
4.2.6.12 Sybase-CT
--with-sybase-ct=DIR Compile PHP pour le support des bases de donnés Sybase-CT. Le paramètre est le répertoire d'installation de la base de données Sybase-CT et par défaut `/home/sybase'.
Voir aussi 7.1.10 Sybase-CT Configuration Directives dans le 7.1 Le fichier de configuration.
4.2.6.13 Velocis
--with-velocis=DIR Compile PHP pour le support des bases de données Velocis. Le paramètre est le répertoire d'installation de la base de données Velocis et par défaut `/usr/local/velocis'.
Home page Velocis
4.2.6.14 A custom ODBC library
--with-custom-odbc=DIR Compile PHP pour le support d'une autre libraire ODBC. Le paramètre est le répertoire d'installation de la base de données et par défaut `/usr/local'.
Cette option implique que vous ayez défini la variable CUSTOM_ODBC_LIBS avant de lancer le script de configuration. Vous devez aussi avoir un fichier odbc.h quelque part dans votre répertoire d'installation. Si vous n'en avez pas, créez en un et incluez le dans vos fichiers d'entete. Vos entêtes demanderons sûrement des définitions supplémentaires, notamment en cas de base de données multiplateforme. Définissez les dans la variable CFLAGS.
Par exemple, vous pouvez utiliser Sybase SQL n'import oú sous QNX en définissant la variable CFLAGS comme suit: CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib -lodbc" ./configure -with-custom-odbc=/usr/lib/sqlany50
--disable-unified-odbc Désactive le module ODBC unifié, qui est une interface commune à toutes les bases de données dotées d'une interface ODBC tel que Solid et Adabas D. Cette interface fonctionne aussi avec les librairies classiques ODBC. Elle a été testé avec iODBC, Solid, Adabas D et Sybase SQL, sur tous les types d'OS. Cela implique qu'un et un seul des modules oú le module Velocis est utilisé ou bien une librairie personnelle ODBC. Cette option n'est valide que si une des options suivantes est utilisée: 4.2.6.6 iODBC, 4.2.6.10 Solid, 4.2.6.1 Adabas D, 4.2.6.13 Velocis, or 4.2.6.1 Adabas D. Voir aussi 7.1.14 Directives de configuration du driver ODBC unifié dans le 7.1 Le fichier de configuration.
4.2.6.16 LDAP
--with-ldap=DIR Ajoute le support LDAP(Lightweight Directory Access Protocol). Le paramètre est le répertoire d'installation de LDAP et par défaut `/usr/local/ldap'.
Plus d'informations à propos de LDAP sont disponibles dans les RFC1777 et RFC1778.
4.2.7 Autres options de configuration
4.2.7.1 --with-mcrypt=DIR
--with-mcrypt Ajoute le support de la librairie mcrypt. Consultez la documentation concernant 10.37 de cryptage pour plus d'informations. Si vous utilisez le paramètre optionnel, DIR, PHP cherchera le fichier mcrypt.h dans le répertoire DIR/include.
4.2.7.2 --enable-sysvsem
--enable-sysvsem Ajoute le support des sémaphores Sys V (supportés par la plupart des versions d'UNIX). Consultez la documentation concernant 10.56 Sémaphores et gestion de la mémoire partagée pour plus d'informations.
4.2.7.3 --enable-sysvshm
--enable-sysvshm Ajoute le support des sémaphores Sys V (supportés par la plupart des versions d'UNIX) Consulter la documentation concernant 10.56 Sémaphores et gestion de la mémoire partagée pour plus d'information.
4.2.7.4 --with-xml
--with-xml Ajoute le support du XML en utilisant la librairie expatde James Clark. Voir aussi les références aux 10.67 Analyseur syntaxique XML pour plus de renseignements.
4.2.7.5 --enable-maintainer-mode
--enable-maintainer-mode Ajoute des dépendences supplémentaires ainsi que des options de compilation utilisées par certains développeurs du language PHP.
4.2.7.6 --with-system-regex
--with-system-regex Cette option permet d'utiliser les expressions régulières du système en lieu et place de celles fournies avec le language. Si vous compilez PHP comme module serveur, vous devez utilisez la même librairie lorsque vous compilez PHP et lorsque vous le linkez au serveur. Vous pouvez ajouter cette option si la librairie système ajoute des fonctionnalités supplémentaires dont vous avez besoin. Dans le cas contraire, il est recommandé d'utiliser la librairie fournie avec le language.
4.2.7.7 --with-config-file-path
--with-config-file-path=DIR Le chemin utilisé pour rechercher le 7.1 Le fichier de configuration lorsque PHP est lancé.
4.2.7.8 --with-exec-dir
--with-exec-dir=DIR Permet l'exécution des programmes qui se trouvent dans le répertoire DIR lorsque l'option "safe mode" est activée. Par défaut, DIR =`/usr/local/bin'. Cette option ne permet pas de modifier la valeur par défaut. Cette valeur peut être modifiée avec la directive 7.1.3.2 -mode-exec-dir dans le 7.1 Le fichier de configuration.
4.2.7.9 --enable-debug
--enable-debug Ajoute la possibilité d'obtenir des informations complémentaires. Il est alors possible d'obtenir plus d'informations, notamment lorsqu'il y a des problèmes avec PHP. (Il est à noter que cela n'a rien à voir avec des facilités de débuggage ou des informations à propos des scripts PHP.)
4.2.7.10 --enable-safe-mode
--enable-safe-mode Active le "safe mode" par défaut. Cela impose de nombreuses restrictions sur les fonctionnalités du PHP, concernant notamment l'ouverture des fichiers. Consultez le chapitre sur la 6 Sécurité pour avoir plus de renseignements. Si vous compilez PHP comme CGI, vous devriez toujours activer le "safe mode". Cela active l'option par défaut. Ce mode peut être activé ou désactivé en utilisant la directive 7.1.3.1 -mode dans le 7.1 Le fichier de configuration.
4.2.7.11 --enable-track-vars
--enable-track-vars Permet au PHP de stocker dans les tableaux HTTP_GET_VARS, HTTP_POST_VARS et
HTTP_COOKIE_VARS les informations recues par les méthodes GET/POST ou bien en provenance d'un cookie. Cela active l'option par défaut. Cette option peut être activée ou désactivée grâce à la directive 7.1.1.25 ini.track-vars dans le 7.1 Le fichier de configuration.
4.2.7.12 --enable-magic-quotes
--enable-magic-quotes Active l'option "magic quotes" par défaut. Cette option peut être activée ou désactivée
grâce à la directive 7.1.1.17 ini.magic-quotes-runtime dans le 7.1 Le fichier de configuration. Voir aussi les directives 7.1.1.16 ini.magic-quotes-gpc et 7.1.1.18 ini.magic-quotes-sybase.
--enable-debugger Permet d'utiliser le débuggeur interne du PHP. Cette fonctionnalité est encore au stade expérimental. Voir aussi la directive 7.1.4 Directives de configuration de débbugage. dans le 7.1 Le fichier de configuration.
4.2.7.14 --enable-discard-path
--enable-discard-path Si cette option est activée, l'exécutable PHP (dans le cas d'une compilation comme
CGI) peut être placée en toute sûreté à l'extérieur de l'arborescence du serveur web. Les utilisateurs ne pourront pas aller au delà des règles de sécurité imposée par le fichier ".htaccess". Voir aussi le chapitre
concernant la 6.1.5 Cas 4: L'exécutable PHP à l'extérieur de l'arborescence du serveur à propos de cette option.
4.2.7.15 --enable-bcmath
--enable-bcmath Ajoute les fonctions mathématiques de précision arbitraire bc. Voir aussi l'option 7.1.12
Directives de configuration pour les calculs mathématiques. dans le 7.1 Le fichier de configuration.
4.2.7.16 --enable-force-cgi-redirect
--enable-force-cgi-redirect Active une option de sécurité concernant la redirection interne du serveur web. Si vous utilisez Apache comme CGI, vous devriez utiliser cette option.
Lorsque vous utilisez PHP comme CGI, PHP vérifie toujours par défaut qu'il est utilisé par redirection. (par exemple, sous Apache, en utilisant les directives "Action Directives"). Cela assure que l'éxécutable PHP ne peut pas être utilisé pour passer par dessus les procédures d'authentification du serveur web en appelant une procédure directement. Par exemple, `'. Dans cette exemple, on accède à la page `' mais cela n'utilise aucune règle de sécurité pour le répertoire `/secret'.
Ne pas activer cette option revient à annuler la vérification et permet éventuellement de passer par dessus les procédures d'authentification et de sécurité du démon httpd. Désactivez cette option uniquement si votre serveur n'est pas capable d'indiquer si une redirection sécurisée a été effectuée et si tous les fichiers sur votre serveur et dans les répertoires utilisateurs peuvent être accessibles de l'extérieur par tout le monde. Consultez le chapitre concernant la 6.1.3 Cas 2: Utilisation de la directive de compilation -enable-force-cgi-redirect à propos de cette option.
4.2.7.17 --disable-short-tags
--disable-short-tags Désactive la version courte des balises PHP. Vous devez désactiver la version courte des balises si vous souhaitez utiliser le PHP avec XML. Si vous désactivez la version courte des balises, les seules balises PHP acceptées sont . Cette option établit la valeur par défaut. Elle peut être activée ou désactivée avec la directive 7.1.1.22 ini.short-open-tag dans le 7.1 Le fichier de configuration.
4.2.7.18 --enable-url-includes
--enable-url-includes Ajoute la possibilité d'exécuter du code PHP à partir d'un autre serveur HTTP ou FTP directement grâce à la fonction include(). Voir aussi l'option 7.1.1.13 ini.include-path dans le 7.1 Le fichier de configuration.
4.2.7.19 --disable-syntax-hl
--disable-syntax-hl Annule la surbrillance de la syntaxe.
4.2.7.20 CPPFLAGS et LDFLAGS
Pour que, lors de la compilation et de l'installation, PHP cherche les différents fichiers ou librairies dans des répertoires précis, vous devez modifier les variables d'environnement CPPFLAGS et LDFLAGS . Si vous utilisez un shell "sensible" (non-sécurisé?), vous pouvez aussi exécuter la commande suivante : LDFLAGS=L/my/lib/dir CPPFLAGS=-I/my/include/dir ./configure
4.2.8 Compilation
Lorsque vous avez exécuté le script de configuration, vous êtes prêt pour compiler le PHP comme module ou bien comme CGI. La commande make devrait s'occuper de la compilation. Si cela ne fonctionne pas correctement, vous trouverez dans le paragraphe problèmes de nombreuses réponses aux 4.4 Problèmes? de compilation.
4.2.9 Testing
Si vous avez compilé PHP comme CGI, vous pouvez vérifier que votre compilation c'est bien déroulée en tapant la commande make test. C'est toujours une bonne idée pour vérifier que la compilation s'est bien déroulée. Dans ce sens, vous serez capable de détecter une erreur à la source au lieu de chercher des erreurs le problèmes plus tard.
4.2.10 Etalonnage
Si vous avez compilé PHP comme CGI, vous pouvez utiliser le script de benchmark en tapant la commande make bench. Il est à noter que si le "safe mode" est activé, le bench ne pourra pas se finir si l'exécution prend plus que les 30 secondes permises. Cela tient au fait que la fonction set_time_limit() ne peut pas être utilisé lorsque le "safe mode" est activé. Utilisez la directive 7.1.1.19 -execution-time pour contrôler le temps d'exécution dans vos scripts. make bench ne tient pas compte du 7.1 Le fichier de configuration.
4.3 Installation sous Windows 95/98/NT
Ce guide d'installation vous guidera pour installer et configurer PHP sur vos serveurs Windows 9x/NT. Ce guide a été préparé par Bob Silva, et traduit par Damien Seguy. La version la plus récente est disponible (en anglais) à .
Ce guide fournit des informations pour les logiciels :
- Apache 1.3.x
- Omni HTTPd 2.0b1
4.3.1 Configuration de PHP
Les instructions suivantes doivent être suivies pour tous les types d'installation, avant de prendre en compte les spécificités de chaque serveur.
- Décompressez la distribution dans le dossier de votre choix. "C:\PHP3\" est une bonne idée.
- Tous les modules sont préfixés par 'php3_'. Il faudra que vous modifiez le fichier `' et/ou tous les scripts de chargement d'extension avec la fonction dl(). Vous pouvez toujours supprimer le préfixe 'php3_', mais il évite les confusions entre les modules PHP et leur bibliothèque de support.
c:\windows for Windows 95/98 c:\winnt or c:\winnt40 for NT servers
- Editez votre fichier '' :
Vous devez changer 'extension_dir' pour qu'il désigne votre dossier d'installation de PHP, c'est à dire l'endroit oú vous avez installé les fichiers 'php3_*.dll'. Par exemple : c:\php3
Si vous utilisez Omni Httpd, passez à l'étape suivante. Modifiez 'doc_root' pour qu'il désigne la racine de votre serveur web. Par exemple : c:\apache\htdocs ou c:\webroot
Choisissez les modules que vous voulez lancer au démarrage de PHP. Vous pouvez décommenter la ligne : 'extension=php3_*.dll' pour charger automatiquement ces modules. Certains modules nécessitent d'autres librairies dans votre système pour fonctionner correctement. La FAQ; a plus d'informations sur ces librairies supplémentaires. Vous pouvez toujours charger dynamiquement un module avec: dl("php_*.dll")("php_*.dll");
Avec PWS et IIS, vous pouvez modifier le fichier pour qu'il pointe sur:
'c:\windows\system\inetsrv\' sous Windows 95/98 et
'c:\winnt\system32\inetsrv\' sur les serveur NT. D'autres informations sur les fonctionnalités de browscap sous PHP sont disponibles (en anglais) ici, sélectionnez le bouton "source" pour le voir en action.
Les DLLs des extensions PHP sont préfixées avec 'php3_'. Cela évite la confusion avec les extensions PHP, et leurs librairies.
4.3.2 Windows 95/98/NT et PWS/IIS 3
La méthode recommandée pour configurer ces serveurs est d'utiliser le fichier INF inclus avec la distribution (). Vous aurez à éditer ce fichier pour vous assurer que les extensions et les dossiers d'installation de PHP sont bien ceux de votre configuration. Ou alors, il vous faudra le faire manuellement. ATTENTION : Ces instructions impliquent la modification directe des tables de registry de Windows. Une erreur peut laisser votre système dans un état instable. Nous recommandons que vous fassiez une sauvegarde de secours de votre registry d'abord. L'équipe de developpement et le traducteur de cette page ne pourront pas être tenu pour responsable si vous endommagez votre registry.
- Lancez Regedit.
- Allez jusqu'à : HKEY_LOCAL_MACHINE
/System/CurrentControlSet/Services/W3Svc/Parameters/ScriptMap.
- Dans le menu edit, sélectionnez : New->String Value.
- Entrez l'extension que vous voulez utiliser pour vos script PHP. Par exemple: .php3
- Double-cliquez sur la valeur de la chaîne et entrez le chemin jusqu'à dans la valeur du champs. Par exemple c:\php3\ %s %s. La chaîne '%s %s' est TRES TRES importante, PHP ne fonctionnera pas correctement sans!
- Recommencez ces deux dernières instructions avec chacune des extensions que vous souhaitez utiliser pour vos scripts PHP.
- Allez maintenant jusqu'à: HKEY_CLASSES_ROOT
- Dans le menu edit, sélectionnez : New->Key. • Donnez à la clé le nom de l'extension que vous avez donné à la précédente section. Par exemple: .php3
- Selectionnez la nouvelle clé, et dans la boîte de droite, double cliquez sur "default value" et entrez phpfile.
- Recommencez ces deux dernières instructions avec chacune des extensions de la dernière section.
- Dans le menu edit, sélectionnez New->Key dans HKEY_CLASSES_ROOT et donnez lui le nom de phpfile.
- Sélectionnez la clé phpfile et dans la boîte de droite, double cliquez sur et dans le panneau de droite, double cliquez dans "default value" et entrez Script PHP.
- Clic-droit dans la clé phpfile et dans la boîte de droite, double cliquez sur New->Key,et entrez Shell.
- Clic-droit dans la clé Shell et selectionnez New->Key, appelez la open.
- Clic-droit dans la clé open et selectionnez New->Key, appelez la command.
- Sélectionnez la clé command dans la boîte de droite, double cliquez sur "default value" et entrez le chemin jusqu'à . Par exemple : c:\php3\ -q %1. (n'omettez pas le %1).
- Exit Regedit.
Les utilisateurs PWS et IIS 3 sont maintenant prêts à travailler. Les utilisateurs IIS 3 peuvent utiliser l' outil de Steven Genusa pour configurer leur script maps.
4.3.3 Windows NT et IIS 4
Pour installer PHP sur un serveur NT avec IIS 4, suivez les instructions suivantes :
- Dans Internet Service Manager (MMC), sélectionnez le site web, ou le dossier racine d'une application.
- Ouvrez la boîte de propriété du dossier (clic droit et sélectionnez l'item de propriétés), puis cliquez dans Home Directory, Virtual Directory, ou Directory tab.
- Cliquez dans le bouton Configuration, puis cliquez dans l'onglet App Mappings.
- Cliquez dans Add, et dans la boîte Executable, tapez: c:\path-to-php-dir\ %s %s. Vous DEVEZ mettre les %s %s à la fin, sinon PHP ne fonctionnera pas.
- Dans la boîte Extension, tapez le nom de l'extension que vous voulez associer à vos script PHP (Vous devrez répetez les étapes 5 et 6 pour chaque extension que vous voulez associer à vos script PHP). (.php3 et .phtml sont les valeurs les plus répandues).
- Mettez en place la sécurité appropriée. (Cela se fait dans le gestionnaier Internet Service Manager), et si votre serveur NT utilise le sytème de fichier NTFS, ajoutez les droits d'exécution à I_USR_, pour le dossier qui contient .
4.3.4 Windows 9x/NT et Apache 1.3.x
Vous devez éditer votre fichier ou pour configurer Apache et PHP.
Bien qu'il y ait quelques variations de configuration PHP sous Apache, elle est suffisamment simple pour être maîtrisée par le néophyte. Reportez vous aux documentations Apache (Apache Docs) pour plus de détails sur les directives de configuration.
- ScriptAlias /php3/ "c:/path-to-php-dir/"
- AddType application/x-httpd-php3 .php3
- AddType application/x-httpd-php3 .phtml
- Action application/x-httpd-php3 ""
Pour utiliser le fonction de surimpression du code, créez simplement un script PHP et mettez-y le code: . Remplacez original_php_script.php3 par le nom du fichier dont vous souhaitez afficher le code source. (C'est le seul moyen de le faire). Note: sous Win-Apache tous les back slashes d'un chemin tel que: "c:\directory\", doivent être convertis en slash.
4.3.5 Omni HTTPd 2.0b1 pour Windows
Ceci est la configuration la plus simple :
- 1: Installez Omni server
- 2: Clic droit sur l'icône bleue OmniHTTPd et sélectionnez Propriétés
- 3: Cliquez sur Web Server Global Settings
- 4: Dans l'onglet 'Externe', entrez :virtual = .php3 | actual = c:\path-to-php-dir\
- 5: Dans l'onglet Mime, entrez: virtual = wwwserver/stdcgi | actual = .php3 6: Cliquez OK
Répetez les étapes 2 - 6 pour chaque nouvelle extension à associer avec PHP.