language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 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 cryptographiquement sûres, et <emphasis>ne doit pas</emphasis>
  être utilisée à des fins cryptographiques, ou à des fins qui exigent que les valeurs renvoyées soient indéchiffrables.
 </para>
 <para>
  Si de l&#39;aléatoire cryptographiquement sûre est requis, le <classname>Random\Randomizer</classname> peut être utilisé
  avec le moteur <classname>Random\Engine\Secure</classname>. Pour des cas d&#39;usage simple, les fonctions
  <function>random_int</function> et <function>random_bytes</function> fournissent une <acronym>API</acronym>
   pratique et sûre qui est qui est soutenu par le <acronym>CSPRNG</acronym> du système d&#39;exploitation.
 </para>
</caution>'>

<!ENTITY caution.mt19937-tiny-seed '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Étant donné que le moteur Mt19937 ("Mersenne Twister") prend un seul entier de 32 bits en tant que
  graine, le nombre de séquences aléatoires possibles est limité à seulement 2<superscript>32</superscript>
  (par exemple 4 294 967 296), malgré la période énorme de Mt19937 de 2<superscript>19937</superscript>-1.
 </para>
 <para>
  Quand on se fie à une graine aléatoire implicite ou explicite, les duplications apparaîtront
  beaucoup plus tôt. Les graines dupliquées sont attendues avec une probabilité de 50&#37; après moins de
  80 000 graines générées aléatoirement selon le problème d anniversaire. Une probabilité de 10&#37;
  d une graine dupliquée se produit après avoir généré environ 30 000 graines de manière aléatoire.
 </para>
 <para>
  Cela rend Mt19937 inadapté aux applications où les séquences dupliquées ne doivent pas se produire avec
  plus qu une probabilité négligeable. Si une graine reproductible est requise, à la fois le
  moteur <classname>Random\Engine\Xoshiro256StarStar</classname> et <classname>Random\Engine\PcgOneseq128XslRr64</classname>
  supportent des graines beaucoup plus grandes qui sont peu susceptibles de se heurter de manière aléatoire. Si la reproductibilité
  n&apos;est pas requise, le moteur <classname>Random\Engine\Secure</classname> fournit des données aléatoires cryptographiquement
  sécurisées.
 </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.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>
 Une <type>resource</type> de <link linkend="stream.contexts">contexte de flux</link>.
</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.extractto-windows '<note xmlns="http://docbook.org/ns/docbook"><para>
 Les systèmes de fichiers NTFS Windows ne supportent pas certain caractères dans le noms de fichier,
 à savoir <literal>&lt;|&gt;*?":</literal>.
 Les noms de fichiers avec un point trainant ne sont également pas supporté.
 Contrairement à certains outils d&apos;extraction, cette méthode ne remplace pas ces caractères
 avec un tiret bas, mais échoue à extraire de tel fichiers.
</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.func-named-params '<note xmlns="http://docbook.org/ns/docbook"><para>
 À partir de PHP 8.0.0, la famille de fonction func_*() désigné à être essentiellement
 transparent concernant les arguments nommées, en traitant les arguments comme s&apos;ils
 étaient tous passé de manière positionnelle, et les arguments manquant sont remplacés
 avec leurs valeurs par défaut.
 Cette fonction ignore la collection d&apos;argument variadic nommée inconnue.
 Les arguments nommées qui sont collectionnés sont uniquement accessible à travers le paramètre variadic.
</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, ils maintiennent leur ordre original.
  Antérieur à PHP 8.0.0, leur ordre relatif dans le tableau trié n&#39;est pas défini.
 </para>
</note>
'>

<!ENTITY note.reset-index "<note xmlns='http://docbook.org/ns/docbook'>
 <para>
    Réinitialise le pointeur interne du tableau au premier élément.
 </para>
</note>
">

<!ENTITY note.resource-migration-8.0-dead-function '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Cette fonction n&apos;a aucun effet. Antérieur à PHP 8.0.0,
  cette fonction était utilisé pour fermer une ressource.
 </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-0-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
 Cette fonction est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 7.0.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-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 warn.feature.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Cette fonctionnalité a été <emphasis>SUPPRIMÉE</emphasis> à partir de PHP 8.0.0.</simpara>
</warning>'>

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

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

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

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

<!ENTITY warn.deprecated.feature-8-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonctionnalité est
<emphasis>OBSOLÈTE</emphasis> à partir de PHP 8.4.0. Il est fortement déconseillé
de s’appuyer sur cette fonctionnalité.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction est
<emphasis>OBSOLÈTE</emphasis> à partir de PHP 8.4.0. Il est fortement
déconseillé de s&#39;appuyer sur cette fonction.</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 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 avertissements.
 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>
'>

<!ENTITY warn.deprecated.function-8-1-0.alternatives '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Cette fonction
est <emphasis>OBSOLÈTE</emphasis> à partir de PHP 8.1.0.
Il est fortement recommandé de les éviter.</simpara></warning>
<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.81 '<para xmlns="http://docbook.org/ns/docbook">Résultat de l&#39;exemple ci-dessus en PHP 8.1 :</para>'>

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

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

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

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

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

<!ENTITY example.outputs.84.similar '<para xmlns="http://docbook.org/ns/docbook">La sortie de l&#39;exemple ci-dessus en PHP 8.4 est similaire à :</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 array.changelog.by-ref '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Si <parameter>callback</parameter> attend un paramètre à être passé par
  référence, cette fonction émet désormais une <constant>E_WARNING</constant>.
 </entry>
</row>'>

<!ENTITY array.changelog.require-only-one '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Cette fonction peut désormais être appelée avec un seul paramètre.
  Auparavant, au moins deux paramètres étaient nécessaires.
 </entry>
</row>'>

<!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 les éléments normalement;
     les détails sont décrits dans la section des <link linkend="language.operators.comparison">opérateurs de comparaison</link></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 sort.callback.description '<para xmlns="http://docbook.org/ns/docbook">
&return.callbacksort;
</para>
&callback.cmp;
<caution xmlns="http://docbook.org/ns/docbook">
<para>
Retourner des valeurs <emphasis>non-entières</emphasis> à partir de la fonction
de comparaison, telles que <type>float</type>, entraînera une conversion interne
de la valeur de retour du rappel en <type>int</type>. Ainsi, des valeurs telles que
<literal>0.99</literal> et <literal>0.1</literal> seront toutes deux converties en une
valeur entière de <literal>0</literal>, ce qui comparera de telles valeurs comme égales.
</para>
</caution>'>

<!ENTITY sort.callback.description.presort '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  La fonction de rappel de tri doit traiter n&#39;importe quelle valeur de n&#39;importe quel tableau dans n&#39;importe quel ordre,
  quel que soit l&#39;ordre dans lequel elles ont été initialement fournies.
  Cela s&#39;explique par le fait que chaque tableau individuel est d&#39;abord trié avant d&#39;être comparé aux autres tableaux.

  Par exemple :
  <programlisting role="php">
<![CDATA[
<?php
$arrayA = ["chaîne", 1];
$arrayB = [["value" => 1]];
// $item1 et $item2 peuvent être l&#39;une des valeurs suivantes : "chaîne", 1 ou ["value" => 1]
$compareFunc = static function ($item1, $item2) {
    $value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] : $item1);
    $value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
    return $value1 <=> $value2;
};
?>
]]>
  </programlisting>
 </para>
</caution>'>

<!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 match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</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.type.true '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Le type de retour est maintenant &true;, auparavant il était <type>bool</type>.
 </entry>
</row>'>

<!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.true.always 'Retourne toujours &true;.'>

<!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>'>

<!-- Standard -->
<!ENTITY standard.changelog.calling-on-objects '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Soit convertir l&#39;&object; en un &array; en utilisant <function>get_mangled_object_vars</function> d&#39;abord,
  ou utiliser les méthodes fournies par une classe qui implémente <interfacename>Iterator</interfacename>, telle que
  <classname>ArrayIterator</classname>.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>7.4.0</entry>
 <entry>
  À partir de PHP 7.4.0, les instances de classes <link xmlns="http://docbook.org/ns/docbook" linkend="book.spl">SPL</link> sont traitées comme
  des objets vides sans propriétés au lieu d&#39;appeler la méthode <interfacename>Iterator</interfacename> avec
  le même nom que cette fonction.
 </entry>
</row>
'>

<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Cette fonction ne garantit plus de retourner
  <code>strlen($string1) - strlen($string2)</code> lorsque les longueurs
  des chaînes ne sont pas égales, et peut désormais retourner 
  <literal>-1</literal> ou <literal>1</literal> à la place.
 </entry>
</row>
'>

<!-- FileInfo -->
<!ENTITY fileinfo.parameters.finfo '<para xmlns="http://docbook.org/ns/docbook">Une instance <classname>finfo</classname>, retourné par <function>finfo_open</function>.</para>'>
<!ENTITY fileinfo.changelog.finfo-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  La paramètre <parameter>finfo</parameter> attend désormais une instance de
  <classname>finfo</classname> ; auparavant, une &resource; était attendu.
 </entry>
</row>'>

<!-- 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 une instance
 de <classname>GdFont</classname> retourné par <function>imageloadfont</function>.
</para></listitem></varlistentry>'>

<!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Le paramètre <parameter>font</parameter> accepte désormais une instance de <classname>GdFont</classname>
  et un &integer;; auparavant seulement un  &integer; était accepté.
 </entry>
</row>'>

<!ENTITY gd.ttf.fontfile "
<varlistentry xmlns='http://docbook.org/ns/docbook'>
<term><parameter>fontfile</parameter></term>
<listitem>
    <para>
        Le chemin d&apos;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&apos;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&apos;un
        point-virgule, a été utilisé comme séparateur de chemin d&apos;accès pour
        différents fichiers de police. L&apos;utilisation involontaire de cette
        fonctionnalité se traduira par le message d&apos;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&apos;espaces.
    </para>
    <para>
        Dans de nombreux cas où une police réside dans le même répertoire que le
        script en l&apos;utilisant l&apos;astuce suivante permettra d&apos;atténuer les
        problèmes d&apos;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 non-défini ou &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> <literal>gd</literal> était attendue.
 </entry>
</row>'>

<!-- CSV -->
<!ENTITY warning.csv.escape-parameter '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><simpara>
 Lorsque le <parameter>escape</parameter> est défini sur autre chose qu&apos;une chaîne vide
 (<literal>""</literal>), cela peut entraîner un CSV qui n&apos;est pas conforme à
 <link xlink:href="&url.rfc;4180">RFC 4180</link> ou incapable de survivre à un aller-retour
 à travers les fonctions CSV de PHP. La valeur par défaut pour <parameter>escape</parameter> est
 <literal>"\\"</literal>, il est donc recommandé de la définir explicitement sur une chaîne vide.
 La valeur par défaut changera dans une future version de PHP, au plus tôt dans PHP 9.0.
</simpara></warning>'>

<!-- 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>'>

<!-- dba notes -->
<!ENTITY dba.parameter.dba 'Une instance de <classname xmlns="http://docbook.org/ns/docbook">Dba\Connection</classname>, renvoyée par <function xmlns="http://docbook.org/ns/docbook">dba_open</function> ou <function xmlns="http://docbook.org/ns/docbook">dba_popen</function>.'>
<!ENTITY dba.changelog.dba-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Le paramètre <parameter>dba</parameter> attend désormais une instance de <classname>Dba\Connection</classname>;
  auparavant, une &resource; <literal>dba</literal> valide é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.changelog.imap-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  La paramètre <parameter>imap</parameter> attend désormais une instance de
  <classname>IMAP\Connection</classname> ; auparavant, une &resource; <literal>imap</literal> était attendue.
 </entry>
</row>'>

<!ENTITY imap.imap-parameter.imap '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>imap</parameter></term><listitem><para>
 Une instance de <classname>IMAP\Connection</classname>.
</para></listitem></varlistentry>'>

<!-- Deprecated -->
<!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.parameter.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">Une instance <classname>IntlCalendar</classname>.</para>'>

<!ENTITY intl.error.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">
 En cas d&amp;échec &false; est aussi retourné. Pour détecter les conditions d&amp;erreur
 <function>intl_get_error_code</function> doit être utilisé, ou paramétrer Intl pour lancer des
 <link linkend="ini.intl.use-exceptions">exceptions</link>.
</para>'>

<!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;
est retournée. En cas d&#39;échec, retourne &null;.</para>'>

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

<!ENTITY intl.locale-len.return '<para xmlns="http://docbook.org/ns/docbook">
 Retourne &null; quand la longueur de <parameter>locale</parameter> excède
 <constant>INTL_MAX_LOCALE_LEN</constant>.
</para>'>

<!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.parameter.ldap 'Une instance <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>, retourné par
 <function xmlns="http://docbook.org/ns/docbook">ldap_connect</function>.'>

<!ENTITY ldap.parameter.result 'Une instance <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, retourné par
 <function xmlns="http://docbook.org/ns/docbook">ldap_list</function> ou
 <function xmlns="http://docbook.org/ns/docbook">ldap_search</function>.'>

<!ENTITY ldap.parameter.entry 'Une instance <classname xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname>.'>

<!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>'>

<!ENTITY ldap.changelog.ldap-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Le paramètre <parameter>ldap</parameter> attend désormais une instance de
  <classname>LDAP\Connection</classname> ; auparavant, une &resource; <literal>ldap link</literal> était attendue.
 </entry>
</row>'>

<!ENTITY ldap.changelog.entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Le paramètre <parameter>entry</parameter> attend désormais une instance de
  <classname>LDAP\ResultEntry</classname> ; auparavant, une &resource; <literal>ldap result entry</literal> était attendue.
 </entry>
</row>'>

<!ENTITY ldap.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Le paramètre <parameter>result</parameter> attend désormais une instance de
  <classname>LDAP\Result</classname> ; auparavant, une &resource; <literal>ldap result</literal> était attendue.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Retourne désormais une instance de <classname>LDAP\Result</classname> ;
  auparavant, une &resource; était attendu.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Retourne désormais une instance de <classname>LDAP\ResultEntry</classname> ;
  auparavant, une &resource; était attendu.
 </entry>
</row>'>

<!ENTITY ldap.return-result 'Retourne une instance de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,&return.falseforfailure;.'>

<!ENTITY ldap.return-result-array 'Retourne une instance de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, un tableau des instances de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,&return.falseforfailure;.'>

<!ENTITY ldap.return-result-array-info '<para xmlns="http://docbook.org/ns/docbook">Il est également possible d&#39;effectuer des recherches parallèles. Dans ce cas, le premier argument doit être un tableau des
instances de <classname>LDAP\Connection</classname>, plutôt qu&#39;une seule.
Si les recherches ne devraient pas utiliser le même nom distingué (DN) de base et filtre, un tableau de DN de base et/ou un tableau de filtre peuvent être passé comme arguments à la place.
Ces tableaux doivent être de la même taille que le tableau des instances de <classname>LDAP\Connection</classname>,

puisque les premières entrées des tableaux sont utilisées pour une recherche, les secondes pour une autre, et ainsi de suite.
Lors de recherches parallèles, un tableau des instances de <classname>LDAP\Result</classname> est retourné, sauf en cas d&#39;erreur, où la valeur de retour sera &false;.</para>'>

<!-- 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>'>

<!ENTITY mbstring.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> accepte désormais une chaîne vide.
 </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.note.delete-time '<note xmlns="http://docbook.org/ns/docbook"><simpara>
       À partir de memcached 1.3.0 (sortie en 2009) cette fonctionalité n&#39;est plus supporté.
       Passer un <parameter>time</parameter> non-zéro causera l&#39;échec de la suppression.
       <methodname>Memcached::getResultCode</methodname>
       retournera <constant>MEMCACHED_INVALID_ARGUMENTS</constant>.
      </simpara></note>
'>

<!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.'>

<!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
   Retourne un tableau indexé par <parameter>keys</parameter>. Chaque élément est
   &true; si la clé correspondante a été supprimée, ou une des constantes
   <constant>Memcached::RES_<replaceable>*</replaceable></constant> si la suppression correspondante a échoué.
   </para>
  <para xmlns="http://docbook.org/ns/docbook">
   La méthode <methodname>Memcached::getResultCode</methodname> retournera
   le code de résultat pour la dernière opération de suppression éxécuté, c&#39;est à dire,
   l&#39;opération de suppression pour le dernier élément de <parameter>keys</parameter>.
  </para>
'>

<!-- 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.'>

<!-- pspell notes -->

<!ENTITY pspell.changelog.pspell-dictionary '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  La paramètre <parameter>dictionary</parameter> attend désormais une instance de
  <classname>PSpell\Dictionary</classname> ; auparavant, une &resource; était expected.
 </entry>
</row>'>

<!ENTITY pspell.changelog.pspell-config '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Le paramètre <parameter>config</parameter> attend désormais une instance de
  <classname>PSpell\Config</classname> ; auparavant, une &resource; était expected.
 </entry>
</row>'>

<!ENTITY pspell.parameter.pspell-dictionary '<para xmlns="http://docbook.org/ns/docbook">Une instance de <classname>PSpell\Dictionary</classname>.</para>'>

<!ENTITY pspell.parameter.pspell-config '<para xmlns="http://docbook.org/ns/docbook">Une instance de <classname>PSpell\Config</classname>.</para>'>

<!-- RNP -->

<!ENTITY rnp.parameter.ffi-description 'L&apos;objet FFI retourné par rnp_ffi_create.'>

<!ENTITY rnp.parameter.key-format 'Le format de clé pour la donnée (GPG, KBX, G10).'>

<!ENTITY rnp.parameter.loadsave-flags 'Voir la description des drapeaux RNP_LOAD_SAVE_*.'>

<!-- 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 sérialisées à analyser'>

<!ENTITY gearman.parameter.data 'Données additionnelles 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'>

<!ENTITY gearman.parameter.callback '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>callback</parameter></term>
 <listitem>
  <para>
   Une fonction ou méthode à appeler.
   Elle doit retourner une valeur valide <link linkend="gearman.constants">de retour Gearman</link>.
  </para>
  <para>
   Si aucune instruction de retour n&#39;est présente, la valeur par défaut sera <constant>GEARMAN_SUCCESS</constant>.
  </para>
  <methodsynopsis>
   <type>int</type><methodname><replaceable>callback</replaceable></methodname>
   <methodparam><type>GearmanTask</type><parameter>task</parameter></methodparam>
   <methodparam><type>mixed</type><parameter>context</parameter></methodparam>
  </methodsynopsis>
  <variablelist>
   <varlistentry>
    <term><parameter>task</parameter></term>
    <listitem>
     <para>
      La tâche pour laquelle ce callback est appelé.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>context</parameter></term>
    <listitem>
     <para>
      Tout ce qui a été passé à <methodname>GearmanClient::addTask</methodname> (ou méthode équivalente) en tant que <parameter>context</parameter>.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </listitem>
</varlistentry>'>

<!ENTITY gearman.note.callback '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Le callback ne sera déclenché que pour les tâches qui sont ajoutées (par exemple en appelant <methodname>GearmanClient::addTask</methodname>)
  après l&#39;appel de cette méthode.
 </para>
</note>'>

<!-- 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.
De plus, ces fuseaux horaires peuvent être supprimée de la base de donnée IANA de fuseaux horaire à tout moment.
</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 diagnostic de type
<constant>E_WARNING</constant> si le fuseau horaire n&#39;est pas valide.
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 modifié <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> pour chainer les méthodes&return.falseforfailure;.'>
<!ENTITY date.datetime.return.modifiedobject 'Retourne l&#39;objet modifié <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> pour chainer les méthodes.'>
<!ENTITY date.datetimeimmutable.return.modifiedobjectorfalseforfailure 'Retourne un nouvel objet
 <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> avec les données modifiées &return.falseforfailure;.'>
<!ENTITY date.datetimeimmutable.return.modifiedobject 'Retourne un nouvel objet
 <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> avec les données modifiées.'>

<!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 'Amérique'>
<!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 'Abré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.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>mb_convert_encoding</function>,
 <methodname>UConverter::transcode</methodname>, ou <function>iconv</function> pour manipuler d&apos;autres encodages.
</para></note>'>

<!ENTITY dom.note.modern.utf8 '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  L&apos;extension DOM utilise l&apos;encodage UTF-8 lors de l&apos;utilisation des méthodes ou des propriétés.
  Les méthodes du parseur détectent automatiquement l&apos;encodage ou permettent à l&apos;appelant de spécifier un encodage.
 </simpara>
</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>'>
<!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Utilisez <classname>Dom\HTMLDocument</classname> pour analyser et traiter le HTML moderne au lieu de <classname>DOMDocument</classname>.
 </simpara>
 <simpara>
  Cette fonction analyse l&#39;entrée en utilisant un parseur HTML 4. Les règles d&#39;analyse
  du HTML 5, qui sont celles utilisées par les navigateurs web modernes, sont différentes.
  Selon l&#39;entrée, cela peut entraîner une structure DOM différente. Par conséquent,
  cette fonction ne peut pas être utilisée en toute sécurité pour la sanitisation du HTML.
 </simpara>
 <simpara>
  Le comportement lors de l&#39;analyse du HTML peut dépendre de la version de
  <literal>libxml</literal> qui est utilisée, notamment en ce qui concerne
  les conditions limites et la gestion des erreurs.
  Pour une analyse conforme à la spécification HTML5,
  utilisez <methodname>Dom\HTMLDocument::createFromString</methodname> ou
  <methodname>Dom\HTMLDocument::createFromFile</methodname>, ajoutés dans PHP 8.4.
 </simpara>
 <simpara>
  Par exemple, certains éléments HTML fermeront implicitement un élément parent
  lorsqu&#39;ils sont rencontrés. Les règles de fermeture automatique des éléments parents
  diffèrent entre HTML 4 et HTML 5, et par conséquent, la structure DOM que
  <classname>DOMDocument</classname> voit peut être différente de celle qu&#39;un navigateur
  web voit, ce qui peut éventuellement permettre à un attaquant de compromettre le HTML
  résultant.
 </simpara>
</warning>'>
<!ENTITY dom.tokenlist.errors '
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   Lève une <exceptionname>ValueError</exceptionname> si
   un token contient des octets nuls.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Lève une <exceptionname>Dom\DOMException</exceptionname> avec le code
   <constant>Dom\SYNTAX_ERR</constant> si un token est une chaîne vide.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Lève une <exceptionname>Dom\DOMException</exceptionname> avec le code
   <constant>Dom\INVALID_CHARACTER_ERR</constant> si un token contient des
   espaces ASCII.
  </simpara>
 </listitem>
</itemizedlist>
'>

<!-- 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>'>

<!-- Dom entities -->
<!ENTITY dom.parameter.options '<para xmlns="http://docbook.org/ns/docbook">
  <link linkend="language.operators.bitwise">Opération de &apos;OU&apos; logique</link>
  des <link linkend="libxml.constants">constantes d&apos;option libxml</link>.
</para>'>

<!ENTITY dom.parameter.compliant.options '&dom.parameter.options;
 <simpara xmlns="http://docbook.org/ns/docbook">
  Il est également possible de passer <constant>Dom\HTML_NO_DEFAULT_NS</constant>
  pour désactiver l&#39;utilisation de l&#39;espace de noms HTML et de l&#39;élément template.
  Cela ne devrait être utilisé que si les implications sont correctement comprises.
 </simpara>'>

<!ENTITY dom.parameter.compliant.encoding '<simpara xmlns="http://docbook.org/ns/docbook">
 L&#39;encodage dans lequel le document a été créé.
 S&#39;il n&#39;est pas fourni, il tentera de déterminer l&#39;encodage le plus probable utilisé.
 </simpara>'>

<!ENTITY dom.parser.compliant.note.whitespace '<refsect1 role="notes" xmlns="http://docbook.org/ns/docbook">
 &reftitle.notes;
 <note>
  <simpara>
   Les espaces blancs dans les balises <literal>html</literal> et <literal>head</literal>
   ne sont pas considérés comme significatifs et peuvent perdre leur formatage.
  </simpara>
 </note>
</refsect1>'>

<!ENTITY dom.parameters.register_node_ns '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>registerNodeNS</parameter></term>
 <listitem>
  <para>
   Indique s&#39;il faut automatiquement enregistrer les préfixes de namespace en vigueur du nœud de contexte dans l&#39;objet <classname>DOMXPath</classname>.
   Cela peut être utilisé pour éviter d&#39;avoir à appeler manuellement <methodname>DOMXPath::registerNamespace</methodname> pour chaque namespace en vigueur.
   En cas de conflit de préfixes de namespace, seul le préfixe de namespace descendant le plus proche est enregistré.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.parameters.serialize.options '<simpara xmlns="http://docbook.org/ns/docbook">
 Options supplémentaires.
 Les options <constant>LIBXML_NOEMPTYTAG</constant>
 et <constant>LIBXML_NOXMLDECL</constant> sont prises en charge.
 Avant PHP 8.3.0, seule l&#39;option <constant>LIBXML_NOEMPTYTAG</constant>
 est prise en charge.
</simpara>'>


<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
    Levée si le parent est d&apos;un type qui n&apos;autorise pas les enfants du
    type de l&apos;un des <parameter>nodes</parameter> transmis, ou si le nœud à
    insérer est l&apos;un des ancêtres de ce nœud ou ce nœud lui-même.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
    Levée si ce nœud est d&apos;un type qui n&apos;autorise pas les enfants du
    type de l&apos;un des <parameter>nodes</parameter> transmis, ou si le nœud à
    insérer est l&apos;un des ancêtres de ce nœud ou ce nœud lui-même.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.wrong_document '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
  <listitem>
  <para>
    Levée si l&apos;un des <parameter>nodes</parameter> transmis a été créé à partir d&apos;un document différent
    de celui qui a créé ce nœud.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.compliant.wrong_document '<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Lève une exception <exceptionname>Dom\DOMException</exceptionname> avec le code
  <constant>Dom\WRONG_DOCUMENT_ERR</constant> si le <parameter>node</parameter>
  provient d&#39;un autre document.
 </simpara>
</listitem>'>

<!ENTITY dom.errors.compliant.common '<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Lève une exception <exceptionname>ValueError</exceptionname> si
  <parameter>options</parameter> contient une option invalide.
 </simpara>
</listitem>
<listitem>
 <simpara>
  Lève une exception <exceptionname>ValueError</exceptionname> si
  <parameter>overrideEncoding</parameter> utilise un encodage inconnu.
 </simpara>
</listitem>'>

<!ENTITY dom.changelog.previous_hierarchy_exception 'Auparavant, cela déclenchait une
 <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> avec le code
 <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant>.'>

<!ENTITY dom.c14n.xpath_array '<listitem xmlns="http://docbook.org/ns/docbook">
  <para>
   Un tableau de XPaths pour filtrer les nœuds.
   Chaque entrée dans ce tableau est un tableau associatif avec :
   <itemizedlist>
    <listitem>
     <simpara>
      Une clé <literal>query</literal> requise contenant l&apos;expression XPath en tant que chaîne de caractères.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Une clé <literal>namespaces</literal> optionnelle contenant un tableau qui mappe les préfixes de l&apos;espace de noms (clés) aux URI de l&apos;espace de noms (valeurs).
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </listitem>'>

<!-- 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;objet de connexion ODBC,
voir la documentation de la fonction <function>odbc_connect</function> pour plus
de détails.</para>'>

<!ENTITY odbc.result.object 'L’objet de résultat ODBC'>

<!ENTITY odbc.result.object-return 'Renvoie un objet de résultat ODBC'>

<!ENTITY odbc.result.object-return-falseforfailure '&odbc.result.object-return;&return.falseforfailure;.'>

<!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.'>

<!ENTITY odbc.changelog.connection-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  <parameter>odbc</parameter> attend désormais une instance de
  <classname>Odbc\Connection</classname>; auparavant, un <type>resource</type> était attendu.
 </entry>
</row>'>

<!ENTITY odbc.changelog.connection-return '&odbc.changelog.connection-param;
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Cette fonction retourne désormais une instance de
   <classname>Odbc\Connection</classname>; auparavant, un <type>resource</type> était retourné.
  </entry>
 </row>'>

<!ENTITY odbc.changelog.credential-params '
<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   <parameter>user</parameter> et <parameter>password</parameter> peuvent désormais être nuls,
   ils sont également optionnels et valent par défaut &null;.
  </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Auparavant, l&#39;utilisation d&#39;une chaîne vide pour <parameter>password</parameter>
   n&#39;incluait pas <literal>pwd</literal> dans la chaîne de connexion générée
   pour <parameter>dsn</parameter>.
   Désormais, <literal>pwd</literal> est inclus dans la chaîne de connexion, avec
   pour valeur une chaîne vide.
   Pour rétablir le comportement précédent, <parameter>password</parameter> peut
   être défini sur &null;.
  </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Auparavant, si <parameter>dsn</parameter> contenait <literal>uid</literal> ou <literal>pwd</literal>,
   alors les paramètres <parameter>user</parameter> et <parameter>password</parameter> étaient ignorés.
   Désormais, <parameter>user</parameter> est uniquement ignoré si <parameter>dsn</parameter> contient
   <literal>uid</literal>, et <parameter>password</parameter> est uniquement ignoré si
   <parameter>dsn</parameter> contient <literal>pwd</literal>.
  </entry>
</row>
'>

<!ENTITY odbc.changelog.result-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  <parameter>statement</parameter> attend désormais une instance de
  <classname>Odbc\Result</classname>; auparavant, un <type>resource</type> était attendu.
 </entry>
</row>'>

<!ENTITY odbc.changelog.result-return '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Cette fonction retourne désormais une instance de
  <classname>Odbc\Result</classname>; auparavant, un <type>resource</type> était retourné.
 </entry>
</row>'>

<!-- 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é ou &null;, 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&#39;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>'>

<!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> ou <link linkend="functions.named-arguments">arguments nommés</link>.
</simpara></note>'>

<!-- 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 cœur 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 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>'>

<!-- 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>'>

<!-- PDO errors -->

<!ENTITY pdo.errors '<para xmlns="http://docbook.org/ns/docbook">
Émet une erreur de niveau <constant>E_WARNING</constant> si l&#39;attribut <constant>PDO::ATTR_ERRMODE</constant> est défini
à <constant>PDO::ERRMODE_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Lève une exception <classname>PDOException</classname> si l&#39;attribut <constant>PDO::ATTR_ERRMODE</constant> est défini
à <constant>PDO::ERRMODE_EXCEPTION</constant>.
</para>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'Cette extension &link.pecl; n&#39;est pas intégrée à PHP.'>

<!ENTITY pecl.bundled 'Cette extension &link.pecl; 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.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.pecl; et ne sera plus intégrée dans PHP à partir de PHP '>

<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>Cette extension est <emphasis>non maintenue</emphasis>.</simpara>
</warning>'>

<!-- PGSQL entities -->

<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Une instance <classname>PgSql\Connection</classname>.</para>'>

<!ENTITY pgsql.parameter.connection-with-unspecified-default '<para xmlns="http://docbook.org/ns/docbook">
 Une instance <classname>PgSql\Connection</classname>.
 Quand <parameter>connection</parameter> est pas spécifié, la connexion par défaut est utilisé.
 La connexion par défaut est la dernière connexion faite par
 <function>pg_connect</function> ou <function>pg_pconnect</function>
 <warning><simpara>À partir de PHP 8.1.0, utiliser la connexion par défaut est obsolète.</simpara></warning>
</para>'>

<!ENTITY pgsql.parameter.connection-with-nullable-default '<para xmlns="http://docbook.org/ns/docbook">
 Une instance <classname>PgSql\Connection</classname>.
 Quand <parameter>connection</parameter> est &null;, la connexion par défaut est utilisé.
 La connexion par défaut est la dernière connexion faite par
 <function>pg_connect</function> ou <function>pg_pconnect</function>
 <warning><simpara>À partir de PHP 8.1.0, utiliser la connexion par défaut est obsolète.</simpara></warning>
 </para>'>

<!ENTITY pgsql.parameter.result '<para xmlns="http://docbook.org/ns/docbook">
 Une instance <classname>PgSql\Result</classname>, retourné par <function>pg_query</function>,
 <function>pg_query_params</function>, ou <function>pg_execute</function> (entre autres).
</para>'>

<!ENTITY pgsql.parameter.lob '<para xmlns="http://docbook.org/ns/docbook">Une instance <classname>PgSql\Lob</classname>, retourné par <function>pg_lo_open</function>.</para>'>

<!ENTITY pgsql.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">
Un paramètre optionnel qui contrôle la façon dont le <type>array</type> retourné est indexé.
<parameter>mode</parameter> est une constante qui peut prendre les valeurs suivantes :
<constant>PGSQL_ASSOC</constant>, <constant>PGSQL_NUM</constant> et <constant>PGSQL_BOTH</constant>.
En utilisant <constant>PGSQL_NUM</constant>, la fonction retournera un tableau avec des indices numériques,
en utilisant <constant>PGSQL_ASSOC</constant>, elle retournera seulement des indices associatifs
tandis que <constant>PGSQL_BOTH</constant> retournera à la fois des indices numériques et associatifs.</para>'>

<!ENTITY pgsql.changelog.connection-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Le paramètre <parameter>connection</parameter> attend désormais une instance de
  <classname>PgSql\Connection</classname> ; auparavant, une &resource; était attendu.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Le paramètre <parameter>result</parameter> attend désormais une instance de
  <classname>PgSql\Result</classname> ; auparavant, une &resource; était attendu.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.lob-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Le paramètre <parameter>lob</parameter> attend désormais une instance de
  <classname>PgSql\Lob</classname> ; auparavant, une &resource; était attendu.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Retourne désormais une instance de <classname>PgSql\Result</classname> instance ;
  auparavant, une &resource; était retourné.
 </entry>
</row>'>

<!-- 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>'>

<!-- 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>'>

<!ENTITY note.ctype.parameter.non-string "<warning xmlns='http://docbook.org/ns/docbook'><para>
À partir de PHP 8.1.0, passer un argument différent d'une chaîne est obsolète.
À l&#39;avenir, l#39;argument sera interprété comme une chaîne de caractères au lieu d'un point de code ASCII.
Selon le comportement souhaité, l&#39;argument doit être transtypé en &string; ou un appel explicite à <function>chr</function> doit être effectué.</para></warning>">

<!ENTITY ctype.result.empty-string 'Lorsque appelé avec une chaîne vide, le résultat sera toujours &false;.'>

<!-- FTP Notes -->
<!ENTITY ftp.changelog.ftp-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  La paramètre <parameter>ftp</parameter> attend désormais une instance de
  <classname>FTP\Connection</classname> ; auparavant, une &resource; était attendu.
 </entry>
</row>'>
<!ENTITY ftp.parameter.ftp '<para xmlns="http://docbook.org/ns/docbook">Une instance de <classname>FTP\Connection</classname>.</para>'>

<!-- 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 un &string; qui peut être interprété comme un nombre suivant la même logique
 que si la chaîne était utilisée dans <function>gmp_init</function> avec détection automatique de la base (c&#39;est-à-dire lorsque <parameter>base</parameter> est égal à 0).
</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 <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>'>

<!ENTITY mysqli.integer.overflow.as.string.note '<note xmlns="http://docbook.org/ns/docbook"><para>
 Si le nombre de ligne est supérieur à <constant>PHP_INT_MAX</constant>, le nombre sera retourné en tant que &string;.
</para></note>'>

<!ENTITY mysqli.sqlinjection.warning '<warning xmlns="http://docbook.org/ns/docbook">
 <title>Avertissement de Sécurité : injection SQL</title>
 <para>Si la requête contiens des variables d&apos;entrées alors des
 <link linkend="mysqli.quickstart.prepared-statements">déclarations préparées paramétrisées</link>
 devrait être utilisé à la place. Alternativement, les données doivent être correctement
 formatées et toutes les chaînes de caractères doivent être échappées en utilisant la fonction
 <function>mysqli_real_escape_string</function>.</para>
</warning>'>

<!ENTITY mysqli.conditionalexception '<para xmlns="http://docbook.org/ns/docbook">
Si le rapport d&#39;erreurs mysqli est activé (<constant>MYSQLI_REPORT_ERROR</constant>) et que l&#39;opération demandée échoue,
un avertissement est généré. Si, en plus, le mode est défini sur <constant>MYSQLI_REPORT_STRICT</constant>,
une <classname>mysqli_sql_exception</classname> est lancée à la place.</para>'>

<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<para xmlns="http://docbook.org/ns/docbook">
Si le masque regex passé ne compile pas à une regex valide, une <constant>E_WARNING</constant> est émise.
</para>'>

<!-- 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>'>

<!-- Notes for SAPI/FPM -->
<!ENTITY fpm.intro "<para xmlns='http://docbook.org/ns/docbook'>FPM (FastCGI Process Manager, gestionnaire de processus FastCGI)
est une alternative à l&#39;implémentation PHP FastCGI avec des fonctionnalités supplémentaires utiles pour les sites très fortement chargés.
</para>">

<!-- 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 tamponné.</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>'>

<!-- 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 de niveau
 <constant>E_WARNING</constant> sera 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é, la dernière connexion
 ouverte avec la fonction <function>mysql_connect</function> sera utilisée.
 Si aucune connexion n&#39;est trouvée ou é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 de niveau
 <constant>E_WARNING</constant> sera 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>'>

<!-- 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>'>

<!-- 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 warn.install.third-party-support '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <para>
  Les versions provenant de tiers sont considérées comme non officielles et ne
  sont pas directement prises en charge par le projet PHP. Tout bogue rencontré
  doit être signalé au fournisseur de ces versions non officielles, sauf s&apos;il peut
  être reproduit à l&apos;aide des versions provenant de <link xlink:href="&url.php.downloads;">
  la zone de téléchargement officielle</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'>

<!-- runkit entities -->
<!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.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>
'>

<!-- 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.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>'>

<!ENTITY stream.bucket.param '<parameter>bucket</parameter> attend désormais une instance de <classname>StreamBucket</classname> ; auparavant, une <classname>stdClass</classname> était attendue.'>
<!ENTITY stream.bucket.return 'Cette fonction retourne désormais une instance de <classname>StreamBucket</classname> ; auparavant, une <classname>stdClass</classname> était retournée.'>

<!-- 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.'>

<!ENTITY reflection.getattributes.param.name '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>name</parameter></term>
<listitem>
 <para>
  Filtrer les résultats pour inclure uniquement les instances
  de <classname>ReflectionAttribute</classname> pour les attributs correspondant à ce nom de classe.
 </para>
</listitem>
</varlistentry>'>

<!ENTITY reflection.getattributes.param.flags '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>flags</parameter></term>
<listitem>
 <para>
  Flags pour déterminer comment filtrer les résultats, si <parameter>name</parameter> est fourni.
 </para>
 <para>
  La valeur par défaut est <literal>0</literal> qui ne renverra que les résultats
  pour les attributs qui sont de la classe <parameter>name</parameter>.
 </para>
 <para>
  La seule autre option disponible est d&#39;utiliser <constant>ReflectionAttribute::IS_INSTANCEOF</constant>,
  qui utilisera plutôt <literal>instanceof</literal> pour le filtrage.
 </para>
</listitem>
</varlistentry>'>

<!-- 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.fastk.ma.type 'Type de moyenne mobile pour Fast-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.'>

<!-- mongodb -->
<!ENTITY mongodb.changelog.tentative-return-types '
<row xmlns="http://docbook.org/ns/docbook">
  <entry>PECL mongodb 1.15.0</entry>
  <entry>
    Les types de retours des méthodes sont déclarés comme provisoires en PHP 8.0 et ultérieur,
    ce qui déclenche des avis de dépréciation dans le code qui implémente cette interface sans déclarer
    les types de retours appropriés.
    L&#39;attribut <code>#[ReturnTypeWillChange]</code> peut être ajouté
    pour ignorer la notice de dépréciation.
  </entry>
</row>
'>

<!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.let '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>let</entry>
  <entry><type class="union"><type>array</type><type>object</type></type></entry>
  <entry>
   <para>
    Dictionnaire des noms et des valeurs des paramètres. Les valeurs doivent être des constantes ou des expressions fermées qui ne font pas référence aux champs du document. Les paramètres peuvent ensuite être accédés en tant que variables dans un contexte d&#39;expression agrégée (par exemple <literal>$$var</literal>).
   </para>
   <para>
    Cette option est disponible dans MongoDB 5.0+ et entraînera une exception au moment de l&#39;exécution si elle est spécifiée pour une version antérieure du serveur.
   </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. Cette option est requise.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
          <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.
            Les fournisseurs supporté sont <literal>"aws"</literal>,
            <literal>"azure"</literal>, <literal>"gcp"</literal> et
            <literal>"local"</literal>, et au moins un doit être spécifié.
           </para>
           <para>
            Si un document vide est spécifié pour <literal>"aws"</literal>,
            <literal>"azure"</literal>, ou <literal>"gcp"</literal>, le pilote
            tentera de configurer le fournisseur en utilisant
            <link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Automatic Credentials</link>.
           </para>
           <para>
            Le format pour <literal>"aws"</literal> est le suivant :
           </para>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>,
    sessionToken: <optional string>
}
]]>
           </programlisting>
           <para>
            Le format pour <literal>"azure"</literal> est le suivant :
           </para>
           <programlisting role="javascript">
<![CDATA[
azure: {
    tenantId: <string>,
    clientId: <string>,
    clientSecret: <string>,
    identityPlatformEndpoint: <optional string> // Defaults to "login.microsoftonline.com"

}
]]>
           </programlisting>
           <para>
            Le format pour <literal>"gcp"</literal> est le suivant :
           </para>
           <programlisting role="javascript">
<![CDATA[
gcp: {
    email: <string>,
    privateKey: <base64 string>|<MongoDB\BSON\Binary>,
    endpoint: <optional string> // Defaults to "oauth2.googleapis.com"

}
]]>
           </programlisting>
           <para>
            Le format pour <literal>"kmip"</literal> est le suivant :
           </para>
           <programlisting role="javascript">
<![CDATA[
kmip: {
    endpoint: <string>
}
]]>
           </programlisting>
           <para>
            Le format pour <literal>"local"</literal> est le suivant :
           </para>
           <programlisting role="javascript">
<![CDATA[
local: {
    // 96-byte master key used to encrypt/decrypt data keys
    key: <base64 string>|<MongoDB\BSON\Binary>
}
]]>
           </programlisting>
          </entry>
         </row>
'>

<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Options du fournisseur <literal>"aws"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>string</entry>
       <entry>Requis. Le nom de ressource Amazon (ARN) de la clé maîtresse du client AWS (CMK).</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optionnel. Un identifiant d&#39;hôte alternatif pour envoyer les demandes KMS. Peut inclure le numéro de port.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Options du fournisseur <literal>"azure"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>string</entry>
       <entry>Requis. Hôte avec port optionnel (par exemple, "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optionnel. Une version spécifique de la clé nommée. Par défaut, la version primaire de la clé est utilisée.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Options du fournisseur <literal>"gcp"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Requis.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optionnel. Une version spécifique de la clé nommée. Par défaut, la version primaire de la clé est utilisée.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optionnel. Hôte avec port optionnel. La valeur par défaut est "cloudkms.googleapis.com".</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Options du fournisseur <literal>"kmip"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>string</entry>
       <entry>Optionnel. Identifiant unique d&#39;un objet géré de 96 octets de données secrètes KMIP. S&#39;il n&#39;est pas spécifié, le pilote crée un objet géré aléatoire de 96 octets de données secrètes KMIP.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optionnel. Hôte avec port optionnel.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
'>

<!ENTITY mongodb.option.encryption.tlsOptions '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>tlsOptions</entry>
  <entry><type>array</type></entry>
  <entry>
   <para>
    Un document contenant la configuration TLS d&apos;un ou plusieurs
    fournisseurs KMS.
    Les fournisseurs supporté sont <literal>"aws"</literal>,
    <literal>"azure"</literal>, <literal>"gcp"</literal> et
    <literal>"kmip"</literal>.
    Tous les fournisseurs supportent les options suivantes :
   </para>
   <programlisting role="javascript">
<![CDATA[
<provider>: {
    tlsCaFile: <optional string>,
    tlsCertificateKeyFile: <optional string>,
    tlsCertificateKeyFilePassword: <optional string>,
    tlsDisableOCSPEndpointCheck: <optional bool>
}
]]>
   </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.encryptOpts '
<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term>
    <parameter>options</parameter>
  </term>
  <listitem>
    <para>
      <table>
        <title>Options de chiffrement</title>
        <tgroup cols="3">
          <thead>
            <row>
              <entry>Option</entry>
              <entry>Type</entry>
              <entry>Description</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>algorithm</entry>
              <entry>
                <type>string</type>
              </entry>
              <entry>
                <para>
                  L&apos;algorithme de chiffrement à utiliser. Cette option est requise. Spécifiez l&apos;une des constantes suivantes de
                  <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption</link> :
                </para>
                <simplelist>
                  <member>
                    <constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant>
                  </member>
                  <member>
                    <constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant>
                  </member>
                  <member>
                    <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
                  </member>
                  <member>
                    <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant>
                  </member>
                  <member>
                    <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>
                  </member>
                </simplelist>
              </entry>
            </row>
            <row>
              <entry>contentionFactor</entry>
              <entry>
                <type>int</type>
              </entry>
              <entry>
                <para>
                  Le facteur de contention pour évaluer les requêtes avec des charges utiles chiffrées indexées.
                </para>
                <para>
                  Cette option s&apos;applique uniquement et ne peut être spécifiée que lorsque
                  <literal>algorithm</literal> est
                  <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant> ou
                  <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
                </para>
              </entry>
            </row>
            <row>
              <entry>keyAltName</entry>
              <entry>
                <type>string</type>
              </entry>
              <entry>
                <para>
                  Identifie un document de collection de coffre à clés par <literal>keyAltName</literal>. Cette option est mutuellement exclusive
                  avec <literal>keyId</literal> et l&apos;une des deux est requise.
                </para>
              </entry>
            </row>
            <row>
              <entry>keyId</entry>
              <entry>
                <classname>MongoDB\BSON\Binary</classname>
              </entry>
              <entry>
                <para>
                  Identifie une clé de données par <literal>_id</literal>. La valeur est un UUID (sous-type binaire 4). Cette option est mutuellement
                  exclusive avec <literal>keyAltName</literal> et l&apos;une des deux est requise.
                </para>
              </entry>
            </row>
            <row>
              <entry>queryType</entry>
              <entry>
                <type>string</type>
              </entry>
              <entry>
                <para>
                  Le type de requête pour évaluer les requêtes avec des charges utiles chiffrées indexées. Spécifiez l&apos;une des constantes suivantes de
                  <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption</link> :
                </para>
                <simplelist>
                  <member>
                    <constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY</constant>
                  </member>
                  <member>
                    <constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE</constant>
                  </member>
                </simplelist>
                <para>
                  Cette option s&apos;applique uniquement et ne peut être spécifiée que lorsque
                  <literal>algorithm</literal> est
                  <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant> ou
                  <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
                </para>
              </entry>
            </row>
            <row>
              <entry>rangeOpts</entry>
              <entry>
                <type>array</type>
              </entry>
              <entry>
                <para>
                  Options d&apos;index pour un champ de chiffrement interrogeable prenant en charge les requêtes "range". Les options ci-dessous doivent correspondre
                  aux valeurs définies dans <literal>encryptedFields</literal> de la collection cible. Pour les types de champ BSON double et decimal128,
                  <literal>min</literal>, <literal>max</literal> et <literal>precision</literal> doivent être tous définis ou tous non définis.
                </para>
                <para>
                  <table>
                    <title>Options d&apos;index de plage</title>
                    <tgroup cols="3">
                      <thead>
                        <row>
                          <entry>Option</entry>
                          <entry>Type</entry>
                          <entry>Description</entry>
                        </row>
                      </thead>
                      <tbody>
                        <row>
                          <entry>min</entry>
                          <entry>
                            <type>mixed</type>
                          </entry>
                          <entry>Requis si <literal>precision</literal> est défini. La valeur BSON minimale de la plage.</entry>
                        </row>
                        <row>
                          <entry>max</entry>
                          <entry>
                            <type>mixed</type>
                          </entry>
                          <entry>Requis si <literal>precision</literal> est défini. La valeur BSON maximale de la plage.</entry>
                        </row>
                        <row>
                          <entry>sparsity</entry>
                          <entry>
                            <type>int</type>
                          </entry>
                          <entry>Optionnel.Entier positif sur 64 bits.</entry>
                        </row>
                        <row>
                          <entry>precision</entry>
                          <entry>
                            <type>int</type>
                          </entry>
                          <entry>
                           Facultatif. Entier positif sur 32 bits spécifiant la précision à utiliser
                           pour le chiffrement explicite. Peut uniquement être défini pour les types
                           de champ BSON double ou decimal128.
                          </entry>
                       </row>
                       <row>
                        <entry>trimFactor</entry>
                        <entry><type>int</type></entry>
                        <entry>Optionnel. Entier positif sur 32 bits.</entry>
                       </row>
                      </tbody>
                    </tgroup>
                  </table>
                </para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </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="mongodb.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>'>

<!-- Not used in EN anymore -->
<!ENTITY mongodb.note.queryable-encryption-preview ''>

<!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, l&apos;extension 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>
'>

<!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
     Les documents BSON peuvent techniquement contenir des clés dupliquées car
     les documents sont stockés en tant qu&apos;une liste de paire clé-valeur ;
     cependant, les applications devrait s&apos;abstenir de générer des
     documents avec des clés dupliquées car le comportement du serveur et du
     pilote peut être indéfinie. Puisque les objets et tableaux PHP ne peuvent
     pas avoir de clés dupliquées, les données pourraient aussi être perdu lors
     du décodage d&apos;un document BSON avec des clés dupliquées.
    </simpara>
   </warning>
'>

<!-- 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>file_descriptor</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>
</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.stripped.characters '
 <itemizedlist xmlns="http://docbook.org/ns/docbook">
    <listitem>
     <simpara>
      <literal>" "</literal> : caractère <acronym>SP</acronym> en <acronym>ASCII</acronym>
      <literal>0x20</literal>, un espace ordinaire.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\t"</literal> : caractère <acronym>HT</acronym> en <acronym>ASCII</acronym>
      <literal>0x09</literal>, une tabulation.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\n"</literal> : caractère <acronym>LF</acronym> en <acronym>ASCII</acronym>
      <literal>0x0A</literal>, un saut de ligne (line feed).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\r"</literal> : caractère <acronym>CR</acronym> en <acronym>ASCII</acronym>
      <literal>0x0D</literal>, un retour chariot.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\0"</literal> : caractère <acronym>NUL</acronym> en <acronym>ASCII</acronym>
      <literal>0x00</literal>, l&#39;octet NUL.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\v"</literal> : caractère <acronym>VT</acronym> en <acronym>ASCII</acronym>
      <literal>0x0B</literal>, une tabulation verticale.
     </simpara>
    </listitem>
   </itemizedlist>
'>

<!ENTITY strings.stripped.unicode '
 <itemizedlist xmlns="http://docbook.org/ns/docbook">
    <listitem>
     <simpara>
      <literal>" "</literal> (<acronym>Unicode</acronym> U+0020), un espace ordinaire.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\t"</literal> (<acronym>Unicode</acronym> U+0009), une tabulation.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\n"</literal> (<acronym>Unicode</acronym> U+000A), un saut de ligne.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\r"</literal> (<acronym>Unicode</acronym> U+000D), un retour chariot.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\0"</literal> (<acronym>Unicode</acronym> U+0000), l&#39;octet NUL.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\v"</literal> (<acronym>Unicode</acronym> U+000B), une tabulation verticale.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\f"</literal> (<acronym>Unicode</acronym> U+000C), une avance de page.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u00A0"</literal> (<acronym>Unicode</acronym> U+00A0), un ESPACE INSÉCABLE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u1680"</literal> (<acronym>Unicode</acronym> U+1680), une MARQUE D&#39;ESPACE OGHAM.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2000"</literal> (<acronym>Unicode</acronym> U+2000), un CADRATIN MOYEN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2001"</literal> (<acronym>Unicode</acronym> U+2001), un CADRATIN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2002"</literal> (<acronym>Unicode</acronym> U+2002), un ESPACE MOYEN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2003"</literal> (<acronym>Unicode</acronym> U+2003), un ESPACE CADRATIN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2004"</literal> (<acronym>Unicode</acronym> U+2004), un ESPACE D&#39;UN-TIERS-DE-CADRATIN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2005"</literal> (<acronym>Unicode</acronym> U+2005), un ESPACE D&#39;UN-QUART-DE-CADRATIN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2006"</literal> (<acronym>Unicode</acronym> U+2006), un ESPACE D&#39;UN-SIXIÈME-DE-CADRATIN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2007"</literal> (<acronym>Unicode</acronym> U+2007), un ESPACE POUR CHIFFRES.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2008"</literal> (<acronym>Unicode</acronym> U+2008), un ESPACE DE PONCTUATION.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2009"</literal> (<acronym>Unicode</acronym> U+2009), un ESPACE FINE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u200A"</literal> (<acronym>Unicode</acronym> U+200A), un ESPACE CHEVEU.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2028"</literal> (<acronym>Unicode</acronym> U+2028), un SÉPARATEUR DE LIGNE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2029"</literal> (<acronym>Unicode</acronym> U+2029), un SÉPARATEUR DE PARAGRAPHE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u202F"</literal> (<acronym>Unicode</acronym> U+202F), un ESPACE INSÉCABLE ÉTROIT.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u205F"</literal> (<acronym>Unicode</acronym> U+205F), un ESPACE MATHÉMATIQUE MOYEN.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u3000"</literal> (<acronym>Unicode</acronym> U+3000), un ESPACE IDÉOGRAPHIQUE.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u0085"</literal> (<acronym>Unicode</acronym> U+0085), une LIGNE SUIVANTE (NEL).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u180E"</literal> (<acronym>Unicode</acronym> U+180E), un SÉPARATEUR DE VOYELLE MONGOL.
     </simpara>
    </listitem>
   </itemizedlist>
'>

<!ENTITY strings.parameter.characters.optional '
 <simpara xmlns="http://docbook.org/ns/docbook">
  Facultativement, les caractères à supprimer peuvent également être spécifiés en utilisant
  le paramètre <parameter>characters</parameter>.
  Il suffit de lister tous les caractères qui doivent être supprimés.
  Avec <literal>..</literal>, il est possible de spécifier une plage croissante de caractères.
 </simpara>
'>

<!ENTITY strings.parameter.unicode.optional '
 <simpara xmlns="http://docbook.org/ns/docbook">
  Optionnellement, les caractères à supprimer peuvent aussi être spécifiés en utilisant
  le paramètre <parameter>characters</parameter>.
  Il suffit de lister tous les caractères à supprimer.
 </simpara>
'>

<!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>
    Soit un entier indiquant le nombre de caractères (minimum)
    que cette conversion doit produire, soit <literal>*</literal>.
    Si <literal>*</literal> est utilisé, alors la largeur est fournie
    en tant que valeur entière supplémentaire précédant celle formatée
    par le spécificateur.
   </para>
  </formalpara>

  <formalpara>
   <title>Precision</title>
   <para>
    Un point <literal>.</literal> suivi optionnellement
    soit d&apos;un entier, soit de <literal>*</literal>,
    dont la 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é. Si <literal>*</literal> est utilisé, la précision est
      fournie en tant que valeur entière supplémentaire précédant celle formatée
      par le spécificateur.
     </simpara>
    </note>
   </para>
  </formalpara>

  <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.scanf.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>format</parameter></term>
     <listitem>
      <para>
       Le format interprété pour <parameter>string</parameter> décrit
       dans la documentation de la <function>sprintf</function> avec les différences suivantes :
       <simplelist>
        <member>
         La fonction ne tient pas compte du contexte local.
        </member>
        <member>
         <literal>F</literal>, <literal>g</literal>, <literal>G</literal> et
         <literal>b</literal> ne sont pas supportés.
        </member>
        <member>
         <literal>D</literal> représente un nombre décimal.
        </member>
        <member>
         <literal>i</literal> représente un nombre entier avec détection de base.
        </member>
        <member>
         <literal>n</literal> représente le nombre de caractères traités à ce stade.
        </member>
        <member>
         <literal>s</literal> arrête la lecture à chaque caractère d&#39;espacement.
        </member>
        <member>
         <literal>*</literal> au lieu de <literal>argnum$</literal> supprime
         l&#39;affectation de cette spécification de conversion.
        </member>
       </simplelist>
      </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.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> accepte désormais une chaîne vide.
 </entry>
</row>'>

<!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>
'>

<!ENTITY strings.changelog.ascii-case-conversion '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   La conversion de la casse ne dépend désormais plus de la locale définit avec
   <function>setlocale</function>. Seuls les caractères ASCII seront convertis.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-folding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   Le case folding ne dépend désormais plus de la locale définit avec
   <function>setlocale</function>. Uniquement du case folding ASCII sera effectué.
   Les octets non-ASCII seront comparés par leur valeur d&#39;octet.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.sprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Cette fonction ne renvoie plus &false; en cas d&apos;échec.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lance une <classname>ValueError</classname> si le nombre d&apos;arguments est zéro ;
       auparavant, cette fonction émettait un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lance une <classname>ValueError</classname> si <literal>[width]</literal> est inférieur à zéro ou supérieur à <constant>PHP_INT_MAX</constant> ;
       auparavant, cette fonction émettait un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lance une <classname>ValueError</classname> si <literal>[precision]</literal> est inférieur à zéro ou supérieur à <constant>PHP_INT_MAX</constant> ;
       auparavant, cette fonction émettait un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lance une <classname>ArgumentCountError</classname> lorsque moins d&apos;arguments sont donnés que requis ;
       auparavant, cette fonction émettait un <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>
<!ENTITY strings.changelog.vsprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Cette fonction ne renvoie plus &false; en cas d&apos;échec.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lance une <classname>ValueError</classname> si le nombre d&apos;arguments est zéro ;
       auparavant, cette fonction émettait un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lance une <classname>ValueError</classname> si <literal>[width]</literal> est inférieur à zéro ou supérieur à <constant>PHP_INT_MAX</constant> ;
       auparavant, cette fonction émettait un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lance une <classname>ValueError</classname> si <literal>[precision]</literal> est inférieur à zéro ou supérieur à <constant>PHP_INT_MAX</constant> ;
       auparavant, cette fonction émettait un <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lance une <classname>ArgumentCountError</classname> lorsque moins d&apos;arguments sont donnés que requis ;
       auparavant, cette fonction émettait un <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>
<!ENTITY strings.errors.sprintf '
  <para xmlns="http://docbook.org/ns/docbook">
À partir de PHP 8.0.0, une <classname>ValueError</classname> est lancée si le nombre d&apos;arguments est nul.
Antérieur à PHP 8.0.0, un <constant>E_WARNING</constant> était émis à la place.
</para>
<para xmlns="http://docbook.org/ns/docbook">
À partir de PHP 8.0.0, une <classname>ValueError</classname> est lancée si <literal>[width]</literal> est inférieur à zéro ou supérieur à <constant>PHP_INT_MAX</constant>.
Antérieur à PHP 8.0.0, un <constant>E_WARNING</constant> était émis à la place.
</para>
<para xmlns="http://docbook.org/ns/docbook">
À partir de PHP 8.0.0, une <classname>ValueError</classname> est lancée si <literal>[precision]</literal> est inférieur à zéro ou supérieur à <constant>PHP_INT_MAX</constant>.
Antérieur à PHP 8.0.0, un <constant>E_WARNING</constant> était émis à la place.
</para>
<para xmlns="http://docbook.org/ns/docbook">
À partir de PHP 8.0.0, une <classname>ArgumentCountError</classname> est lancée lorsque moins d&apos;arguments sont donnés que requis.
Antérieur à PHP 8.0.0, &false; était retourné et un <constant>E_WARNING</constant> était émis à la place.
</para>
'>

<!ENTITY strings.comparison.return '
  <simpara xmlns="http://docbook.org/ns/docbook">
   Retourne une valeur inférieure à 0 si <parameter>string1</parameter>
   est inférieure à <parameter>string2</parameter> ; une valeur supérieure
   à 0 si <parameter>string1</parameter> est supérieure à
   <parameter>string2</parameter>, et <literal>0</literal> si elles
   sont égales.
   Aucune signification particulière ne peut être déduite de cette valeur,
   hormis son signe.
  </simpara>
'>

<!-- filter snippets -->
<!-- TODO: Remove -->
<!ENTITY filter.param.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter></term>
<listitem>
    <para>
     Le filtre à appliquer.  
     Peut être un filtre de validation en utilisant l&apos;une des constantes  
     <constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>, un filtre de  
     nettoyage en utilisant l&apos;une des constantes  
     <constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant> ou <constant>FILTER_UNSAFE_RAW</constant>,  
     ou encore un filtre personnalisé en utilisant <constant>FILTER_CALLBACK</constant>.
    </para>
    <para>
     La valeur par défaut est <constant>FILTER_DEFAULT</constant>,  
     qui est un alias de <constant>FILTER_UNSAFE_RAW</constant>.
    </para>
</listitem>
</varlistentry>
'>

<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
Les sources de hasard par ordre de priorité sont les suivantes :
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<listitem>
  <para>
   Linux: <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
</listitem>
<listitem>
   <para>
   FreeBSD &gt;= 12 (PHP &gt;= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Windows (PHP &gt;= 7.2): <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
  </para>
  <para>
   Windows: <link xlink:href="&url.csprng.crypt-gen-random;">CryptGenRandom</link>
  </para>
 </listitem>
 <listitem>
  <para>
   macOS (PHP &gt;= 8.2; &gt;= 8.1.9; &gt;= 8.0.22 si CCRandomGenerateBytes est disponible au moment de la compilation): CCRandomGenerateBytes()
  </para>
  <para>
   macOS (PHP &gt;= 8.1; &gt;= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   NetBSD &gt;= 7 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   OpenBSD &gt;= 5.5 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   DragonflyBSD (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Solaris (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
</listitem>
<listitem>
    <simpara>
      Toute combinaison d&apos;un système d&apos;exploitation et d&apos;une version de PHP non mentionnée précédemment:
      <filename>/dev/urandom</filename>.
    </simpara>
</listitem>
<listitem>
    <simpara>
      Si aucune des sources de hasard n&apos;est disponible ou si elles échouent toutes à générer
      de l&apos;aléatoire, une exception de type <classname>Random\RandomException</classname>
      sera levée.
    </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>Random\RandomException</classname> sera lancée.
</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>
'>

<!-- Random snippets -->
<!ENTITY random.engineErrors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Tout <classname>Throwable</classname>s lancé par la méthode <methodname>Random\Engine::generate</methodname>
   du <link linkend="random-randomizer.props.engine"><literal>Random\Randomizer::$engine</literal></link> sous-jacent.
  </simpara>
 </listitem>
'>

<!-- 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.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <para>
   Le parseur XML.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
 Si &null; est passé, le gestionnaire est réinitialisé à son état par défaut.
 <warning>
  <simpara>
    Une chaîne vide réinitialisera également le gestionnaire,
    cependant cette fonctionnalité est dépréciée à partir de PHP 8.4.0.
  </simpara>
 </warning>
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Si <parameter>handler</parameter> est un <type>callable</type>,
 l&#39;appelable est défini comme le gestionnaire.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Si <parameter>handler</parameter> est une <type>string</type>,
 il peut s&#39;agir du nom d&#39;une méthode d&#39;un objet défini avec
 <function>xml_set_object</function>.
 <warning>
  <simpara>
   Cette fonctionnalité est dépréciée à partir de PHP 8.4.0.
  </simpara>
</warning>
</para>
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  À partir de PHP 8.4.0, la validité du callable est vérifiée lors de la configuration du gestionnaire,
  et non au moment de son appel.
  Cela signifie que <function>xml_set_object</function> doit être appelé avant
  de définir une méthode sous forme de chaîne comme rappel.
  Cependant, comme ce comportement est également déprécié à partir de PHP 8.4.0,
  il est recommandé d&#39;utiliser un <type>callable</type> approprié pour la méthode.
 </simpara>
</warning>
'>

<!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <simpara>
   Le parseur XML appelant le gestionnaire.
  </simpara>
 </listitem>
</varlistentry>'>

<!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> <literal>xml</literal> était attendue.
 </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
-->