Bagaimana untuk menangani API GraphQL dalam pembangunan API PHP

Dengan pembangunan aplikasi web yang berterusan, penggunaan API (Antaramuka Pengaturcaraan Aplikasi) menjadi semakin biasa. API, sebagai teras aplikasi web, membenarkan aplikasi yang berbeza untuk berkomunikasi antara satu sama lain dan berkongsi data. Dalam pembangunan PHP, API GraphQL telah menjadi kaedah pembangunan yang semakin popular, yang boleh menjadi lebih fleksibel dan cekap daripada API RESTful tradisional.

GraphQL ialah bahasa pertanyaan API yang dibangunkan oleh Facebook, yang membolehkan pelanggan mendapatkan data tepat yang diperlukan daripada pelayan. Berbanding dengan API RESTful tradisional, GraphQL adalah lebih fleksibel dan cekap, dan boleh mengurangkan volum komunikasi antara aplikasi dan pelayan dengan banyak. Dalam artikel ini, kami akan meneroka cara untuk membangunkan dan memproses API GraphQL dalam PHP.

Langkah pertama ialah memahami cara API GraphQL berfungsi. Teras API GraphQL ialah Skema (skema), yang mentakrifkan jenis dan operasi data yang boleh ditanya dan boleh diubah. Pelanggan boleh menggunakan bahasa pertanyaan GraphQL untuk menyerahkan permintaan kepada pelayan untuk menanyakan data yang diperlukan. Pelayan mentafsir operasi mengikut Skema GraphQL dan mengembalikan data yang diperlukan oleh klien. graphql-php ialah perpustakaan PHP yang boleh membantu kami membangunkan API GraphQL dengan lebih mudah.

Langkah pertama dalam membangunkan API GraphQL ialah mencipta Skema. Kita perlu menentukan Skema, yang mengandungi jenis dan operasi data yang boleh ditanya dan boleh diubah. Skema biasanya mengandungi objek pertanyaan, menukar objek, objek input dan jenis skalar.

Antaranya, objek pertanyaan mewakili data yang boleh ditanya oleh klien; objek perubahan mewakili data yang boleh diubah suai oleh klien; termasuk rentetan, nilai Boolean, Jenis data asas seperti integer dan nombor titik terapung.

Dalam proses mencipta Skema, kita perlu menentukan jenis dan parameter setiap objek dan medan. Sebagai contoh, berikut ialah objek pertanyaan mudah:

type Query {
  hello: String!
}

Objek pertanyaan ini menunjukkan bahawa medan helo jenis rentetan boleh disoal. Tanda seru menunjukkan bahawa medan ini diperlukan dan tidak boleh mengembalikan nol.

Seterusnya, kita perlu menentukan Penyelesai (parser), yang bertanggungjawab untuk memproses pemerolehan data dan perubahan untuk setiap objek atau medan. Penyelesai ialah fungsi panggil balik PHP yang perlu menerima permintaan dan maklumat konteks, dan kemudian mengembalikan hasil pertanyaan. Sebagai contoh, untuk medan helo yang ditakrifkan di atas, kita boleh mencipta Penyelesai:

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

Penyelesai ini terus mengembalikan rentetan "Hello, Dunia!". Kita perlu mengikat Penyelesai ini kepada Skema supaya permintaan pertanyaan boleh diproses.

Seterusnya, kita boleh menggunakan kelas GraphQL dalam perpustakaan graphql-php untuk menulis pemproses permintaan HTTP untuk mengendalikan permintaan pertanyaan pelanggan. Pengendali permintaan HTTP menerima permintaan, menghuraikan pertanyaan dan perubahan dalam permintaan ke dalam bahasa pertanyaan GraphQL dan menghantarnya kepada Skema.

<?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);

Akhir sekali, kami juga perlu mempertimbangkan cara untuk mengamankan API GraphQL. API GraphQL membolehkan pelanggan membuat pertanyaan dan mengubah suai data secara fleksibel, jadi beberapa langkah diperlukan untuk mengelakkan penyalahgunaan. Kami boleh memastikan keselamatan dan kesahihan API melalui pengesahan dan kebenaran.

Ringkasnya, membangunkan API GraphQL memerlukan kami mentakrifkan Skema, menulis Penyelesai dan mencipta pengendali permintaan HTTP. API GraphQL mempunyai kelebihan fleksibiliti tinggi dan kecekapan tinggi. Oleh itu, jika anda perlu membina API yang fleksibel dan cekap dalam pembangunan PHP, maka GraphQL API sudah pasti akan menjadi pilihan yang baik.

Atas ialah kandungan terperinci Bagaimana untuk menangani API GraphQL dalam pembangunan API PHP. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!