Ubuntu 18.04配置PHP与GraphQL教程

本文详细介绍了在Ubuntu 18.04系统上从零搭建PHP与GraphQL集成开发环境的完整流程：涵盖LAMP基础环境安装与PHP验证、通过Composer引入权威GraphQL PHP库（webonyx/graphql-php）、定义可扩展的GraphQL Schema结构、编写入口脚本处理查询请求，以及配置Apache重写模块以支持标准GraphQL API调用——步骤清晰、实操性强，特别适合遇到请求解析失败或依赖缺失问题的开发者快速排查并落地一个稳定可用的GraphQL后端服务。

如果您尝试在Ubuntu 18.04上搭建PHP与GraphQL的集成环境，但无法正确解析请求或执行查询，则可能是由于环境配置不完整或依赖缺失。以下是完成该配置的具体步骤：

一、安装LAMP环境

LAMP（Linux, Apache, MySQL, PHP）是运行PHP应用的基础环境。在Ubuntu 18.04上安装这些组件可确保PHP能够正常运行。

1、更新系统包列表：sudo apt update

2、安装Apache2：sudo apt install apache2

3、安装MySQL服务器：sudo apt install mysql-server

4、安装PHP及其常用扩展：sudo apt install php libapache2-mod-php php-mysql php-curl php-json php-mbstring

5、重启Apache服务以加载PHP模块：sudo systemctl restart apache2

二、验证PHP安装

确认PHP已正确安装并可由Web服务器解析，避免后续GraphQL库无法加载。

1、在/var/www/html目录下创建info.php文件：sudo nano /var/www/html/info.php

2、输入以下内容并保存：
phpinfo();
?>

3、在浏览器中访问http://localhost/info.php，若显示PHP信息页面则表示安装成功。

4、测试完成后删除该文件以保障安全：sudo rm /var/www/html/info.php

三、安装GraphQL PHP库

使用第三方GraphQL实现库（如webonyx/graphql-php）来支持GraphQL查询解析和执行。

1、进入网站根目录：cd /var/www/html

2、使用Composer安装GraphQL PHP库：composer require webonyx/graphql-php

3、若未安装Composer，先执行：sudo apt install composer

4、再次运行安装命令以确保依赖被正确引入。

四、创建GraphQL模式文件

定义GraphQL的Schema和类型，用于处理客户端查询请求。

1、创建schema.php文件：nano /var/www/html/schema.php

2、添加基础类型和查询结构示例代码：

require_once 'vendor/autoload.php';

use GraphQL\Type\Definition\ObjectType;
use GraphQL\Type\Definition\Type;
use GraphQL\Type\Schema;

$queryType = new ObjectType([
    'name' => 'Query',
    'fields' => [
        'hello' => [
            'type' => Type::string(),
            'resolve' => function () {
                return 'Hello World';
            }
        ]
    ]
]);

$schema = new Schema(['query' => $queryType]);
?>

五、设置GraphQL入口脚本

创建一个PHP脚本接收HTTP请求，解析GraphQL查询并返回结果。

1、创建graphql.php文件：nano /var/www/html/graphql.php

2、写入以下处理逻辑：

require_once 'vendor/autoload.php';
require_once 'schema.php';

use GraphQL\GraphQL;

try {
    $input = json_decode(file_get_contents('php://input'), 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 = ['error' => $e->getMessage()];
}
header('Content-Type: application/json');
echo json_encode($output);
?>

3、保存后可通过POST请求向该文件发送GraphQL查询。

六、配置Apache虚拟主机支持重写规则

启用mod_rewrite模块，以便支持友好的URL路径或API路由。

1、启用重写模块：sudo a2enmod rewrite

2、编辑默认站点配置：sudo nano /etc/apache2/sites-available/000-default.conf

3、在段落内添加：

AllowOverride All
Require all granted

4、保存后重启Apache：sudo systemctl restart apache2

本篇关于《Ubuntu 18.04配置PHP与GraphQL教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！