Index: phpdoc/fr/functions/errorfunc.xml
diff -u phpdoc/fr/functions/errorfunc.xml:1.9 phpdoc/fr/functions/errorfunc.xml:1.10
--- phpdoc/fr/functions/errorfunc.xml:1.9 Sat Jul 7 18:22:06 2001
+++ phpdoc/fr/functions/errorfunc.xml Fri Nov 2 04:15:46 2001
@@ -1,98 +1,113 @@
-
- Gestion des erreurs
- Gestion des erreurs
-
+
+
+
+ Gestion des erreurs
+ Gestion des erreurs
+
+
+ Ces fonctions permettent de gérer les erreurs, et de les enregistrer.
+ Vous pouvez définir les règles de traitement des erreurs et
+ choisir la manière de les enregistrer : vous pouvez adapter le rapport
+ d'erreurs à vos besoins.
+
+
+ Avec les fonctions d'enregistrements, vous pouvez envoyer directement les
+ rapports à d'autres machines (ou même les envoyer par email
+ à un pager), à l'historique système, ou encore
+ sélectionner les erreurs les plus importantes et ne pas enregistrer
+ les autres.
+
+
+ La fonction de niveau d'erreur vous permet de personnaliser le niveau
+ et le type d'erreur noté : depuis les inoffensives alertes jusqu'au
+ erreurs personnalisées retournées par les fonctions.
+
+
+
+
+ error_log
+ Envoie un message d'erreur quelque part
+
+
+ Description
+
+
+ int error_log
+ string message
+ int message_type
+ string
+ destination
+
+ string
+ extra_headers
+
+
+
- Ces fonctions permettent de gérer les erreurs, et de les enregistrer.
- Vous pouvez définir les règles de traitement des erreurs et choisir
- la manière de les enregistrer : vous pouvez adapter le rapport d'erreur
- à vos besoins.
+ error_log envoie un message d'erreur à
+ l'historique du serveur web, à un port TCP ou un
+ fichier.
+ message est le message d'erreur qui doit être
+ enregistré. message_type indique où le
+ message doit être envoyé :
+
+ Types de <function>error_log</function>
+
+
+
+ 0
+
+ message est envoyé à l'historique
+ PHP, qui est basé sur l'historique système ou un fichier,
+ en fonction de la configuration de error_log.
+
+
+
+ 1
+
+ message est envoyé par email à
+ l'adresse destination. C'est le seul type qui
+ utilise le quatrième paramètre
+ extra_headers. Ce message
+ utilise la même fonction interne que mail.
+
+
+
+ 2
+
+ message est envoyé par la connexion de
+ debuggage PHP. Cette option n'est disponible que si l'option
+ remote_debugging a
+ été désactivée. Dans ce cas, le
+ paramètre destination spécifie
+ l'hôte ou l'adresse IP, et optionnellement le numéro de
+ port, de la socket qui recevra les informations de débuggage.
+
+
+
+ 3
+
+ message est ajouté au fichier
+ destination.
+
+
+
+
+
+
- Avec les fonctions d'enregistrements, vous pouvez envoyer directement les
- rapport à d'autres machines (ou même les envoyer par email à un pager), à l'
- historique système, ou encore selectionner les erreurs les plus importantes
- et ne pas enregistrer les autres.
+ Le débuggage à distance via TCP/IP est une
+ fonctionnalité PHP 3 qui n'est pas disponible en
+ PHP 4.
+
- La fonction de niveau d'erreur vous permet de personnaliser le niveau
- et le type d'erreur noté : depuis les inoffensives alertes jusqu'au
- erreurs personnalisées retournées par les fonctions.
-
-
-
-
- error_log
- Envoie un message d'erreur quelque part
-
-
- Description
-
-
- int error_log
- string message
- int message_type
- string
- destination
-
- string
- extra_headers
-
-
-
-
- error_log envoie un message d'erreur à l'historique
- du serveur web, à un port TCP ou un fichier.
- message est le message d'erreur qui doit être
- enregistré. message_type indique où le
- message doit être envoyé :
-
- Types de <function>error_log</function>
-
-
-
- 0
-
- message est envoyé à l'historique PHP, qui est basé
- sur l'historique système ou un fichier, en fonction de la configuration
- de error_log.
-
-
-
- 1
-
- message est envoyé par email à l'adresse
- destination. C'est le seul type qui utilise le
- quatrième paramètre extra_headers. Ce message
- utilise la même fonction interne que mail.
-
-
-
- 2
-
- message est envoyé par la connexion de debuggage
- PHP. Cette option n'est disponible que si l'option
- remote debugging a été désactivé.
- Dans ce cas, le parmètre destination spécifie
- l'hôte ou l'adresse IP, et optionnellement le numéro de port, de la
- socket qui recevra les informations de débuggage.
-
-
-
- 3
-
- message est ajouté au fichier
- destination.
-
-
-
-
-
-
-
-
- Exemples avec <function>error_log</function>
-
+
+ Exemples avec <function>error_log</function>
+
<?php
// Envoi une notification par l'historique du serveur, si la connexion à la base
// de données est impossible.
@@ -109,129 +124,129 @@
error_log ("Grosse bourde!", 2, "loghost");
error_log ("Grosse bourde!", 3, "/var/tmp/my-errors.log");
?>
-
-
-
-
-
-
-
- error_reporting
- Fixe le niveau de rapport d'erreurs PHP
-
-
- Description
-
-
- int error_reporting
- int
- level
-
-
-
-
- error_reporting fixe le niveau de rapport d'erreur PHP
- et retourne l'ancienne valeur. Le niveau d'erreur peut être un champs
- de bits, ou une constante. L'utilisation des constantes est vivement
- recommandé, pour assurer une compatiblité maximale avec
- les futures versions. Au fur et à mesure que de nouveaux niveaux
- d'erreurs sont créés, l'intervalle de validité des niveaux
- évolue, et les anciennes valeurs n'ont plus les mêmes significations.
-
- Exemple de modification de niveau d'erreur
-
+
+
+
+
+
+
+
+ error_reporting
+ Fixe le niveau de rapport d'erreurs PHP
+
+
+ Description
+
+
+ int error_reporting
+ int
+ level
+
+
+
+
+ error_reporting fixe le niveau de rapport d'erreur PHP
+ et retourne l'ancienne valeur. Le niveau d'erreur peut être un champs
+ de bits, ou une constante. L'utilisation des constantes est vivement
+ recommandée, pour assurer une compatibilité maximale avec
+ les futures versions. Au fur et à mesure que de nouveaux niveaux
+ d'erreurs sont créés, l'intervalle de validité des niveaux
+ évolue, et les anciennes valeurs n'ont plus les mêmes significations.
+
+ Exemple de modification de niveau d'erreur
+
error_reporting (55); // En PHP 3, équivalent à E_ALL ^ E_NOTICE
/* ...en PHP 4, '55' signifie (E_ERROR | E_WARNING | E_PARSE |
E_CORE_ERROR | E_CORE_WARNING) */
error_reporting (2039); // PHP 4 équivalent à E_ALL ^ E_NOTICE
error_reporting (E_ALL ^ E_NOTICE); // La même signification en PHP 3 et 4
-
-
- Suivez les liens de chaque valeur interne pour connaître leur signification :
-
+
+
+
+ Exemples avec <function>error_reporting</function>
+
error_reporting(0);
/* Empêche tout affichage d'erreur */
error_reporting(7); // Ancienne syntaxe PHP 2/3
@@ -272,9 +287,11 @@
fonction PHP par défaut, ou une autre fonction utilisateur).
- Voir aussi error_reporting,
+ Voir aussi
+ error_reporting,
set_error_handler,
- trigger_error et user_error
+ trigger_error et
+ user_error
@@ -298,21 +315,21 @@
error_handler pour gérer
les erreurs dans un script. Retourne un pointeur sur l'ancienne fonction
de gestion des erreurs (si il y en avait une), ou &false;, en cas d'erreur.
- set_error_handler sert à définir votre propre
- gestionnaire d'erreur, qui prendra en charge leur traitement durant
- l'exécution d'un script. Cela peut être utile lorsque vous devez
- repérer des erreurs critiques lors d'un nettoyage de bases, ou bien si
- vous souhaitez générer une erreur dans certaines conditions
- (avec trigger_error).
+ set_error_handler sert à définir votre
+ propre gestionnaire d'erreurs, qui prendra en charge leur traitement durant
+ l'exécution d'un script. Cela peut être utile lorsque vous
+ devez repérer des erreurs critiques lors d'un nettoyage de bases, ou
+ bien si vous souhaitez générer une erreur dans certaines
+ conditions (avec trigger_error).
La fonction utilisateur doit accepter deux arguments : le code de l'erreur,
- et une chaîne décrivant l'erreur. L'exemple ci dessous montre le traitement
- d'exceptions en déclenchant des erreurs, et en les gérant avec une fonction
- utilisateur :
+ et une chaîne décrivant l'erreur. L'exemple ci dessous montre
+ le traitement d'exceptions en déclenchant des erreurs, et en les
+ gérant avec une fonction utilisateur :
- Traitement des erreurs avec <function>set_error_handler</function> et
+ Traitement des erreurs avec <function>set_error_handler</function> et
<function>trigger_error</function>
@@ -379,11 +396,11 @@
echo "----\nvector d - fatal error\n";
$d = scale_by_log($a, -2.5);
?>
-
-
- L'éxécution du script devrait donner ceci :
-
-
+
+
+ L'éxécution du script devrait donner ceci :
+
+
vector a
Array
(
@@ -415,112 +432,121 @@
<B>FATAL</B> [256] log(x) de x <= 0 est indéfini : scale = -2.5<br>
Erreur fatale à la ligne 16 du fichier trigger_error.php, PHP 4.0.1pl2 (Linux)<br>
Annulation du script....<br>
-
-
-
-
- Il faut se rappeler que la fonction standard de traitement des erreurs
- de PHP est alors complètement ignorée. error_reporting
- n'aura plus d'effet, et votre fonction de gestion des
- erreurs sera toujours appelée. Vous pourrez toujours lire la valeur
- de l'erreur courante de error_reporting et
- faire réagier la fonction de gestion des erreurs en fonction.
- Cette remarque est notamment valable si la commande a été
- préfixée par @
- (0 sera retourné).
-
-
- Notez aussi qu'il est alors confié à cette fonction de terminer le script
- (die) si nécessaire. Si la fonction de gestion des
- erreurs se termine normalement, l'exécution du script se poursuivra
- avec l'exécution de la prochaine commande.
-
-
- Voir aussi error_reporting,
- restore_error_handler,
- trigger_error, et user_error
-
-
-
-
-
- trigger_error
-
- Déclenche une erreur utilisateur
-
-
-
- Description
-
-
- void trigger_error
- string error_msg
- int
- error_type
-
-
-
-
- trigger_error est utilisé pour déclencher
- une erreur utilisateur. Elle peut aussi être utilisée en
- conjonction avec un gestionnaire d'erreur interne, ou un gestionnaire
- d'erreurs utilisateur qui a été choisi comme gestionnaire
- d'erreur avec set_error_handler.
-
-
- trigger_error est pratique lorsque vous devez générer
- une réponse particulière lors de l'exécution. Par exemple
-
-
+
+
+
+
+ Il faut se rappeler que la fonction standard de traitement des erreurs
+ de PHP est alors complètement ignorée.
+ error_reporting
+ n'aura plus d'effet, et votre fonction de gestion des
+ erreurs sera toujours appelée. Vous pourrez toujours lire la valeur
+ de l'erreur courante de error_reporting et
+ faire réagir la fonction de gestion des erreurs en fonction.
+ Cette remarque est notamment valable si la commande a été
+ préfixée par @
+ (0 sera retourné).
+
+
+ Notez aussi qu'il est alors confié à cette fonction de
+ terminer le script (die) si nécessaire. Si la
+ fonction de gestion des erreurs se termine normalement, l'exécution
+ du script se poursuivra avec l'exécution de la prochaine commande.
+
+
+ Voir aussi
+ error_reporting,
+ restore_error_handler,
+ trigger_error et
+ user_error
+
+
+
+
+
+ trigger_error
+
+ Déclenche une erreur utilisateur
+
+
+
+ Description
+
+
+ void trigger_error
+ string error_msg
+ int
+ error_type
+
+
+
+
+ trigger_error est utilisé pour déclencher
+ une erreur utilisateur. Elle peut aussi être utilisée en
+ conjonction avec un gestionnaire d'erreur interne, ou un gestionnaire
+ d'erreurs utilisateur qui a été choisi comme gestionnaire
+ d'erreur avec set_error_handler.
+
+
+ trigger_error est pratique lorsque vous devez
+ générer une réponse particulière lors de
+ l'exécution. Par exemple :
+
+
<?php
if (assert ($divisor == 0))
trigger_error ("Impossible de diviser par zéro", E_USER_ERROR);
?>
-
-
-
+
+
+
- Voir set_error_handler pour illustration.
+ Voir aussi
+ set_error_handler pour illustration.
-
-
-
- Voir aussi error_reporting,
- set_error_handler,
- restore_error_handler,
- user_error
-
-
-
-
-
- user_error
-
- Génére un message d'erreur utilisateur
-
-
-
- Description
-
-
- void user_error
- string error_msg
- int
- error_type
-
-
-
-
- user_error est un alias de la fonction trigger_error.
-
-
- Voir aussi error_reporting,
- set_error_handler,
- restore_error_handler et trigger_error.
-
-
-
-
+
+
+
+ Voir aussi
+ error_reporting,
+ set_error_handler,
+ restore_error_handler et
+ user_error
+
+
+
+
+
+ user_error
+
+ Génère un message d'erreur utilisateur
+
+
+
+ Description
+
+
+ void user_error
+ string error_msg
+ int
+ error_type
+
+
+
+
+ user_error est un alias de la fonction
+ trigger_error.
+
+
+ Voir aussi
+ error_reporting,
+ set_error_handler,
+ restore_error_handler et
+ trigger_error.
+
+
+
+
