Manuel PHP
Précédent |  | Suivant

# LXXXIII. Options PHP et informations

# Introduction

Ces fonctions vous donnent accès à de nombreuses informations sur PHP lui-même, comme par exemple les configurations d'exécution, les extensions chargées, les versions, etc... Vous trouverez aussi des fonctions pour modifier des options. Et vous trouverez aussi la star des fonctions PHP phpinfo().

# Pré-requis

Ces fonctions sont disponibles dans le module PHP standard, qui est toujours accessible.

# Installation

Il n'y pas d'installation nécessaire pour utiliser ces fonctions, elles font parties du coeur de PHP.

# Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier `php.ini`.

Tableau 1. Options de configuration

Nom | Par défaut | Modifiable
--- | --- | ---
assert.active | "1" | PHP_INI_ALL
assert.bail | "0" | PHP_INI_ALL
assert.warning | "1" | PHP_INI_ALL
assert.callback | NULL | PHP_INI_ALL
assert.quiet_eval | "0" | PHP_INI_ALL
enable_dl | "1" | PHP_INI_SYSTEM
max_execution_time | "30" | PHP_INI_ALL
max_input_time | "60" | PHP_INI_ALL
magic_quotes_gpc | "1" | PHP_INI_PERDIR|PHP_INI_SYSTEM
magic_quotes_runtime | "0" | PHP_INI_ALL

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à ini_set().

Voici un éclaircissement sur l'utilisation des directives de configuration.

`assert.active` boolean

  Active les évaluations de type assert().

`assert.bail` boolean

  Termine le script si une assertion échoue.

`assert.warning` boolean

  Emet une alerte `PHP` pour chaque assertion échouée.

`assert.callback` string

  Fonction définie par le programmeur, à appeler pour chaque assertion échouée.

`assert.quiet_eval` boolean

  Utilise la configuration courante de error_reporting() durant les évaluations d'assertions. Si activée, aucune erreur n'est affichée (error_reporting(0) implicite) durant l'évaluation. Si désactivée, les erreurs sont affichées en fonction de la configuration de error_reporting()

`enable_dl` boolean

  Cette directive est réellement utile lorsque `PHP` est compilé comme module PHP. Vous pouvez activer le chargement dynamique d'extension (avec la fonction dl()) au cas par cas, pour chaque serveur virtuel.

  La raison principale pour désactiver ce système est la sécurité. Avec le chargement dynamique, il est possible de passer outre les configurations de safe mode et open_basedir.

  Par défaut, le chargement dynamique est autorisé, sauf avec le safe mode. En safe mode, il est toujours impossible d'utiliser la fonction dl().

`max_execution_time` integer

  Fixe le temps maximal d'exécution d'un script, en secondes. Cela permet d'éviter que des scripts en boucles infinies saturent le serveur. La configuration par défaut est de `30` secondes.

  Le temps d'exécution maximum n,est pas affectés par des appels systèmes tels que sleep(). Reportez-vous à la fonction set_time_limit() pour plus de détails.

  Vous ne pouvez pas modifier la valeur de cette directive avec ini_set() lorsque `PHP` est configuré en safe mode. Le seul moyen de le faire est de désactiver le safe mode ou de changer la valeur dans `php.ini`.

`max_input_time` integer

  Cette option spécifie la durée maximale pour recevoir les données d'entrée, via POST, GET et téléchargement de fichier. La valeur par défaut est `60`.

`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.

  > Note : Si la directive magic_quotes_sybase est aussi activée, elle écrasera magic_quotes_gpc. Avec les deux directives activées, seuls les guillemets simples seront protégés avec un autre guillemet simple. Les guillemets doubles, les antislashs et les NUL ne seront pas protégés.

  Voir aussi get_magic_quotes_gpc().

`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.

# Types de ressources

Cette extension ne définit aucune ressource.

# Constantes prédefinies

Les constantes listées ici sont toujours disponibles dans PHP.

Tableau 2. Constantes de phpcredits()

Constant | Description
--- | ---
CREDITS_ALL | Tous les crédits. C'est l'équivalent de : CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + CREDITS_FULLPAGE. Elle génère une page HTML complète et autonome.
CREDITS_DOCS | Les crédits de l'équipe de documentation
CREDITS_FULLPAGE | Généralement utilisé combiné avec d'autres options. Cette option indique qu'une page HTML complète doit être générée.
CREDITS_GENERAL | Crédits généraux. Design du langage, concepts, auteurs de PHP 4.0 et module SAPI.
CREDITS_GROUP | Une liste des développeurs principaux
CREDITS_MODULES | Une liste des extensions de PHP, et leurs auteurs
CREDITS_SAPI | Une liste des API de serveurs, et leurs auteurs.

Tableau 3. Constantes de phpinfo()

Constante | Valeur | Description
--- | --- | ---
INFO_GENERAL | 1 | La ligne de configuration, le chemin du `php.ini`, la date de compilation, le système et plus encore.
INFO_CREDITS | 2 | Crédits de PHP 4. Voir aussi phpcredits().
INFO_CONFIGURATION | 4 | Valeurs locales et serveurs des directives PHP. Voyez aussi ini_get().
INFO_MODULES | 8 | Les modules chargés et leur configuration respective.
INFO_ENVIRONMENT | 16 | Les varibles d'environnement, qui sont aussi disponibles dans `$_ENV`.
INFO_VARIABLES | 32 | Toutes les variables prédéfinies : EGPCS (Environnement, GET, POST, Cookie, Server).
INFO_LICENSE | 64 | La licence PHP. Voir aussi la FAQ de la license.
INFO_ALL | -1 | Affiche toutes les valeurs citées ci-dessus. C'est la valeur par défaut.

`ASSERT_ACTIVE` (entier)

`ASSERT_CALLBACK` (entier)

`ASSERT_BAIL` (entier)

`ASSERT_WARNING` (entier)

`ASSERT_QUIET_EVAL` (entier)

Précédent | Sommaire | Suivant
pfpro_version | Niveau supérieur | assert_options