Läsa attribut med Reflection API: Skillnad mellan sidversioner

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök
Ingen redigeringssammanfattning
 
Rad 1: Rad 1:
=== Läsa attribut med Reflection API ===
=== Läsa attribut med Reflection API ===


För att få tillgång till attribut från klasser, metoder, funktioner, parametrar, egenskaper och klasskonstanter, tillhandahåller Reflection API metoden getAttributes() på var och en av de motsvarande Reflection-objekten. Denna metod returnerar en array av ReflectionAttribute-instanser som kan användas för att fråga om attributnamn, argument och för att instansiera en instans av det representerade attributet.
För att komma åt attribut från klasser, metoder, funktioner, parametrar, egenskaper och klasskonstanter tillhandahåller Reflection API metoden `getAttributes()` varje motsvarande Reflection-objekt. Denna metod returnerar en array av `ReflectionAttribute`-instanser som kan frågas efter attributnamn, argument och för att skapa en instans av det representerade attributet.


Denna separation mellan reflekterad attributrepresentation och faktisk instans ökar kontrollen för programmeraren att hantera fel angående saknade attributklasser, felstavade eller saknade argument. Först efter att ReflectionAttribute::newInstance() har anropats, instansieras objekt av attributklassen och den korrekta matchningen av argument valideras, inte tidigare.
Denna separering av reflekterad attributrepresentation från faktisk instans ökar programmets kontroll över att hantera fel relaterade till saknade attributklasser, felskrivna eller saknade argument. Först efter att ha anropat `ReflectionAttribute::newInstance()` skapas objekt av attributklassen, och korrekt matchning av argument valideras, inte tidigare.


==== Exempel #1 Läsa attribut med hjälp av Reflection API ====
==== Exempel #1 Läsa attribut med Reflection API ====


<pre> <?php #[Attribute] class MyAttribute { public $value; public function __construct($value) { $this->value = $value; } } #[MyAttribute(value: 1234)] class Thing { } function dumpAttributeData($reflection) { $attributes = $reflection->getAttributes(); foreach ($attributes as $attribute) { var_dump($attribute->getName()); var_dump($attribute->getArguments()); var_dump($attribute->newInstance()); } } dumpAttributeData(new ReflectionClass(Thing::class)); /* string(11) "MyAttribute" array(1) { ["value"]=> int(1234) } object(MyAttribute)#3 (1) { ["value"]=> int(1234) } */ </pre>
<pre>
Istället för att iterera över alla attribut på reflection-instansen, kan endast de av en specifik attributklass hämtas genom att skicka det sökta attributklassnamnet som argument.
<?php
 
#[Attribute]
class MyAttribute
{
    public $value;
 
    public function __construct($value)
    {
        $this->value = $value;
    }
}
 
#[MyAttribute(value: 1234)]
class Thing
{
}
 
function dumpAttributeData($reflection) {
    $attributes = $reflection->getAttributes();
 
    foreach ($attributes as $attribute) {
      var_dump($attribute->getName());
      var_dump($attribute->getArguments());
      var_dump($attribute->newInstance());
    }
}
 
dumpAttributeData(new ReflectionClass(Thing::class));
/*
string(11) "MyAttribute"
array(1) {
  ["value"]=>
  int(1234)
}
object(MyAttribute)#3 (1) {
  ["value"]=>
  int(1234)
}
*/
?>
</pre>
 
Istället för att iterera över alla attribut på Reflection-instansen, kan endast de av en viss attributklass hämtas genom att skicka det sökta attributklassnamnet som argument.
 
==== Exempel #2 Läsa specifika attribut med Reflection API ====
 
<pre>
<?php
 
function dumpMyAttributeData($reflection) {
    $attributes = $reflection->getAttributes(MyAttribute::class);
 
    foreach ($attributes as $attribute) {
      var_dump($attribute->getName());
      var_dump($attribute->getArguments());
      var_dump($attribute->newInstance());
    }
}
 
dumpMyAttributeData(new ReflectionClass(Thing::class));
?>
</pre>


==== Exempel #2 Läsa specifika attribut med hjälp av Reflection API ====


<pre>
<?php function dumpMyAttributeData($reflection) { $attributes = $reflection->getAttributes(MyAttribute::class); foreach ($attributes as $attribute) { var_dump($attribute->getName()); var_dump($attribute->getArguments()); var_dump($attribute->newInstance()); } } dumpMyAttributeData(new ReflectionClass(Thing::class)); ?> </pre>


= Sidslut =
= Sidslut =

Nuvarande version från 24 augusti 2024 kl. 11.24

Läsa attribut med Reflection API

För att komma åt attribut från klasser, metoder, funktioner, parametrar, egenskaper och klasskonstanter tillhandahåller Reflection API metoden `getAttributes()` på varje motsvarande Reflection-objekt. Denna metod returnerar en array av `ReflectionAttribute`-instanser som kan frågas efter attributnamn, argument och för att skapa en instans av det representerade attributet.

Denna separering av reflekterad attributrepresentation från faktisk instans ökar programmets kontroll över att hantera fel relaterade till saknade attributklasser, felskrivna eller saknade argument. Först efter att ha anropat `ReflectionAttribute::newInstance()` skapas objekt av attributklassen, och korrekt matchning av argument valideras, inte tidigare.

Exempel #1 Läsa attribut med Reflection API

<?php

#[Attribute]
class MyAttribute
{
    public $value;

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

#[MyAttribute(value: 1234)]
class Thing
{
}

function dumpAttributeData($reflection) {
    $attributes = $reflection->getAttributes();

    foreach ($attributes as $attribute) {
       var_dump($attribute->getName());
       var_dump($attribute->getArguments());
       var_dump($attribute->newInstance());
    }
}

dumpAttributeData(new ReflectionClass(Thing::class));
/*
string(11) "MyAttribute"
array(1) {
  ["value"]=>
  int(1234)
}
object(MyAttribute)#3 (1) {
  ["value"]=>
  int(1234)
}
*/
?>

Istället för att iterera över alla attribut på Reflection-instansen, kan endast de av en viss attributklass hämtas genom att skicka det sökta attributklassnamnet som argument.

Exempel #2 Läsa specifika attribut med Reflection API

<?php

function dumpMyAttributeData($reflection) {
    $attributes = $reflection->getAttributes(MyAttribute::class);

    foreach ($attributes as $attribute) {
       var_dump($attribute->getName());
       var_dump($attribute->getArguments());
       var_dump($attribute->newInstance());
    }
}

dumpMyAttributeData(new ReflectionClass(Thing::class));
?>


Sidslut

Orginalhemsidan på Engelska : https://www.php.net/manual/en/language.attributes.reflection.php
PHP
Språkreferens
Språkreferens#Attribut


Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp som har sponsrat Linux.se med webserver.