doc-fr/language/oop5/static.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8e7cce7b98ed33cda72ce0a77b1368ab396f6e09 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
 <sect1 xml:id="language.oop5.static" xmlns="http://docbook.org/ns/docbook">
  <title>Statique</title>

  <tip>
   <simpara>
    Cette page décrit l'utilisation du mot clé <literal>static</literal>
    qui permet de définir des méthodes et des propriétés statiques.
    <literal>static</literal> peut aussi être utilisé pour
    <link linkend="language.variables.scope.static">définir des variables statiques</link>
    et pour <link linkend="language.oop5.late-static-bindings">des Résolutions statiques à la volée</link>.
    Reportez-vous à ces pages pour plus d'informations sur la signification de
    <literal>static</literal>.
   </simpara>
  </tip>
  
  <para>
   Le fait de déclarer des propriétés ou des méthodes comme statiques vous
   permet d'y accéder sans avoir besoin d'instancier la classe.
   Celles-ci peuvent alors être accédées statiquement depuis une instance d'objet.
  </para>

  <sect2 xml:id="language.oop5.static.methods">
   <title>Méthodes statiques</title>

   <para>
    Comme les méthodes statiques peuvent être appelées sans qu'une instance
    d'objet n'ait été créée, la pseudo-variable <varname>$this</varname> n'est pas
    disponible dans les méthodes déclarées comme statiques.
   </para>

   <warning>
    <para>
     Appeler une méthode non-statique statiquement lancera une <classname>Error</classname>.
    </para>
    <para>
     Antérieur à PHP 8.0.0, appeler une méthode non-statique statiquement était obsolète,
     et générait un avertissement <constant>E_DEPRECATED</constant>.
    </para>
   </warning>

   <example>
   <title>Exemple avec une méthode statique</title>
    <programlisting role="php">
<![CDATA[
<?php
class Foo
{
    public static function aStaticMethod() {
        // ...
    }
}

Foo::aStaticMethod();
$classname = 'Foo';
$classname::aStaticMethod();
?>
]]>
    </programlisting>
  </example> 
  </sect2>
  
  <sect2 xml:id="language.oop5.static.properties">
   <title>Propriétés statiques</title>
   <para>
    Les propriétés statiques sont accédées en utilisant l'
    <link linkend="language.oop5.paamayim-nekudotayim">opérateur de résolution de portée</link>
    (<literal>::</literal>) et ne peuvent pas être accédé à travers l'opérateur
    objet (<literal>-&gt;</literal>).
   </para>

  <para>
   Il est possible de référencer la classe en utilisant une variable.
   La valeur de la variable ne peut être un mot-clé (par exemple <literal>self</literal>,
   <literal>parent</literal> et <literal>static</literal>).
  </para>

  <example>
   <title>Exemple avec une propriété statique</title>
   <programlisting role="php">
<![CDATA[
<?php
class Foo
{
    public static $my_static = 'foo';

    public function staticValue() {
        return self::$my_static;
    }
}

class Bar extends Foo
{
    public function fooStatic() {
        return parent::$my_static;
    }
}


print Foo::$my_static . "\n";

$foo = new Foo();
print $foo->staticValue() . "\n";
print $foo->my_static . "\n";      // "Propriété" my_static non définie

print $foo::$my_static . "\n";
$classname = 'Foo';
print $classname::$my_static . "\n";

print Bar::$my_static . "\n";
$bar = new Bar();
print $bar->fooStatic() . "\n";
?>
]]>
   </programlisting>
   &example.outputs.8.similar;
   <screen>
<![CDATA[
foo
foo
Notice: Accessing static property Foo::$my_static as non static in /in/V0Rvv on line 23
Warning: Undefined property: Foo::$my_static in /in/V0Rvv on line 23
foo
foo
foo
foo
]]>
   </screen>
  </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
-->