language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4  Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- Relecture des Notes, Précautions, Avertissements, Astuces, Divers et Retour le 2018-12-29 par girgias -->

<!--
NOTE AUX TRADUCTEURS :
Gardez les entités dans ce fichier dans le même ordre que celles dans
la version originale. Merci.
-->

<!ENTITY installation.enabled.disable 'Cette extension est activée par défaut. Elle peut être désactivée en utilisant l&#39;option de configuration : '>

<!-- Not used in EN anymore -->
<!ENTITY changelog.randomseed '<row xmlns="http://docbook.org/ns/docbook"><entry>4.2.0</entry><entry>Le générateur
de nombres aléatoires est initialisé automatiquement.</entry></row>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!-- Cautions / Précautions -->
<!ENTITY caution.cryptographically-insecure '<caution xmlns="http://docbook.org/ns/docbook"><para>
 Cette fonction ne génère pas de valeurs sécurisées d&#39;un point de vue cryptographique, et ne doit pas être utilisée
 dans un contexte de chiffrement. Si vous avez besoin d&#39;une valeur sécurisée d&#39;un point de vue cryptographique,
 utilisez plutôt <function>random_int</function>, <function>random_bytes</function>, ou
 <function>openssl_random_pseudo_bytes</function>.
</para></caution>'>

<!-- Notes -->

<!ENTITY note.bin-safe '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction gère les chaînes binaires.
</simpara></note>'>


<!ENTITY note.locale-single-byte '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est conscient de la locale et traite l&#39;entrée en fonction
 de la locale actuellement définie. Cependent, ceci ne fonctionne que sur des
 jeux de caractères d&#39;un octet. Si vous devez utiliser des jeux de caractères
 multi-octet (la plupart des langues différentes de l&#39;Europe de l&#39;ouest)
 regarder à la place les extensions
 <link linkend="book.mbstring">multibyte</link> ou <link linkend="book.intl">intl</link>
</simpara></note>'>

<!ENTITY note.clearstatcache '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Les résultats de cette fonction sont mis en cache.
 Voyez la fonction <function>clearstatcache</function> pour plus de détails.
</simpara></note>'>

<!ENTITY note.context-support '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Le support de contexte a été ajouté en PHP 5.0.0. Pour une description des <literal>contexts</literal>,
 référez-vous à <xref linkend="book.stream"/>.
</simpara></note>'>

<!ENTITY note.exec-bg '<note xmlns="http://docbook.org/ns/docbook"><para>
 Si un programme est démarré avec cette fonction et qu&#39;il tourne en arrière plan, la sortie du programme doit
 être redirigée vers un fichier, ou un autre flux de sortie. À défaut, PHP sera bloqué
 jusqu&#39;à la fin de l&#39;exécution du programme.
</para></note>'>

<!ENTITY note.exec-bypass-shell '<note xmlns="http://docbook.org/ns/docbook"><para>
 Sur Windows <function>exec</function> démarrera d&#39;abord cmd.exe pour exécuter la commande.
 Si vous voulez démarrer un programme externe sans exécuter cmd.exe utilisez <function>proc_open</function>
 en définissant l&#39;option <parameter>bypass_shell</parameter>.
</para></note>'>

<!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 À la place d&#39;un nom de fonction, un tableau contenant une référence d&#39;objet et un nom de méthode peut aussi
 être utilisé.
</simpara></note>'>

<!ENTITY note.func-callback-exceptions '<note xmlns="http://docbook.org/ns/docbook"><para>
 Notez que les fonctions de rappel enregistrées avec des fonctions comme <function>call_user_func</function> et
 <function>call_user_func_array</function> ne seront pas appelées si une exception n&#39;est pas interceptée alors
 qu&#39;elle a été lancée dans une précédente fonction de rappel.
</para></note>'>

<!ENTITY note.funcbyref '<note xmlns="http://docbook.org/ns/docbook"><para>
 Si les arguments sont passés par référence, toutes leurs modifications seront reflétées dans les valeurs
 retournées par cette fonction. À partir de PHP 7, les valeurs courantes seront aussi retournées si les arguments
 sont passés par leur valeur.
</para></note>'>

<!ENTITY note.funcnoparam '<note xmlns="http://docbook.org/ns/docbook"><para>
 Parce que cette fonction dépend de la portée courante pour déterminer les détails des paramètres, ils ne
 peuvent pas être utilisés en tant que paramètre d&apos;une fonction dans les versions de PHP antérieures à 5.3.0.
 Si cette valeur doit être passée, le résultat doit être assigné à une variable et cette variable doit être passée.
</para></note>'>

<!ENTITY note.line-endings '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Si PHP ne reconnaît pas correctement les fins de lignes lors de la lecture de fichiers qui ont été créés ou lus sur
 un Macintosh, l&apos;activation de l&apos;option de configuration
 <link linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link> peut régler le problème.
</simpara></note>'>

<!ENTITY note.no-remote '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction ne fonctionne pas avec les <link linkend="features.remote-files">fichiers distants</link>,
 car le fichier examiné doit être accessible sur le système de fichiers du serveur.
</simpara></note>'>

<!ENTITY note.not-bin-safe '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction n&#39;est pas capable de gérer les chaînes binaires !
</simpara></warning>'>

<!ENTITY note.no-key-association '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction assigne de nouvelles clés aux éléments dans <parameter>array</parameter>.
 Elle effacera toutes les clés existantes qui ont pu être assignées, plutôt que de réarranger les clés.
</simpara></note>'>

<!ENTITY note.no-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction n&#39;est pas implémentée sur les plates-formes Windows.
</simpara></note>'>

<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette extension n&#39;est pas disponible sur les plates-formes Windows.
</simpara></note>'>

<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction n&#39;est pas disponible dans les interpréteurs PHP compilé avec
 ZTS (Zend Thread Safety) d&#39;activé. Pour vérifier si votre copie de PHP a été
 compilé avec ZTS d&#39;activé, utiliser <command>php -i</command> ou tester la
 constante incluse <constant>PHP_ZTS</constant>.
</simpara></note>'>

<!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Il n&#39;est pas nécessaire d&#39;initialiser le générateur de nombres aléatoires avec
 <function>srand</function> ou <function>mt_srand</function>, ceci est fait automatiquement.
</simpara></note>'>

<!ENTITY note.is-superglobal "<note xmlns='http://docbook.org/ns/docbook'><para>
 Ceci est une 'superglobale', ou variable globale automatique. Cela signifie simplement que cette variable
 est disponible dans tous les contextes du script. Il n'est pas nécessaire de faire <command>global $variable;</command>
 pour y accéder dans les fonctions ou les méthodes.
</para></note>">

<!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>
 Lorsque le paramètre <parameter>return</parameter> est utilisé, cette fonction utilise la mise en tampon
 (buffer) interne de sortie, il ne peut donc pas être utilisé dans la fonction de rappel de <function>ob_start</function>.
</para></note>'>

<!ENTITY note.uses-ob-php70 '<note xmlns="http://docbook.org/ns/docbook"><para>
 Lorsque le paramètre <parameter>return</parameter> est utilisé, cette fonction
 utilisait la mise en tampon (buffer) interne de sortie antérieur à PHP 7.1.0, et donc ne peut pas être
 utilisé dans la fonction de rappel de <function>ob_start</function>.
</para></note>'>

<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><para>
 Notez que la précision temporelle peut varier selon le système de fichiers utilisé.
</para></note>'>

<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook"><para>
 L&#39;usage de cette fonction utilisera tous les <link linkend="language.oop5.autoload">autoloaders</link>
 enregistrés si la classe n&#39;est pas encore connue.
</para></note>'>

<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Les en-têtes ne seront accessibles et s&#39;afficheront que lorsqu&#39;un SAPI qui les supporte sera utilisé.
 </para>
</note>
'>

<!ENTITY note.sigchild '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Si PHP a été compilé avec l&#39;option de configuration --enable-sigchild,
  la valeur retournée de cette fonction sera indéfinie.
 </para>
</note>
'>

<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Si deux membres se comparent comme égaux, leur ordre relatif dans le tableau trié n&#39;est pas défini.
 </para>
</note>
'>

<!-- Tips / Astuces -->

<!ENTITY tip.fopen-wrapper '<tip xmlns="http://docbook.org/ns/docbook"><simpara>
 Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le
 <link linkend="ini.allow-url-fopen">gestionnaire fopen</link> a été activé. Voyez <function>fopen</function>
 pour plus de détails sur la façon de spécifier le nom du fichier. Reportez-vous aux
 <xref linkend="wrappers"/> pour plus d&#39;informations sur les capacités des différents gestionnaires,
 les notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu&apos;elles fournissent.
</simpara></tip>'>

<!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara>
 À partir de PHP 5.0.0, cette fonction peut aussi être utilisée avec <emphasis>quelques</emphasis> protocoles url.
 Lisez <xref linkend="wrappers"/> pour connaître les protocoles supportant la famille de fonctionnalités de
 <function>stat</function>.
</simpara></tip>'>

<!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara>
 Comme pour toutes les fonctions qui affichent directement des résultats au navigateur, les
 <link linkend="book.outcontrol">fonctions de gestion des sorties</link> peuvent être utilisées pour capturer la sortie
 de cette fonction et l&apos;enregistrer dans une &string; (par exemple).
</simpara></tip>'>

<!ENTITY tip.userlandnaming '<tip xmlns="http://docbook.org/ns/docbook"><simpara>
 Jetez un oeil sur <xref linkend="userlandnaming" />.
</simpara></tip>'>

<!-- Warnings / Avertissement -->

<!ENTITY warn.escapeshell '<warning xmlns="http://docbook.org/ns/docbook"><para>
 Si des données provenant des utilisateurs ont la permission d&apos;être passées à cette fonction, utilisez
 <function>escapeshellarg</function> ou <function>escapeshellcmd</function> pour s&apos;assurer que les utilisateurs
 ne peuvent pas amener le système à exécuter des commandes arbitraires.
</para></warning>'>

<!ENTITY warn.experimental '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette extension est <emphasis>EXPERIMENTALE</emphasis>. Le comportement de cette extension, les noms de ses fonctions,
 et toute la documentation autour de cette extension peut changer sans préavis dans une prochaine version de PHP.
 Cette extension doit être utilisée à vos risques et périls.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 5.4.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 5.4.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.5.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.6.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.0.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-1-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.1.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.1.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0.removed-7-2-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.1.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.2.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.2.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.2.0,
 et <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 8.0.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.2.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.2.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 8.0.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.3.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.3.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.3.0,
 et a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 8.0.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-4-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.4.0.
 Dépendre de cette fonctionnalité est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.4.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.4.0,
 et a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 8.0.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 8.0.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY removed.php.future 'Cette fonctionnalité obsolète <emphasis xmlns="http://docbook.org/ns/docbook">sera</emphasis>
certainement <emphasis xmlns="http://docbook.org/ns/docbook">supprimée</emphasis> dans le futur.'>

<!ENTITY warn.deprecated.function.removed-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> et a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 5.3.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.function.removed-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis>, et a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 5.5.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cet alias est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0.
 Dépendre de cet alias est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.4.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cet alias est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.4.0.
 Dépendre de cet alias est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.5.0.
 Dépendre de cette fonction est fortement déconseillé.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.5.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-5-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.5.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-4-1-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 4.1.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cet alias est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.4.0. et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.6.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</simpara></warning>'>

<!ENTITY warn.removed.function-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</simpara></warning>'>

<!ENTITY warn.removed.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.4.0.
</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-2-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Cet alias est
<emphasis>OBSOLÈTE</emphasis> en PHP 7.2.0, et <emphasis>SUPPRIMÉ</emphasis> à partir de PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Cet alias est
<emphasis>OBSOLÈTE</emphasis> en PHP 7.4.0, et <emphasis>SUPPRIMÉ</emphasis> à partir de PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Cet alias est
<emphasis>OBSOLÈTE</emphasis> en PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.removed.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Cet alias est
<emphasis>SUPPRIMÉ</emphasis> à partir de PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.experimental.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>EXPERIMENTALE</emphasis>. Le comportement de cette fonction, son nom, et toute la
 documentation autour de cette fonction peut changer sans préavis dans une prochaine version de PHP.
 Cette fonction doit être utilisée à vos risques et périls.
</simpara></warning>'>

<!ENTITY warn.imaprecodeyaz '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Les extensions <link linkend="book.imap">IMAP</link>, <link linkend="book.recode">recode</link> et
 <link linkend="book.yaz">YAZ</link>
 ne peuvent être utilisées simultanément puisqu&#39;elles utilisent un symbole interne commun.
 Note: Yaz 2.0 et supérieur ne souffre plus de ce problème.
</simpara></warning>'>

<!ENTITY warn.install.cgi '<warning xmlns="http://docbook.org/ns/docbook"><para>
 Un serveur déployé en mode CGI s&#39;expose à plusieurs vulnérabilités possibles. Veuillez lire notre
 <link linkend="security.cgi-bin">section sur la sécurité en mode CGI</link>
 pour apprendre comment vous protéger contre ces attaques.
</para></warning>'>

<!ENTITY note.magicquotes.gpc '<note xmlns="http://docbook.org/ns/docbook">
<title>Note concernant la directive : magic_quotes_gpc</title>
<para>
 La directive PHP <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> est positionné à
 <literal>on</literal> par défaut. En bref, elle applique la fonction <function>addslashes</function> sur toutes les
 données issues de GET, POST et COOKIE. <function>stripslashes</function> peut être utilisé pour annuler cet effet.
</para>
</note>'>

<!ENTITY warn.passwordhashing '<warning xmlns="http://docbook.org/ns/docbook">
<para>
 Il n&#39;est pas recommandé d&#39;utiliser cette fonction pour sécuriser les mots de passe, en raison de la nature
 rapide de cet algorithme de hachage. Voir <link linkend="faq.passwords.fasthash">F.A.Q du hachage des
 mots de passe</link> pour plus de détails et les bonnes pratiques.
</para>
</warning>'>

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>
 Lorsque SSL est utilisé, le serveur IIS de Microsoft violera le protocole en fermant la connexion sans
 envoyer un indicateur <literal>close_notify</literal>. PHP le reportera en tant que "SSL: Fatal Protocol Error"
 quand vous arrivez à la fin des données. Pour contourner ce le niveau de la directive
 <link linkend="ini.error-reporting">error_reporting</link> doit être baissée pour ne pas inclure les avertissments.
 PHP peut détecter automatiquement les serveur IIS bogué lors de l&#39;ouverture
 du flux en utilisant <literal>https://</literal> et supprimera l&#39;avertissement.
 Lors de l&#39;utilisation de <function>fsockopen</function> pour créer un socket <literal>ssl://</literal>,
 c&#39;est au développeur de détecter et supprimer l&#39;avertissement.
</para></warning>'>

<!ENTITY warn.undocumented.class '
<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
 Cette classe est actuellement non documentée ; seule la liste de ses propriétés et de ses méthodes est disponible.
</simpara>
</warning>
'>

<!ENTITY warn.undocumented.func '
<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
 Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.
</simpara>
</warning>
'>

<!-- Deprecation and removal warnings designed for use with a list of
    alternatives. See en/reference/regex/functions/ereg.xml and
    en/reference/regex/reference.xml for examples of these in action. -->

<!ENTITY warn.deprecated.function.4-1-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 4.1.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Les alternatives à cette fonction incluent :
</para>
'>

<!ENTITY warn.deprecated.feature.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Les alternatives à cette fonctionnalité incluent :
</para>
'>

<!ENTITY warn.deprecated.function.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.3.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Les alternatives à cette fonction incluent :
</para>
'>

<!ENTITY warn.deprecated.function.5-5-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 5.5.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Les alternatives à cette fonction incluent :
</para>
'>

<!ENTITY warn.removed.feature.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Cette fonctionnalité a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Les alternatives à cette fonctionnalité incluent :
</para>
'>

<!ENTITY warn.removed.function.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Cette fonction a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Les alternatives à cette fonction incluent :
</para>
'>

<!ENTITY warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Cette fonctionnalité est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.1.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Les alternatives à cette fonctionnalité incluent :
</para>
'>

<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.1.0 et a été
 <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Les alternatives à cette fonction incluent :
</para>
'>

<!-- Misc / Divers -->

<!ENTITY version.exists.asof 'Existe à partir de PHP '>

<!ENTITY version.trunk.changelog 'Futur'>

<!ENTITY no.function.parameters '<para xmlns="http://docbook.org/ns/docbook">Cette fonction ne contient aucun paramètre.</para>'>

<!ENTITY example.outputs '<para xmlns="http://docbook.org/ns/docbook">L&#39;exemple ci-dessus va afficher :</para>'>

<!ENTITY example.outputs.5 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 5 :</para>'>

<!ENTITY example.outputs.53 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 5.3 :</para>'>

<!ENTITY example.outputs.54 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 5.4 :</para>'>

<!ENTITY example.outputs.55 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 5.5 :</para>'>

<!ENTITY example.outputs.56 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 5.6 :</para>'>

<!ENTITY example.outputs.7 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 7 :</para>'>

<!ENTITY example.outputs.70 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 7.0 :</para>'>

<!ENTITY example.outputs.71 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 7.1 :</para>'>

<!ENTITY example.outputs.72 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 7.2:</para>'>

<!ENTITY example.outputs.73 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 7.3 :</para>'>


<!ENTITY example.outputs.8 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 8 :</para>'>

<!ENTITY example.outputs.8.similar '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 8 est similaire à :</para>'>

<!ENTITY example.outputs.80 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 8.0 :</para>'>

<!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus sur une machine 32 bits :</para>'>

<!ENTITY example.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus sur une machine 64 bits :</para>'>

<!ENTITY example.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus est similaire à :</para>'>

<!ENTITY examples.outputs '<para xmlns="http://docbook.org/ns/docbook">Les exemples ci-dessus vont afficher :</para>'>

<!ENTITY examples.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Résultat des exemples ci-dessus sur une machine 32 bits :</para>'>

<!ENTITY examples.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Résultat des exemples ci-dessus sur une machine 64 bits :</para>'>

<!ENTITY examples.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">Les exemples ci-dessus vont afficher quelque chose de similaire à :</para>'>

<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction remet le pointeur au début du tableau d&#39;entrée (équivalent de <function>reset</function>).
</simpara></note>'>

<!ENTITY seealso.array.sorting 'Les fonctions de <link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">tri des tableaux</link>'>

<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>flags</parameter></term>
 <listitem>
  <para>
   Le deuxième paramètre optionnel <parameter>flags</parameter>
   peut être utilisé pour modifier le comportement de tri en utilisant ces valeurs :
  </para>
  <para>
   Type de drapeaux de tri :
   <itemizedlist>
    <listitem>
     <simpara><constant>SORT_REGULAR</constant> - compare items normally;
     the details are described in the <link linkend="language.operators.comparison">comparison operators</link> section</simpara>
    </listitem>
    <listitem>
     <simpara><constant>SORT_NUMERIC</constant> - compare les éléments numériquement</simpara>
    </listitem>
    <listitem>
     <simpara><constant>SORT_STRING</constant> - compare les éléments comme des chaînes de caractères</simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>SORT_LOCALE_STRING</constant> - compare les éléments comme
      des chaînes de caractères, basé sur la locale courante. Ceci utilise la locale,
      qui peut être changée en utilisant <function>setlocale</function>
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>SORT_NATURAL</constant> - compare les éléments comme des chaînes de caractères
      utilisant "l&#39;ordre naturel" comme <function>natsort</function>
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>SORT_FLAG_CASE</constant> - peut être combiné
      (OU bit à bit) avec
      <constant>SORT_STRING</constant> ou
      <constant>SORT_NATURAL</constant> pour trier les chaînes sans tenir compte de la casse
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </listitem>
</varlistentry>
'>

<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">Lorsqu&#39;un &integer; est utilisé,
sa valeur est mesurée en octets. Vous pouvez également utiliser la notation sténographique
comme décrit dans cette
<link linkend="faq.using.shorthandbytes">entrée de la FAQ.</link>.</simpara>'>

<!ENTITY info.deprecated.alias 'Pour des raisons de compatibilité ascendante,
l&#39;alias obsolète suivant peut être utilisé : '>

<!ENTITY info.function.alias 'Cette fonction est un alias de : '>

<!ENTITY info.method.alias 'Cette méthode est un alias de: '>

<!ENTITY info.function.alias.deprecated '<simpara xmlns="http://docbook.org/ns/docbook">Cet alias est obsolète
et n&#39;existe que pour des raisons de compatibilité. Il est recommandé
de ne pas utiliser cette fonction car elle peut être supprimée dans une version future de PHP.</simpara>'>

<!ENTITY ext.windows.path.dll 'Afin de faire fonctionner cette extension, quelques bibliothèques
<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> doivent être disponibles via le
<envar xmlns="http://docbook.org/ns/docbook">PATH</envar> du système Windows. Lisez la
<acronym xmlns="http://docbook.org/ns/docbook">F.A.Q</acronym> intitulée
"<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">Comment ajouter mon dossier
PHP à mon PATH Windows</link>" pour plus d&#39;informations. Le fait de copier les bibliothèques DLL depuis le
dossier PHP dans le dossier système Windows fonctionne également (car le dossier système est par défaut dans le
<envar xmlns="http://docbook.org/ns/docbook">PATH</envar> système), mais cette méthode n&#39;est pas recommandée.
<emphasis xmlns="http://docbook.org/ns/docbook">Cette extension nécessite que les fichiers suivants se trouvent dans le
<envar>PATH</envar> :</emphasis> '>

<!ENTITY manual.migration.seealso 'Voir aussi les guides de migration entre les différentes versions de PHP'>

<!ENTITY style.oop 'Style orienté objet'>
<!ENTITY style.procedural 'Style procédural'>

<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">ressource</link>'>

<!ENTITY foreach '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.foreach">foreach</link>'>

<!ENTITY yield '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.yield">yield</link>'>

<!ENTITY parameter.context 'Reportez-vous à la section <link xmlns="http://docbook.org/ns/docbook" linkend="context">contexte</link>
de ce manuel pour une description des <literal xmlns="http://docbook.org/ns/docbook">contextes</literal>.'>

<!ENTITY parameter.use_include_path 'Lorsque définit à &true;, le nom du fichier est
également recherché dans <link xmlns="http://docbook.org/ns/docbook" linkend="ini.include-path">include_path</link>'>

<!-- Returns / Retours -->

<!ENTITY return.falseforfailure ' ou &false; si une erreur survient'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; retourne &false; en cas d&#39;erreur.'>

<!ENTITY return.success 'Cette fonction retourne &true; en cas de succès&return.falseforfailure;.'>

<!ENTITY return.nullorfalse 'Cette fonction retourne &null; en cas de succès&return.falseforfailure;.'>

<!ENTITY return.void 'Aucune valeur n&#39;est retournée.'>

<!ENTITY return.callbacksort 'La fonction de comparaison doit retourner un entier inférieur à, égal à, ou supérieur
à 0 si le premier argument est considéré comme, respectivement, inférieur à, égal à, ou supérieur au second.'>

<!ENTITY return.falseproblem '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction peut retourner &false;, mais elle peut aussi retourner une valeur équivalent à &false;.
 Veuillez lire la section sur les <link linkend="language.types.boolean">booléens</link> pour plus d&#39;informations.
 Utilisez l&#39;<link linkend="language.operators.comparison">opérateur ===</link>
 pour tester la valeur de retour exacte de cette fonction.
</simpara></warning>'>

<!-- OpenSSL -->
<!ENTITY openssl.param.x509 '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>x509</parameter></term>
<listitem>
    <para>
        Voir les <link linkend="openssl.certparams">paramètres clés/Certificats</link>
        pour une liste de valeurs valides.
    </para>
</listitem>
</varlistentry>'>

<!ENTITY openssl.param.csr '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>csr</parameter></term>
<listitem>
    <para>
        Voir les <link linkend="openssl.certparams">paramètres CSR</link> pour obtenir une liste des valeurs valides.
    </para>
</listitem>
</varlistentry>'>

<!ENTITY openssl.param.key '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>key</parameter></term>
<listitem>
    <para>
        Voir les <link linkend="openssl.certparams">paramètres clé publique/privé</link> pour obtenir une liste des valeurs valides.
    </para>
</listitem>
</varlistentry>'>


<!-- Image (GD) Notes -->
<!ENTITY note.config.t1lib '<note xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction n&#39;est disponible
    que si PHP est compilé en utilisant <option
            role="configure">--enable-t1lib[=DIR]</option>.</simpara></note>'>

<!ENTITY note.freetype '<note xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction n&#39;est disponible que si
    si PHP est compilé avec le support Freetype (<option role="configure">--with-freetype-dir=DIR</option>)
</simpara></note>'>

<!ENTITY note.gd.notrequired '<note xmlns="http://docbook.org/ns/docbook"><para>Cette fonction ne nécessite pas la bibliothèque GD.</para></note>'>

<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>Cette fonction est affectée par
    la méthode d&#39;interpolation, définie par la fonction <function>imagesetinterpolation</function>.</para></note>'>

<!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    image</parameter></term><listitem><para>Un objet <classname>GdImage</classname>, retournée
    par une des fonctions de création d&#39;images, comme <function>imagecreatetruecolor</function>.
</para></listitem></varlistentry>'>

<!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    font</parameter></term><listitem><para>Peut être 1, 2, 3, 4, 5 pour les
    polices internes d&#39;encodage Latin2 (où les plus grands nombres correspondent aux polices larges)
    ou n&#39;importe quels identifiants de police de votre choix, enregistrées avec
    la fonction <function>imageloadfont</function>.
</para></listitem></varlistentry>'>

<!ENTITY gd.psfont.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    font_index</parameter></term><listitem><para>Une ressource police retourné par <function>imagepsloadfont</function>.
</para></listitem></varlistentry>'>

<!ENTITY gd.ttf.fontfile "
<varlistentry xmlns='http://docbook.org/ns/docbook'>
<term><parameter>fontfile</parameter></term>
<listitem>
    <para>
        Le chemin d'accès à la police TrueType que vous souhaitez utiliser.
    </para>
    <para>
        Selon la version de la bibliothèque GD que PHP utilise, <emphasis>quand
        <parameter>fontfile</parameter> ne commence pas par une premier
        <literal>/</literal> alors <literal>.ttf</literal> sera ajouté</emphasis>
        au nom de fichier et la bibliothèque essaiera de rechercher ce nom de
        fichier le long d'un chemin de police défini par la bibliothèque.
    </para>
    <para>
        Lorsque vous utilisez des versions de la bibliothèque GD inférieure à
        2.0.18, un caractère <literal>espace</literal>, plutôt qu'un
        point-virgule, a été utilisé comme séparateur de chemin d'accès pour
        différents fichiers de police. L'utilisation involontaire de cette
        fonctionnalité se traduira par le message d'avertissement: <literal>
        Avertissement: impossible de trouver/ouvrir la police</literal>. Pour
        ces versions affectées, la seule solution consiste à déplacer la police
        vers un chemin qui ne contient pas d'espaces.
    </para>
    <para>
        Dans de nombreux cas où une police réside dans le même répertoire que le
        script en l'utilisant l'astuce suivante permettra d'atténuer les
        problèmes d'inclusion.
        <programlisting role='php'>
            <![CDATA[
<?php
// Définir la variable d'environnement pour GD
putenv('GDFONTPATH=' . realpath('.'));

// Nommez la police à utiliser (Notez l'absence de l'extension .ttf)
$font = 'SomeFont';
?>
]]>
        </programlisting>
    </para>
    <note>
        <para>
            Notez que <link linkend='ini.open-basedir'>open_basedir</link>
            <emphasis>ne s'applique pas</emphasis> à <parameter>fontfile</parameter>.
        </para>
    </note>
</listitem>
</varlistentry>
">


<!ENTITY gd.return.identifier 'Retourne un objet d&#39;image en cas de succès, ou &false; si une erreur survient.'>

<!ENTITY gd.return.trueonerror '<caution xmlns="http://docbook.org/ns/docbook"><simpara>Toutefois, si libgd ne parvient pas à produire l&#39;image, cette fonction retourne &true;.</simpara></caution>'>

<!ENTITY gd.identifier.color 'Un identificateur de couleur créé avec <function xmlns="http://docbook.org/ns/docbook">imagecolorallocate</function>.'>

<!ENTITY gd.value.red 'Valeur du composant rouge.'>

<!ENTITY gd.value.green 'Valeur du composant vert.'>

<!ENTITY gd.value.blue 'Valeur du composant bleu.'>

<!ENTITY gd.source.height 'Hauteur de la source.'>

<!ENTITY gd.source.width 'Largeur de la source.'>

<!ENTITY gd.image.path 'Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé après
        le retour de cette fonction) vers lequel le fichier sera sauvegardé. Si défini à &null;, le flux
        brute de l&#39;image sera affiché directement.'>

<!ENTITY gd.image.new 'Crée une nouvelle image depuis un fichier ou une URL'>

<!ENTITY gd.image.source 'Ressource source de l&#39;image.'>

<!ENTITY gd.image.destination 'Ressource cible de l&#39;image.'>

<!ENTITY gd.image.output 'Affichage de l&#39;image vers le navigateur ou dans un fichier'>

<!ENTITY gd.image.colors 'Si vous créez l&#39;image depuis un fichier, seules les couleurs utilisées dans l&#39;image
        seront résolues. Les couleurs uniquement présentes dans la palette ne le seront pas.'>

<!ENTITY gd.font.size 'La taille de la police de caractères en point.'>

<!ENTITY gd.constants.types '<simpara xmlns="http://docbook.org/ns/docbook">
Utilisée comme valeur retournée par la fonction <function>imagetypes</function>
</simpara>'>

<!ENTITY gd.constants.color '<simpara xmlns="http://docbook.org/ns/docbook">
Option spéciale de couleur qui peut être utilisée à la place d&#39;une couleur allouée avec la
fonction <function>imagecolorallocate</function> ou la fonction <function>imagecolorallocatealpha</function>.
</simpara>'>

<!ENTITY gd.constants.affine '<simpara xmlns="http://docbook.org/ns/docbook">
Un type de constante de transformation affinée utilisé par la fonction
<function>imageaffinematrixget</function>.
</simpara>'>

<!ENTITY gd.constants.arc '<simpara xmlns="http://docbook.org/ns/docbook">
Une constante de style utilisée par la fonction <function>imagefilledarc</function>.
</simpara>'>

<!ENTITY gd.constants.gd2 '<simpara xmlns="http://docbook.org/ns/docbook">
Un type de constante utilisé par la fonction <function>imagegd2</function>.
</simpara>'>

<!ENTITY gd.constants.effect '<simpara xmlns="http://docbook.org/ns/docbook">
Un effet d&#39;alpha blending utilisé par la fonction <function>imagelayereffect</function>.
</simpara>'>

<!ENTITY gd.constants.filter '<simpara xmlns="http://docbook.org/ns/docbook">
Un filtre spécial GD utilisé par la fonction <function>imagefilter</function>.
</simpara>'>

<!ENTITY gd.constants.type '<simpara xmlns="http://docbook.org/ns/docbook">
Une constante de type d&#39;image utilisée par la fonction <function>image_type_to_mime_type</function>
et la fonction <function>image_type_to_extension</function>.
</simpara>'>

<!ENTITY gd.constants.png-filter '<simpara xmlns="http://docbook.org/ns/docbook">
Un filtre PNG spécial, utilisé par la fonction <function>imagepng</function>.
</simpara>'>

<!ENTITY gd.constants.flip '<simpara xmlns="http://docbook.org/ns/docbook">
Utilisé avec la fonction <function>imageflip</function>, disponible à partir de PHP 5.5.0.
</simpara>'>

<!ENTITY gd.constants.interpolation '<simpara xmlns="http://docbook.org/ns/docbook">
Utilisé avec la fonction <function>imagesetinterpolation</function>, disponible à partir de PHP 5.5.0.
</simpara>'>

<!ENTITY gd.changlog.t1lib '<row xmlns="http://docbook.org/ns/docbook">
<entry>7.0.0</entry><entry>La prise en charge de T1Lib a été supprimé de PHP, ainsi cette fonction a été supprimée.</entry>
</row>'>

<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Les formats d&apos;image GD et GD2 sont des formats d&apos;images propriétaire de libgd.
Ils doivent être considérés <emphasis>obsolète</emphasis>, et devraient seulement
être utilisé lors du développement et la phase de test.</simpara></warning>'>

<!ENTITY gd.changelog.image-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>image</parameter> attend une instance de <classname>GdImage</classname> désormais;
  auparavant, une <type>resource</type> était attendu.
 </entry>
</row>'>

<!-- DBM notes -->

<!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    dbm_identifier</parameter></term><listitem><para>L&#39;identifiant de lien DBM,
    retourné par la fonction <function>dbmopen</function>.</para></listitem></varlistentry>'>

<!-- JSON notes -->

<!ENTITY json.implementation.superset '
<note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<para>
    PHP implémente un sur-ensemble de JSON tel que spécifié dans la
    <link xlink:href="&url.rfc;7159">RFC 7159</link> originale.
</para>
</note>
'>

<!-- cURL notes -->

<!ENTITY curl.ch.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>handle</parameter>
</term><listitem><para>Un gestionnaire cURL retourné par
<function>curl_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.mh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>multi_handle</parameter>
</term><listitem><para>Un gestionnaire cURL multiple retourné par
<function>curl_multi_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
</term><listitem><para>Un gestionnaire cURL partagé retourné par
<function>curl_share_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>handle</parameter> attend désormais une instance de <classname>CurlHandle</classname>;
  auparavant; une <type>resource</type> était attendue.
 </entry>
</row>'>

<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>multi_handle</parameter> attend désormais une instance de <classname>CurlMultiHandle</classname>;
  auparavant; une <type>resource</type> était attendue.
 </entry>
</row>'>

<!ENTITY curl.changelog.share-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>share_handle</parameter> attend désormais une instance de <classname>CurlShareHandle</classname>;
  auparavant; une <type>resource</type> était attendue.
 </entry>
</row>'>

<!-- dbase notes -->

<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
Chaque champs est converti en type PHP approprié, sauf :
<itemizedlist>
    <listitem>
        <simpara>
            Les dates sont conservées comme chaînes de caractères.
        </simpara>
    </listitem>
    <listitem>
        <simpara>
            Les valeurs DateTime sont converties en chaînes de caractères.
        </simpara>
    </listitem>
    <listitem>
        <simpara>
            Les entiers en dehors de l&apos;intervalle
            <constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant> sont retournés
            comme chaînes de caractères.
        </simpara>
    </listitem>
    <listitem>
        <simpara>
            Avant dbase 7.0.0, les booléens (<literal>L</literal>) étaient convertis en <literal>1</literal> ou
            <literal>0</literal>.
        </simpara>
    </listitem>
</itemizedlist>
</para>'>

<!-- enchant entities -->

<!ENTITY enchant.param.broker '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>broker</parameter></term>
     <listitem>
      <para>
       Un courtier Enchant retourné par <function>enchant_broker_init</function>.
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.param.dictionary '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>dictionary</parameter></term>
     <listitem>
      <para>
       Un dictionnaire Enchant retourné par <function>enchant_broker_request_dict</function>
       ou <function>enchant_broker_request_pwl_dict</function>.
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.changelog.broker-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>broker</parameter> attend désormais une instance de <classname>EnchantBroker</classname> ;
  auparavant, une &resource; était attendu.
 </entry>
</row>'>

<!ENTITY enchant.changelog.dictionary-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>dictionary</parameter> attend désormais une instance de <classname>EnchantDictionary</classname> ;
  auparavant, une &resource; était attendu.
 </entry>
</row>'>

<!-- IMAP notes -->

<!ENTITY imap.imap-stream.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    imap</parameter></term><listitem><para>Un flux IMAP retourné par la fonction
    <function>imap_open</function>.</para></listitem></varlistentry>'>

<!ENTITY imap.pattern '<para xmlns="http://docbook.org/ns/docbook">Spécifie la position dans la hiérarchie des boîtes
aux lettres, où il faut commencer à chercher.</para><para xmlns="http://docbook.org/ns/docbook">Il y a deux caractères
spéciaux que vous pouvez utiliser dans <parameter>pattern</parameter> :
&apos;<literal>*</literal>&apos; et &apos;<literal>&#37;</literal>&apos;.
&apos;<literal>*</literal>&apos; signifie : toutes les boîtes aux lettres. Si vous passez
<parameter>pattern</parameter> comme &apos;<literal>*</literal>&apos;, vous obtiendrez
la liste complète des boîtes aux lettres de la hiérarchie.
&apos;<literal>&#37;</literal>&apos; signifie qu&apos;on ne s&apos;intéresse qu&apos;au niveau courant.
&apos;<literal>&#37;</literal>&apos; passé à <parameter>pattern</parameter> ne retournera
que les boîtes aux lettres de niveau supérieur; &apos;<literal>~/mail/&#37;</literal>&apos;
sous <literal>UW_IMAPD</literal> retournera toutes les boîtes aux lettres du
dossier <filename>~/mail</filename> directory, mais pas leurs enfants.</para>'>

<!ENTITY imap.mailboxname.insecure '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
    Passer des données qui ne sont pas digne de confiance à ce paramètre est <emphasis>dangereux</emphasis>, sauf si,
    <link linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link> est désactivé.
</simpara></warning>'>

<!-- intl notes -->

<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">La valeur codepoint de type &integer;
(i.e. <literal>0x2603</literal> pour <emphasis>U+2603 SNOWMAN</emphasis>), ou le caractère encodé en UTF-8 de type &string;
(i.e. <literal>"\u{2603}"</literal>)</para>'>

<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">Le type retourné sera &integer; tant
que le codepoint a été passé en une chaîne de type &string; encodée en UTF-8, auquel cas, une &string;
sera retournée.</para>'>

<!ENTITY intl.codepoint.example 'Test de différents codepoint'>

<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">La propriété Unicode à chercher (voir la
constante <literal>IntlChar::PROPERTY_*</literal>).</para>'>

<!ENTITY intl.property.example 'Test de différentes propriétés'>

<!-- LDAP notes -->

<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.4.0,
  et <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 8.0.0.
  À la place le paramètre <parameter>controls</parameter> de <function>ldap_search</function> devrait être utilisée.
  Voir les <link linkend="ldap.controls">Contrôles LDAP</link> pour plus d&#39;information.
 </simpara>
</warning>'>

<!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>controls</parameter> est désormais nullable ; auparavant, sa valeur par défaut était <literal>[]</literal>.
 </entry>
</row>'>

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para>L&#39;encodage interne ou l&#39;encodage
    des caractères spécifié par la fonction <function>mb_regex_encoding</function> sera utilisé
    comme encodage de caractères pour cette fonction.</para></note>'>

<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><para>L&#39;encodage de caractères
    spécifié par <function>mb_regex_encoding</function> sera utilisé comme encodage
    pour cette fonction par défaut.</para></note>'>

<!ENTITY mbstring.encoding.parameter '<para xmlns="http://docbook.org/ns/docbook">Le paramètre <parameter>encoding</parameter>
est l&#39;encodage des caractères. S&#39;il est omis ou &null;, l&#39;encodage de caractères interne
sera utilisé.</para>'>

<!ENTITY mbstring.warning.e-modifier '<warning xmlns="http://docbook.org/ns/docbook"><para>N&#39;utilisez jamais l&#39;option <literal>e</literal>
    lorsque vous travaillez avec des données entrantes. Aucune protection automatique n&#39;est appliquée
    (sous la forme de la fonction <function>preg_replace</function>). Si vous omettez cette étape, vous
    allez certainement crée des failles dans votre application.</para></warning>'>

<!ENTITY mbstring.changelog.encoding-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>encoding</parameter> est désormais nullable.
 </entry>
</row>'>

<!-- mcrypt notes -->

<!ENTITY mcrypt.parameter.cipher '<para xmlns="http://docbook.org/ns/docbook">Une constante parmi les constantes
<constant>MCRYPT_ciphername</constant>, ou le nom de l&#39;algorithme, sous la forme d&#39;une chaîne de caractères.</para>'>

<!ENTITY mcrypt.parameter.iv '<para xmlns="http://docbook.org/ns/docbook">Utilisé pour l&#39;initialisation des modes CBC, CFB, OFB,
ainsi que dans quelques algorithmes du mode STREAM. Si vous ne fournissez pas un IV, alors que cela est nécessaire
pour l&#39;algorithme, la fonction émettra une alerte et utilisera un IV dont tous les octets vaudront "<literal>\0</literal>".</para>'>

<!ENTITY mcrypt.parameter.iv.strict '<para xmlns="http://docbook.org/ns/docbook">Utilisé pour l&#39;initialisation des modes CBC, CFB, OFB,
ainsi que dans quelques algorithmes du mode STREAM. Si la taille de l&#39;IV fourni n&#39;est pas supporté par le mode d&#39;opération ou si vous ne fournissez pas d&#39;IV, mais que le mode d&#39;opération en requiert un, la fonction émettra un avertissement et retournera &false;.</para>'>

<!ENTITY mcrypt.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">Une constantes parmi les constantes
<constant>MCRYPT_MODE_modename</constant>, ou une des chaînes suivantes : "ecb", "cbc", "cfb", "ofb", "nofb" ou "stream".</para>'>

<!-- MCVE notes -->

<!ENTITY mcve.conn.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    conn</parameter></term><listitem><para>Une ressource MCVE_CONN retournée par la fonction
    <function>m_initengine</function>.</para></listitem></varlistentry>'>

<!-- memcached notes -->

<!ENTITY memcached.parameter.expiration 'Le délai d&#39;expiration, par défaut à zéro. Voyez
<link linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">délais d&#39;expiration</link> pour plus d&#39;informations.'>

<!ENTITY memcached.parameter.server_key 'La clé d&#39;identification du serveur de stockage ou de récupération.
        Au lieu de hacher avec la clé courante pour l&#39;élément, nous hachons avec la clé serveur lorsqu&#39;il est décidé avec quel serveur memcache il convient de dialoguer.
        Ceci permet le regroupement des éléments correspondants sur un seul serveur permettant de meilleures performances lors d&#39;opérations multiples.'>

<!ENTITY memcached.parameter.server_key 'La clé d&#39;identification du serveur de stockage.'>

<!ENTITY memcached.parameter.items 'Un tableau de paires clé/valeur à stocker sur le serveur.'>

<!ENTITY memcached.parameter.key 'La clé avec laquelle stocker la valeur.'>

<!ENTITY memcached.parameter.value 'La valeur à stocker.'>

<!ENTITY memcached.result.getresultcode 'Utilisez <methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname>
        si nécessaire.'>

<!-- password notes -->

<!ENTITY password.parameter.algo 'Une <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">constantes de l&#39;algorithme
de mot de passe</link> représentant l&#39;algorithme à utiliser lors du hachage du mot de passe.'>

<!ENTITY password.parameter.hash 'Un hachage créé par la fonction <function xmlns="http://docbook.org/ns/docbook">password_hash</function>.'>

<!ENTITY password.parameter.options 'Un tableau associatif contenant les options. Voir aussi <link xmlns="http://docbook.org/ns/docbook"
                                                                                                   linkend="password.constants">les constantes de l&#39;algorithme de mot de passe</link> pour une documentation
        sur les options supportées pour chaque algorithme.'>

<!ENTITY password.parameter.password 'Le mot de passe utilisateur.'>

<!-- socket entities -->

<!ENTITY sockets.changelog.socket-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>socket</parameter> est désormais une instance de <classname>Socket</classname> ;
  auparavant, c&apos;était une <type>resource</type>.
 </entry>
</row>'>

<!ENTITY sockets.changelog.address-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>address</parameter> est désormais une instance de <classname>AddressInfo</classname> ;
  auparavant, c&apos;était une <type>resource</type>.
 </entry>
</row>'>

<!-- geaman notes -->

<!ENTITY gearman.parameter.host 'Le nom d&#39;hôte du serveur de travaux.'>

<!ENTITY gearman.parameter.port 'Le port du serveur de travaux.'>

<!ENTITY gearman.parameter.functionname 'Une fonction enregistrée que le travailleur va exécuter'>

<!ENTITY gearman.parameter.workload 'Données linéarisées à analyser'>

<!ENTITY gearman.parameter.data 'Données aditionnelles nécessaires pour terminer le travail'>

<!ENTITY gearman.parameter.context 'Contexte de l&#39;application à associer avec une tâche'>

<!ENTITY gearman.parameter.unique 'Un identifiant unique utilisé pour identifier une tâche particulière'>

<!ENTITY gearman.parameter.jobhandle 'Le gestionnaire de travaux assigné par le serveur Gearman'>

<!-- Date and time entities -->
<!ENTITY date.timezone.intro.title '<title xmlns="http://docbook.org/ns/docbook">Liste des Fuseaux Horaires Supportés</title>'>

<!ENTITY date.timezone.intro "<para xmlns='http://docbook.org/ns/docbook'>Ici, vous trouverez une liste complète des
fuseaux horaires supportés par PHP, qui peuvent être utilisés avec, e.g.
<function>date_default_timezone_set</function>.
<caution><simpara>Le comportement des fuseaux horaires qui ne sont pas listés ici est indéfini.</simpara></caution>
</para><note xmlns='http://docbook.org/ns/docbook'>
<simpara>La dernière version de la base de données des fuseaux horaires peut
    être installée via la commande PECL
    <link xlink:href='&url.pecl.package.get;timezonedb' xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>.
</simpara></note>">

<!ENTITY date.timezone.bc '<simpara xmlns="http://docbook.org/ns/docbook">
N&#39;utilisez aucun des fuseaux horaires listés ici (excepté UTC), ils
n&#39;existent que pour des raisons de compatibilité ascendante et leur comportement peut provoquer des erreurs.</simpara>'>

<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
Si vous ne tenez pas compte de l&#39;avertissement précédent, veuillez prendre
note que la base de données de l&#39;IANA qui fournit le support des fuseaux
horaires dans PHP utilise les signes POSIX ce qui signifie que les zones
<literal>Etc/GMT+n</literal> et <literal>Etc/GMT-n</literal> sont inversées
par rapport à l&#39;usage commun.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
Par exemple, le fuseau horaire 8 heures après GMT qui est utilisé en Chine et
en Australie occidentale est actuellement <literal>Etc/GMT-8</literal> dans
cette base de données, et non <literal>Etc/GMT+8</literal> comme on
pourrait s&#39;y attendre.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
Une fois encore, il est fortement recommandé que vous utilisiez le bon fuseau
horaire  pour votre emplacement, tel que <literal>Asia/Shanghai</literal> ou
<literal>Australia/Perth</literal> pour les exemples précédents.
</simpara>'>

<!ENTITY date.timezone.abbrev-volatile '<simpara xmlns="http://docbook.org/ns/docbook">
Ces abréviations de fuseaux horaires doivent être considérées comme non pérennes, i.e.
elles peuvent être différentes pour chaque version de la base de données des fuseaux
horaires, et ne doivent donc pas être utilisées. Il est fortement recommandé de les éviter.
</simpara>'>

<!ENTITY date.timezone.errors.description '<para xmlns="http://docbook.org/ns/docbook">
Chaque appel à une fonction date/heure générera un message de type
<constant>E_NOTICE</constant> si le fuseau horaire n&#39;est pas valide,
et/ou un message de type <constant>E_STRICT</constant>
ou <constant>E_WARNING</constant> si vous
utilisez la configuration du système ou la variable d&#39;environnement
<varname>TZ</varname>. Voir aussi <function>date_default_timezone_set</function></para>'>

<!ENTITY date.timezone.errors.changelog '<row xmlns="http://docbook.org/ns/docbook"><entry>5.1.0</entry><entry><para>
    Émet un message de type <constant>E_STRICT</constant> et <constant>E_NOTICE</constant>
    lors d&#39;erreurs de fuseaux horaires.</para></entry></row>'>

<!ENTITY date.timestamp.description '
<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>timestamp</parameter></term><listitem><para>
    Le paramètre optionnel <parameter>timestamp</parameter> est un timestamp
    Unix de type &integer; qui vaut par défaut l&#39;heure courante locale si
    <parameter>timestamp</parameter> est omis ou &null;. En d&#39;autres
    termes, il vaut par défaut la valeur de la fonction <function>time</function>.
</para></listitem></varlistentry>'>

<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Seulement en style procédural : un objet <classname>DateTime</classname>
    retourné par <function>date_create</function></para></listitem></varlistentry>'>

<!ENTITY date.datetime.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Style procédural uniquement : Un objet <classname>DateTime</classname>
    retourné par la fonction <function>date_create</function>.
    Cette fonction modifie cet objet.</para></listitem></varlistentry>'>

<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term><listitem><para>
    Seulement en style procédural : un <classname>DateTimeZone</classname> objet
    retourné par <function>timezone_open</function></para></listitem></varlistentry>'>

<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Retourne l&#39;objet <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> pour chainer les méthodes&return.falseforfailure;.'>

<!ENTITY date.timezone.dbversion 'Cette liste est basée sur la version de la base de données des fuseaux horaires'>

<!ENTITY date.timezone.africa 'Afrique'>
<!ENTITY date.timezone.america 'Amerique'>
<!ENTITY date.timezone.antarctica 'Antarctique'>
<!ENTITY date.timezone.arctic 'Arctique'>
<!ENTITY date.timezone.asia 'Asie'>
<!ENTITY date.timezone.atlantic 'Atlantique'>
<!ENTITY date.timezone.australia 'Australie'>
<!ENTITY date.timezone.europe 'Europe'>
<!ENTITY date.timezone.indian 'Indien'>
<!ENTITY date.timezone.pacific 'Pacifique'>
<!ENTITY date.timezone.others 'Autres'>
<!ENTITY date.timezone.abbreviations 'Abbréviations'>

<!ENTITY date.formats 'Les formats valides sont expliqués dans la documentation sur les
<link xmlns="http://docbook.org/ns/docbook" linkend="datetime.formats">formats Date et Heure</link>.'>
<!ENTITY date.formats.parameter 'Une chaîne date/heure. &date.formats;'>

<!-- DomXml Notes -->
<!ENTITY node.inserted 'Le nœud ne sera pas affiché dans le document, à moins
        qu&#39;il ne soit inséré avec <function xmlns="http://docbook.org/ns/docbook">domnode_append_child</function>.'>

<!-- Dom Notes -->
<!ENTITY dom.node.inserted 'Ce nœud ne sera pas affiché dans le document,
        à moins qu&#39;il ne soit inséré avec <function xmlns="http://docbook.org/ns/docbook">DOMNode::appendChild</function>.'>

<!ENTITY dom.allowstatic '<para xmlns="http://docbook.org/ns/docbook">Cette méthode <emphasis>peut</emphasis> être appelée statiquement, mais enverra une erreur <constant>E_STRICT</constant>.</para>'>

<!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">Bien que le HTML mal-formé devrait se charger avec succès, cette fonction peut générer
une alerte de type <constant>E_WARNING</constant> lorsqu&#39;elle rencontre une mauvaise balise.
<link linkend="function.libxml-use-internal-errors">Les fonctions de gestion des erreurs libxml</link>
peuvent être utilisées pour gérer ces erreurs.</para>'>

<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>
 L&apos;extension DOM utilise l&apos;encodage UTF-8. Utilisez
 <function>utf8_encode</function> et <function>utf8_decode</function> pour
 travailler avec des textes dans l&apos;encodage ISO-8859-1 ou
 <link linkend="ref.iconv">iconv</link> pour d&apos;autre encodages.
</para></note>'>

<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para>
 Lors de l&apos;utilisation de <function>json_encode</function> sur un objet
 <classname>DOMDocument</classname> le résultat sera celui d&apos;encoder un objet vide.
</para></note>'>
 

<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">L&#39;exemple suivant
utilise le fichier <filename>book.xml</filename>, dont le contenu est :</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE books [
  <!ELEMENT books   (book+)>
  <!ELEMENT book    (title, author+, xhtml:blurb?)>
  <!ELEMENT title   (#PCDATA)>
  <!ELEMENT blurb   (#PCDATA)>
  <!ELEMENT author  (#PCDATA)>
  <!ATTLIST books   xmlns        CDATA  #IMPLIED>
  <!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
  <!ATTLIST book    id           ID     #IMPLIED>
  <!ATTLIST author  email        CDATA  #IMPLIED>
]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <book id="php-basics">
    <title>PHP Basics</title>
    <author email="jim.smith@basics.php">Jim Smith</author>
    <author email="jane.smith@basics.php">Jane Smith</author>
    <xhtml:blurb><![CDATA[
<p><em>PHP Basics</em> provides an introduction to PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
  </book>
  <book id="php-advanced">
    <title>PHP Advanced Programming</title>
    <author email="jon.doe@advanced.php">Jon Doe</author>
  </book>
</books>
]]></programlisting>'>

<!-- FileSystem entities -->
<!ENTITY fs.emits.warning.on.failure '<para xmlns="http://docbook.org/ns/docbook">
En cas d&#39;échec, une alerte de type <constant>E_WARNING</constant> sera émise.
</para>'>

<!ENTITY fs.validfp.all '<para xmlns="http://docbook.org/ns/docbook">Le pointeur de fichier doit être valide et pointer
sur un fichier ouvert avec succès par <function>fopen</function> ou
<function>fsockopen</function> (et pas encore fermé par <function>fclose</function>).</para>'>

<!ENTITY fs.file.pointer '<para xmlns="http://docbook.org/ns/docbook">Un pointeur de système de fichiers de type &resource;
qui est habituellement créé en utilisant la fonction <function>fopen</function>.</para>'>

<!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
    Comme le type entier de PHP est signé et que de nombreuses plates-formes
    utilisent des entiers de 32 bits, certaines fonctions relatives au système
    de fichiers peuvent retourner des résultats étranges pour les fichiers de
    taille supérieure à 2 Go.
</simpara></note>'>

<!ENTITY ini.scanner.typed '<para xmlns="http://docbook.org/ns/docbook">
À parti de PHP 5.6.1 peut aussi être spécifié comme <constant>INI_SCANNER_TYPED</constant>.
Dans ce mode les booléens, null et entiers sont préservés tant que possible.
Les chaines de caractères <literal>"true"</literal>, <literal>"on"</literal> et <literal>"yes"</literal>
sont converties vers &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
et <literal>"none"</literal> sont considérés comme &false;. <literal>"null"</literal> est converti en &null; dans ce mode. De plus toutes les chaines de caractères numériques sont converties en entier si possible.
</para>'>

<!-- GNUPG -->
<!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook">L&#39;identifiant gnupg, généré par un appel
à la fonction <function>gnupg_init</function> ou à la fonction
<classname>gnupg</classname>.</para>'>

<!ENTITY gnupg.fingerprint '<para xmlns="http://docbook.org/ns/docbook">L&#39;empreinte de la clé.</para>'>

<!-- HaruDoc -->
<!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">Émet une exception <classname>HaruException</classname> en cas d&#39;erreur.</para>'>

<!-- ODBC -->
<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">L&#39;identifiant de connexion ODBC,
voir la documentation de la fonction <function>odbc_connect</function> pour plus
de détails.</para>'>

<!ENTITY odbc.parameter.catalog 'Le catalogue (&apos;calificatif&apos; dans le jargon ODBC 2).'>

<!ENTITY odbc.parameter.schema 'Le schéma (&apos;propriétaire&apos; dans le jargon ODBC 2).'>

<!ENTITY odbc.parameter.search 'Ce paramètre accepte les masques de recherche suivants :
        <literal xmlns="http://docbook.org/ns/docbook">&#x25;</literal> pour chercher zéro ou plusieurs caractères, et <literal xmlns="http://docbook.org/ns/docbook">_</literal> pour chercher un seul caractère.'>

<!ENTITY odbc.result.driver-specific 'Les pilotes peuvent signaler des colonnes supplémentaires.'>

<!-- OAUTH -->
<!ENTITY oauth.callback.error 'Émet une erreur <constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>
        si la fonction de rappel ne peut être appelée ou n&#39;a pas été spécifiée.'>

<!ENTITY oauth.changelog.error.null 'Avant cette version, &null; était retourné au lieu de &false;.'>

<!-- Oracle -->
<!ENTITY oci.db "<para xmlns='http://docbook.org/ns/docbook' xmlns:xlink='http://www.w3.org/1999/xlink'>
Contient l&#39;instance <literal>Oracle</literal> sur laquelle nous devons nous connecter.
Ce peut être une <link xlink:href='&url.oracle.oic.connect;'>chaîne de connexion
    rapide</link>, un nom de connexion issue du fichier <filename>tnsnames.ora</filename>,
ou le nom d&#39;une instance locale Oracle.</para>
<para xmlns='http://docbook.org/ns/docbook'>Si non spécifié, PHP utilise des
variables d&#39;environnement comme <constant>TWO_TASK</constant> (sous Linux)
ou <constant>LOCAL</constant> (sous Windows)
et <constant>ORACLE_SID</constant> pour déterminer l&#39;instance
<literal>Oracle</literal> sur laquelle nous devons nous connecter.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Pour utiliser la méthode de connexion rapide, PHP doit être lié avec la bibliothèque
cliente Oracle 10<emphasis>g</emphasis> ou supérieur. La chaîne de connexion rapide pour Oracle
10<emphasis>g</emphasis> ou supérieur est de la forme :
<emphasis>[//]host_name[:port][/service_name]</emphasis>. Depuis Oracle
11<emphasis>g</emphasis>, la syntaxe est :
<emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>.
 Des options supplémentaires ont été introduit avec Oracle 19c
Les noms des services peuvent être trouvés en exécutant l'utilitaire
Oracle <literal>lsnrctl status</literal> sur la machine exécutant
la base de données.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Le fichier <filename>tnsnames.ora</filename> peut être dans le chemin
de recherche d'Oracle Net, qui inclut
<filename>/your/path/to/instantclient/network/admin</filename>, <filename>$ORACLE_HOME/network/admin</filename>
et <filename>/etc</filename>.
Une solution alternative serait de définit <literal>TNS_ADMIN</literal>
afin que le fichier <filename>$TNS_ADMIN/tnsnames.ora</filename> soit lu.
Assurez-vous que le daemon exécutant le serveur web a accès en lecture à ce
fichier.
</para>">

<!ENTITY oci.charset "<para xmlns='http://docbook.org/ns/docbook'>Détermine
le jeu de caractères utilisé par la bibliothèque cliente Oracle. Le jeu de
caractères n'a pas besoin d&#39;être identique à celui utilisé par la base de données.
S'il ne correspond pas, Oracle ferait de son mieux pour convertir les données
depuis le jeu de caractères de la base de données. Suivant les jeux de caractères,
il se peut que le résultat ne soit pas parfait. De plus, cette conversion
nécessite un peu de temps système.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Si non spécifié, la bibliothèque
cliente Oracle déterminera un jeu de caractères depuis la variable d&#39;environnement
<constant>NLS_LANG</constant>.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Le fait de passer ce paramètre peut
réduire la durée de connexion.
</para>">

<!ENTITY oci.sessionmode '<para xmlns="http://docbook.org/ns/docbook">Ce paramètre
est disponible à partir de PHP 5 (PECL OCI8 1.1) et accepte les valeurs suivantes :
<constant>OCI_DEFAULT</constant>, <constant>OCI_SYSOPER</constant> et
<constant>OCI_SYSDBA</constant>.
Si soit la constante <constant>OCI_SYSOPER</constant>, soit la constante
<constant>OCI_SYSDBA</constant> est spécifiée, cette fonction tentera d&#39;établir
une connexion privilégiée en utilisant des identifiants externes. Les
connexions privilégiées sont désactivées par défault. Pour les activer, vous
devez définir l&#39;option <link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
à <literal>On</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
PHP 5.3 (PECL OCI8 1.3.4) introduisent la valeur de mode
<constant>OCI_CRED_EXT</constant>. Ce mode demande à Oracle d&#39;utiliser une
identification externe ou bien issue du système d&#39;exploitation, qui doit être
configurée dans la base de données. Le drapeau <constant>OCI_CRED_EXT</constant>
ne peut être utilisé qu&#39;avec le nom d&#39;utilisateur &quot;/&quot; associé à un
mot de passe vide.
L&#39;option <link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
peut être définie à <literal>On</literal> ou <literal>Off</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> peut être combiné avec le mode
<constant>OCI_SYSOPER</constant> ou le mode
<constant>OCI_SYSDBA</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> n&#39;est pas supporté sous Windows pour des
raisons de sécurité.
</para>'>

<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">Pour plus de détails sur le mapping des types de données
effectué par l&#39;extension OCI8, lisez les <link linkend="oci8.datatypes">types de données
    supportés par le driver</link>.</para>'>

<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Un identifiant de connexion Oracle,
retourné par la fonction <function>oci_connect</function>, <function>oci_pconnect</function>
ou la fonction <function>oci_new_connect</function>.</para>'>

<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Requis par la version Oracle</title>
<para>Cette fonction est disponible si PHP est lié à partir de la version 10<emphasis>g</emphasis>
    de la bibliothèque de la base de données Oracle .</para></note>'>

<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook"><title>Performance</title><para>Avec les anciennes
    version OCI8 ou les anciennes bases de données Oracle, l&#39;information quant au client
    peut être défini en utilisant le paquet Oracle <literal>DBMS_APPLICATION_INFO</literal>.
    Ceci est moins efficace que d&#39;utiliser la fonction
    <function>oci_set_client_info</function>.</para></tip>'>

<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Allers-retours</title>
<para>Quelques fonctions OCI8 nécessitent des allers-retours avec la base de données.
    Ces allers-retours peuvent être évités lors de l&#39;utilisation de requêtes dont
    le résultat est mis en cache.
</para></caution>'>

<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">Pour les
requêtes retournant un très grand nombre de lignes, les performances peuvent
être très grandement accrues en augmentant la valeur de l&#39;option
<link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link>
ou en utilisant la fonction <function>oci_set_prefetch</function>.
</para>'>

<!ENTITY oci.arg.statement.id "<para xmlns='http://docbook.org/ns/docbook'>Un identifiant de requête OCI8
créé par la fonction <function>oci_parse</function> et exécuté par la fonction
<function>oci_execute</function>, ou un identifiant de requête <literal>REF
    CURSOR</literal>.</para>">

<!-- PCNTL Notes -->
<!ENTITY pcntl.parameter.status '<para xmlns="http://docbook.org/ns/docbook">Le paramètre
<parameter>status</parameter> est le paramètre status passé à un appel
de <function>pcntl_waitpid</function> ayant réussi.</para>'>

<!-- PS Notes -->
<!ENTITY ps.note.visible '<para xmlns="http://docbook.org/ns/docbook">La note ne sera pas visible si le document est imprimé ou
affiché, mais elle sera visible si le document est converti en PDF, soit par
Acrobat Distiller™, soit par Ghostview.</para>'>

<!-- Notes for safe-mode limited functions: -->
<!ENTITY note.sm.disabled '<note xmlns="http://docbook.org/ns/docbook"><simpara>&sm.disabled;</simpara></note>'>

<!ENTITY note.sm.uidcheck '<note xmlns="http://docbook.org/ns/docbook"><simpara>Lorsque le <link
        linkend="features.safe-mode">safe-mode</link> est activé, PHP vérifie si le
    fichier/dossier que vous allez utiliser a le même UID que le script qui est
    actuellement exécuté.</simpara></note>'>

<!ENTITY note.sm.uidcheck.dir '<note xmlns="http://docbook.org/ns/docbook"><simpara>Lorsque le <link
        linkend="features.safe-mode">safe-mode</link> est activé, PHP vérifie si le
    fichier/dossier que vous allez utiliser a le même UID que le script qui est
    actuellement exécuté.</simpara></note>'>

<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><para>Cette fonction est affectée par
    la directive de configuration <link linkend="ini.open-basedir">open_basedir</link>.</para></note>'>

<!ENTITY note.language-construct '<note xmlns="http://docbook.org/ns/docbook"><simpara>Comme ceci est une structure
    du langage, et non pas une fonction, il n&#39;est pas possible de l&#39;appeler
    avec les <link linkend="functions.variable-functions">fonctions variables</link>.
</simpara></note>'>

<!-- Common pieces in features/safe-mode.xml
             Jade doesn't allow in-line entities, so I put them here... Though they
             should have been inline in safe-mode.xml -->
<!ENTITY sm.uidcheck 'Vérifie que le fichier/dossier que vous
        allez utiliser a le même UID que le script qui est actuellement exécuté.'>

<!ENTITY warn.sm.exec '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Lorsque le <link
        linkend="features.safe-mode">safe mode</link> est activé, la chaîne de commande
    est échappée avec la fonction <function>escapeshellcmd</function>.
    Par exemple, <literal>echo y | echo x</literal> devient
    <literal>echo y \| echo x</literal>.</simpara></warning>'>

<!ENTITY note.exec-path '<note xmlns="http://docbook.org/ns/docbook"><simpara>Lorsque le
    <link linkend="features.safe-mode">safe mode</link> est activé, vous pouvez
    uniquement exécuter des programmes qui se situent dans le dossier défini par
    <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>.
    Pour des raisons pratiques, il n&#39;est actuellement pas permis d&#39;&#39;avoir
    le composant <literal>..</literal> dans le chemin de l&#39;exécutable.
</simpara></note>'>

<!ENTITY sm.uidcheck.dir 'Vérifie que le fichier/dossier que vous
        allez utiliser a le même UID que le script qui est actuellement exécuté.'>

<!ENTITY sm.disabled 'Cette fonction est désactivée par le <link xmlns="http://docbook.org/ns/docbook"
                                                                 linkend="features.safe-mode">safe-mode</link>'>

<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">Cette extension ne définit aucune directive de
configuration.</para>'>
<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">Cette extension ne définit aucune ressource.</para>'>
<!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">Cette extension ne définit aucune constante.</para>'>
<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Aucune bibliothèque externe n&#39;est nécessaire pour compiler cette extension.</para>'>
<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">Il n&#39;y pas d&#39;installation nécessaire pour
utiliser ces fonctions, elles font parties du coeur de PHP.</para>'>

<!-- Used in every chapter that has directive descriptions -->
<!ENTITY ini.descriptions.title '<para xmlns="http://docbook.org/ns/docbook">Voici un éclaircissement sur
l&#39;utilisation des directives de configuration.</para>'>

<!-- Common pieces for reference part BEGIN-->

<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime '<simpara xmlns="http://docbook.org/ns/docbook">Le comportement de ces fonctions est
affecté par la configuration dans le fichier &php.ini;.</simpara>'>

<!ENTITY ini.php.constants 'Pour plus de détails sur les modes PHP_INI_*,
        reportez-vous à <xref xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.modes"/>.'>

<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants '<simpara xmlns="http://docbook.org/ns/docbook">Ces constantes sont définies par cette
extension, et ne sont disponibles que si cette extension a été compilée avec
PHP, ou bien chargée au moment de l&#39;exécution.</simpara>'>

<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core '<simpara xmlns="http://docbook.org/ns/docbook">Les constantes listées ici sont
toujours disponibles dans PHP.</simpara>'>

<!-- Used in reference/$extname/classes.xml -->
<!ENTITY extension.classes '<simpara xmlns="http://docbook.org/ns/docbook">Ces classes sont définies par cette
extension, et elles ne seront disponibles que si cette extension a été compilée
avec PHP, ou bien chargée dynamiquement.</simpara>'>

<!ENTITY note.extension.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>
    Cette extension requiert PHP 5.</simpara></note>'>

<!-- PDO entities -->
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">Les constantes ci-dessous sont
définies par ce pilote et seront seulement disponibles lorsque l&#39;extension
aura été compilée dans PHP ou chargée dynamiquement du moteur d&#39;exécution.
De plus, ces constantes spécifiques au pilote devraient être utilisées seulement
si vous utilisez ce pilote. En utilisant les attributs spécifiques à un pilote
avec un autre pilote pourrait causer un comportement inattendu.
<function>PDO::getAttribute</function> pourrait être utilisé pour obtenir
l&#39;attribut <constant>PDO::ATTR_DRIVER_NAME</constant> pour vérifier le
pilote, si votre code peut fonctionner sur des pilotes multiples.</simpara>'>

<!ENTITY pdo.errors.exception-not-errmode '<note xmlns="http://docbook.org/ns/docbook"><simpara>
    Une exception sera émise même si l&#39;attribut <constant>PDO::ATTR_ERRMODE</constant> ne vaut pas
    <constant>PDO::ERRMODE_EXCEPTION</constant>.</simpara></note>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'Cette extension <link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
        n&#39;est pas intégrée à PHP.'>

<!ENTITY pecl.bundled 'Cette extension <link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
        est intégrée à PHP.'>

<!ENTITY pecl.info 'Des informations sur l&#39;installation de ces extensions PECL
        peuvent être trouvées dans le chapitre du manuel intitulé <link xmlns="http://docbook.org/ns/docbook" linkend="install.pecl">Installation
des extensions PECL</link>. D&#39;autres informations comme les notes sur les nouvelles
        versions, les téléchargements, les sources des fichiers, les informations concernant les mainteneurs
        ainsi qu&#39;un CHANGELOG, peuvent être trouvées ici :'>

<!ENTITY pecl.info.dead 'Cette extension est considérée comme non-maintenue et morte.
        Cependant, le code source est toujours disponible depuis le
<acronym xmlns="http://docbook.org/ns/docbook">SVN</acronym> de
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> ici : '>

<!ENTITY pecl.info.dead.git 'Cette extension est considérée comme morte et non maintenue. Cependant, le code
        source de cette extension est toujours disponible dans le <acronym xmlns="http://docbook.org/ns/docbook">GIT</acronym>
        de <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> : '>

<!ENTITY pecl.windows.download 'Aucune bibliothèque <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> pour cette
        extension <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> n&#39;est actuellement disponible. Reportez-vous à la section
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.legacy.building">Compilation sous Windows</link>.'>

<!ENTITY pecl.windows.download.avail 'Les binaires Windows
        (les fichiers <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>)
        pour cette extension <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> sont disponibles sur le site web PECL.'>

<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>

<!ENTITY pecl.moved-ver 'Cette extension a été déplacée dans le module
<link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> et ne sera plus intégrée dans PHP à partir de PHP '>

<!-- Common pieces for reference part END -->

<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook">La version Windows de PHP
dispose du support automatique de cette extension. Vous n&#39;avez pas à ajouter
de bibliothèque supplémentaire pour disposer de ces fonctions.</simpara>'>

<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY safemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.safe-mode">safe mode</link>'>

<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">safe mode SQL</link>'>

<!-- APD Notes -->
<!ENTITY apd.debug-level.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    debug_level</parameter></term><listitem><para>Un entier qui est formé en ajoutant
    les constantes <literal>XXX_TRACE</literal>.</para><para>Il n&#39;est pas recommandé
    d&#39;utiliser <constant>MEMORY_TRACE</constant>. C&#39;est très lent et ne semble pas être précis.
    <constant>ASSIGNMENT_TRACE</constant> n&#39;est actuellement pas implémenté.</para>
    <para>Pour activer toutes les traces fonctionnelles (TIMING, FUNCTIONS, ARGS SUMMARY (comme strace -c)),
        utilisez la valeur 99</para>
</listitem></varlistentry>'>

<!-- BCMath Notes -->
<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>scale</parameter></term><listitem>
    <para>Ce paramètre optionnel est utilisé pour
        définir le nombre de digits après la décimale à placer dans le résultat. Vous pouvez également
        définir la précision globale par défaut pour toutes les fonctions en utilisant la
        fonction <function>bcscale</function>.</para></listitem></varlistentry>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>
    Si un entier dans l&#39;intervalle -128 et 255 inclus est fourni, il sera interprété comme
    la valeur ASCII d&#39;un seul caractère (les valeurs négatives se verront ajouter 256 afin d&#39;autoriser
    les caractères dans l&#39;intervalle ASCII étendue). Tout autre entier sera interprété comme
    une chaîne de caractères contenant les décimales de l&#39;entier.</para></note>'>

<!-- FBSQL Notes -->
<!ENTITY fbsql.link-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>link_identifier</parameter></term><listitem>
    <para>Un identifiant de lien FrontBase
        retourné par la fonction <function>fbsql_connect</function> ou la fonction
        <function>fbsql_pconnect</function>.</para><para>Si ce paramètre est optionnel
    et qu&#39;il n&#39;est pas spécifié, la fonction tentera de trouver un lien ouvert vers le serveur
    FrontBase et un tel lien n&#39;est pas trouvé, la fonction tentera d&#39;en créer un,
    de la même façon que si la fonction <function>fbsql_connect</function> est appelée
    sans aucun argument.</para></listitem></varlistentry>'>

<!ENTITY fbsql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>result</parameter></term><listitem>
    <para>Un identifiant de résultat
        retourné par la fonction <function>fbsql_query</function> ou la fonction
        <function>fbsql_db_query</function>.</para></listitem></varlistentry>'>

<!-- GMP Notes -->
<!ENTITY gmp.return 'Un objet <classname xmlns="http://docbook.org/ns/docbook">GMP</classname>.'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">Un objet <classname>GMP</classname>, un &integer;, ou une &string; numérique.</para>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    result</parameter></term><listitem><para>Style procédural uniquement : Un
    objet <classname>mysqli_result</classname> retourné par <function>mysqli_query</function>,
    <function>mysqli_store_result</function>, <function>mysqli_use_result</function>,
     ou <function>mysqli_stmt_get_result</function>.
</para></listitem></varlistentry>'>

<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    mysql</parameter></term><listitem><para>Seulement en style procédural : Un
    objet <classname>mysqli</classname> retourné par la fonction <function>mysqli_connect</function>
    ou par la fonction <function>mysqli_init</function></para></listitem></varlistentry>'>

<!ENTITY mysqli.stmt.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    statement</parameter></term><listitem><para>Style procédural uniquement : Un
    objet <classname>mysqli_stmt</classname> retourné par la fonction <function>mysqli_stmt_init</function>.</para>
</listitem></varlistentry>'>

<!ENTITY mysqli.available.mysqlnd 'Disponible uniquement avec <link xmlns="http://docbook.org/ns/docbook"
                                                                    linkend="book.mysqlnd">mysqlnd</link>.'>

<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>MySQLnd s&#39;occupe toujours du jeu de caractères par défaut du serveur. Celui-ci est envoyé durant la négociation de la
    connexion ou l&#39;authentification.</para><para>Libmysqlclient utilise le jeu de caractères par défaut de
    <filename>my.cnf</filename> ou via par un appel à <function>mysqli_options</function> avant
    <function>mysqli_real_connect</function>, mais après <function>mysqli_init</function>.</para></note>'>

<!-- Notes for SAPI/Apache -->
<!ENTITY apache.req.module '<simpara xmlns="http://docbook.org/ns/docbook">Cette fonction
est supportée lorsque PHP est installé comme module d&#39;Apache.
</simpara>'>

<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration '<note xmlns="http://docbook.org/ns/docbook"><simpara>SimpleXML ajoute des propriétés
    itératives pour presque toutes ses méthodes. Celles-ci ne peuvent être vues en
    utilisant <function>var_dump</function> ou tout autre fonction qui examine les
    objets.</simpara></note>'>

<!-- SQLite Notes -->
<!ENTITY sqlite.case-fold '<para xmlns="http://docbook.org/ns/docbook">Les noms de colonnes retournés par
<constant>SQLITE_ASSOC</constant> et <constant>SQLITE_BOTH</constant>
suivent les règles concernant la case définie par l&#39;option de configuration
<link linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link>.</para>'>

<!ENTITY sqlite.decode-bin '<para xmlns="http://docbook.org/ns/docbook">Lorsque <parameter>decode_binary</parameter>
vaut &true; (par défaut), PHP va décoder les données binaires, si elles ont été
codées avec la fonction <function>sqlite_escape_string</function>.
Vous allez généralement laisser cette valeur à sa valeur par défaut,
à moins que vous ne travailliez avec des bases opérées par d&#39;autres
applications.</para>'>

<!ENTITY sqlite.no-unbuffered '<note xmlns="http://docbook.org/ns/docbook"><para>Cette fonction ne fonctionnera pas sur des
    résultats non bufférisés.</para></note>'>

<!ENTITY sqlite.param-compat '<note xmlns="http://docbook.org/ns/docbook"><simpara>Deux syntaxes alternatives sont
    supportées pour assurer la compatibilité avec les autres bases de données
    (telles que MySQL) : la forme recommandée est la première, où le paramètre
    <parameter>dbhandle</parameter> est le premier dans la fonction.</simpara></note>'>

<!ENTITY sqlite.result-type '<para xmlns="http://docbook.org/ns/docbook">Le paramètre optionnel
<parameter>result_type</parameter> accepte une constante et détermine comment
le tableau retourné doit être indexé. L&#39;utilisation de
<constant>SQLITE_ASSOC</constant> retournera uniquement un tableau associatif
(nom des champs) tandis que <constant>SQLITE_NUM</constant> retournera un
tableau indexé numériquement (numéro ordinal des champs).
<constant>SQLITE_BOTH</constant> retournera des indices numériques et associatifs.
<constant>SQLITE_BOTH</constant> est la valeur par défaut pour cette
fonction.</para>'>

<!-- Database Notes -->
<!ENTITY database.field-case '<note xmlns="http://docbook.org/ns/docbook"><simpara>Les noms des champs retournés par
    cette fonction sont <emphasis>sensibles à la casse</emphasis>.</simpara></note>'>

<!ENTITY database.fetch-null '<note xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction définit les champs NULL à la
    valeur PHP &null;.</simpara></note>'>

<!-- MSQL Notes -->
<!-- The msql.*.description entities are used in the parameters refsect1 -->
<!ENTITY msql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    link_identifier</parameter></term><listitem><para>La connexion mSQL.
    S&#39;il n&#39;est pas spécifié, la dernière connexion ouverte avec la fonction
    <function>msql_connect</function> sera utilisée. Si une telle connexion
    n&#39;est pas trouvée, la fonction tentera d&#39;ouvrir une connexion, comme si
    la fonction <function>msql_connect</function> avait été appelée, et
    l&#39;utilise.</para></listitem></varlistentry>'>

<!ENTITY msql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    result</parameter></term><listitem><para>La &resource; de résultat
    qui vient d&#39;être évaluée. Ce résultat vient de l&#39;appel à la fonction
    <function>msql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY msql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    field_offset</parameter></term><listitem><para>La position numérique du champ.
    La position <parameter>field_offset</parameter> commence à <literal>1</literal>.</para></listitem></varlistentry>'>


<!-- MySQL Notes -->
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
<!ENTITY mysql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    link_identifier</parameter></term><listitem><para>La connexion MySQL.
    S&#39;il n&#39;est pas spécifié, la dernière connexion ouverte avec la fonction
    <function>mysql_connect</function> sera utilisée. Si une telle connexion
    n&#39;est pas trouvée, la fonction tentera d&#39;ouvrir une connexion, comme si
    la fonction <function>mysql_connect</function> avait été appelée sans argument.
    Si aucune connexion n&#39;est trouvée ou établie, une alerte
    <constant>E_WARNING</constant> est générée.</para></listitem></varlistentry>'>

<!ENTITY mysql.linkid-noreopen.description '<varlistentry
xmlns="http://docbook.org/ns/docbook"><term><parameter>
    link_identifier</parameter></term><listitem><para>La connexion MySQL.
    Si l&#39;identifiant du lien n&#39;est pas spécifié, le dernier lien ouvert avec
    la fonction <function>mysql_connect</function> sera utilisée. Si aucune
    connexion n&#39;est trouvée ou n&#39;est établie, une alerte de niveau
    <constant>E_WARNING</constant> sera générée.</para></listitem></varlistentry>'>

<!ENTITY mysql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    result</parameter></term><listitem><para>La &resource; de résultat
    qui vient d&#39;être évaluée. Ce résultat vient de l&#39;appel à la fonction
    <function>mysql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY mysql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    field_offset</parameter></term><listitem><para>La position numérique du champ.
    <parameter>field_offset</parameter> commence à <literal>0</literal>. Si
    <parameter>field_offset</parameter> n&#39;existe pas, une alerte
    <constant>E_WARNING</constant> sera également
    générée.</para></listitem></varlistentry>'>

<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">Cette extension
était obsolète en PHP 5.5.0, et a été supprimée en PHP 7.0.0. À la place, vous pouvez
utiliser l&#39;extension <link linkend="book.mysqli">MySQLi</link> ou l&#39;extension
<link linkend="ref.pdo-mysql">PDO_MySQL</link>. Voir aussi
<link linkend="mysqlinfo.api.choosing">MySQL : choisir une API</link> du guide.
Alternatives à cette fonction :</para>'>

<!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Cette fonction était obsolète
en PHP 4.3.0, et la totalité de <link linkend="book.mysql">l&#39;extension original MySQL</link> a été supprimée en PHP 7.0.0.
À la place, vous pouvez utiliser soit l&#39;extension <link linkend="book.mysqli">MySQLi</link>, soit l&#39;extension
<link linkend="ref.pdo-mysql">PDO_MySQL</link>. Voir aussi <link linkend="mysqlinfo.api.choosing">MySQL : choisir
une API</link> du guide. Alternatives à cette fonction :</para>'>

<!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Cette fonction était obsolète
en PHP 5.3.0, et la totalité de <link linkend="book.mysql">l&#39;extension original MySQL</link> a été supprimée en PHP 7.0.0.
À la place, vous pouvez utiliser soit l&#39;extension <link linkend="book.mysqli">MySQLi</link>, soit l&#39;extension
<link linkend="ref.pdo-mysql">PDO_MySQL</link>. Voir aussi <link linkend="mysqlinfo.api.choosing">MySQL : choisir
une API</link> du guide.
Alternatives à cette fonction :</para>'>

<!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">Cette fonction était obsolète
en PHP 5.4.0, et la totalité de <link linkend="book.mysql">l&#39;extension original MySQL</link> a été supprimée en PHP 7.0.0.
À la place, vous pouvez utiliser soit l&#39;extension <link linkend="book.mysqli">MySQLi</link>, soit l&#39;extension
<link linkend="ref.pdo-mysql">PDO_MySQL</link>. Voir aussi <link linkend="mysqlinfo.api.choosing">MySQL : choisir
    une API</link> du guide. Alternatives à cette fonction :</para>'>

<!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook">Cette fonction était obsolète
en PHP 5.5.0, et la totalité de <link linkend="book.mysql">l&#39;extension original MySQL</link> a été supprimée en PHP 7.0.0.
À la place, vous pouvez utiliser soit l&#39;extension <link linkend="book.mysqli">MySQLi</link>, soit l&#39;extension
<link linkend="ref.pdo-mysql">PDO_MySQL</link>. Voir aussi <link linkend="mysqlinfo.api.choosing">MySQL : choisir
    une API</link> du guide. Alternatives à cette fonction :</para>'>

<!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
Les connexions et les jeux de résultats ouverts de façon non persistantes sont automatiquement
détruits lorsqu&#39;un script PHP termine son exécution. Aussi, le fait de fermer une connexion
et libérer les résultats étant optionnel, le fait de le faire explicitement est néanmoins vivement
recommandé. Ceci va retourner les ressources immédiatement à PHP et à MySQL, ce qui va améliorer les
performance. Pour plus d&#39;informations, référez-vous à la
<link linkend="language.types.resource.self-destruct">libération des ressources</link></para>'>

<!-- Sybase Notes -->
<!ENTITY sybase.ct.only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction n&#39;est disponible
    qu&#39;avec la bibliothèque CT Sybase, et non pas avec la bibliothèque DB.
</simpara></note>'>
<!ENTITY sybase.db.only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction n&#39;est disponible
    qu&#39;avec la bibliothèque DB Sybase, et non pas avec la bibliothèque CT.
</simpara></note>'>

<!ENTITY sybase.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    link_identifier</parameter></term><listitem><para>La connexion Sybase.
    S&#39;il n&#39;est pas spécifié, la dernière connexion ouverte avec la fonction
    <function>sybase_connect</function> sera utilisée. Si une telle connexion
    n&#39;est pas trouvée, la fonction tentera d&#39;ouvrir une connexion, comme si
    la fonction <function>sybase_connect</function> avait été appelée sans argument.
    Si aucune connexion n&#39;est trouvée ou établie, une alerte
    <constant>E_WARNING</constant> est générée.</para></listitem>
</varlistentry>'>

<!-- CPDF Notes -->
<!ENTITY cpdf.ul '<para xmlns="http://docbook.org/ns/docbook">Le paramètre optionnel <parameter>mode</parameter>
détermine la longueur de l&#39;unité. S&#39;il prend la valeur <literal>0</literal> (ou s&#39;il
est omis), c&#39;est la valeur par défaut définie pour la page qui est utilisée.
Sinon, les coordonnées sont mesurées en points PostScript sans se préoccuper de
l&#39;unité courante.</para>'>

<!ENTITY cpdf.mode.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    mode</parameter></term><listitem><para>Le paramètre optionnel <parameter>mode</parameter>
    détermine la longueur de l&#39;unité. S&#39;il vaut 0 ou s&#39;il est omis, l&#39;unité par défaut tel que
    spécifié pour la page sera utilisé. Sinon, les coordonnées seront mesurées en points
    PostScript sans tenir compte de l&#39;unité courante.</para></listitem></varlistentry>'>

<!ENTITY cpdf.pdf-document.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    pdf_document</parameter></term><listitem><para>Le gestionnaire de document, retourné par la fonction
    <function>cpdf_open</function>.</para></listitem></varlistentry>'>

<!-- Xattr entities -->
<!ENTITY xattr.namespace '<para xmlns="http://docbook.org/ns/docbook">Les attributs étendus ont deux espaces de noms
différents : <literal>user</literal> et <literal>root</literal>. L&#39;espace de noms
<literal>user</literal> est disponible pour tous les utilisateurs tandis que l&#39;espace de
noms <literal>root</literal> n&#39;est disponible que pour les utilisateurs ayant les privilèges
<literal>root</literal>. xattr opère sur l&#39;espace de noms <literal>user</literal> par
défaut, mais vous pouvez changer cela en utilisant l&#39;argument
<parameter>flags</parameter>.</para>'>

<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets '<note xmlns="http://docbook.org/ns/docbook"><simpara>Lors de la spécification d&#39;adresses
    IPv6 au format numérique (e.g. <literal>fe80::1</literal>) vous devez placer l&#39;adresse IP
    entre crochets. Par exemple : <literal>tcp://[fe80::1]:80</literal>.
</simpara></note>'>

<!ENTITY ipv6.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>Le support des adresses IPv6 a été ajouté en
    PHP 5.0.</simpara></note>'>

<!-- Notes for tidy -->
<!ENTITY tidy.object 'L&#39;objet <classname xmlns="http://docbook.org/ns/docbook">Tidy</classname>'>

<!ENTITY tidy.conf-enc '<para xmlns="http://docbook.org/ns/docbook">Le paramètre <parameter>config</parameter> peut
prendre la forme d&#39;un tableau ou d&#39;une chaîne de caractères. Sous forme
de chaîne, il représente le nom du fichier de configuration et sinon, c&#39;est
un tableau avec les options de configuration. Lisez <link xmlns:xlink="http://www.w3.org/1999/xlink"
                                                          xlink:href="&url.tidy.conf;">&url.tidy.conf;</link> pour en savoir plus sur chaque
option.</para>
<para>Le paramètre <parameter>encoding</parameter> spécifie le jeu de caractères
utilisé pour les documents en entrées et sorties. Les valeurs possibles de
<parameter>encoding</parameter> sont :
<literal>ascii</literal>, <literal>latin0</literal>, <literal>latin1</literal>,
<literal>raw</literal>, <literal>utf8</literal>, <literal>iso2022</literal>,
<literal>mac</literal>, <literal>win1252</literal>, <literal>ibm858</literal>,
<literal>utf16</literal>, <literal>utf16le</literal>,
<literal>utf16be</literal>, <literal>big5</literal> et
<literal>shiftjis</literal>.</para>'>

<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat '<warning xmlns="http://docbook.org/ns/docbook"><para>Nous ne recommandons pas
    l&#39;utilisation de PHP dans un environnement threadé MPM, avec Apache 2.
    Utilisez le mode prefork MPM, qui est le MPM par défaut pour Apache 2.0 et 2.2.
    Pour savoir pourquoi, lisez
    l&#39;entrée de la FAQ correspondante à l&#39;<link linkend="faq.installation.apache2">utilisation
        d&#39;Apache 2 dans un environnement threadé MPM</link>.</para></warning>'>

<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara>Souvenez-vous que lorsque vous ajoutez
    des valeurs représentants un chemin dans la configuration d&#39;Apache sous Windows,
    tous les antislash, comme <filename>c:\repertoire\fichier.ext</filename>, devraient être
    convertis en slashes, comme
    <filename>c:/repertoire/fichier.ext</filename>. Un slash final peut
    également être nécessaire pour les dossiers.</simpara></note>'>

<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors 'Auteurs et Contributeurs'>

<!ENTITY Credit.Introduction '<para xmlns="http://docbook.org/ns/docbook">Nous mettons en avant les personnes les
plus actives dans la préface du manuel mais il y a bien plus de contributeurs
qui nous aident actuellement dans notre travail ou qui ont fournis une aide
précieuse au projet dans le passé. Il y a beaucoup d&#39;inconnus qui nous ont
aidés à travers leurs notes concernant les pages du manuel qui sont
continuellement incluses dans le manuel, travail dont nous sommes très
reconnaissants. La liste fournie ci-dessous est classée par ordre
alphabétique.</para>'>

<!ENTITY Credit.Authors.and.Editors 'Auteurs et Éditeurs'>

<!ENTITY Credit.Past.Authors.Text 'Les contributeurs suivants
        ont eu un impact énorme en ajoutant du contenu dans le manuel :'>

<!ENTITY Credit.Past.Editors.Text 'Les contributeurs suivants
        ont énormément aidé dans l&#39;édition du manuel :'>

<!ENTITY Credit.Note.Editors.Title 'Mainteneurs des notes utilisateurs'>

<!ENTITY Credit.Note.Editors.Active 'Les mainteneurs actuellement les plus actifs sont :'>

<!ENTITY Credit.Note.Editors.Inactive 'Ces personnes ont également déployé énormément
        d&#39;efforts dans le maintien des notes utilisateurs :'>

<!ENTITY listendand ' et'>

<!-- classkit and runkit entities -->
<!ENTITY note.classkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction ne peut
    pas être utilisée pour manipuler la méthode en cours (ou liée) d&#39;exécution.</simpara>
</note>'>

<!ENTITY note.runkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction
    ne peut être utilisée pour manipuler la méthode en cours d&#39;utilisation (ou chaînée).</simpara>
</note>'>

<!ENTITY note.runkit.sandbox '<note xmlns="http://docbook.org/ns/docbook"><simpara>Support Sandbox (requis pour
    <function>runkit_lint</function>, <function>runkit_lint_file</function>
    et la classe <classname>Runkit_Sandbox</classname>) n&#39;est seulement disponible
    qu&#39;avec PHP 5.1 ou les versions de PHP 5.0 spécialement patché et
    nécessite que la protection de thread soit activée. Voyez le fichier <filename>README</filename>
    inclus dans le paquetage runkit pour plus d&#39;informations.
</simpara></note>'>

<!ENTITY note.runkit.internal-override '<note xmlns="http://docbook.org/ns/docbook"><simpara>Par défaut, seulement
    les fonctions définies par l&#39;utilisateur peuvent être supprimées,
    renommées ou modifiées. Afin de surcharger des fonctions internes, vous
    devez activer la configuration <literal>runkit.internal_override</literal>
    dans le fichier &php.ini; du système entier.</simpara></note>'>

<!-- SSH2 Extension -->
<!ENTITY note.ssh2.subsystem.publickey '<note xmlns="http://docbook.org/ns/docbook"><simpara>Le publickey subsystem
    est utilisé pour gérer les clés publiques sur un serveur sur lequel le client
    est <emphasis>déjà</emphasis> identifié. Pour s&#39;identifier à un system
    distant en utilisant l&#39;identification par clé publique, utilisez la fonction
    <function>ssh2_auth_pubkey_file</function> à la place.</simpara></note>'>

<!-- Session notes -->
<!ENTITY returns.session.storage.retval 'La valeur retournée (habituellement &true; en cas de succès, &false; si une erreur survient).
        Notez que cette valeur est retournée en interne à PHP pour analyse.'>

<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
    writer</parameter></term><listitem><para>Uniquement pour les appels procéduraux.
L&#39;instance <classname>XMLWriter</classname> qui est modifiée. Cet objet provient d&#39;un appel à <function>xmlwriter_open_uri</function> ou <function>xmlwriter_open_memory</function>.</para></listitem></varlistentry>'>

<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>writer</parameter> attend une instance de <classname>XMLWriter</classname>
  désormais; auparavant, une <type>resource</type> était attendu.
 </entry>
</row>'> 

<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only "<note xmlns='http://docbook.org/ns/docbook'><para>Cette fonction n'est disponible qu&#39;en mode WSDL.</para></note>">

<!-- Stomp notes -->
<!ENTITY stomp.param.link "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>link</parameter></term><listitem><para>Style procédural uniquement : L&#39;identifiant stomp retourné par la fonction<function>stomp_connect</function>.</para></listitem></varlistentry>">
<!ENTITY stomp.param.headers "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>headers</parameter></term><listitem><para>Tableau associatif contenant les en-têtes additionnels (exemple : receipt).</para></listitem></varlistentry>">
<!ENTITY stomp.note.transaction "<note xmlns='http://docbook.org/ns/docbook'><para>Un en-tête de transaction peut être spécifié, indiquant que la confirmation des messages doit faire partie de la transaction.</para></note>">
<!ENTITY stomp.note.sync "<tip xmlns='http://docbook.org/ns/docbook'><simpara>Stomp est, par nature, asynchrone. Une communication synchrone peut être implémentée en ajoutant un en-tête <literal>receipt</literal>. Ceci fera que les méthodes ne retourneront rien tant que le message de confirmation n&#39;aura pas été reçu ou tant que le délai d&#39;attente ne sera pas atteint.</simpara></tip>">

<!-- SVN notes -->
<!ENTITY svn.relativepath "<note xmlns='http://docbook.org/ns/docbook'><simpara>Les chemins relatifs peuvent être résolus
    si le dossier de travail courant est l&#39;un de ceux qui contiennent le binaire PHP.
    Pour utiliser le dossier de travail, utilisez la fonction <function>realpath</function>,
    ou l&#39;instruction dirname(__FILE__).</simpara></note>">
<!ENTITY svn.referto.status 'Référez-vous aux
<link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">constantes de statut</link> pour les valeurs possibles.'>
<!ENTITY svn.referto.type 'Référez-vous aux <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">constantes de type</link> pour les valeurs possibles.'>

<!-- FANN notes -->
<!ENTITY fann.ann.description '<para xmlns="http://docbook.org/ns/docbook">Ressource de réseau de neurones.</para>'>
<!ENTITY fann.train.description '<para xmlns="http://docbook.org/ns/docbook">Ressource de données d&#39;entrainement du réseau de neurones.</para>'>
<!ENTITY fann.errdat.description '<para xmlns="http://docbook.org/ns/docbook">Soit une ressource de réseau de neurones, soit une ressource de données d&#39;entrainement d&#39;un réseau de neurones.</para>'>
<!ENTITY fann.return.void '<para xmlns="http://docbook.org/ns/docbook">Aucune valeur retournée.</para>'>
<!ENTITY fann.return.bool '<para xmlns="http://docbook.org/ns/docbook">Retourne &true; en cas de succès, &false; sinon.</para>'>
<!ENTITY fann.return.ann '<para xmlns="http://docbook.org/ns/docbook">Retourne une ressource de réseau de neurones en cas de succès, ou &false; si une erreur survient.</para>'>
<!ENTITY fann.return.train '<para xmlns="http://docbook.org/ns/docbook">Retourne une ressource de données d&#39;entrainement en cas de succès, ou &false; si une erreur survient.</para>'>
<!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>Cette fonction est maintenant disponible si l&#39;extension fann a été compilée
avec libfann &gt;= 2.2.</para></note>'>

<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'Retourne &true; en cas de succès.'>
<!ENTITY imagick.imagick.throws 'Lance une exception <classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname> si une erreur survient.'>
<!ENTITY imagick.imagickdraw.throws 'Lance une exception <classname xmlns="http://docbook.org/ns/docbook">ImagickDrawException</classname> si une erreur survient.'>
<!ENTITY imagick.imagickpixel.throws 'Lance une exception <classname xmlns="http://docbook.org/ns/docbook">ImagickPixelException</classname> si une erreur survient.'>
<!ENTITY imagick.imagickpixeliterator.throws 'Lance une exception <classname xmlns="http://docbook.org/ns/docbook">ImagickPixelIteratorException</classname> si une erreur survient.'>

<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.2.9 ou supérieur.'>
<!ENTITY imagick.method.available.0x631 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.3.1 ou supérieur.'>
<!ENTITY imagick.method.available.0x632 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.3.2 ou supérieur.'>
<!ENTITY imagick.method.available.0x636 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.3.6 ou supérieur.'>
<!ENTITY imagick.method.available.0x637 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.3.7 ou supérieur.'>
<!ENTITY imagick.method.available.0x638 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.3.8 ou supérieur.'>
<!ENTITY imagick.method.available.0x639 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.3.9 ou supérieur.'>
<!ENTITY imagick.method.available.0x640 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.4.0 ou supérieur.'>
<!ENTITY imagick.method.available.0x641 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.4.1 ou supérieur.'>
<!ENTITY imagick.method.available.0x642 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.4.2 ou supérieur.'>
<!ENTITY imagick.method.available.0x643 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.4.3 ou supérieur.'>
<!ENTITY imagick.method.available.0x644 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.4.4 ou supérieur.'>
<!ENTITY imagick.method.available.0x645 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.4.5 ou supérieur.'>
<!ENTITY imagick.method.available.0x647 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.4.7 ou supérieur.'>
<!ENTITY imagick.method.available.0x649 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.4.9 ou supérieur.'>
<!ENTITY imagick.method.available.0x653 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.5.3 ou supérieur.'>
<!ENTITY imagick.method.available.0x657 'Cette méthode n&#39;est disponible que si Imagick a été compilé avec ImageMagick version 6.5.7 ou supérieur.'>

<!ENTITY imagick.method.not.available.0x700 'Cette méthode n&#39;est pas disponible si Imagick a été compilé avec ImageMagick version 7.0.0 ou supérieur.'>

<!ENTITY imagick.constant.available 'Cette constante n&#39;est disponible que si Imagick a été compilé avec ImageMagick version'>

<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de Imagick 3.4.4. Dépendre de cette fonctionnalité est fortement déconseillé.</simpara></warning>'> 

<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info 'Par défaut, vaut <constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>. Reportez-vous à la liste des <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">constantes de canaux</link>'>

<!-- Fuzz parameter -->
<!ENTITY imagick.parameter.fuzz 'La quantité de poussière de papier. Par exemple, le fait de définir la poussière de papier à 10 et la couleur rouge à une intensité de 100 et de 102 ne sera pas interprété comme la même couleur.'>

<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel 'Fournit une constante de canal valide pour votre mode de canal. Pour l&#39;appliquer à plus d&#39;un canal, combinez les <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">constantes de canaux</link> en utilisant un opérateur sur les bits. &imagick.default.channel.info;'>

<!-- Alpha parameter -->
<!ENTITY imagick.parameter.alpha 'Le degré de transparence : 1.0 correspond à totalement opaque et 0.0 à totalement transparent.'>

<!ENTITY imagick.imagickexception.throw 'Émet une exception
<classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname> en cas d&#39;échec.'>

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    Le comportement du paramètre <parameter>bestfit</parameter> a changé avec Imagick 3.0.0.
    Avant cette version, fournir les dimensions 400x400 à une image de dimensions 200x150
    faisait que la partie gauche était inchangée. Avec Imagick 3.0.0 et suivants, l&#39;image
    est réduite à la taille 400x300, sachant que c&#39;est le meilleur résultat pour ces
    dimensions. Si le paramètre <parameter>bestfit</parameter> est utilisé, la largeur
    et la hauteur doivent être fournies.
</simpara>
</note>'>

<!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    Vous devez avoir un fichier <filename>openssl.cnf</filename> valide et
    installé pour que cette fonction opère correctement.
    Voir les notes se trouvant dans la <link linkend="openssl.installation">section
    concernant l&#39;installation</link> pour plus d&#39;informations.
</simpara>
</note>'>
<!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook">
Le paramètre optionnel <parameter>notext</parameter> affecte le niveau verbeux de l&#39;affichage ;
s&#39;il vaut &false;, des informations humainement lisibles seront ajoutées dans l&#39;affichage.
Par défaut, le paramètre <parameter>notext</parameter> vaut &true;.
</para>'>

<!-- COM/Dotnet -->
<!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook">
<para>
    Comme pour toutes les fonctions arithmétiques, les paramètres pour cette fonction
    peuvent être soit un type PHP natif (entier, chaîne de caractères, nombre à virgule flottante,
    booléen ou &null;), ou une instance de la classe COM, VARIANT ou DOTNET. Les types PHP natifs
    seront convertis en VARIANT en utilisant les mêmes règles que celles trouvées dans le
    constructeur de la classe <xref linkend="class.variant"/>. Les objets COM et DOTNET
    auront la valeur de leur propriété par défaut récupérée et utilisée en tant que valeur VARIANT.
</para>
<para>
    Les fonctions arithmétiques VARIANT sont interfacées sur les fonctions de la bibliothèque
    COM équivalentes ; pour plus d&#39;informations sur ces fonctions, veuillez consulter
    la bibliothèque MSDN. Les fonctions PHP sont nommées de façon légèrement différentes :
    par exemple, <function>variant_add</function>, en PHP, correspond à
    <literal>VarAdd()</literal> dans la documentation MSDN.
</para>
</note>
'>
<!ENTITY com.use-oo-instead '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    Cette fonction n&#39;existe pas en PHP 5 ; à la place, vous devriez utiliser
    la syntaxe OO pour accéder aux propriétés ou appeler les méthodes.
</simpara>
</note>
'>

<!-- phar -->
<!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"><para>Cette
    méthode nécessite que la variable de configuration INI <literal>phar.readonly</literal>
    soit définie à &zero; pour fonctionner avec les objets <classname>Phar</classname>.
    Sinon, une exception <classname>PharException</classname> sera lançée.</para></note>'>

<!ENTITY phar.removed.pharcompress '<note xmlns="http://docbook.org/ns/docbook"><para>
    Cette méthode a été supprimée de l&#39;extension phar depuis la version 2.0.0. Vous
    pouvez utiliser <function>Phar::compress</function>, <function>Phar::decompress</function>,
    <function>Phar::compressFiles</function> et <function>Phar::decompressFiles</function>
    à la place.</para></note>'>

<!ENTITY phar.removed.pharfileinfocompress '<note xmlns="http://docbook.org/ns/docbook"><para>
    Cette méthode a été supprimée de l&#39;extension phar depuis la version 2.0.0. Vous
    pouvez utiliser <function>PharFileInfo::isCompressed</function>,
    <function>PharFileInfo::decompress</function>, et <function>PharFileInfo::compress</function>
    à la place.</para></note>'>

<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>Phar::addFile</function>, <function>Phar::addFromString</function> et <function>Phar::offsetSet</function>
  enregistre une nouvelle archive phar à chaque fois qu&#39;elles sont appelées. Si les performances sont une préoccupation,
  <function>Phar::buildFromDirectory</function> ou <function>Phar::buildFromIterator</function>
  devraient être utilisé à la place.
 </simpara>
</note>'>

<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>PharData::addFile</function>, <function>PharData::addFromString</function> et <function>PharData::offsetSet</function>
  enregistre une nouvelle archive phar à chaque fois qu&#39;elles sont appelées. Si les performances sont une préoccupation,
  <function>PharData::buildFromDirectory</function> ou <function>PharData::buildFromIterator</function>
  devraient être utilisé à la place.
 </simpara>
</note>'>

<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">
 Cette extension requière l&#39;extension PHP <link linkend="book.libxml">libxml</link>.
 Ceci signifie passer l&#39;option de configuration
 <option role="configure">--with-libxml</option>, ou antérieur à PHP 7.4
 l&#39;option de configuration <option role="configure">--enable-libxml</option>,
 bien que ceci est accomplie implicitement car libxml est activé par défaut.
</para>'>

<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note '<caution xmlns="http://docbook.org/ns/docbook"><para>Cette fonction n&#39;est disponible que
    si PHP est compilé à l&#39;aide de la librarie libxml 20620 ou ultérieure.</para></caution>'>

<!-- inotify -->
<!ENTITY inotify.instance.description 'Ressource returnée par
<function xmlns="http://docbook.org/ns/docbook">inotify_init</function>'>

<!-- User streams -->
<!ENTITY userstream.not.implemented.warning '<para xmlns="http://docbook.org/ns/docbook">Émet une alerte
<constant>E_WARNING</constant> si l&#39;appel à cette méthode échoue
(i.e. pas implémenté).</para>'>

<!ENTITY userstream.updates.context '<note xmlns="http://docbook.org/ns/docbook"><para>La propriété
    <varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
    est mise à jour si un contexte valide est passé à la fonction.</para></note>'>

<!-- Gmagick -->
<!ENTITY gmagick.return.success 'Retourne &true; en cas de succès.'>
<!ENTITY gmagick.gmagickexception.throw 'Émet une exception
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname> en cas d&#39;erreur.'>

<!-- Reflection -->
<!ENTITY reflection.export.return 'Si le paramètre <parameter xmlns="http://docbook.org/ns/docbook">return</parameter>
        est défini à &true;, l&#39;export sera retourné sous la forme d&#39;une &string;,
        sinon, &null; sera retourné.'>

<!ENTITY reflection.export.param.return 'Le fait de le définir à &true; retournera
        l&#39;export plutôt que l&#39;émission. Le définir à &false; (par défaut) fera l&#39;inverse.'>

<!ENTITY reflection.invoke.reference 'Si la fonction a des arguments qui ont besoin d&#39;être
        des références, alors ils doivent être passés par références dans la liste des arguments.'>

<!ENTITY reflection.export.param.name 'La réflection à exporter.'>

<!-- SPL -->
<!ENTITY spl.datastructures.intro.title '<title xmlns="http://docbook.org/ns/docbook">Structures des données</title>'>

<!ENTITY spl.exceptions.intro.title '<title xmlns="http://docbook.org/ns/docbook">Exceptions</title>'>
<!ENTITY spl.exceptions.intro '<para xmlns="http://docbook.org/ns/docbook">SPL fournit un jeu d&#39;exceptions standards.</para><para xmlns="http://docbook.org/ns/docbook">Voir aussi le mot réservé <xref linkend="reserved.exceptions" /></para>'>

<!ENTITY spl.files.intro.title '<title xmlns="http://docbook.org/ns/docbook">Gestion des fichiers</title>'>
<!ENTITY spl.files.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para>SPL fournit des classes pour travailler sur les fichiers.</para></partintro>'>

<!ENTITY spl.interfaces.intro.title '<title xmlns="http://docbook.org/ns/docbook">Interfaces</title>'>
<!ENTITY spl.interfaces.intro '<para xmlns="http://docbook.org/ns/docbook">SPL fournit un jeu d&#39;interfaces.</para><para xmlns="http://docbook.org/ns/docbook">Voir aussi le mot réservé <xref linkend="reserved.interfaces" /></para>'>
<!ENTITY spl.interfaces.list '<title xmlns="http://docbook.org/ns/docbook">Liste des interfaces</title>'>

<!ENTITY spl.iterators.intro.title '<title xmlns="http://docbook.org/ns/docbook">Itérateurs</title>'>
<!ENTITY spl.iterators.intro '<para xmlns="http://docbook.org/ns/docbook">SPL fournit un jeu d&#39;itérateurs pour gérer les objets.</para>'>

<!ENTITY spl.misc.intro.title '<title xmlns="http://docbook.org/ns/docbook">Classes et interfaces diverses</title>'>
<!ENTITY spl.misc.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para>Classes et interfaces qui n&#39;appartiennent pas aux autres catégories SPL.</para></partintro>'>

<!-- ZIP -->
<!ENTITY zip.filename.separator '<note xmlns="http://docbook.org/ns/docbook"><simpara>Pour une portabilité maximale, il est recommandé de toujours utiliser des barres obliques (<literal>/</literal>) comme séparateur de dossier dans les noms de fichiers zip.</simpara></note>'>

<!-- Win32Service -->
<!ENTITY win32service.false.error ', &false; if there is a problem with the parameters or a <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 Error Code</link> on failure.'>
<!ENTITY win32service.success.false.error 'Returns &true; on success&win32service.false.error;'>
<!ENTITY win32service.noerror.false.error 'retournait <constant xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant> on success&win32service.false.error;'>

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<para xmlns="http://docbook.org/ns/docbook">
Le <acronym>MIB</acronym> définit le type de chaque identifiant d&#39;objets. Il doit
être spécifié sous la forme d&#39;un simple caractère depuis la liste suivante.
</para>
<table xmlns="http://docbook.org/ns/docbook">
<title>types</title>
<tgroup cols="2">
    <tbody>
        <row><entry>=</entry><entry>Le type est récupéré depuis le MIB</entry></row>
        <row><entry>i</entry><entry>INTEGER</entry> </row>
        <row><entry>u</entry><entry>INTEGER</entry></row>
        <row><entry>s</entry><entry>STRING</entry></row>
        <row><entry>x</entry><entry>HEX STRING</entry></row>
        <row><entry>d</entry><entry>DECIMAL STRING</entry></row>
        <row><entry>n</entry><entry>NULLOBJ</entry></row>
        <row><entry>o</entry><entry>OBJID</entry></row>
        <row><entry>t</entry><entry>TIMETICKS</entry></row>
        <row><entry>a</entry><entry>IPADDRESS</entry></row>
        <row><entry>b</entry><entry>BITS</entry></row>
    </tbody>
</tgroup>
</table>
<para xmlns="http://docbook.org/ns/docbook">
Si la constante <constant>OPAQUE_SPECIAL_TYPES</constant> a été définie lors
de la compilation de la bibliothèque <acronym>SNMP</acronym>, les caractères suivants
seront également disponibles :
</para>
<table xmlns="http://docbook.org/ns/docbook">
<title>types</title>
<tgroup cols="2">
    <tbody>
        <row><entry>U</entry><entry>int64 non-signé</entry></row>
        <row><entry>I</entry><entry>int64 signé</entry></row>
        <row><entry>F</entry><entry>float</entry></row>
        <row><entry>D</entry><entry>double</entry></row>
    </tbody>
</tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping '<para xmlns="http://docbook.org/ns/docbook">
La plupart de ces valeurs utilise le type ASN.1 correspondant. &apos;s&apos;, &apos;x&apos;, &apos;d&apos; et &apos;b&apos;
sont toutes des façons différentes de spécifier la valeur OCTET STRING et le type non-signé
&apos;u&apos; est également utilisé pour gérer les valeurs Gauge32.
</para>
'>
<!ENTITY snmp.set.type.values.equal.note '<para xmlns="http://docbook.org/ns/docbook">
Si les fichiers MIB sont chargés dans l&#39;arbre MIB avec "snmp_read_mib" ou en les spécifiant
dans la configuration de libsnmp, &apos;=&apos; pourra être utilisé comme paramètre
de type pour tous les identifiants d&#39;objets, vu que le type peut automatiquement être lu depuis le MIB.
</para>
'>
<!ENTITY snmp.set.type.values.bitset.note '<para xmlns="http://docbook.org/ns/docbook">
Notez qu&#39;il y a 2 façons de définir une variable de type BITS like i.e.
"SYNTAX    BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
<listitem>
    <simpara>
        En utilisant le type "b" et une liste d&#39;octets. Cette méthode n&#39;est pas
        recommandée vu que la requête GET pour un même OID retournera i.e. 0xF8.
    </simpara>
</listitem>
<listitem>
    <simpara>
        En utilisant le type "x" et un nombre hexadécimal mais sans(!) le préfixe usuel
        "0x".
    </simpara>
</listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
Reportez-vous à la section sur les exemples pour plus de détails.
</para>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect '<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<para>
    Cette méthode ne lance aucune exception par défaut.
    Pour activer l&#39;émission d&#39;exceptions SNMPException lorsque
    des erreurs de la bibliothèque surviennent,
    le paramètre de la classe SNMP <parameter>exceptions_enabled</parameter>
    doit être défini à la valeur correspondante. Voir les <link linkend="snmp.props.exceptions-enabled">
    explications sur <parameter>SNMP::$exceptions_enabled</parameter></link>
    pour plus de détails.
</para>
</refsect1>
'>

 <!-- Eio -->
<!ENTITY eio.callback.proto '<para xmlns="http://docbook.org/ns/docbook">
La fonction de rappel <parameter xmlns="http://docbook.org/ns/docbook">callback</parameter>
est appelée lorsque la requête est terminée.
Elle doit correspondre au prototype suivant : <programlisting role="php"><![CDATA[
void callback(mixed $data, int $result[, resource $req]);
]]></programlisting>
<variablelist xmlns="http://docbook.org/ns/docbook">
    <varlistentry xmlns="http://docbook.org/ns/docbook">
        <term><parameter>data</parameter></term>
        <listitem><para>représente les données personnalisées passées à la requête.</para></listitem>
    </varlistentry>
    <varlistentry xmlns="http://docbook.org/ns/docbook">
        <term><parameter>result</parameter></term>
        <listitem><para>représente la valeur résultante spécifique à la requête ; basiquement,
            la valeur retournée par l&#39;appel système correspondant.</para></listitem>
    </varlistentry>
    <varlistentry xmlns="http://docbook.org/ns/docbook">
        <term><parameter>req</parameter></term>
        <listitem><para>est la ressource optionnelle de la requête qui peut être
            utilisée avec les fonctions comme <function>eio_get_last_error</function></para></listitem>
    </varlistentry>
</variablelist>
</para>
'>

<!ENTITY eio.request.pri.values '<para
xmlns="http://docbook.org/ns/docbook">La priorité de la requête : <constant
        xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>, <constant
        xmlns="http://docbook.org/ns/docbook">EIO_PRI_MIN</constant>, <constant
        xmlns="http://docbook.org/ns/docbook">EIO_PRI_MAX</constant>, ou &null;.
Si &null; est passé, le paramètre <parameter
        xmlns="http://docbook.org/ns/docbook">pri</parameter>, en interne, est défini à
<constant xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>.
</para>
'>

<!ENTITY eio.warn.relpath '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Éviter les
    chemin relatif !</simpara></warning>
'>

<!ENTITY trader.arg.array.of.real 'Tableau de valeurs réelles.'>
<!ENTITY trader.arg.array.of.real.high 'Prix élevé, tableau de valeurs réelles.'>
<!ENTITY trader.arg.array.of.real.low 'Prix bas, tableau de valeurs réelles.'>
<!ENTITY trader.arg.array.of.real.close 'Prix fermé, tableau de valeurs réelles.'>
<!ENTITY trader.arg.array.of.real.open 'Prix ouvert, tableau de valeurs réelles.'>
<!ENTITY trader.arg.array.of.real.volume 'Volume échangé, tableau de valeurs réelles.'>
<!ENTITY trader.arg.array.of.real.periods 'Tableau de valeurs réelles.'>
<!ENTITY trader.arg.penetration 'Pourcentage de pénétration d&#39;une bougie dans une autre bougie.'>
<!ENTITY trader.arg.vfactor 'Facteur de volume. Intervalle valide : 1 à 0.'>
<!ENTITY trader.arg.time.period 'Nombre de période. Intervalle valide : 2 à 100000.'>
<!ENTITY trader.arg.fast.period 'Nombre de période pour le fast MA. Intervalle valide : 2 à 100000.'>
<!ENTITY trader.arg.slow.period 'Nombre de période pour le MA. Intervalle valide : 2 à 100000.'>
<!ENTITY trader.arg.signal.period 'Lissage de la ligne du signal (nombre de période). Intervalle valide : 1 à 100000.'>
<!ENTITY trader.arg.fastk.period 'Période de temps pour construire la ligne Fast-K. Intervalle valide : 1 à 100000.'>
<!ENTITY trader.arg.fastd.period 'Lissage pour réaliser la ligne Fast-D. Intervalle valide : 1 à 100000, habituellement défini à 3.'>
<!ENTITY trader.arg.slowk.period 'Lissage pour réaliser la ligne Slow-K. Intervalle valide : 1 à 100000, habituellement défini à 3.'>
<!ENTITY trader.arg.slowd.period 'Lissage pour réaliser la ligne Slow-D. Intervalle valide : 1 à 100000.'>
<!ENTITY trader.arg.min.period 'Une valeur inférieure au minimum sera modifiée en la période minimum. Intervalle valide : 2 à 100000'>
<!ENTITY trader.arg.max.period 'Une valeur supérieure au minimum sera modifiée en la période maximale. Intervalle valide : 2 à 100000'>
<!ENTITY trader.arg.ma.type 'Type de moyenne mobile. Une constante de la série <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> doit être utilisée.'>
<!ENTITY trader.arg.fast.ma.type 'Type de moyenne mobile pour fast MA. Une constante de la série <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> doit être utilisée.'>
<!ENTITY trader.arg.slow.ma.type 'Type de moyenne mobile pour slow MA. Une constante de la série <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> doit être utilisée.'>
<!ENTITY trader.arg.fastd.ma.type 'Type de moyenne mobile pour Fast-D. Une constante de la série <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> doit être utilisée.'>
<!ENTITY trader.arg.slowk.ma.type 'Type de moyenne mobile pour Slow-K. Une constante de la série <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> doit être utilisée.'>
<!ENTITY trader.arg.slowd.ma.type 'Type de moyenne mobile pour Slow-D. Une constante de la série <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> doit être utilisée.'>
<!ENTITY trader.arg.slowk.ma.type 'Type de moyenne mobile pour Slow-K. Une constante de la série <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> doit être utilisée.'>
<!ENTITY trader.arg.signal.ma.type 'Type de moyenne mobile pour la ligne du signal. Une constante de la série <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> doit être utilisée.'>

<!ENTITY trader.arg.nbdevup 'Multiplicateur d&#39;écart pour la bande supérieure. Intervalle valide : <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> à <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.nbdevdn 'Multiplicateur d&#39;écart pour la bande inférieure. Intervalle valide : <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> à <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.fast.limit 'Limite supérieure de l&#39;algorithme adaptatif. Intervalle valide : 0.01 à 0.99.'>
<!ENTITY trader.arg.slow.limit 'Limite inférieure de l&#39;algorithme adaptatif. Intervalle valide : 0.01 à 0.99.'>

<!-- Mongo -->
<!ENTITY mongo.setreadpreference.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>read_preference</parameter></term><listitem><para>Le mode de préférence de lecture : <constant>MongoClient::RP_PRIMARY</constant>, <constant>MongoClient::RP_PRIMARY_PREFERRED</constant>, <constant>MongoClient::RP_SECONDARY</constant>, <constant>MongoClient::RP_SECONDARY_PREFERRED</constant>, ou <constant>MongoClient::RP_NEAREST</constant>.</para></listitem></varlistentry><varlistentry><term><parameter>tags</parameter></term><listitem><para>Un tableau de zéro ou plusieurs jeux de tags, où chaque jeu de tags est lui même un tableau de critères utilisés pour faire correspondre les tags sur les membres du jeu de réplication.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Retourne &true; en cas de succès, ou &false; sinon.</para>'>
<!ENTITY mongo.setreadpreference.errors '<para xmlns="http://docbook.org/ns/docbook">Emets une alerte de niveau <constant>E_WARNING</constant> si soit le paramètre est invalide, soit si un ou plusieurs jeux de tags sont fournis avec le mode de préférence de lecture <constant>MongoClient::RP_PRIMARY</constant>.</para>'>
<!ENTITY mongo.getreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Cette fonction retourne un tableau décrivant les préférences de lecture. Ce tableau contient les valeurs <literal>type</literal> contenant une chaîne représentant le mode de préférence de lecture (suivant les <classname>MongoClient</classname>), et <literal>tagsets</literal> contenant une liste de tous les critères du jeu de tags. Si aucun jeu de tags n&#39;est spécifié, <literal>tagsets</literal> ne sera pas présent dans ce tableau.</para>'>
<!ENTITY mongo.setwriteconcern.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>w</parameter></term><listitem><para>La préoccupation d&#39;écriture. Peut être un entier indiquant le nombre de serveurs requis pour approuver une écriture, ou un mode sous forme de chaîne de caractères (e.g. "majority").</para></listitem></varlistentry><varlistentry><term><parameter>wtimeout</parameter></term><listitem><para>Le nombre maximal de millisecondes à attendre le serveur pour satisfaire une préoccupation d&#39;écriture.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Retourne &true; en cas de succès, ou &false; sinon.</para>'>
<!ENTITY mongo.setwriteconcern.errors '<para xmlns="http://docbook.org/ns/docbook">Emets une exception de niveau <constant>E_WARNING</constant> si le paramètre <literal>w</literal> n&#39;est pas un entier ou une chaîne de caractères.</para>'>
<!ENTITY mongo.getwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Cette fonction retourne un tableau décrivant la préoccupation d&#39;écriture. Le tableau contient la valeur <literal>w</literal> pour le niveau d&#39;approbation (valeur entière), ou un mode sous forme de chaîne de caractères, et la valeur <literal>wtimeout</literal> indiquant le nombre maximal de millisecondes à attente le serveur pour satisfaire la préoccupation d&#39;écriture.</para>'>
<!ENTITY mongo.command.parameters.maxtimems '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"maxTimeMS"</literal></para><para>Spécifie une limite cumulative de temps, en millisecondes, pour procéder à l&#39;opération (n&#39;inclut pas le temps d&#39;inactivité). Si l&#39;opération n&#39;est pas terminée durant cette période, une exception <classname>MongoExecutionTimeoutException</classname> sera émise.</para></listitem>'>
<!ENTITY mongo.index.parameters.background '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"background"</literal></para><para>Construit l&#39;index en arrière plan faisant ainsi que la construction de l&#39;index <emphasis>ne bloquera pas</emphasis> les autres activités de la base de données. Spécifiez &true; pour une construction en arrière plan. La valeur par défaut est &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para>Avant MongoDB 2.6.0, les constructions d&#39;index sur les secondaires étaient exécutés comme des opérations de premier plan, sans respecter cette option. Voir <link xlink:href="&url.mongodb.dochub.indexes.rs;" xmlns:xlink="http://www.w3.org/1999/xlink">la construction d&#39;index sur les jeux de réplication</link> pour plus d&#39;informations.</para></warning></listitem>'>
<!ENTITY mongo.index.parameters.dropdups '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal></para><para>Spécifiez &true; pour forcer la création d&#39;un index unique lorsque la collection peut contenir des valeurs dupliqués pour une même clé. MongoDB va indexer la première occurrence dans la clé et supprimer les documents suivants dans la collection qui contiennent une valeur dupliquée pour cette clé. La valeur par défaut est &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal> peut supprimer des données dans votre base de données. A utiliser avec une extrême attention.</para></warning><note xmlns="http://docbook.org/ns/docbook"><para>Cette option n&#39;est pas supporté sur MongoDB 2.8+. La création d&#39;index sera refusé si la collection contient des clés dupliquées.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.expireafterseconds '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"expireAfterSeconds"</literal></para><para>La valeur de cette option doit spécifier le nombre de secondes après lequel un document doit être considéré comme expiré, et automatiquement supprimé de la collection. Cette option n&#39;est compatible qu&#39;avec des indexes sur un seul champ où le champ contient une valeur <classname>MongoDate</classname>.</para><note xmlns="http://docbook.org/ns/docbook"><para>Cette fonctionnalité est disponible depuis MongoDB 2.2+. Voir <link xlink:href="&url.mongodb.docs.expire_data;" xmlns:xlink="http://www.w3.org/1999/xlink">l&#39;expiration des données d&#39;une collection en définissant un TTL</link> pour plus d&#39;informations.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.name '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"name"</literal></para><para>Un nom optionnel qui identifie de façon unique l&#39;index.</para><note xmlns="http://docbook.org/ns/docbook"><para>Par défaut, le driver va générer un nom d&#39;index basé sur le(s) champ(s) d&#39;index, leur tri, ou leur type. Par exemple, un index calculé <literal>array("x" => 1, "y" => -1)</literal> sera nommé <literal>"x_1_y_-1"</literal> et un index géospacial <literal>array("loc" => "2dsphere")</literal> sera nommé <literal>"loc_2dsphere"</literal>. Pour les indexes avec beaucoup de champs, il est possible que le nom généré puisse excéder la <link xlink:href="&url.mongodb.docs.limits;#Index-Name-Length" xmlns:xlink="http://www.w3.org/1999/xlink">limite des noms d&#39;index</link> MongoDB. L&#39;option <literal>"name"</literal> peut être utilisée dans ce cas pour fournir un nom plus court.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.sparse '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"sparse"</literal></para><para>Spécifiez &true; pour créer un index clairsemé, qui n&#39;indexe que des documents contenant un champ spécifié. La valeur par défaut est &false;.</para></listitem>'>
<!ENTITY mongo.index.parameters.unique '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"unique"</literal></para><para>Spécifiez &true; pour créer un index unique. La valeur par défaut est &false;. Cette option s&#39;applique uniquement sur les indexes croissants/décroissants.</para><note xmlns="http://docbook.org/ns/docbook"><para>Lorsque MongoDB indexe un champ, si un document n&#39;a pas une valeur pour ce champ, la valeur &null; sera indexée. Si plusieurs documents ne contiennent pas un champ, un index unique rejètera tout, sauf le premier de ces documents. L&#39;option <literal>"sparse"</literal> peut être utilisée pour remédier à cela, sachant qu&#39;il va éviter que les documents ne contenant pas ce champ ne soient indexés.</para></note></listitem>'>
<!ENTITY mongo.listcollections.note '<note xmlns="http://docbook.org/ns/docbook"><simpara>Cette méthode va utiliser la commande de base de données <link xlink:href="&url.mongodb.docs.command;listCollections" xmlns:xlink="http://www.w3.org/1999/xlink">listCollections</link> lors des communications avec MongoDB 2.8+. Pour les versions précédentes, la méthode va interroger la collection spéciale <literal>system.namespaces</literal>.</simpara></note>'>
<!ENTITY mongo.listcollections.parameters.filter '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"filter"</literal></para><para>Critère de requête optionnel. Si fourni, ce critère sera utilisé pour filtrer les collections inclues dans le résultat.</para><para>Les champs pertinents qui peuvent être requêtés inclus <literal>"name"</literal> (nom de la collection comme chaine de caractères, sans préfixer par le nom de la base de données) et <literal>"options" (objet contenant les options utilisées pour créér la collection).</literal>.</para><note><simpara>MongoDB 2.6 et les versions antérieures requierent que le critère <literal>"name"</literal>, si spécifié, soit une chaine de caractère (i.e. correspondance exacte). Ceci, car le driver doit préfixer la valeur avec le nom de la base de données afin de requêter la collection <literal>system.namespaces</literal>. Les versions suivantes de MongoDB n&#39;ont pas cette limitation, comme le driver va utiliser la commande listCollections.</simpara></note></listitem>'>
<!ENTITY mongo.listcollections.parameters.includesystemcollections '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"includeSystemCollections"</literal></para><para>Booléen, par défaut &false;. Détermine si les collections systèmes doivent être incluses dans le résultat.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcern '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"w"</literal></para><para>Voir les <link linkend="mongo.writeconcerns">préoccupatios d&#39;écriture</link>. La valeur par défaut pour <classname>MongoClient</classname> est <literal>1</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wtimeout"</literal></para><para>Alias obsolète pour <literal>"wTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wTimeoutMS"</literal></para><para>Cette option spécifie la durée limite, en millisecondes, pour la reconnaissance des <link linkend="mongo.writeconcerns">préoccupations d&#39;écriture</link>.Ceci n&#39;est applicable que lorsque <literal>"w"</literal> est supérieur à <literal>1</literal>, sachant que le délai d&#39;attente maximal est en relation avec la réplication. Si la préoccupation d&#39;écriture n&#39;est pas spécifiée dans la durée limite, une exception <classname>MongoCursorException</classname> sera émise. Une valeur de <literal>0</literal> peut être spécifiée pour un blocage permanent. La valeur par défaut pour <classname>MongoClient</classname> est <literal>10000</literal> (dix secondes).</para></listitem>'>
<!ENTITY mongo.writes.parameters.fsync '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"fsync"</literal></para><para>Booléen, par défaut à &false;. Si l&#39;historisation est activée, il fonctionne exactement comme <literal>"j"</literal>. Si l&#39;historisation n&#39;est pas activée, l&#39;opération en écriture sera bloquante tant qu&#39;elle ne sera pas synchronisé sur les fichiers de base de données du disque. Si vaut &true;, une insertion reconnue devient implicite, et cette option va écraser la configuration <literal>"w"</literal> à <literal>0</literal>.</para><note><simpara>Si l&#39;historisation est activée, les utilisateurs sont vivement encouragés à utiliser l&#39;option <literal>"j"</literal> au lieu de <literal>"fsync"</literal>. N&#39;utilisez pas <literal>"fsync"</literal> et <literal>"j"</literal> en même temps, ou une erreur sera produite.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.sockettimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"socketTimeoutMS"</literal></para><para>Cette option spécifie la durée limite, en millisecondes, pour la communication avec un socket. Si le serveur ne répond pas pendant cette période, une exception <classname>MongoCursorTimeoutException</classname> sera émise et il n&#39;y a aucune façon de déterminer si le serveur gère actuellement l&#39;écriture ou non. Une valeur de <literal>-1</literal> peut être spécifiée pour bloquer indéfiniement. La valeur par défaut pour <classname>MongoClient</classname> est <literal>30000</literal> (30 secondes).</para></listitem>'>
<!ENTITY mongo.writes.parameters.journal '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"j"</literal></para><para>Booléen, par défaut à &false;. Force les opérations en écriture a être bloquantes tant qu&#39;elles ne sont pas synchronisées dans le journal du disque. Si vaut &true;, une écriture reconnue est implicite, et cette option va écraser la configuration <literal>"w"</literal> à <literal>0</literal>.</para><note><simpara>Si cette option est utilisée, et que l&#39;historisation est désactivée, MongoDB 2.6+ va lancer une erreur, et l&#39;écriture échouera ; les anciennes versions du serveur vont simplement ignorer cette ooption.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.safe '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"safe"</literal></para><para>Deprecated. Please use the <link linkend="mongo.writeconcerns">write concern</link> <literal>"w"</literal> option.</para></listitem>'>
<!ENTITY mongo.writes.parameters.timeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"timeout"</literal></para><para>Alias obsolète pour <literal>"socketTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.errors.exceptions.writeconcern '<para xmlns="http://docbook.org/ns/docbook">Lance une exception <classname>MongoCursorException</classname> si l&#39;option <literal>"w"</literal> est définie, et que l&#39;écriture échoue.</para><para xmlns="http://docbook.org/ns/docbook">Lance une exception <classname>MongoCursorTimeoutException</classname> si l&#39;option <literal>"w"</literal> est définie à une valeur supérieure à 1 et que l&#39;opération prend plus de temps que <varname>MongoCursor::$timeout</varname> millisecondes à se terminer. Ceci ne va pas mettre fin à l&#39;opération sur le serveur, ce n&#39;est qu&#39;un délai d&#39;attente maximal côté client. L&#39;unité pour <varname>MongoCollection::$wtimeout</varname> est la milliseconde.</para>'>
<!ENTITY mongo.errors.deprecated '<para xmlns="http://docbook.org/ns/docbook">Lance une alerte de type <constant>E_DEPRECATED</constant></para>'>
<!ENTITY mongo.gridfs.store.metadata.note '<note xmlns="http://docbook.org/ns/docbook"><para>Ces champs peuvent aussi écraser ceux qui auraient pu être créés automatiquement par le driver, tel que décrit dans la documentation MongoDB sur les <link xlink:href="&url.mongodb.docs.gridfs;#the-files-collection" xmlns:xlink="http://www.w3.org/1999/xlink">fichiers de collection</link>. Une des particularités de ce comportement serait de spécifier un <literal>chunkSize</literal> ou un <literal>_id</literal> personnalisé pour le fichier.</para></note>'>
<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">Retourne l&#39;<literal>_id</literal> du fichier document sauvegardé. Cela va retourner un <classname>MongoId</classname> généré tant qu&#39;un <literal>_id</literal> ne soit explicitement spécifié dans le paramètre <parameter>metadata</parameter>.</para>'>
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>Un tableau d&#39;options d&#39;écriture.<informaltable><thead><row><entry>key</entry><entry>Signification de la valeur</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry>Valeur de <link linkend="mongo.writeconcerns">Write concern</link></entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">Durée maximale à attendre pour une réplication</link></entry></row><row><entry>ordered</entry><entry>Détermine si MongoDB doit appliquer ce lot dans l&#39;ordre. Les écritures dans l&#39;ordre sont exécutées en série (i.e. une à la fois) et l&#39;exécution va s&#39;arrêter après la première erreur. Les écritures dans le désordre sont exécutées en parallèle et l&#39;exécution ne s&#39;arrêtera pas après la première erreur. Par défaut, vaut &true;</entry></row><row><entry>j (bool)</entry><entry>Attend le journal du primaire. Cette valeur n&#39;est pas conseillée, utilisez plutôt les WriteConcern</entry></row><row><entry>fsync (bool)</entry><entry>Attend fsync sur le primaire. Cette valeur n&#39;est pas conseillée, utilisez plutôt les WriteConcern</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>La <classname>MongoCollection</classname> sur laquelle le lot sera exécuté. Sa <link linkend="mongo.writeconcerns">préoccupation d&#39;écriture</link> sera copiée et utilisée comme précoccupation d&#39;écriture par défaut si aucune n&#39;est fournie comme paramètre <parameter>$write_options</parameter> ou pendant <methodname>MongoWriteBatch::execute</methodname>.</para></listitem>'>
<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>server</parameter></term><listitem><para>Un tableau contenant les informations basiques du serveur récupéré.<informaltable><tgroup cols="2"><thead><row><entry>clé</entry><entry>valeur</entry></row></thead><tbody><row><entry>hash</entry><entry>Hash du serveur, par exemple : <literal>localhost:27017;-;X;56052</literal></entry></row><row> <entry>type</entry> <entry>Type du nœud (primaire/secondaire/mongos/arbitraire) : <literal>2</literal></entry></row><row> <entry>max_bson_size</entry> <entry>La taille BSON maximale que ce nœud accepte : <literal>16777216</literal></entry></row><row> <entry>max_message_size</entry> <entry>La taille maximale du message que ce nœud accepte : <literal>48000000</literal></entry></row><row> <entry>request_id</entry> <entry>L&#39;identifiant de requête pour ce message : <literal>42</literal></entry></row></tbody></tgroup></informaltable></para></listitem></varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>booléen, si l&#39;opération doit être exécutée séquentiellement (dans le cas d&#39;une exécution par lot) (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>Un tableau d&#39;option pour writeConcern (Voir plus loin)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>Tableau de valeurs writeConcern</title> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>booléen, force le flushing vers le disque avant de retourner</entry> </row> <row> <entry>j</entry> <entry>boolean, force l&#39;écriture dans le journal avant de retourner</entry> </row> <row> <entry>wtimeout</entry> <entry>entier, millisecondes, temps maximum le serveur primaire est autorisé à attendre pour vérifier la réplication</entry> </row> <row> <entry>w</entry> <entry>integer=server count, or string=replication-tag</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>La taille totale (en bytes) du message encodé en cours d&#39;envoi.</entry> </row> <row> <entry>request_id</entry> <entry>L&#39;identifiant de requête pour ce message : <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>L&#39;espace de nommage MongoDB utilisé pour le message  protocolaire <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.alternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">Cette extension, qui définie cette classe est obsolète.
Veuillez utiliser l&#39;extension <link linkend="set.mongodb">MongoDB</link> à la place.
Les alertnatives à cette classe sont :</para>'>
<!ENTITY mongo.noalternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">Cette extension, qui définie cette classe est obsolète.
Veuillez utiliser l&#39;extension <link linkend="set.mongodb">MongoDB</link> à la place.
Il n&#39;y a pas d&#39;équivalent à cette classe dans la nouvelle extension.</para>'>
<!ENTITY mongo.alternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">Cette extension, qui définie cette méthode est obsolète.
Veuillez utiliser l&#39;extension <link linkend="set.mongodb">MongoDB</link> à la place.
Les alertnatives à cette méthode sont :</para>'>
<!ENTITY mongo.noalternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">Cette extension, qui définie cette méthode est obsolète.
Veuillez utiliser l&#39;extension <link linkend="set.mongodb">MongoDB</link> à la place.
Il n&#39;y a pas d&#39;équivalent à cette méthode dans la nouvelle extension.</para>'>
<!ENTITY mongo.alternative.phplib.note '<para
xmlns="http://docbook.org/ns/docbook">Cette extension, qui définie cette méthode est obsolète.
Veuillez utiliser l&#39;extension <link linkend="set.mongodb">MongoDB</link> à la place.
Il n&#39;y a pas d&#39;équivalent à cette méthode dans la nouvelle extension, mais il existe
une alternative dans la <link linkend="mongodb.overview">bibliothèque PHP</link>:</para>'>

<!ENTITY mongo.deprecated.note '<para
xmlns="http://docbook.org/ns/docbook">Cette extension est obsolète. À la place,
vous devriez utiliser l&#39;extension <link linkend="set.mongodb">MongoDB</link>.</para>'>

<!-- mongodb -->
<!ENTITY mongodb.option.collation '
<row xmlns="http://docbook.org/ns/docbook">
<entry>collation</entry>
<entry><type class="union"><type>array</type><type>object</type></type></entry>
<entry>
    <para>
        <link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Collation</link> permet aux utilisateurs de spécifier des règles spécifiques au langage pour la comparaison des chaînes, par exemple, des règles pour les majuscules ou les accents. Lors de la spécification d&#39;une collation, le champ <literal>"locale"</literal> est obligatoire ; tous les autres champs de la collation sont optionnels. Pour la description de ces champs, reportez-vous au <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">document Collation</link>.
    </para>
    <para>
        Si la collation n&#39;est pas spécifiée mais que la collection a une collation par défaut, l&#39;opération utilisera la collation spécifiée pour la collection. Si aucune collation n&#39;est spécifiée pour la collection ou pour l&#39;opération, MongoDB utilisera le binaire simple de comparaison utilisé dans les versions précédentes pour les comparaisons des chaînes.
    </para>
    <para>
        Cette option est disponible en MongoDB 3.4+ et une exception sera émise au moment de l&#39;exécution si elle est spécifiée dans une version antérieure.
    </para>
</entry>
</row>
'>
<!ENTITY mongodb.option.encryption.keyVaultClient '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultClient</entry>
          <entry><classname>MongoDB\Driver\Manager</classname></entry>
          <entry>Le Manager utilisé pour router les requêtes de clés de données à un cluster MongoDB différent. Par défaut, le Manager et cluster courant et utilisé.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultNamespace</entry>
          <entry>&string;</entry>
          <entry>Un nom d&apos;espace complètement qualifié (par exemple <literal>"databaseName.collectionName"</literal>) dénotant la collection qui contient toutes les clés de données utilisé pour le chiffrement et déchiffrement.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>kmsProviders</entry>
          <entry>&array;</entry>
          <entry>
           <para>
            Un document contenant la configuration d&apos;un ou plusieurs
            fournisseurs KMS, qui sont utilisés pour chiffrer les clés de données.
            Actuellement <literal>aws</literal> ou <literal>local</literal> sont
            supporté et au moins un doit être spécifié.
           </para>
           <para>
            Le format pour <literal>aws</literal> est le suivant:
           </para>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>
}
]]>
           </programlisting>
           <para>
            Le format pour <literal>local</literal> est le suivant:
           </para>
           <programlisting role="javascript">
<![CDATA[
local: {
    // The master key used to encrypt/decrypt data keys
    key: <96-byte MongoDB\BSON\Binary with subtype 0>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.maxCommitTimeMS '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>maxCommitTimeMS</entry>
 <entry>integer</entry>
 <entry>
  <para>
   Le temps maximum en millisecondes pour permettre à une seule commande
   <literal>commitTransaction</literal> de s&#39;exécuter.
  </para>
  <para>
   Si spécifié, <literal>maxCommitTimeMS</literal> doit être un entier
   32 bits signé supérieur ou égal à zéro.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.readConcern '
<row xmlns="http://docbook.org/ns/docbook">
<entry>readConcern</entry>
<entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
<entry>
    <para>
        Une préoccupation de lecture à appliquer à l&#39;opération.
    </para>
    <para>
        Cette option est disponible dans MongoDB 3.2+ et se traduira par
        une exception au moment de l&#39;exécution si elle est spécifiée pour
        une version plus ancienne du serveur.
    </para>
</entry>
</row>
'>
<!ENTITY mongodb.option.readPreference '
<row xmlns="http://docbook.org/ns/docbook">
<entry>readPreference</entry>
<entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
<entry>
    <para>
        Une préférence de lecture à utiliser pour sélectionner un serveur
        pour l&#39;opération.
    </para>
</entry>
</row>
'>
<!ENTITY mongodb.option.session '
<row xmlns="http://docbook.org/ns/docbook">
<entry>session</entry>
<entry><classname>MongoDB\Driver\Session</classname></entry>
<entry>
    <para>
        Une session à associer à l&#39;opération.
    </para>
</entry>
</row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
<warning xmlns="http://docbook.org/ns/docbook">
<para>
    Si vous utilisez une <literal>"session"</literal> qui a une transaction
    en cours, vous ne pouvez pas spécifier l&#39;option <literal>"readConcern"</literal>
    ou <literal>"writeConcern"</literal>. Tenter de faire ceci lancera une exception
    <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.
    À la place vous devriez définir ces options quand vous créez la transaction avec
    <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
</para>
</warning>
'>
<!ENTITY mongodb.option.writeConcern '
<row xmlns="http://docbook.org/ns/docbook">
<entry>writeConcern</entry>
<entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
<entry>
    <para>
        Une préoccupation d&#39;écriture à appliquer à l&#39;opération.
    </para>
</entry>
</row>
'>
<!ENTITY mongodb.parameter.namespace '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>namespace</parameter> (<type>string</type>)</term>
<listitem>
    <para>
        Un espace de noms totalement qualifié (e.g. <literal>"databaseName.collectionName"</literal>)
    </para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.db '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>db</parameter> (<type>string</type>)</term>
<listitem>
    <para>
        Le nom de la base de données sur laquelle la commande sera exécutée.
    </para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
<listitem>
    <para>
        Écriture(s) à exécuter.
    </para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.command '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
<listitem>
    <para>
        La commande à exécuter.
    </para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.query '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
<listitem>
    <para>
        La requête à exécuter.
    </para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>typeMap</parameter> (<type>array</type>)</term>
<listitem>
    <para>
        <link linkend="mongodb.persistence.typemaps">Configuration du type de carte</link>.
    </para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
<listitem>
    <para>
        L&#39;<link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">attribut de la requête</link>.
        Un attribut vide va faire correspondre tous les documents de la collection.
    </para>
    <note>
        <simpara>
            Lors de l&#39;évaluation des critères de requête, MongoDB compare les type et les valeurs en fonction de leur propre <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">règles de comparaison pour les types BSON</link>, qui diffère des règles de <link linkend="types.comparisons">comparaison</link> et de <link linkend="language.types.type-juggling">manipulation des type</link> de PHP. Lors de  la correspondance d&#39;un type BSON spcécial, les critères de requête doivent utiliser la <link linkend="book.bson">classe BSON</link> (ex. : utiliser <classname>MongoDB\BSON\ObjectId</classname> pour correspondre à un <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
        </simpara>
    </note>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Retourne un <classname>MongoDB\Driver\Cursor</classname> en cas de succès.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Retourne un <classname>MongoDB\Driver\WriteResult</classname> en cas de succès.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.authentication;&mongodb.throws.connection;'>
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Lance une exception <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> si l&#39;option <literal>"session"</literal> est utilisée conjointement avec une préoccupation d&#39;écriture non reconnu.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Lance une exception <classname>MongoDB\Driver\BulkWriteException</classname> lors d&#39;une erreur d&#39;une opération en écriture (une erreur WriteError et WriteConcern)</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Lance une exception <classname>MongoDB\Driver\InvalidArgumentException</classname> lors d&#39;une erreur survenue pendant l&#39;analyse d&#39;un argument.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Lance une exception <classname>MongoDB\Driver\AuthenticationException</classname> si une identification est nécessaire mais qu&#39;elle échoue</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Lance une exception <classname>MongoDB\Driver\ConnectionException</classname> si la connexion au serveur échoue pour une autre raison qu&#39;en raison d&#39;un problème d&#39;identification</member>'>
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Lance une exception <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname> si l&#39;entrée ne contient pas exactement un document BSON. Les raisons possibles comprennent, mais ne sont pas limitées à, BSON invalide, des données supplémentaires (après avoir lu un document BSON), ou une erreur imprévu de <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link>.</member>'>

<!ENTITY mongodb.note.decimal128 '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    <classname>MongoDB\BSON\Decimal128</classname> n&#39;est compatible qu&#39;avec
    MongoDB 3.4+. Si vous tentez d&#39;utiliser le type BSON avec une ancienne version
    de MongoDB, une erreur sera émise.
</simpara>
</note>
'>
<!ENTITY mongodb.note.extended-json '
<note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<simpara>
    La sortie est cohérente avec la fonction <function>MongoDB\BSON\toJSON</function>,
    qui utilise le format JSON étendu spécifique au pilote. Cela ne correspond
    pas nécessairement aux représentations JSON étendues
    <link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">décontractées</link>
    ou <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canoniques</link>
    utilisées par <function>MongoDB\BSON\toRelaxedExtendedJSON</function> et
    <function>MongoDB\BSON\toCanonicalExtendedJSON</function>, respectivement.
</simpara>
</note>
'>
<!ENTITY mongodb.note.forking '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    Sur les plate-formes Unix, le driver MongoDB est sensible aux scripts qui utilisent
    l&#39;appel système fork() sans pour autant appeler exec(). Vous ne devez pas ré-utliser
    des instances <classname>MongoDB\Driver\Manager</classname> dans une processus
    fils issue d&#39;un fork.
</simpara>
</note>
'>

<!ENTITY mongodb.note.uint32 '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    Étant donné que le type entier de PHP est signé, certaines valeurs
    retournées par cette méthode peuvent apparaître sous forme d&#39;entiers négatifs
    sur les plates-formes 32 bits. Le formateur "&#37;u" de
    <function>sprintf</function> peut être utilisé pour obtenir une
    représentation sous forme de chaîne de la valeur décimale non signée.
</simpara>
</note>'>

<!ENTITY mongodb.note.server.readpreference '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    L&apos;option <literal>readPreference</literal> ne contrôle pas le serveur vers
    lequel le pilote émet l&apos;opération; il sera toujours exécuté sur cet objet
    serveur. Au lieu de cela, il peut être utilisé lors de l&apos;émission de
    l&apos;opération à un secondaire (à partir d&#39;une connexion de jeu de répliques,
    pas autonome) ou le nœud Mongos pour s&apos;assurer que le pilote définit le
    protocole de fil en conséquence ou ajoute la préférence de lecture à
    l&apos;opération, respectivement.
</simpara>
</note>
'>

<!ENTITY mongodb.note.server.write '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    Il est de la responsabilité de l&apos;appelant de s&apos;assurer que le
    serveur est capable d&apos;exécuter l&apos;opération d&apos;écriture. Par
    exemple, l&apos;exécution d&apos;une opération d&apos;écriture sur un
    secondaire (à l&apos;exclusion de sa base de données  "local") échouera.
</simpara>
</note>
'>

<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>Une requête doit être créée via la fonction <function>radius_create_request</function> avant que cette fonction puisse être appelée.</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>Le type d&#39;attribut.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><para>La ressource RADIUS.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><para>Un masqe d&#39;options d&#39;attribut. Les options disponibles incluent <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> et <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link>.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><para>L&#39;attribut tag. Ce paramètre est ignoré tant que l&#39;option <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> est défini.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>L&#39;identifiant du vendeur.</para></listitem></varlistentry>'>

<!-- posix snippets -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>fd</parameter></term>
<listitem>
    <para>
        Le descripteur de fichier, qui doit être soit une ressource
        de fichier, soit un entier. Un entier est supposé être un descripteur
        de fichier qui peut être passé directement à l&#39;appel système
        sous-jacent.
    </para>
    <para>
        Dans tous les autres cas, vous devez fournir une ressource de fichier.
    </para>
</listitem>
</varlistentry>'>

<!ENTITY posix.rlimits '
<para xmlns="http://docbook.org/ns/docbook">
Chaque ressource a une limite soft et hard d&#39;associées. La limite
soft correspond à la valeur que le noyau force pour la ressource
correspondante. La limite hard agit comme un plafond de la limite soft.
Un processus non privilégié ne peut que définir sa limite soft en une
valeur comprise entre 0 et la limite hard, ce qui ne fera qu&#39;abaisser
sa limite hard.
</para>
'>

<!-- strings snippets -->
<!ENTITY strings.parameter.encoding '
<para xmlns="http://docbook.org/ns/docbook">
Un argument optionnel définissant l&#39;encodage utilisé lors
de la conversion des caractères.
</para>

<para xmlns="http://docbook.org/ns/docbook">
Si omis, la valeur par défaut du paramètre <parameter>encoding</parameter>
est la valeur de l&#39;option de configuration
<link linkend="ini.default-charset">default_charset</link>.
</para>

<para xmlns="http://docbook.org/ns/docbook">
Malgré le fait que cet argument soit techniquement optionnel, vous
êtes vivement encouragé à spécifier la valeur correcte pour votre code
si l&#39;option de configuration
<link linkend="ini.default-charset">default_charset</link>
a été définie de façon incorrecte pour l&#39;entrée fournie.
</para>
'>

<!ENTITY strings.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>format</parameter></term>
 <listitem>
  <para>
   La chaîne de format est composé de zéro ou plusieurs directives :
   des caractères ordinaires (à l&#39;exception de <literal>&#37;</literal>)
   qui sont copiés directement dans le résultat et des
   <emphasis>spécifications de conversion</emphasis>,
   chacun ayant pour résultat de récupérer ses propres paramètre.
  </para>

  <para>
   Une spécification de conversion qui suit ce prototype :
   <literal>&#37;[argnum$][flags][width][.precision]specifier</literal>.
  </para>

  <formalpara>
   <title>Argnum</title>
   <para>
    Un &integer; suivit d&apos;un signe dollar <literal>$</literal>,
    pour spécifier quel numéro d&#39;argument à traiter dans la conversion.
   </para>
  </formalpara>

  <para>
   <table>
    <title>Drapeaux</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Drapeau</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>-</literal></entry>
       <entry>
        Justifie le texte à gauche donnée la largeur du champ ;
        Justification à droite est le comportement par défaut.
       </entry>
      </row>
      <row>
       <entry><literal>+</literal></entry>
       <entry>
        Préfixe les nombres positives avec un signe plus
        <literal>+</literal> ; Par défaut seul les nombres
        négatifs sont préfixés avec un signe négatif.
       </entry>
      </row>
      <row>
       <entry><literal> </literal>(espace)</entry>
       <entry>
        Complète le résultat avec des espaces.
        Ceci est par défaut.
       </entry>
      </row>
      <row>
       <entry><literal>0</literal></entry>
       <entry>
        Complète uniquement les nombres à gauches avec des zéros.
        Avec le spécificateur <literal>s</literal> ceci peut aussi
        compléter à droite avec des zéros.
       </entry>
      </row>
      <row>
       <entry><literal>&apos;</literal>(char)</entry>
       <entry>
        Complète le résultat avec le caractère (char).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <formalpara>
   <title>Largeur</title>
   <para>
    Un entier indiquant combien de caractères (au minimum)
    cette conversion doit avoir pour résultat.
   </para>
  </formalpara>

  <formalpara>
   <title>Precision</title>
   <para>
    Un point <literal>.</literal> suivie d&apos;un entier dont
    sa signification dépend du spécificateur :
    <itemizedlist>
     <listitem>
      <simpara>
       Pour les spécificateurs <literal>e</literal>, <literal>E</literal>,
       <literal>f</literal> et <literal>F</literal> :
       ceci est le nombre de chiffres à afficher après
       la virgule (par défaut, ceci est 6).
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Pour les spécificateurs <literal>g</literal>, <literal>G</literal>,
       <literal>h</literal> et <literal>H</literal> :
       ceci est le nombre maximal de chiffres significatifs à afficher.
       digits to be printed.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Pour le spécificateur <literal>s</literal> : il agit comme un point de coupure,
       définissant une limite maximale de caractères de la chaîne.
      </simpara>
     </listitem>
    </itemizedlist>
    <note>
     <simpara>
      Si le point est spécifié sans une valeur explicite pour la précision,
      0 est assumé.
     </simpara>
    </note>
   </para>
  </formalpara>

  <note>
   <simpara>
    Tenter d&apos;utiliser une position supérieure à
    <constant>PHP_INT_MAX</constant> génèrera une alerte.
   </simpara>
  </note>

  <para>
   <table>
    <title>Spécificateurs</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Spécificateur</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>&#37;</literal></entry>
       <entry>
        Un caractère de pourcentage littéral. Aucun argument n&apos;est nécessaire.
       </entry>
      </row>
      <row>
       <entry><literal>b</literal></entry>
       <entry>
        L&apos;argument est traité comme un entier et présenté
        comme un nombre binaire.
       </entry>
      </row>
      <row>
       <entry><literal>c</literal></entry>
       <entry>
        L&apos;argument est traité comme un entier et présenté
        comme le caractère de code ASCII correspondant.
       </entry>
      </row>
      <row>
       <entry><literal>d</literal></entry>
       <entry>
       L&apos;argument est traité comme un entier et présenté
       comme un nombre entier décimal (signé).
       </entry>
      </row>
      <row>
       <entry><literal>e</literal></entry>
       <entry>
        L&apos;argument est traité comme une notation scientifique
        (e.g. <literal>1.2e+2</literal>).
       </entry>
      </row>
      <row>
       <entry><literal>E</literal></entry>
       <entry>
        Comme le spécificateur <literal>e</literal> mais utilise
        une lettre majuscule (par exemple 1.2E+2).
       </entry>
      </row>
      <row>
       <entry><literal>f</literal></entry>
       <entry>
        L&apos;argument est traité comme un nombre à virgule flottante
        (type &float;) et présenté comme un nombre à virgule
        flottante (tenant compte de la locale utilisée).
       </entry>
      </row>
      <row>
       <entry><literal>F</literal></entry>
       <entry>
        L&apos;argument est traité comme un nombre à virgule flottante
        (type &float;) et présenté comme un nombre à virgule
        flottante (ne tenant pas compte de la locale utilisée).
       </entry>
      </row>
      <row>
       <entry><literal>g</literal></entry>
       <entry>
        <para>
         Format général.
        </para>
        <para>
         Soit P égal à la précision si différent de 0, 6 si la précision
         est omit ou 1 si la précision est zéro.
         Alors, si la conversion avec le style E aurait comme exposant X :
        </para>
        <para>
         Si P > X ≥ −4, la conversion est avec style f et précision P − (X + 1).
         Sinon, la conversion est avec le style e et précision P - 1.
        </para>
       </entry>
      </row>
      <row>
       <entry><literal>G</literal></entry>
       <entry>
        Comme le spécificateur <literal>g</literal> mais utilise
        <literal>E</literal> et <literal>f</literal>.
       </entry>
      </row>
      <row>
       <entry><literal>h</literal></entry>
       <entry>
        Comme le spécificateur <literal>g</literal> mais utilise <literal>F</literal>.
        Disponible à partir de PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>H</literal></entry>
       <entry>
        Comme le spécificateur <literal>g</literal> mais utilise
        <literal>E</literal> et <literal>F</literal>. Disponible à partir de PHP 8.0.0.
       </entry>
      </row> 
      <row>
       <entry><literal>o</literal></entry>
       <entry>
        L&apos;argument est traité comme un entier et présenté
        comme un nombre octal.
       </entry>
      </row>
      <row>
       <entry><literal>s</literal></entry>
       <entry>
        L&apos;argument est traité et présenté comme une chaîne de caractères.
       </entry>
      </row>
      <row>
       <entry><literal>u</literal></entry>
       <entry>
        L&apos;argument est traité comme un entier et présenté
        comme un nombre décimal non signé.
       </entry>
      </row>
      <row>
       <entry><literal>x</literal></entry>
       <entry>
        L&apos;argument est traité comme un entier et présenté
        comme un nombre hexadécimal (les lettres en minuscules).
       </entry>
      </row>
      <row>
       <entry><literal>X</literal></entry>
       <entry>
       L&apos;argument est traité comme un entier et présenté
       comme un nombre hexadécimal (les lettres en majuscules).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <warning>
   <para>
    Le spécificateur de type <literal>c</literal> ignore l&apos;alignement et la taille.
   </para>
  </warning>

  <warning>
   <para>
    Le fait de tenter d&apos;utiliser une combinaison d&apos;une chaîne
    et de spécificateurs avec des jeux de caractères qui nécessitent
    plus d&apos;un octet par caractères donnera un résultat inattendu.
   </para>
  </warning>

  <para>
   Les variables seront contraints à un type approprié pour le spécificateur :
   <table>
    <title>Gestion des types</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Type</entry>
       <entry>Spécificateurs</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><type>string</type></entry>
       <entry><literal>s</literal></entry>
      </row>
      <row>
       <entry><type>int</type></entry>
       <entry>
        <literal>d</literal>,
        <literal>u</literal>,
        <literal>c</literal>,
        <literal>o</literal>,
        <literal>x</literal>,
        <literal>X</literal>,
        <literal>b</literal>
       </entry>
      </row>
      <row>
       <entry><type>float</type></entry>
       <entry>
        <literal>e</literal>,
        <literal>E</literal>,
        <literal>f</literal>,
        <literal>F</literal>,
        <literal>g</literal>,
        <literal>G</literal>,
        <literal>h</literal>,
        <literal>H</literal>
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </listitem>
</varlistentry>
'>

<!ENTITY strings.parameter.needle.non-string '
 <para xmlns="http://docbook.org/ns/docbook">
  Antérieur à PHP 8.0.0, si <parameter>needle</parameter> n&#39;est pas une chaîne de caractères,
  elle est convertie en un entier et appliqué en tant que valeur ordinal d&#39;un caractère.
  Ce comportement est obsolète à partir de PHP 7.3.0, et se fier à celui-ci 
  est fortement déconseillé. En fonction du comportement attendu, 
  <parameter>needle</parameter> doit être transtypé explicitement en une chaîne de caractère,
  ou un appel explicite à <function>chr</function> doit être exécuté.
 </para>
'>

<!ENTITY strings.changelog.encoding '
<row xmlns="http://docbook.org/ns/docbook">
<entry>5.6.0</entry>
<entry>
    La valeur par défaut pour le paramètre <parameter>encoding</parameter>
    a été modifiée pour être la valeur de l&#39;option de configuration
    <link linkend="ini.default-charset">default_charset</link>.
</entry>
</row>
'>

<!-- filter snippets -->
<!ENTITY filter.param.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter></term>
<listitem>
    <para>
        L&#39;ID du filtre à appliquer. La <xref linkend="filter.filters" /> page du manuel liste les filtres disponibles.
    </para>
    <para>
        Si non spécifié, <constant>FILTER_DEFAULT</constant> sera utilisé, ce qui est équivalent à
        <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>.
        Cela reviendra à n&#39;avoir aucun filtre en place par défaut.
    </para>
</listitem>
</varlistentry>
'>

<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
La source des données aléatoires utilisée pour cette fonction est :
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<listitem>
    <simpara>
        Sous Windows,
        <link xlink:href="&url.csprng.crypt-gen-random;"><function>CryptGenRandom</function></link>
        sera toujours utilisé. À partir de PHP 7.2.0 c&#39;est
        <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
        qui sera toujours utilisé à la place
    </simpara>
</listitem>
<listitem>
    <simpara>
        Sous Linux, l&#39;appel système
        <link xlink:href="&url.csprng.get-random-2;">getrandom(2)</link>
        sera utilisé si disponible.
    </simpara>
</listitem>
<listitem>
    <simpara>
        Sous les autres plate-formes, <filename>/dev/urandom</filename> sera utilisé.
    </simpara>
</listitem>
<listitem>
    <simpara>
        Si tout ce qui précède n&#39;est pas disponible, alors une
        <classname>Exception</classname> sera émise.
    </simpara>
</listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
    Si aucune source de données aléatoires n&#39;est trouvée, une
    <classname>Exception</classname> sera émise.
</simpara>
</listitem>
<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
    Si un paramètre invalide est fourni, une exception
    de type <classname>TypeError</classname> sera émise.
</simpara>
</listitem>
'>
<!ENTITY csprng.function.backport '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
    Bien que cette fonction ait été ajoutée en PHP 7.0, une
    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">implementation en espace utilisateur</link>
    est disponible pour PHP 5.2 jusqu&#39;à 5.6, inclus.
</simpara>
</note>
'>


<!-- UOPZ snippets -->

<!ENTITY uopz.warn.removed.function-5-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction a été
    <emphasis>SUPPRIMEE</emphasis> dand PECL uopz 5.0.0.</simpara></warning>'>

<!-- XML snippets -->

<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>parser</parameter> attend une instance de <classname>XMLParser</classname>
  désormais; auparavent, une <type>resource</type> était attendu.
 </entry>
</row>'> 

<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
<para xmlns="http://docbook.org/ns/docbook">
    Tous les flux clients cryptés activent désormais la vérification par paire par défaut.
    Par défaut, ceci va utiliser le CA OpenSSL par défaut pour vérifier la paire
    de certificat. Dans la plupart des cas, aucune modification n&#39;a besoin d&#39;être faite
    pour communiquer avec des serveurs et des certificats SSL valides, sachant que les
    distributeurs configurent généralement OpenSSL pour utiliser les CA connus.
</para>

<para xmlns="http://docbook.org/ns/docbook">
    Le CA par défaut peut être écrasé sur une base globale en utilisant les
    options de configuration openssl.cafile ou openssl.capath, ou via une requête
    basique en utilisant les options de contexte
    <link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> ou
    <link linkend="context.ssl.capath"><parameter>capath</parameter></link>.
</para>

<para xmlns="http://docbook.org/ns/docbook">
    Bien que ce ne soit pas conseillé en général, il est possible de désactiver la
    vérification de certificats par paire pour une requête en définissant l&#39;option
    de contexte <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
    à &false;, et pour désactiver la validation du nom des paires, en configurant
    l&#39;option de contexte
    <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>
    à &false;.
</para>
'>

<!--

Les entités qui suivent ne sont pas définies dans le fichier
anglais. On devrait penser à leur utilité :
- utile ? on ajoute à la doc en
- inutile ? qu'est ce que ca fait là ?

-->

<!ENTITY php.version.added 'Disponible à partir de PHP '>
<!ENTITY php.version.in 'Disponible en PHP '>
<!ENTITY php.version.retired 'Disponible jusqu&#39;en PHP '>

<!ENTITY imagick.imagickdraw.return.success 'Retourne &true; en cas de succès, et lance une exception
<classname>ImagickDrawException</classname> si une erreur survient.'>
<!ENTITY imagick.imagickpixel.return.success 'Retourne &true; en cas de succès, et lance une exception
<classname>ImagickPixelException</classname> si une erreur survient.'>
<!ENTITY imagick.imagickpixeliterator.return.success 'Retourne &true; en cas de succès, et lance une exception
<classname>ImagickPixelIteratorException</classname> si une erreur survient.'>

<!-- Easy links -->

<!ENTITY string '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.string">chaîne de caractères</link>'>
<!ENTITY integer '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.integer">entier</link>'>
<!ENTITY float '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.float">nombre décimal</link>'>
<!ENTITY boolean '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.boolean">booléen</link>'>
<!ENTITY array '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.array">tableau</link>'>
<!ENTITY object '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.object">objet</link>'>
<!ENTITY void '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.declarations.void">void</link>'>
<!ENTITY iterable '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.iterable">iterable</link>'>


<!ENTITY zero '<literal xmlns="http://docbook.org/ns/docbook">0</literal>'>
<!ENTITY one '<literal xmlns="http://docbook.org/ns/docbook">1</literal>'>

<!-- Widely used -->
<!ENTITY class.theclass 'La classe'>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->