Chapitre 3. Configuration

Table des mati�res
Le fichier de configuration

Le fichier de configuration

Le fichier de configuration (appel� php3.ini dans la version 3.0 du PHP, et simplement php.ini dans la version 4.0) est lu par le PHP au d�marrage. Si vous avez compil� PHP en module, le fichier n'est lu qu'une seule fois, au lancement du d�mon HTTP. Pour la version CGI le fichier est lu � chaque invocation.

Exemple 3-1. Extrait du php.ini

; tout texte sur une ligne, situ� apr�s un point-virgule  ";" est ignor�
[php] ; les marqueur de section (texte entre crochets) sont aussi ignor�s
; Les valeurs bool�enne peuvent �tre sp�cifi�es comme ceci :
;    true, on, yes
; ou false, off, no, none
register_globals = off
magic_quotes_gpc = yes
; vous pouvez placer les cha�nes de caract�res entre guillemets
include_path = ".:/usr/local/lib/php"
; Les anti-slash sont trait�s comme n'importe quel caract�re
include_path = ".;c:\php\lib"

Lorsque vous utilisez le module Apache, vous pouvez aussi changer les param�tres de configurations en utilisant les directives dans les fichiers de configuration d'Apache et dans les fichiers .htaccess.

Dans la version 3.0, � chaque directive de configuration pr�sente dans le fichier de configuration d'Apache correspond une directive de configuration dans le fichier php3.ini, � l'exception des directives pr�fix�es par "php3_".

Dans la version 4.0, il n'y a que quelques directives dans le fichier de configuration d'Apache qui vous permettent de modifier la configuration de PHP.

php_value name value: Cette directive affecte une valeur � la variable sp�cifi�e.
php_flag name on|off: Cette directive est utilis�e pour activer ou d�sactiver une option.
php_admin_value name value: Cette directive affecte une valeur � la variable sp�cifi�e. La directive "Admin" ne peut �tre utilis�e que dans le fichier de configuration d'Apache, et non dans un fichier .htaccess.
php_admin_flag name on|off: Cette directive est utilis�e pour activer ou d�sactiver l'option pr�c�dente.

Exemple 3-2. Exemple de configuration Apache

<IfModule mod_php4.c>
  php_value include_path ".:/usr/local/lib/php"
  php_flag safe_mode on
</IfModule>
<IfModule mod_php3.c>
  php3_include_path ".:/usr/local/lib/php"
  php3_safe_mode on
</IfModule>

Vous pouvez voir l'�tat de votre configuration en utilisant la fonction phpinfo(). Vous pouvez aussi acc�der aux valeurs de votre configuration de mani�re individuelle en utilisant la fonction get_cfg_var().

Directives de configuration g�n�rale

allow_url_fopen boolean

Cette option autorise les acc�s au r�seau des fonctions fopen(). Par d�faut, l'acc�s est autoris� aux proc�dures d'acc�s distants, avec les protocoles FTP, NNTP, et certaines extensions telles ques zlib.

Note�: Cette option a �t� introduite imm�diatement apr�s la version 4.0.3. Pour les versions jusqu'� 4.0.3 incluse, vous pouvez d�sactiver cette fonctionnalit� au moment de la compilation en utilisant la configuration --disable-url-fopen-wrapper.

asp_tags bool�en

Active l'utilisation des balises de type ASP <% %>, en plus des traditionnelles balises <?php ?> . Cela inclut l'utilisation du raccourcid <%= $value %>. Pour plus d'informations, reportez-vous � inclusion dans le HTML.

Note�: Le support des balises ASP a �t� ajout� dans la version 3.0.4.

auto_append_file cha�ne de caract�res

Sp�cifie le nom d'un fichier qui sera automatiquement ajout� apr�s le fichier principal. Le fichier est inclus comme s'il avait �t� appel� avec la fonction include(), donc include_path est utilis�.

Le mot r�serv� NONE d�sactive l'auto-appending.

Note�: Si le script s'arr�te par la fonction exit(), auto-append ne fonctionnera pas.

auto_prepend_file cha�ne de caract�res

Sp�cifie le nom d'un fichier qui sera automatiquement ajout� avant le fichier principal. Le fichier est inclus comme s'il avait �t� appel� avec la fonction include(), donc include_path est utilis�.

Le mot r�serv� NONE d�sactive l'auto-appending.

cgi_ext cha�ne de caract�res

(NDT : aucune documentation n'est fournie).

display_errors bool�en

Cette directive d�termine si les erreurs doivent �tre affich�es � l'�cran au format HTML ou non.

doc_root string

Le dossier racine de PHP. Cette directive n'est utilis�e que si elle est d�finie. Si PHP est configur� en safe mode, aucun fichier en dehors de ce dossier ne sera accessible.

engine boolean

Cette directive ne sert vraiment que si PHP est un module Apache. Elle sert aux sites qui veulent activer ou d�sactiver l'analyse des fichiers par PHP, dossier par dossier. En mettant php3_engine off au bon endroit, dans le fichier httpd.conf, PHP peut �tre activ� ou d�sactiv�.

error_log string

Nom du fichier o� les erreurs seront enregistr�es. Si la valeur sp�ciale syslog est utilis�e, les erreurs sont envoy�es au syst�me standard d'historique. Sous UNIX, c'est syslog(3) et sous Windows NT, c'est l'historique d'�v�nements. L'historique syst�me n'est pas support� sous Windows 95.

error_reporting integer

Fixe le niveau d'erreur. Ce param�tre est un entier, repr�sentant un champs de bits. Ajoutez les valeurs suivantes pour choisir le niveau que vous d�sirez :

Tableau 3-1. Niveau de rapport d'erreur

valeur du bit	niveau choisi
1	erreurs normales
2	alertes normales
4	erreurs d'analyseur (parser errors)
8	alertes non critiques

Par d�faut, la valeur est de 7 (erreurs normales, alertes normales et erreurs d'analyseur sont affich�es).

open_basedir string

Limite l'espace o� PHP peut ouvrir des fichiers.

Lorsqu'un script essaie d'ouvrir un fichier avec les fonctions fopen ou gzopen (par exemple), la localisation du fichier est v�rifi�e. Si ce fichier est hors du dossier cit� dans cette directive, PHP refusera de l'ouvrir. Tous les liens symboliques sont r�solus, et subissent aussi la restriction.

La valeur sp�ciale . indique que le dossier courant du script est utilis� comme open_basedir.

Sous Windows, s�parez les noms de dossiers par un point virgule (;). Sur les autres syst�mes, s�parez les noms de dossiers par des deux points (:). Lorsque PHP est un module Apache, la valeur de la directive open_basedir des dossiers parents est automatiquement h�rit�e par les fils.

Note�: Le support pour les dossiers multiples a �t� ajout� dans 3.0.7.

La valeur par d�faut est : libre acc�s � tous les fichiers.

gpc_order cha�ne de caract�res

Etablit l'ordre de pr�s�ance des m�thodes GET/POST/COOKIE. Par d�faut, cette directive est �tablie � "GPC". En affectant "GP" � cette directive, PHP ignorera les cookies, et �crasera toute m�thode GET utilis�e par une m�thode POST avec des variables du m�me nom.

ignore_user_abort cha�ne de caract�res

D�sactiv�e par d�faut. Si cette directive est activ�e, alors tous les scripts lanc�s iront jusqu'� leur terme, m�me si le client se d�connecte en plein milieu. Voir aussi la fonction ignore_user_abort().

include_path string

Sp�cifie une liste de dossiers, o� les fonctions require(), include() et fopen_with_path() (NDtraducteur : cette fonction semble avoir disparu) iront chercher les fichiers. Le format est le m�me que celui de la variable d'environnement PATH : une liste de dossiers, s�par�s par des deux points (:) sous UNIX, et par des points virgules (;) sous Windows.

Exemple 3-3. UNIX include_path

include_path=.:/home/httpd/php-lib

Exemple 3-4. Windows include_path

include_path=".;c:\www\phplib"

La valeur par d�faut pour cette directive est ., c'est-�-dire le dossier courant.

isapi_ext string

(Aucune documentation n'est fournie)

log_errors boolean

Indique o� les messages d'erreur g�n�r�s doivent �tre �crits. Cette fonction est sp�cifique aux serveurs.

magic_quotes_gpc boolean

Fixe le mode magic_quotes pour les op�rations GPC (Get/Post/Cookie). Lorsque magic_quotes est activ�, tous les caract�res ' (guillemets simples), " (guillemets doubles), \ (antislash) et NUL sont �chapp�s avec un antislash. Si magic_quotes_sybase fonctionne aussi, les guillemets simples seront �chapp�s avec un autre guillemet simple, plut�t qu'un antislash.

magic_quotes_runtime boolean

Si magic_quotes_runtime est activ�, toutes les fonctions qui obtiennent des donn�es aupr�s d'une source externe, y compris les bases de donn�es et les fichiers texte, verront leur guillemets �chapp�s avec un antislash. Si magic_quotes_sybase est aussi activ�, les guillemets simples seront �chapp�s avec un autre guillemet simple, plut�t qu'un antislash.

magic_quotes_sybase boolean

Si magic_quotes_sybase est activ�, les guillemets simples seront �chapp�s avec un autre guillemet simple, plut�t qu'un antislash, si magic_quotes_gpc ou magic_quotes_runtime est activ�.

max_execution_time integer

Fixe le temps maximal d'�x�cution d'un script, en secondes. Cela permet d'�viter que des scripts en boucles infinies saturent le serveur.

memory_limit entier

Gr�ce � cette option, vous pouvez donner la quantit� maximale de m�moire qu'un script peut allouer. Ceci permet de se prevenir contre des scripts mal cod�s pouvant consommer toute la m�moire disponible d'un serveur

nsapi_ext cha�ne de caract�res

Aucune documentation n'est fournie.

register_globals boolean

Cette option active l'enregistrement des variables EGPCS (Environnement, GET, POST, Cookie, Serveur), en tant que variables globales. Vous pouvez d�sactiver cette fonction si vous ne voulez pas truffer vos scripts avec des valeurs utilisateurs. Cette option est surtout utile lorsqu'elle est utilis�e conjointement avec track_vars - dans ce cas, vous pouvez acc�der � toutes les variables EGPCS gr�ce aux tableaux $HTTP_ENV_VARS, $HTTP_GET_VARS, $HTTP_POST_VARS, $HTTP_COOKIE_VARS, et $HTTP_SERVER_VARS.

short_open_tag bool�en

Active ou d�sactive l'utilisation des balises courtes, (<? ?>). Si vous voulez utiliser PHP et XML en m�me temps, vous devez d�sactiver cette option. Si cette option est d�sactiv�e, vous devez utiliser la forme longue des tags, (<?php ?>).

sql.safe_mode bool�en

Aucune documentation n'est fournie.

track_errors bool�en

Si cette option est activ�e, le dernier message d'erreur sera plac� dans la variable globale $php_errormsg.

track_vars bool�en

Si cette option est activ�e, lors de l'appel des m�thodes GET, POST et l'utilisation des cookies, les variables sont disponibles dans des tableaux associatifs globaux appel�s respectivement $HTTP_GET_VARS, $HTTP_POST_VARS et $HTTP_COOKIE_VARS.

upload_tmp_dir cha�ne de caract�res

Indique le r�pertoire utilis� lors du chargement d'un fichier sur un serveur. Ce r�pertoire doit �tre accessible en lecture pour l'utilisateur qui lance le script PHP.

upload_max_filesize entier

La taille maximale d'un fichier t�l�charg� sur le serveur. La valeur doit �tre en octets. Par d�faut, elle est de 2 m�ga-octets. in bytes.

user_dir cha�ne de caract�res

R�pertoire o� sont stock�s les fichiers PHP dans le r�pertoire d'un utilisateur. Par exemple, public_html.

warn_plus_overloading bool�en

Si cette option est activ�e, PHP �met une alerte lorsque l'op�rateur plus (+) est utilis� sur une cha�ne de caract�res. Cela permet de r�perer plus facilement les scripts qui doivent �tre r��crits en utilisant l'op�rateur de concat�nation (.) plut�t que l'op�rateur plus.

Directives de configuration concernant le mail

SMTP cha�ne de caract�res

Sous Windows, adresse IP ou nom que PHP doit utiliser pour envoyer du mail avec la fonction mail().

sendmail_from cha�ne de caract�res

Sous Windows, valeur du champs "From:" qui doit �tre utilis�e lors de l'envoi de mail.

sendmail_path cha�ne de caract�res

Localisation du programme de sendmail : habituellement /usr/sbin/sendmail ou /usr/lib/sendmail. configure essaye de rep�rer la pr�sence de sendmail par lui-m�me, et affecte ce r�sultat par d�faut. En cas de probl�me de localisation, vous pouvez �tablir une nouvelle valeur par d�faut ici.

Tout syst�me n'utilisant pas sendmail doit �tablir cette directive � la valeur chemin du programme de substitution qui remplace le serveur de mail, si celui-ci existe, par exemple, . Dans ce cas l�, vous devez mettre: /var/qmail/bin/sendmail.

Directives de configuration du "Safe Mode"

safe_mode bool�en: Cette directive active ou d�sactive l'option "safe mode". Lisez le chapitre s�curit� pour plus d'informations.
safe_mode_exec_dir cha�ne de caract�res: Si l'option "SAFE MODE" est activ�e, system() et les autres fonctions ex�cutant des programmes syst�mes refusent de se lancer si ces programmes ne sont pas plac�s dans ce r�pertoire.

Directives de configuration de d�bugage.

debugger.host cha�ne de caract�res: Adresse IP ou nom de l'h�te utilis� pour le d�bugage.
debugger.port cha�ne de caract�res: Num�ro du port utilis� pour le d�bugage.
debugger.enabled bool�en: Activation ou d�sactivation du d�bugueur.

Directives de chargement des extensions

enable_dl bool�en

Cette directive n'est r�ellement utile que dans le cas d'une compilation comme module Apache. Vous pouvez activer le chargement dynamique des extensions avec la fonction dl(), et cela de mani�re locale � chaque serveur virtuel ou � chaque r�pertoire.

La principale raison qui pousse � d�sactiver le chargement dynamique est un probl�me de s�curit�. Lorsque le chargement dynamique est activ�, il est possible d'ignorer les directives safe mode ou "open_basedir".

Par d�faut, il est possible d'utiliser le chargement dynamique, sauf lorsque la directive safe mode est activ�e. En effet, il est alors impossible d'utiliser la fonction dl().

extension_dir cha�ne de caract�res

D�finit le r�pertoire dans lequel le PHP doit chercher les extensions lors du chargement dynamique.

extension cha�ne de caract�res

D�finit les extensions qui doivent �tre charg�es lors du d�marrage du PHP.

Directives de configuration MySQL

mysql.allow_persistent bool�en: Active ou d�sactive les connexions persistantes � la base de donn�es MySQL.
mysql.default_host cha�ne de caract�res: Adresse par d�faut du serveur, � utiliser lors de la connexion � un serveur MySQL, si aucun h�te n'est sp�cifi�.
mysql.default_user cha�ne de caract�res: Utilisateur par d�faut, � utiliser lors de la connexion � un serveur MySQL, si aucun utilisateur n'est sp�cifi�.
mysql.default_password cha�ne de caract�res: Mot de passe par d�faut, � utiliser lors de la connexion � un serveur MySQL, si aucun mot de passe n'est sp�cifi�.
mysql.default_port string: Le num�ro de port TCP par d�faut, utilis� pour se connecter � la base de donn�es, lorsqu'aucun port n'est sp�cifi�. Si aucun port par d�faut est sp�cifi�, le port sera alors obtenu en lisant la variable d'environnement MYSQL_TCP_PORT, l'entr�e mysql-tcp dans le fichier /etc/services ou encore la constante de compilation MYSQL_PORT, dans cet order. Win32 n'utilisera aussi que la constante MYSQL_PORT.
mysql.default_socket string: Le nom par d�faut de la socket lorsque l'on se conecte au serveur local, si aucune autre socket n'est sp�cifi�e.
mysql.max_persistent entier: Nombre maximum de connexions persistantes � une base de donn�es MySQL, par processus.
mysql.max_links entier: Nombre de connexions maximum � une base de donn�es MySQL, par processus, incluant les connexions persistantes

Directives de configuration mSQL

msql.allow_persistent bool�en: Active ou d�sactive les connexions persistantes � la base de donn�es mSQL.
msql.max_persistent entier: Nombre maximum de connexions persistantes � une base de donn�es mSQL, par processus.
msql.max_links entier: Nombre maximum de connexions � une base de donn�es mSQL, par processus, incluant les connexions persistantes.

Directives de configuration Postgres

pgsql.allow_persistent bool�en: Active ou d�sactive les connexions persistantes � la base de donn�es Postgres.
pgsql.max_persistent entier: Nombre maximum de connexions persistantes � une base de donn�es Postgres, par processus.
pgsql.max_links entier: Nombre maximal de connexions � une base de donn�es Postgres, par processus, incluant les connexions persistantes.

Directives de configuration SESAM

sesam_oml string

Nom de la librairieBS2000 PLAM contenant les pilotes de connexion SESAM. Obligatoire pour les fonctions SESAM. La librairie BS2000 PLAM doit �tre configur�e avec ACCESS=READ,SHARE=YES, car elle doit �tre accessible � l'utilisateur Apache.

sesam_configfile string

Nom du fichier de configuration de l'application SESAM. Obligatoire pour les fonctions SESAM. Le fichier BS2000 doit �tre accessible �tre accessible � l'utilisateur Apache.

Le fichier de configuration de l'application va contenir la configuration sur le sch�ma suivant (voir le manuel SESAM) :

CNF=B
NAM=K
NOTYPE

sesam_messagecatalog string

Nom du catalogue de messages SESAM. Dans la plupart des cas, cette directive n'est pas n�cessaire. Seulement, si le fichier de messages SESAM n'est pas install� dans la table de messages BS2000, il faut indiquer sa localisation avec cette directive.

Le catalogue de messages doit �tre param�tr� avec ACCESS=READ,SHARE=YES, car il doit �tre accessible � l'utilisateur Apache.

Directives de configuration Sybase

sybase.allow_persistent bool�en: Active ou d�sactive les connexions persistantes � la base de donn�es Sybase.
sybase.max_persistent entier: Nombre maximum de connexions persistantes � une base de donn�es Sybase par processus.
sybase.max_links entier: Nombre maximum de connexions � une base de donn�es Sybase, par processus, incluant les connexions persistantes.

Directives de configuration Sybase-CT

sybct.allow_persistent bool�en: Active ou d�sactive les connexions persistantes � la base de donn�es Sybase-CT. Par d�faut, cette option est activ�e.
sybct.max_persistent entier: Nombre maximum de connexions persistantes � une base de donn�es Sybase-CT par processus. Par d�faut, cette option est � -1, ce qui signifie que le nombre de connexion est illimit�.
sybct.max_links entier: Nombre maximum de connexions � une base de donn�es Sybase-CT, par processus, incluant les connexions persistantes. Par d�faut, cette option est � -1, ce qui signifie que le nombre de connexions est illimit�.
sybct.min_server_severity entier: Les messages en provenance du serveur d'un niveau d'erreur �gal � sybct.min_server_severity seront consid�r�s comme des alertes (warnings). Cette valeur peut �tre modifi�e � l'int�rieur du script en appelant la fonction sybase_min_server_severity (NDtraducteur : cette fonction semble ne pas exister). Par d�faut, cette valeur vaut 10.
sybct.min_client_severity entier: Les messages en provenance de la librairie client avec un niveau d'erreur �gal ou sup�rieur � sybct.min_client_severity seront consid�r�s comme des alertes. Cette valeur peut �tre modifi�e � l'int�rieur du script en appelant la fonction sybase_min_client_severity (NDtraducteur : cette fonction semble ne pas exister). Par d�faut, cette valeur vaut 10, ce qui annule tout rapport d'erreur.
sybct.login_timeout entier: D�lai de validit� d'une tentative de connexion. Il est � noter que si max_execution_time est d�pass� avant que la connexion n'expire, le script sera termin� avant le message d'erreur. Par d�faut, cette valeur vaut 1 minute.
sybct.timeout entier: Temps maximum en secondes avant qu'une tentative de requ�te "select_db" ou "query" non aboutie renvoie une erreur. Il est � noter que si max_execution_time est d�pass� avant que la requ�te n'expire, votre script sera termin� avant le message d'erreur. Par d�faut, il n'y a pas de limite.
sybct.hostname cha�ne de caract�res: Nom de l'h�te � partir duquel vous vous connectez, afin d'�tre affich� par la fonction sp_who (NDtraducteur : cette fonction semble ne pas exister). Par d�faut, cette valeur �gale � 0.

Directives de configuration Informix

ifx.allow_persistent bool�en: Active les connexions persistantes � une base de donn�es Informix.
ifx.max_persistent entier: Nombre maximum de connexions persistantes � une base de donn�es Informix, par processus.
ifx.max_links entier: Nombre maximum de connexions � une base de donn�es Informix par processus, en incluant les connexions persistantes.
ifx.default_host cha�ne de caract�res: H�te par d�faut o� se connecter si aucun h�te n'est sp�cifi� par les fonctions ifx_connect() ou ifx_pconnect().
ifx.default_user cha�ne de caract�res: Utilisateur par d�faut si aucun utilisateur n'est sp�cifi� par les fonctions ifx_connect() ou ifx_pconnect().
ifx.default_password cha�ne de caract�res: Mot de passe par d�faut si aucun mot de passe n'est sp�cifi� par les fonctions ifx_connect() ou ifx_pconnect().
ifx.blobinfile bool�en: Lorsque cette option est activ�e, les colonnes de type "blob" seront retourn�es dans un fichier. Par d�faut, elles seront retourn�es en m�moire. Il est possible de modifier dynamiquement cette valeur gr�ce � la fonction ifx_blobinfile_mode().
ifx.textasvarchar bool�en: Lorsque cette option est activ�e, les colonnes de type "TEXT" seront retourn�es dans une cha�ne de caract�res. Par d�faut, elles seront retourn�es en m�moire. Il est possible de modifier dynamiquement cette valeur gr�ce � la fonction ifx_textasvarchar().
ifx.byteasvarchar bool�en: Lorsque cette option est activ�e, les colonnes de type "BYTE" seront retourn�es dans une cha�ne de caract�res. Par d�faut, elles seront retourn�es en m�moire. Il est possible de modifier dynamiquement cette valeur gr�ce � la fonction ifx_textasvarchar().
ifx.charasvarchar bool�en: Lorsque cette option est activ�e, les espaces en fin de cha�ne de caract�res seront conserv�s lors d'une commande FETCH.
ifx.nullformat bool�en: Lorsque cette option est activ�e, les colonnes de valeur NULL seront retourn�es comme des cha�nes de caract�res vides. Il est possible de modifier dynamiquement cette valeur gr�ce � la fonction ifx_nullformat().

Directives de configuration pour les calculs math�matiques.

bcmath.scale entier: Nombre de chiffres apr�s la virgule pour toutes les fonctions de pr�cision math�matique arbitraire.

Directives de configuration du navigateur.

browscap cha�ne de caract�res: Nom du fichier de descriptif des clients HTML. Voir aussi get_browser().

Directives de configuration du pilote ODBC unifi�

uodbc.default_db cha�ne de caract�res: Source de donn�es ODBC � utiliser par d�faut avec les fonctions odbc_connect() ou odbc_pconnect().
uodbc.default_user cha�ne de caract�res: Nom d'utilisateur d�faut avec les fonctions odbc_connect() ou odbc_pconnect().
uodbc.default_pw cha�ne de caract�res: Mot de passe par d�faut dans les fonctions odbc_connect() ou odbc_pconnect().
uodbc.allow_persistent bool�en: Cette option active ou d�sactive les connexions persistantes � la base de donn�es, via le canal ODBC.
uodbc.max_persistent entier: Nombre maximum de connexions persistantes autoris�es � la base de donn�es.
uodbc.max_links entier: Nombre maximum de connexions (persistantes ou non), par processus, � la base de donn�es.

Directives de configuration des cha�nes mulit-octets

mbstring.internal_encoding string: mbstring.internal_encoding d�finit l'encodage interne par d�faut.
mbstring.http_input string: mbstring.http_input d�finit l'encodage de reception HTTP par d�faut.
mbstring.http_output string: mbstring.http_output d�finit l'encodage d'affichage HTTP par d�faut.
mbstring.detect_order string: mbstring.detect_order d�finit l'ordre de d�tection des encodages par d�faut.
mbstring.substitute_character string: mbstring.substitute_character d�finit l'encodage de substitution par d�faut : il est utilis� pour les caract�res invalides.


	downloads \| documentation \| faq \| getting help \| \| php.net sites \| links

search for in the