anonymous.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d6f54016d62904cfd8200604aadd5e3f0d9bad97 Maintainer: jeanseb Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="language.oop5.anonymous" xmlns="http://docbook.org/ns/docbook">
 <title>Classes anonymes</title>

 <para>
  Les classes anonymes sont utiles lorsque de simples objets uniques ont besoin d'être créés.
 </para>

 <informalexample>
  <programlisting role="php">
<![CDATA[
<?php

// Utilisant une classe explicite
class Logger
{
    public function log($msg)
    {
        echo $msg;
    }
}

$util->setLogger(new Logger());

// Utilisant une classe anonyme
$util->setLogger(new class {
    public function log($msg)
    {
        echo $msg;
    }
});
]]>
  </programlisting>
 </informalexample>

 <para>
  On peut leur passer des arguments via le constructeur, elles peuvent étendre 
  d'autres classes, implémenter des interfaces ou utiliser des traits comme 
  avec une classe normale.
 </para>

 <informalexample>
  <programlisting role="php">
<![CDATA[
<?php

class SomeClass {}
interface SomeInterface {}
trait SomeTrait {}

var_dump(new class(10) extends SomeClass implements SomeInterface {
    private $num;

    public function __construct($num)
    {
        $this->num = $num;
    }

    use SomeTrait;
});
]]>
  </programlisting>
  &example.outputs;
  <screen>
<![CDATA[
object(class@anonymous)#1 (1) {
  ["Command line code0x104c5b612":"class@anonymous":private]=>
  int(10)
}
]]>
  </screen>
 </informalexample>

 <para>
  Imbriquer une classe anonyme à l'intérieur d'une autre classe ne donne pas 
  accès aux méthodes ou propriétés privées ou protégées de la classe contenante. 
  Afin d'utiliser des méthodes ou propriétés protégées de la classe contenante, 
  la classe anonyme doit étendre celle ci. Pour utiliser les propriétés privées 
  de la classe contenant dans la classe anonyme, celles ci doivent 
  être passées via le constructeur.
 </para>

 <informalexample>
  <programlisting role="php">
<![CDATA[
<?php

class Outer
{
    private $prop = 1;
    protected $prop2 = 2;

    protected function func1()
    {
        return 3;
    }

    public function func2()
    {
        return new class($this->prop) extends Outer {
            private $prop3;

            public function __construct($prop)
            {
                $this->prop3 = $prop;
            }

            public function func3()
            {
                return $this->prop2 + $this->prop3 + $this->func1();
            }
        };
    }
}

echo (new Outer)->func2()->func3();
]]>
  </programlisting>
  &example.outputs;
  <screen>
<![CDATA[
6
]]>
  </screen>
 </informalexample>

 <para>
  Tous les objets créés par la même déclaration de classe anonyme sont des 
  instances de cette même classe.
 </para>

 <informalexample>
  <programlisting role="php">
<![CDATA[
<?php
function anonymous_class()
{
    return new class {};
}

if (get_class(anonymous_class()) === get_class(anonymous_class())) {
    echo 'same class';
} else {
    echo 'different class';
}]]>
 </programlisting>
 &example.outputs;
 <screen>
<![CDATA[
same class
]]>
  </screen>
 </informalexample>

 <note>
  <para>
   Notez que les classes anonymes sont affectées d'un nom par le moteur, comme 
   l'illustre l'exemple suivant. Ce nom doit être considéré comme un détail 
   de mise en œuvre, qui ne doit pas être invoqué.
  </para>
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php
echo get_class(new class {});
]]>
  </programlisting>
  &example.outputs.similar;
  <screen>
<![CDATA[
class@anonymous/in/oNi1A0x7f8636ad2021
]]>
   </screen>
  </informalexample>
 </note>
 <sect2 xml:id="language.oop5.anonymous.readonly">
  <title>Classes anonymes en lecture seule</title>
  <simpara>
   À partir de PHP 8.3.0, le modificateur <literal>readonly</literal> peut
   être appliqué aux classes anonymes.
  </simpara>
  <example xml:id="language.oop5.anonymous.readonly.example">
   <title>Définir une classe anonyme en lecture seule</title>
   <programlisting role="php">
    <![CDATA[
<?php
// Utilisation d'une classe anonyme
var_dump(new readonly class('[DEBUG]') {
    public function __construct(private string $prefix)
    {
    }

    public function log($msg)
    {
        echo $this->prefix . ' ' . $msg;
    }
});
]]>
   </programlisting>
  </example>
 </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
-->