call i callStatic

Część sekcji Programowanie obiektowe ścieżki PHP w Coddy. Lekcja 47 z 91.

Podobnie jak __get() i __set() przechwytują dostęp do właściwości, metody __call() i __callStatic() przechwytują wywołania metod. Są uruchamiane, gdy wywołujesz metodę, która nie istnieje lub jest niedostępna w obiekcie albo klasie.

Metoda __call() obsługuje wywołania metod instancji. Otrzymuje nazwę metody i tablicę argumentów:

<?php
class Messenger {
    public function __call(string $name, array $arguments): string {
        return "Called '$name' with: " . implode(", ", $arguments);
    }
}

$msg = new Messenger();
echo $msg->sendEmail("Hello", "World");

Wynik:

Called 'sendEmail' with: Hello, World

W przypadku wywołań metod statycznych użyj __callStatic(). Zwróć uwagę, że musi być zadeklarowana jako static:

<?php
class QueryBuilder {
    public static function __callStatic(string $name, array $arguments): string {
        if (str_starts_with($name, "findBy")) {
            $field = substr($name, 6);
            return "Finding by $field: " . $arguments[0];
        }
        return "Unknown method: $name";
    }
}

echo QueryBuilder::findByEmail("test@example.com");

Wynik:

Finding by Email: test@example.com

Te magiczne metody są przydatne do tworzenia płynnych interfejsów API, implementowania przekazywania wywołań metod lub budowania dynamicznych kreatorów zapytań, w których nazwy metod przekładają się na operacje na bazie danych. Pozwalają obiektom inteligentnie reagować na każde wywołanie metody, nawet jeśli nie zdefiniowano jej jawnie.

Wyzwanie

Łatwy

Zbudujmy dynamicznego klienta API, który używa metod magicznych do elastycznej obsługi wywołań metod. Utworzysz klasę, która przechwytuje wywołania zarówno metod instancji, jak i metod statycznych, przekształcając je w odpowiedzi przypominające odpowiedzi API bez jawnego definiowania każdej metody.

Podzielisz kod na dwa pliki:

ApiClient.php: Utwórz klasę ApiClient, która symuluje interakcje z API za pomocą metod magicznych. Twoja klasa powinna mieć prywatną właściwość $baseUrl, której wartość jest ustawiana przez konstruktor. Zaimplementuj dwie metody magiczne:
- __call(): Obsługuje wywołania metod instancji. Gdy zostanie wywołana metoda zaczynająca się od get (na przykład getUsers lub getPosts), wyodrębnij nazwę zasobu (część po "get") i zwróć "GET [baseUrl]/[resource]: [arguments joined by comma]". Nazwa zasobu powinna zostać zamieniona na małe litery. Jeśli metoda nie zaczyna się od "get", zwróć "Unknown action: [methodName]".
- __callStatic(): Obsługuje wywołania metod statycznych. Gdy zostanie wywołana metoda zaczynająca się od create (na przykład createUser), wyodrębnij nazwę zasobu i zwróć "POST /[resource]: [arguments joined by comma]". Nazwa zasobu powinna składać się z małych liter. W przypadku metod zaczynających się od delete zwróć "DELETE /[resource]: [first argument]". W przypadku każdej innej metody zwróć "Static action not supported: [methodName]".
main.php: Dołącz plik ApiClient. Otrzymasz trzy dane wejściowe: podstawowy adres URL, identyfikator zasobu i wartość. Utwórz instancję ApiClient z podstawowym adresem URL. Następnie wypisz cztery wiersze:
- Wywołaj dynamiczną metodę get, używając identyfikatora zasobu jako przyrostka nazwy metody (na przykład, jeśli zasobem jest "Users", wywołaj getUsers), i przekaż wartość jako argument
- Wywołaj getProducts z dwoma argumentami: "electronics" i "active"
- Wywołaj statyczną metodę createOrder, przekazując wartość jako argument
- Wywołaj statyczną metodę deleteItem, przekazując identyfikator zasobu jako argument

Metody magiczne pozwalają klientowi API dynamicznie reagować na dowolne wywołanie metody. Zamiast definiować getUsers(), getPosts(), getProducts() i dziesiątki innych metod, jedna metoda __call() obsługuje je wszystkie, analizując nazwę metody i wyodrębniając odpowiednie informacje.

Spróbuj swoich sił

<?php

require_once 'ApiClient.php';

// Odczytaj dane wejściowe
$baseUrl = trim(fgets(STDIN));
$resource = trim(fgets(STDIN));
$value = trim(fgets(STDIN));

// TODO: Utwórz instancję ApiClient z bazowym adresem URL

// TODO: Wywołaj dynamiczną metodę get, używając resource jako przyrostka nazwy metody
// Wskazówka: Użyj wywołania metody o zmiennej nazwie, np. $api->{"get" . $resource}($value)

// TODO: Wywołaj getProducts z dwoma argumentami: "electronics" i "active"

// TODO: Wywołaj statyczną metodę createOrder z value jako argumentem
// Wskazówka: Użyj ApiClient::createOrder($value)

// TODO: Wywołaj statyczną metodę deleteItem z resource jako argumentem

?>