如何在JavaScript、PHP中使用webhooks将Picqer数据存入Firebase数据库

Vue+Axios的前端方案无法直接处理Webhook需求：Webhook是第三方服务（此处为Picqer）主动向公网可访问的服务端地址发送POST请求的机制，前端页面运行在用户浏览器中，没有固定公网地址，也无法24小时在线接收请求，因此必须通过服务端实现。

PHP实现Webhook不需要额外编写24小时运行的常驻监听脚本，配合Nginx/Apache这类Web服务器即可实现事件触发式运行，核心逻辑如下：

• 编写单独的PHP接口文件，比如picqer-webhook.php，部署到具备公网IP的服务器上，对应公网可访问的URL，例如https://your-domain.com/picqer-webhook.php
• 进入Picqer后台，将上述URL填写到Webhook接收地址栏，勾选需要监听的触发事件
• 每次Picqer对应事件触发时，会自动向该URL发送携带事件数据的POST请求，Web服务器收到请求后会自动执行对应的PHP脚本，处理完成后脚本自动结束，Web服务器本身的24小时运行机制已经承担了监听工作。

<?php
// 固定返回200状态码，Picqer判定推送成功的必要条件
http_response_code(200);
// 读取Picqer发送的原始JSON请求体
$rawPayload = file_get_contents('php://input');
// 可选：校验请求来源合法性，避免恶意伪造请求
// Picqer会在请求头携带签名，可结合后台获取的密钥做校验，防止非法数据写入
// $signature = $_SERVER['HTTP_X_PICQER_SIGNATURE'] ?? '';
// 解析JSON数据为数组格式
$eventData = json_decode($rawPayload, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    // 解析错误可自行增加日志记录逻辑，此处直接终止执行
    exit;
}
// 后续为写入Firebase的逻辑
?>

使用官方适配的Firebase Admin SDK for PHP即可快速实现：

1. 首先通过Composer安装依赖：
   composer require kreait/firebase-php
2. 进入Firebase后台下载服务账号密钥JSON文件，存到服务器非Web可访问的目录，避免密钥泄露。
3. 在上述picqer-webhook.php中补充写入逻辑：

<?php
// 引入Composer自动加载文件
require __DIR__ . '/vendor/autoload.php';
use Kreait\Firebase\Factory;
use Kreait\Firebase\ServiceAccount;
// 前面接收解析$eventData的逻辑保持不变
// 初始化Firebase实例
$serviceAccount = ServiceAccount::fromJsonFile(__DIR__ . '/替换为你的服务账号密钥文件名.json');
$firebase = (new Factory)
    ->withServiceAccount($serviceAccount)
    ->create();
$database = $firebase->getDatabase();
// 取Picqer推送的事件ID作为存储节点key，避免重复写入
$eventId = $_SERVER['HTTP_X_PICQER_EVENT_ID'] ?? uniqid();
// 写入到Firebase Realtime Database的指定节点
$database->getReference('picqer_events/' . $eventId)
    ->set($eventData);
exit;
?>

• 部署完成后可先使用Picqer后台的测试推送功能验证，确认接口可正常接收数据并写入Firebase
• 生产环境必须加请求签名校验逻辑，避免恶意请求伪造数据入库
• 可增加本地日志记录，留存每次请求的payload和处理结果，方便问题排查
• 没有自有服务器的场景下，可使用Serverless云函数部署该PHP脚本，无需自行维护服务器运行环境，也可实现24小时正常接收请求

内容的提问来源于stack exchange，提问作者bartske2002