anonymous.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c373ef087f8ba9c2d4358c81edd42c57d1eb7452 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->

<sect1 xml:id="language.oop5.anonymous" xmlns="http://docbook.org/ns/docbook">
 <title>Clases anónimas</title>
 
 <para>
  En PHP 7 se ha añadido soporte para clases anónimas. Las clases anónimas son
  útiles cuando es necesario crear objetos sencillos y únicos.
 </para>
 
 <informalexample>
  <programlisting role="php">
<![CDATA[
<?php

// Código anterior a PHP 7
class Logger
{
    public function log($msg)
    {
        echo $msg;
    }
}

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

// Código de PHP 7+
$util->setLogger(new class {
    public function log($msg)
    {
        echo $msg;
    }
});
]]>
  </programlisting>
 </informalexample>
 
 <para>
  Pueden pasar argumentos a través de sus constructores, extender otras clases,
  implementar interfaces, y utilizar rasgos al igual que una clase normal:
 </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>
  El anidamiento de una clase anónima dentro de otra clase no le proporciona acceso a
  ningún método o propiedad privados o protegidos de la clase externa. Para
  utilizar las propiedades o métodos protegidos de la clase externa, la clase anónima
  puede extender la clase externa. Para utilizar las propiedades privadas de
  la clase externa en la clase anónima, estos deben pasarse a su
  constructor:
 </para>
 
 <informalexample>
  <programlisting role="php">
<![CDATA[
<?php

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

    protected function func1()
    {
        return 3;
    }

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

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

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

echo (new Externa)->func2()->func3();
]]>
  </programlisting>
  &example.outputs;
  <screen>
<![CDATA[
6
]]>
  </screen>
 </informalexample>
 
 <para>
  Todos los objetos creados por la misma declaración de clase anónima son instancias de
  esa misma clase.
 </para>
 
 <informalexample>
  <programlisting role="php">
<![CDATA[
<?php
function clase_anónima()
{
    return new class {};
}

if (get_class(clase_anónima()) === get_class(clase_anónima())) {
    echo 'misma clase';
} else {
    echo 'clase diferente';
}]]>
  </programlisting>
  &example.outputs;
  <screen>
<![CDATA[
misma clase
]]>
  </screen>
 </informalexample>
 
 <note>
  <para>
   Observe que el motor le asigna un nombre a las clases anónimas, como
   se demuestra en el siguiente ejemplo. Este nombre name ha de considerarse un
   detalle de implementación del cual no se debería depender.
  </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>
</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
-->