xsuchy09/visitor

Visitor将网页访问者的信息保存到数据库中,并使用cookie来识别他们。

1.0.4 2020-01-28 15:55 UTC

This package is auto-updated.

Last update: 2024-08-29 02:30:06 UTC


README

PHP库,用于将网页访问者的信息保存到数据库。需要PHP 7.1。

作者

概述

Visitor将网页访问者的信息保存到数据库中,并使用cookie来识别相同的访问者。cookie的有效期可配置,默认为10年。它使用UtmCookie来保存UTMs,并使用Hashids为每个单独的访问者获取唯一的哈希(例如,在JavaScript中直接使用数据库ID是不安全的)。

创建数据库表的SQL语句已包含在内(visitor.sql - 用于PostgreSQL)。列"visits_count"使用触发器计数(如果新访问距离上次访问超过24小时,则计算新访问)。您可以根据需要更改它。

安装(通过composer)

获取composer并在composer.json的requires部分添加以下内容

{
    "require": {
        "xsuchy09/visitor": "*"
    }
}

然后

composer install

用法

基本示例

$pdo = $PDO = new PDO(sprintf('pgsql:host=%s;port=%d;dbname=%s;user=%s;password=%s', 'localhost', 5432, 'db_name', 'username', 'password'));
$visitor = new Visitor($pdo, 'HashidsKey'); // it needs pdo instance in constructor and key for Hashids (use your own for your security). You can use others optionally params as you need.
$visitor->addVisit(); // set last visit of of visitor if he is identified or just create the new one with first visit

更多示例可以在examples/目录中找到。自1.0.4版本起,您可以在构造函数中设置cookie参数(路径、域名、安全、httpOnly、sameSite)并添加了一些getter。