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。
