摘要：代碼示例產品列表和用戶列表的例子昨天我們學習了在中搭建環境，現在我們來學習的。可以提升調用的靈活性，我們可以像寫數據庫查詢語句一樣來請求來獲取所需要的數據，這對構建復雜的查詢來說非常有用。

代碼示例：產品列表和用戶列表的 API 例子

昨天我們學習了?在 Visual Code 中搭建 Laravel 環境，現在我們來學習 Facebook 的 GraphQL 。

GraphQL 是一種 API 查詢語言，還是一種根據你為數據定義的類型系統執行查詢的服務器端運行時。GraphQL 不依賴于任何指定的數據庫或存儲引擎，而是由你的代碼和數據來作支持的。?graphql.org

GraphQL?可以提升 API 調用的靈活性，我們可以像寫數據庫查詢語句一樣來請求 API 來獲取所需要的數據，這對構建復雜的 API 查詢來說非常有用。GraphQL 還提供了可視化界面來幫助我們編寫查詢語句，還提供了自動補全的功能，這讓編寫查詢更加簡單。

https://github.com/graphql/gr...

從以下圖片可以看出，GraphQL 和 Rest 一樣都是運行在業務邏輯層以外的：

使用下面命令安裝最新版本的 Laravel ：

# 在命令行中執行
composer global require "laravel/installer"
laravel new laravel-graphql

使用 composer 安裝?graphql-laravel，這個包提供了非常多的功能用于整合 Laravel 和 GraphQL 。

像下面這樣創建模型和表?user_profiles,?products,?product_images，別忘了還要創建模型間的關系。

GraphQL 中的查詢與 Restful API 中的末端路徑查詢是一樣的，查詢只是用于獲取數據，以及創建、更新、刪除操作。我們把它稱作 Mutation 。

GraphQL 中的 類型 用于定義查詢中每個字段的類型定義，類型會幫助我們格式化查詢結果中的有格式的字段，例如布爾類型，字符串類型，浮點類型，整數類型等等，以及我們的自定義類型。下面是查詢和類型的目錄結構：

這是 UsersQuery.php?和?UsersType.php 文件完整的源代碼：

 "Users Query",
        "description" => "A query of users"
    ];
    public function type()
    {
        // 帶分頁效果的查詢結果
        return GraphQL::paginate("users");
    }
    
    // 過濾查詢的參數
    public function args()
    {
        return [
            "id" => [
                "name" => "id",
                "type" => Type::int()
            ],
            "email" => [
                "name" => "email",
                "type" => Type::string()
            ]
        ];
    }
    public function resolve($root, $args, SelectFields $fields)
    {
        $where = function ($query) use ($args) {
            if (isset($args["id"])) {
                $query->where("id",$args["id"]);
            }
            if (isset($args["email"])) {
                $query->where("email",$args["email"]);
            }
        };
        $user = User::with(array_keys($fields->getRelations()))
            ->where($where)
            ->select($fields->getSelect())
            ->paginate();
        return $user;
    }
}

 "Users",
        "description" => "A type",
        "model" => User::class, // 定義用戶類型的數據模型
    ];
    
    // 定義字段的類型
    public function fields()
    {
        return [
            "id" => [
                "type" => Type::nonNull(Type::int()),
                "description" => "The id of the user"
            ],
            "email" => [
                "type" => Type::string(),
                "description" => "The email of user"
            ],
            "name" => [
                "type" => Type::string(),
                "description" => "The name of the user"
            ],
            // 數據模型 user_profiles 中的關聯字段
            "user_profiles" => [
                "type" => GraphQL::type("user_profiles"),
                "description" => "The profile of the user"
            ]
        ];
    }
    protected function resolveEmailField($root, $args)
    {
        return strtolower($root->email);
    }
}

在編寫完查詢語句和類型之后，我們需要編輯 config/graphql.php 文件，將查詢語句和類型注冊到 Schema 中。

 "graphql",
    "routes" => "query/{graphql_schema?}",
    "controllers" => RebingGraphQLGraphQLController::class . "@query",
    "middleware" => [],
    "default_schema" => "default",
    // 注冊查詢命令 
    "schemas" => [
        "default" => [
            "query" => [
                "users" => UsersQuery::class,
                "products" => ProductsQuery::class,
            ],
            "mutation" => [
            ],
            "middleware" => []
        ],
    ],
    // 注冊類型
    "types" => [
        "product_images" => ProductImagesType::class,
        "products"  => ProductsType::class,
        "user_profiles"  => UserProfilesType::class,
        "users"  => UsersType::class,
    ],
    "error_formatter" => ["RebingGraphQLGraphQL", "formatError"],
    "params_key"    => "params"
];

我們可以使用?GraphiQL?來十分簡單地編寫查詢語句，因為在編寫的時候它可以自動補全，或者我們也可以使用 postman 來請求 API，下面是自動補全的示例：

下面是查詢結果的示例

如果你想查閱源代碼，可以訪問以下地址 :)。

https://github.com/ardani/lar...

轉自 PHP / Laravel 開發者社區 https://laravel-china.org/top...