واجهة برمجة تطبيقات GraphQL مع PHP: دليل تعليمي عملي خطوة بخطوة

مقدمة إلى GraphQL مع PHP: لماذا يستحق التجربة

GraphQL هي لغة استعلام حديثة لواجهات برمجة التطبيقات (API)، طورتها Facebook. على عكس REST، حيث يعيد كل نقطة نهاية بنية بيانات ثابتة، يسمح GraphQL للعميل بطلب الحقول التي يحتاجها فقط. هذا يقلل من حجم البيانات المنقولة ويبسط تطوير التطبيقات المعقدة.

في هذا الدليل التعليمي، سننشئ واجهة برمجة تطبيقات GraphQL كاملة باستخدام PHP مع مكتبة webonyx/graphql-php. ستتعلم كيفية تعريف المخطط، كتابة المحللات، معالجة الاستعلامات والتحويرات، وكذلك اختبار واجهة API عبر GraphiQL.

من المفترض أن يكون لديك PHP 8.0+ و Composer مثبتين. إذا لم يكن الأمر كذلك، فابدأ بتثبيتهما.

تثبيت المشروع وإعداده

الخطوة 1: إنشاء المشروع وتثبيت التبعيات

أنشئ دليلاً جديداً للمشروع وقم بتهيئة Composer:

mkdir graphql-php-tutorial\ncd graphql-php-tutorial\ncomposer init

قم بتثبيت مكتبة webonyx/graphql-php:

composer require webonyx/graphql-php

قم أيضاً بتثبيت nikic/fast-route لتوجيه بسيط (اختياري ولكنه مفيد):

composer require nikic/fast-route

الخطوة 2: هيكل المشروع

أنشئ هيكل المجلدات التالي:

graphql-php-tutorial/\n├── src/\n│   ├── Schema/\n│   │   └── schema.php\n│   ├── Resolvers/\n│   │   ├── QueryResolver.php\n│   │   └── MutationResolver.php\n│   └── Data/\n│       └── Database.php\n├── public/\n│   └── index.php\n├── vendor/\n└── composer.json

إنشاء مخطط GraphQL

الخطوة 3: تعريف الأنواع والمخطط

لننشئ نموذج بيانات بسيط: مستخدم (User) ومنشور (Post). افتح src/Schema/schema.php وأضف الكود التالي:

<?php\n\nnamespace App\\Schema;\n\nuse GraphQL\\Type\\Definition\\ObjectType;\nuse GraphQL\\Type\\Definition\\Type;\nuse GraphQL\\Type\\Schema as GraphQLSchema;\n\nclass Schema\n{\n    public static function build(): GraphQLSchema\n    {\n        // نوع User\n        $userType = new ObjectType([\n            'name' => 'User',\n            'fields' => [\n                'id' => Type::int(),\n                'name' => Type::string(),\n                'email' => Type::string(),\n                'posts' => [\n                    'type' => Type::listOf(function() use (&$postType) {\n                        return $postType;\n                    }),\n                    'resolve' => function($user) {\n                        return \\App\\Resolvers\\QueryResolver::getPostsByUser($user['id']);\n                    }\n                ]\n            ]\n        ]);\n\n        // نوع Post\n        $postType = new ObjectType([\n            'name' => 'Post',\n            'fields' => [\n                'id' => Type::int(),\n                'title' => Type::string(),\n                'content' => Type::string(),\n                'author' => [\n                    'type' => $userType,\n                    'resolve' => function($post) {\n                        return \\App\\Resolvers\\QueryResolver::getUserById($post['author_id']);\n                    }\n                ]\n            ]\n        ]);\n\n        // النوع الجذر Query\n        $queryType = new ObjectType([\n            'name' => 'Query',\n            'fields' => [\n                'users' => [\n                    'type' => Type::listOf($userType),\n                    'resolve' => function() {\n                        return \\App\\Resolvers\\QueryResolver::getAllUsers();\n                    }\n                ],\n                'user' => [\n                    'type' => $userType,\n                    'args' => [\n                        'id' => Type::nonNull(Type::int())\n                    ]