Umgang mit der GraphQL-API in der PHP-API-Entwicklung

Mit der kontinuierlichen Entwicklung von Webanwendungen wird die Verwendung von APIs (Application Programming Interface) immer häufiger. Die API als Kern von Webanwendungen ermöglicht es verschiedenen Anwendungen, miteinander zu kommunizieren und Daten auszutauschen. In der PHP-Entwicklung hat sich die GraphQL-API zu einer immer beliebter werdenden Entwicklungsmethode entwickelt, die flexibler und effizienter sein kann als die herkömmliche RESTful-API.

GraphQL ist eine von Facebook entwickelte API-Abfragesprache, die es dem Client ermöglicht, genau die benötigten Daten vom Server zu erhalten. Im Vergleich zu herkömmlichen RESTful-APIs ist GraphQL flexibler und effizienter und kann das Kommunikationsvolumen zwischen Anwendungen und Servern erheblich reduzieren. In diesem Artikel untersuchen wir, wie man GraphQL-APIs in PHP entwickelt und verarbeitet.

Der erste Schritt besteht darin, zu verstehen, wie die GraphQL-API funktioniert. Der Kern der GraphQL-API ist ein Schema (Schema), das abfragbare und veränderbare Datentypen und Operationen definiert. Der Client kann mithilfe der GraphQL-Abfragesprache eine Anfrage an den Server senden, um die erforderlichen Daten abzufragen. Der Server interpretiert die Operation gemäß dem GraphQL-Schema und gibt die vom Client benötigten Daten zurück. graphql-php ist eine PHP-Bibliothek, die uns helfen kann, die GraphQL-API bequemer zu entwickeln.

Der erste Schritt bei der Entwicklung einer GraphQL-API besteht darin, ein Schema zu erstellen. Wir müssen ein Schema definieren, das abfragbare und veränderbare Datentypen und Operationen enthält. Schema enthält normalerweise Abfrageobjekte, Änderungsobjekte, Eingabeobjekte und Skalartypen.

Unter diesen stellt das Abfrageobjekt die Daten dar, die der Client abfragen kann. Das Eingabeobjekt stellt die Daten dar, die der Client an den Server senden kann Werte, Ganzzahlen und Gleitkommazahlen und andere grundlegende Datentypen.

Beim Erstellen eines Schemas müssen wir den Typ und die Parameter jedes Objekts und Felds angeben. Das Folgende ist beispielsweise ein einfaches Abfrageobjekt:

type Query {
  hello: String!
}

Dieses Abfrageobjekt gibt an, dass ein Hallo-Feld vom Typ Zeichenfolge abgefragt werden kann. Das Ausrufezeichen gibt an, dass dieses Feld erforderlich ist und keinen Nullwert zurückgeben kann.

Als nächstes müssen wir einen Resolver (Parser) definieren, der für die Verarbeitung der Datenerfassung und -änderungen für jedes Objekt oder Feld verantwortlich ist. Resolver ist eine PHP-Rückruffunktion, die die Anforderungs- und Kontextinformationen empfangen und dann die Abfrageergebnisse zurückgeben muss. Für das oben definierte Hallo-Feld können wir beispielsweise einen Resolver erstellen:

$resolvers = [
     'Query' => [
          'hello' => function () {
                return 'Hello, World!';
          },
     ],
];

Dieser Resolver gibt direkt die Zeichenfolge „Hello, World!“ zurück. Wir müssen diesen Resolver an Schema binden, damit Abfrageanfragen verarbeitet werden können.

Als nächstes können wir die GraphQL-Klasse in der graphql-php-Bibliothek verwenden, um einen HTTP-Anforderungsprozessor zu schreiben, der die Abfrageanforderung des Clients verarbeitet. Der HTTP-Anforderungshandler empfängt die Anforderung, analysiert die Abfrage und Änderungen in der Anforderung in der GraphQL-Abfragesprache und übergibt sie an das Schema.

<?php
require_once __DIR__ . '/vendor/autoload.php';

use GraphQLGraphQL;
use GraphQLTypeSchema;
use function GraphQLTypealidate;

$schema = new Schema([
    'query' => $queryType,
    'mutation' => $mutationType,
]);

try {
    $rawInput = file_get_contents('php://input');
    $input = json_decode($rawInput, true);
    $query = isset($input['query']) ? $input['query'] : null;
    $variableValues = isset($input['variables']) ? $input['variables'] : null;
    $operationName = isset($input['operationName']) ? $input['operationName'] : null;

    $result = GraphQL::executeQuery($schema, $query, null, null, $variableValues, $operationName);
    $output = $result->toArray();
} catch (Exception $e) {
    $output = [
        'error' => [
            'message' => $e->getMessage()
        ]
    ];
}

header('Content-Type: application/json; charset=UTF-8');
echo json_encode($output);

Abschließend müssen wir auch darüber nachdenken, wie wir die GraphQL-API sichern können. Die GraphQL-API ermöglicht es Clients, Daten flexibel abzufragen und zu ändern, daher sind einige Maßnahmen erforderlich, um Missbrauch zu verhindern. Durch Authentifizierung und Autorisierung können wir die Sicherheit und Rechtmäßigkeit der API gewährleisten.

Zusammenfassend erfordert die Entwicklung der GraphQL-API, dass wir ein Schema definieren, einen Resolver schreiben und einen HTTP-Anforderungshandler erstellen. Die GraphQL-API bietet die Vorteile hoher Flexibilität und hoher Effizienz. Wenn Sie daher eine flexible und effiziente API für die PHP-Entwicklung erstellen müssen, ist die GraphQL-API zweifellos eine gute Wahl.

Das obige ist der detaillierte Inhalt vonUmgang mit der GraphQL-API in der PHP-API-Entwicklung. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!