graphql突變在php中用于執行創建、更新或刪除數據等變更操作。1.定義schema中的突變類型，包括名稱、參數和返回值類型；2.實現resolver函數，處理業務邏輯并與突變關聯；3.創建腳本接收并解析graphql請求，執行對應resolver；4.注重安全性，如輸入驗證、身份認證、速率限制及錯誤處理；5.優化性能，如批量處理、數據庫事務、緩存及查詢優化；6.實現文件上傳需自定義upload類型并在resolver中處理文件。通過以上步驟可構建安全高效的graphql api。
GraphQL突變（Mutation）在PHP中用于執行數據的變更操作，例如創建、更新或刪除數據。處理GraphQL突變的關鍵在于定義好突變類型，并將其與PHP函數或類方法關聯起來，以便在接收到GraphQL請求時執行相應的業務邏輯。
解決方案
-
定義GraphQL Schema中的突變類型： 首先，需要在GraphQL Schema中定義突變類型。每個突變都需要指定一個名稱、參數（輸入類型）和返回值類型。
type Mutation { createUser(input: CreateUserInput!): User updateUser(id: ID!, input: UpdateUserInput!): User deleteUser(id: ID!): Boolean } input CreateUserInput { name: String! email: String! } input UpdateUserInput { name: String email: String } type User { id: ID! name: String! email: String! } -
實現Resolver函數： 接下來，需要為每個突變定義一個Resolver函數。Resolver函數負責接收GraphQL請求中的參數，執行相應的業務邏輯，并返回結果。在PHP中，可以使用各種GraphQL庫（例如Webonyx/GraphQL-PHP）來實現Resolver。
use GraphQLTypeDefinitionObjectType; use GraphQLTypeDefinitionType; use GraphQLTypeSchema; // 假設已經有了數據庫連接和用戶模型 $userType = new ObjectType([ 'name' => 'User', 'fields' => [ 'id' => ['type' => Type::nonNull(Type::id())], 'name' => ['type' => Type::nonNull(Type::string())], 'email' => ['type' => Type::nonNull(Type::string())], ], ]); $mutationType = new ObjectType([ 'name' => 'Mutation', 'fields' => [ 'createUser' => [ 'type' => $userType, 'args' => [ 'input' => ['type' => Type::nonNull(new ObjectType([ 'name' => 'CreateUserInput', 'fields' => [ 'name' => ['type' => Type::nonNull(Type::string())], 'email' => ['type' => Type::nonNull(Type::string())], ], ]))], ], 'resolve' => function ($rootValue, $args) { // 創建用戶 $name = $args['input']['name']; $email = $args['input']['email']; $user = User::create(['name' => $name, 'email' => $email]); // 假設User模型有create方法 return $user; }, ], 'updateUser' => [ 'type' => $userType, 'args' => [ 'id' => ['type' => Type::nonNull(Type::id())], 'input' => ['type' => Type::nonNull(new ObjectType([ 'name' => 'UpdateUserInput', 'fields' => [ 'name' => ['type' => Type::string()], 'email' => ['type' => Type::string()], ], ]))], ], 'resolve' => function ($rootValue, $args) { // 更新用戶 $id = $args['id']; $input = $args['input']; $user = User::find($id); // 假設User模型有find方法 if (!$user) { throw new Exception("User not found with id: $id"); } if (isset($input['name'])) { $user->name = $input['name']; } if (isset($input['email'])) { $user->email = $input['email']; } $user->save(); // 假設User模型有save方法 return $user; }, ], 'deleteUser' => [ 'type' => Type::boolean(), 'args' => [ 'id' => ['type' => Type::nonNull(Type::id())], ], 'resolve' => function ($rootValue, $args) { // 刪除用戶 $id = $args['id']; $user = User::find($id); if (!$user) { return false; } $user->delete(); return true; }, ], ], ]); $queryType = new ObjectType([ // 添加 QueryType，否則會報錯 'name' => 'Query', 'fields' => [ 'hello' => [ 'type' => Type::string(), 'resolve' => function () { return 'Hello world!'; } ] ] ]); $schema = new Schema([ 'query' => $queryType, 'mutation' => $mutationType, ]); -
處理GraphQL請求： 最后，需要創建一個php腳本來接收GraphQL請求，解析請求內容，并執行相應的Resolver函數。
use GraphQLGraphQL; use GraphQLUtilsUtils; try { $rawInput = file_get_contents('php://input'); $input = json_decode($rawInput, true); $query = $input['query']; $variableValues = isset($input['variables']) ? $input['variables'] : null; $result = GraphQL::executeQuery($schema, $query, null, null, $variableValues); $output = $result->toArray(); } catch (Exception $e) { $output = [ 'errors' => [ [ 'message' => $e->getMessage() ] ] ]; } header('Content-Type: application/json'); echo json_encode($output);
PHP GraphQL突變的安全性考慮
立即學習“PHP免費學習筆記（深入）”；
在處理GraphQL突變時，安全性至關重要。需要考慮以下幾個方面：
- 輸入驗證：確保對所有輸入參數進行驗證，防止sql注入、xss等安全漏洞。可以使用PHP的filter_var函數或第三方驗證庫來實現輸入驗證。
- 身份驗證和授權：只有經過身份驗證的用戶才能執行某些突變。可以使用PHP的會話管理或JWT等技術來實現身份驗證。此外，還需要根據用戶的角色或權限來限制其可以執行的突變。
- 速率限制：為了防止惡意攻擊，可以對GraphQL API進行速率限制。可以使用PHP的緩存機制或第三方速率限制庫來實現速率限制。
- 錯誤處理：在Resolver函數中，需要對可能發生的錯誤進行處理，并返回有意義的錯誤信息。避免將敏感信息暴露給客戶端。
優化GraphQL突變的性能
GraphQL突變的性能對于用戶體驗至關重要。可以采取以下措施來優化性能：
- 批量處理：如果需要執行多個相關的突變，可以考慮將其合并為一個批量操作。這樣可以減少網絡請求的次數，提高性能。
- 使用數據庫事務：對于需要修改多個數據表的突變，可以使用數據庫事務來保證數據的一致性。
- 緩存：對于不經常變化的數據，可以使用緩存來提高讀取性能。可以使用PHP的緩存擴展（例如redis、memcached）來實現緩存。
- 優化數據庫查詢：確保數據庫查詢語句的性能良好。可以使用數據庫的索引、查詢優化器等工具來優化查詢性能。
GraphQL突變中的文件上傳
GraphQL本身不支持文件上傳，但可以通過一些技巧來實現文件上傳功能。一種常見的方法是使用multipart/form-data格式來發送文件，并在GraphQL Schema中定義一個特殊的輸入類型來處理文件。
首先，需要在GraphQL Schema中定義一個文件類型的輸入類型：
scalar Upload
然后，在突變中使用該輸入類型：
type Mutation { uploadFile(file: Upload!): String }
在PHP的Resolver函數中，需要從$_FILES數組中獲取上傳的文件，并進行處理：
'uploadFile' => [ 'type' => Type::string(), 'args' => [ 'file' => ['type' => Type::nonNull(new UploadType())], ], 'resolve' => function ($rootValue, $args) { $file = $args['file']; $filename = $file['name']; $tmp_name = $file['tmp_name']; $error = $file['error']; if ($error !== UPLOAD_ERR_OK) { throw new Exception("File upload failed with error code: $error"); } // 將文件保存到服務器 $destination = '/path/to/uploads/' . $filename; move_uploaded_file($tmp_name, $destination); return "File uploaded successfully to: $destination"; }, ],
需要注意的是，UploadType是一個自定義的GraphQL類型，需要自己實現。可以使用第三方庫（例如mll-lab/graphql-php-scalars）來提供UploadType。
總的來說，PHP處理GraphQL突變涉及定義Schema、編寫Resolver和處理請求。安全性和性能優化是關鍵，文件上傳需要特殊處理。通過這些技巧，可以構建健壯且高效的GraphQL API。
