Bắt đầu
Hasura Extra là bộ tập hợp các thư viện PHP độc lập có thể sử dụng ở bất kỳ project nào. Ngoài ra chúng tôi còn có cung cấp package/bundle và các application tempates (boilerplate) dành cho Laravel và Symfony framework.
Chuẩn bị
Bạn cần chuẩn bị Docker engine và Docker compose version 3.
Cài đặt thông qua application templates
Nếu như project của bạn là một project mới thì bạn nên sử dụng Laravel hoặc Symfony application template, đây là 2 bộ boilerplate dành riêng cho Laravel và Symfony framework được cài đặt sẵn các cấu hình cần thiết cho việc integrate giữa framework và Hasura như local remote schema, handle event triggered bởi Hasura, tổ chức sắp xếp Hasura metadata, Sailor graphql client code generator, authentication hook, Sanctum/JWT authentication, Helm chart dùng để deploy dự án của bạn lên Kubernetes và có example giúp bạn dễ tiếp cận hơn.
Mặt khác bạn có thể cài đặt package/bundle thông qua Composer.
Cài đặt thông qua Composer
- Đối với Laravel users
- Đối với Symfony users
composer require hasura-extra/laravel
Sau đó bạn cần publish Hasura Extra config:
php artisan vendor:publish --provider="Hasura\Laravel\ServiceProvider\HasuraServiceProvider"
Và publish Laravel GraphQLite config:
php artisan vendor:publish --provider="TheCodingMachine\GraphQLite\Laravel\Providers\GraphQLiteServiceProvider"
Sau khi publish config files, bạn hãy kham khảo chú thích bên trong để cấu hình cho phù hợp với project của bạn.
composer require hasura-extra/bundle
Symfony Flex sẽ giúp bạn cấu hình config và routes, sau đó bạn cần mở file
config/packages/hasura.yaml
để cấu hình Hasura base uri, admin secret.