svn: /phpdoc/fr/trunk/ appendices/tokens.xml language/oop5/basic.xml language/operators.xml language/types/pseudo-types.xml language-snippets.ent reference/phar/fileformat.xml

Modified: phpdoc/fr/trunk/appendices/tokens.xml
===================================================================
--- phpdoc/fr/trunk/appendices/tokens.xml	2020-12-02 00:28:19 UTC (rev 351838)
+++ phpdoc/fr/trunk/appendices/tokens.xml	2020-12-02 01:40:10 UTC (rev 351839)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 351112 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 351735 Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->

 <appendix xml:id="tokens" xmlns="http://docbook.org/ns/docbook">
@@ -583,6 +583,11 @@
      <entry><link linkend="language.oop5">classes et objets</link></entry>
     </row>
     <row>
+     <entry><constant>T_NULLSAFE_OBJECT_OPERATOR</constant></entry>
+     <entry>?-&gt;</entry>
+     <entry><link linkend="language.oop5">classes et objets</link></entry>
+    </row>
+    <row>
      <entry><constant>T_OPEN_TAG</constant></entry>
      <entry>&lt;?php, &lt;? or &lt;%</entry>
      <entry><link linkend="language.basic-syntax.phpmode">sortie du mode HTML</link></entry>

Modified: phpdoc/fr/trunk/language/oop5/basic.xml
===================================================================
--- phpdoc/fr/trunk/language/oop5/basic.xml	2020-12-02 00:28:19 UTC (rev 351838)
+++ phpdoc/fr/trunk/language/oop5/basic.xml	2020-12-02 01:40:10 UTC (rev 351839)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350429 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 351735 Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->

  <sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook">
@@ -410,7 +410,7 @@
    <title>::class</title>

    <para>
-    Depuis PHP 5.5, le mot clé <literal>class</literal> est également utilisé
+    Le mot clé <literal>class</literal> est également utilisé
     pour la résolution des noms de classes. Vous pouvez récupérer une chaîne
     contenant le nom qualifié complet de la classe <literal>ClassName</literal>
     en utilisant <literal>ClassName::class</literal>. C'est particulièrement
@@ -448,10 +448,100 @@
      les noms de classes sont étendues même si la classe n'existe pas. Aucune erreur
      n'est émise dans ce cas là.
     </para>
+    <example xml:id="language.oop5.basic.class.class.fail">
+     <title>Résolution de nom de classe manquante</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+print Some\Class\DoesNot\Exist::class;
+?>
+]]>
+     </programlisting>
+     &example.outputs;
+     <screen>
+<![CDATA[
+Some\Class\Does\Not\Exist
+]]>
+     </screen>
+    </example>
    </note>
+   <para>
+    À partir de PHP 8.0.0, la constante <literal>::class</literal> peut être utilisé
+    sur les objets. Cette résolution se produit lors de l'exécution, et non lors de
+    la compilation. Ses effets sont les mêmes que d'appeller
+    <function>get_class</function> sur l'objet.
+   </para>
+   <example xml:id="language.oop5.basic.class.class.object">
+    <title>Résolution du nom d'un objet</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+namespace NS {
+    class ClassName {
+    }
+}
+$c = new ClassName();
+print $c::class;
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+NS\ClassName
+]]>
+    </screen>
+   </example>
   </sect2>
+ <sect2 xml:id="language.oop5.basic.nullsafe">
+  <title>Méthodes et propriétés nullsafe</title>
+  <para>
+   À partir de PHP 8.0.0, les méthodes et propriétés peuvent aussi être accédés
+   avec l'opérateur "nullsafe": <literal>?-></literal>. L'opérateur nullsafe
+   fonctionne à l'identique que l'accès de propriétés ou méthodes comme si dessus,
+   à l'exception que si l'objet qui est déréférencé est &null; alors &null; sera
+   retourné au lieu de lancer une exception. Si le déréférencement fait par d'une
+   chaîne, le reste de la chaîne est ignoré.
+  </para>
+  <para>
+   L'effet est similaire à entourer chaque accès par une vérification avec
+   <function>is_null</function> d'abord, mais plus compact.
+  </para>
+  <para>
+   <example>
+    <title>Opérateur nullsafe</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+// À partir de PHP 8.0.0, cette ligne:
+$result = $repository?->getUser(5)?->name;
+
+// Est équivalente à bloc de code suivant :
+if (is_null($repository)) {
+    $result = null;
+} else {
+    $user = $repository->getUser(5);
+    if (is_null($user)) {
+        $result = null;
+    } else {
+        $result = $user->name;
+    }
+}
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <note>
+   <para>
+    L'opérateur nullsafe est mieux utilisé quand null est considéré une valeur valide
+    et potentiellement attendu pour une propriété ou valeur de retour d'une méthode.
+    Pour indiquer une erreur, une exception lancé est préférable.
+   </para>
+  </note>
+ </sect2>
  </sect1>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/fr/trunk/language/operators.xml
===================================================================
--- phpdoc/fr/trunk/language/operators.xml	2020-12-02 00:28:19 UTC (rev 351838)
+++ phpdoc/fr/trunk/language/operators.xml	2020-12-02 01:40:10 UTC (rev 351839)
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 351706 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 351816 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <!-- CREDITS: DAnnebicque -->
-
 <chapter xml:id="language.operators" xmlns="http://docbook.org/ns/docbook">
  <title>Les opérateurs</title>
  <simpara>
@@ -1861,7 +1860,7 @@
      &null;, et <replaceable>expr1</replaceable> dans les autres cas.
    </para>
    <para>
-    En particulier, cet opérateur n'émet pas de notice si
+    En particulier, cet opérateur n'émet pas de notice ou avertissement si
     la partie gauche n'existe pas, exactement comme <function>isset</function>.
     Ceci est particulièrement utile pour les clés des tableaux.
    </para>

Deleted: phpdoc/fr/trunk/language/types/pseudo-types.xml
===================================================================
--- phpdoc/fr/trunk/language/types/pseudo-types.xml	2020-12-02 00:28:19 UTC (rev 351838)
+++ phpdoc/fr/trunk/language/types/pseudo-types.xml	2020-12-02 01:40:10 UTC (rev 351839)
@@ -1,61 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 351340 Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes Maintainer: girgias -->
-<!-- CREDITS: DavidA -->
-
-<sect1 xml:id="language.pseudo-types">
- <title>Variables et pseudo-types utilisés dans cette documentation</title>
-<para>
-  Les pseudo-types sont des mots-clés utilisés dans la documentation PHP pour spécifier les types ou les valeurs qu'un argument peut avoir. Il est à noter qu'ils ne sont pas des primitives du langage PHP. Vous ne pouvez donc pas utiliser les pseudo-types comme typage dans vos propres fonctions personnalisées.
- </para>
- <sect2 xml:id="language.types.mixed">
-  <title>mixed</title>
-
-  <para>
-   <literal>mixed</literal> indique qu'un paramètre peut accepter plusieurs
-   (mais pas nécessairement tous) types.
-  </para>
-
-  <para>
-   <function>gettype</function> par exemple, accepte tous les types PHP,
-   alors que <function>str_replace</function> accepte les &string; et les
-   &array;x.
-  </para>
-
- </sect2>
-
- <sect2 xml:id="language.types.void">
-  <title>void</title>
-
-  <para>
-   <literal>void</literal> comme type retourné signifie que la valeur retournée
-   est inutile. <literal>void</literal> dans une liste de paramètre signifie que
-   la fonction n'accepte aucun paramètre. À partir de PHP 7.1 <literal>void</literal>
-   est accepté comme type de retour d'une fonction.
-  </para>
-
- </sect2>
-
-</sect1>
-
-<!-- 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: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file

Modified: phpdoc/fr/trunk/language-snippets.ent
===================================================================
--- phpdoc/fr/trunk/language-snippets.ent	2020-12-02 00:28:19 UTC (rev 351838)
+++ phpdoc/fr/trunk/language-snippets.ent	2020-12-02 01:40:10 UTC (rev 351839)
@@ -3263,7 +3263,7 @@
 <!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.void">void</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>'>



Modified: phpdoc/fr/trunk/reference/phar/fileformat.xml
===================================================================
--- phpdoc/fr/trunk/reference/phar/fileformat.xml	2020-12-02 00:28:19 UTC (rev 351838)
+++ phpdoc/fr/trunk/reference/phar/fileformat.xml	2020-12-02 01:40:10 UTC (rev 351839)
@@ -1,8 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350041 Maintainer: gui Status: ready -->
+<!-- EN-Revision: 351819 Maintainer: gui Status: ready -->
 <!-- Reviewed: yes -->
-
 <chapter xml:id="phar.fileformat" xmlns="http://docbook.org/ns/docbook">
  <title>Qu'est-ce qui fait d'un phar un phar et pas un tar ou un zip ?</title>
  <section xml:id="phar.fileformat.ingredients" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -446,7 +445,8 @@
   <para>
    Les Phar qui contiennent une signature ont toujours la signature ajoutée à la fin du Phar,
    après le chargeur, le manifeste et le contenu.
-   Les types de signature supportés à ce jour sont MD5, SHA1, SHA256 and SHA512.
+   Les types de signature supportés à ce jour sont MD5, SHA1, SHA256, SHA512,
+   et OPENSSL.
   </para>
   <para>
    <table>
@@ -460,11 +460,12 @@
      </thead>
      <tbody>
       <row>
-       <entry>16 ou 20 octets</entry>
+       <entry>variant</entry>
        <entry>
         La signature actuelle, 20 octets pour une SHA1,
         16 octets pour une MD5, 32 octets pour une SHA256,
-        et 64 octets pour une SHA512.
+        et 64 octets pour une SHA512. La longueur d'une signature
+        OPENSSL dépend de la taille de la clé privée.
        </entry>
       </row>
       <row>
@@ -472,9 +473,11 @@
        <entry>
         Les drapeaux de signature.  <literal>0x0001</literal> est utilisé pour
         définir une signature MD5, <literal>0x0002</literal> pour une SHA1,
-        <literal>0x0004</literal> pour une SHA256 et <literal>0x0008</literal>
-        pour une SHA512. Le support des signatures SHA256 et SHA512 a été introduit
-        avec l'API version 1.1.0.
+        <literal>0x0003</literal> pour une SHA256 et <literal>0x0004</literal>
+        pour une SHA512. Le support des signatures SHA256 et SHA512 est disponible
+        à partir de la version 1.1.0 de l'API.
+        <literal>0x0010</literal> est utilisé pour définir une signature OPENSSL,
+        qui est disponible à partir de la version 1.1.1 de l'API, si OpenSSL est disponible.
        </entry>
       </row>
       <row>