如何通过PHP添加Google Analytics事件？寻找适配Composer的便捷PHP库

我完全明白你的需求——不想每次调用GA事件都要写一堆Measurement Protocol的繁琐配置，就像前端JS里那样，只需要一次初始化跟踪ID，之后随便传事件参数就行对吧？

下面给你两个方案：一个是自己封装一个极简的Composer可引入模块，完全贴合你的需求；另一个是推荐一个已经封装好的现成库。

方案1：自己封装专属的GA事件跟踪类 #

这个方案最灵活，完全按照你的需求来，而且实现起来非常简单：

1. 创建Composer包结构 #

先在项目里（或者单独建一个小仓库）创建如下结构：

ga-event-tracker/
├── src/
│   └── GAEventTracker.php
└── composer.json

2. 编写跟踪类代码 #

src/GAEventTracker.php内容如下：

<?php

namespace YourProject\GA;

use GuzzleHttp\Client;

class GAEventTracker
{
    private $trackingId;
    private $clientId;
    private $httpClient;

    // 初始化时只需要传入跟踪ID，可选传入clientId（和前端GA保持一致）
    public function __construct(string $trackingId, string $clientId = null)
    {
        $this->trackingId = $trackingId;
        // 优先用传入的clientId，没有的话从会话生成/获取（保证用户会话内一致）
        $this->clientId = $clientId ?? $this->getOrGenerateClientId();
        $this->httpClient = new Client();
    }

    private function getOrGenerateClientId(): string
    {
        if (session_status() === PHP_SESSION_NONE) {
            session_start();
        }

        if (!isset($_SESSION['ga_client_id'])) {
            $_SESSION['ga_client_id'] = uniqid('', true);
        }

        return $_SESSION['ga_client_id'];
    }

    // 完全复刻JS的调用方式：category, action, label(可选), value(可选)
    public function sendEvent(string $category, string $action, string $label = null, int $value = null): void
    {
        $payload = [
            'v' => 1, // GA协议版本
            'tid' => $this->trackingId,
            'cid' => $this->clientId,
            't' => 'event', // 事件类型
            'ec' => $category, // 事件分类
            'ea' => $action, // 事件动作
        ];

        // 可选参数添加
        if ($label !== null) {
            $payload['el'] = $label;
        }
        if ($value !== null) {
            $payload['ev'] = $value;
        }

        // 发送请求到GA Measurement Protocol
        try {
            $this->httpClient->post('https://www.google-analytics.com/collect', [
                'form_params' => $payload
            ]);
        } catch (\Exception $e) {
            // 可以根据需求添加错误日志，避免影响主流程
            error_log('GA Event Send Failed: ' . $e->getMessage());
        }
    }
}

3. 配置Composer #

composer.json内容：

{
    "name": "your-project/ga-event-tracker",
    "description": "Simple GA Event Tracker with one-time configuration, just like JS",
    "require": {
        "guzzlehttp/guzzle": "^7.0"
    },
    "autoload": {
        "psr-4": {
            "YourProject\\GA\\": "src/"
        }
    }
}

4. 在项目中使用 #

首先安装依赖：

composer require your-project/ga-event-tracker

然后在项目的入口文件（比如index.php或者配置文件）里初始化一次：

<?php
require 'vendor/autoload.php';

use YourProject\GA\GAEventTracker;

// 全局初始化，只需要做一次
$gaTracker = new GAEventTracker('UA-XXXXXXXXX-X');

// 如果要和前端GA的clientId保持一致，可以从Cookie里获取（前端GA会存_gac_UA-XXXXXXXXX-X的Cookie）
// $clientId = $_COOKIE['_ga'] ?? null;
// $gaTracker = new GAEventTracker('UA-XXXXXXXXX-X', $clientId);

之后在任何模块里，直接调用就行，和JS一样简单：

// 发送基础事件
$gaTracker->sendEvent('test', 'test');

// 带label和value的事件
$gaTracker->sendEvent('button', 'click', 'submit_form', 1);

方案2：使用现成封装库 #

如果你不想自己写，也可以试试theiconic/php-ga-measurement-protocol，虽然它基于Measurement Protocol，但可以通过初始化一次Tracker实例，之后调用事件方法：

安装：

composer require theiconic/php-ga-measurement-protocol

使用示例：

<?php
require 'vendor/autoload.php';

use TheIconic\Tracking\GoogleAnalytics\Analytics;

// 初始化一次
$analytics = new Analytics(true);
$analytics->setTrackingId('UA-XXXXXXXXX-X')
          ->setClientId($clientId); // 同样可以从会话或Cookie获取

// 发送事件
$analytics->setEventCategory('test')
          ->setEventAction('test')
          ->setEventLabel('value')
          ->sendEvent();

不过这个库的调用方式比自己封装的稍微繁琐一点，但胜在成熟稳定，支持更多GA功能。

不管选哪个方案，都能实现你想要的一次配置，多次简单调用的效果，完全适配你的项目需求。

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