Laravel Device Tracking 项目安装与使用教程

Laravel Device Tracking 项目安装与使用教程

laravel-device-tracking a library that allow to track different devices used 项目地址: https://gitcode.com/gh_mirrors/la/laravel-device-tracking

1. 项目目录结构及介绍

laravel-device-tracking/
├── config/
│   └── laravel-device-tracking.php
├── database/
│   └── migrations/
│       └── 2023_01_01_000000_create_device_tracking_table.php
├── src/
│   ├── Facades/
│   │   └── DeviceTracker.php
│   ├── Http/
│   │   └── Middleware/
│   │       └── DeviceTrackerMiddleware.php
│   ├── Traits/
│   │   └── UseDevices.php
│   └── LaravelDeviceTrackingServiceProvider.php
├── tests/
│   └── DeviceTrackingTest.php
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .scrutinizer.yml
├── .styleci.yml
├── .travis.yml
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE.md
├── README.md
├── composer.json
└── phpunit.xml.dist

目录结构介绍

• config/: 包含项目的配置文件 laravel-device-tracking.php。
• database/migrations/: 包含数据库迁移文件 2023_01_01_000000_create_device_tracking_table.php，用于创建设备跟踪相关的数据库表。
• src/: 项目的核心代码目录。
  • Facades/: 包含 DeviceTracker 门面类，用于设备跟踪的静态调用。
  • Http/Middleware/: 包含 DeviceTrackerMiddleware 中间件，用于在后续请求中检查设备信息。
  • Traits/: 包含 UseDevices 特性，用于在用户模型中添加设备跟踪功能。
  • LaravelDeviceTrackingServiceProvider.php: 服务提供者，用于注册和引导设备跟踪服务。
• tests/: 包含测试文件 DeviceTrackingTest.php，用于测试设备跟踪功能。
• 其他文件: 包含项目的配置文件、文档、构建配置等。

2. 项目的启动文件介绍

LaravelDeviceTrackingServiceProvider.php

LaravelDeviceTrackingServiceProvider.php 是项目的启动文件，负责注册和引导设备跟踪服务。它主要包含以下功能：

• 注册服务: 将设备跟踪服务注册到 Laravel 的服务容器中。
• 发布配置文件: 发布配置文件 laravel-device-tracking.php 到 Laravel 的配置目录中。
• 发布迁移文件: 发布数据库迁移文件到 Laravel 的迁移目录中。
• 引导服务: 在应用程序启动时执行必要的初始化操作。

DeviceTracker.php

DeviceTracker.php 是设备跟踪的门面类，提供了静态方法用于设备检测、更新和验证。主要方法包括：

• detectFindAndUpdate(): 检测、查找并更新设备信息。
• flagCurrentAsVerified(): 将当前设备标记为已验证。
• flagAsVerified($device, $user_id): 将指定设备标记为已验证。
• flagAsVerifiedByUuid($device_uuid, $user_id): 根据设备 UUID 将设备标记为已验证。

3. 项目的配置文件介绍

laravel-device-tracking.php

laravel-device-tracking.php 是项目的配置文件，包含了设备跟踪的相关配置选项。主要配置项包括：

• detect_on_login: 是否在登录事件触发时检测设备信息，默认为 true。
• device_hijacking_detector: 设备劫持检测器的配置，用于检测设备信息是否被篡改。
• middleware: 中间件配置，用于在后续请求中检查设备信息。

配置文件示例

return [
    'detect_on_login' => true,
    'device_hijacking_detector' => [
        'enabled' => true,
        'threshold' => 5,
    ],
    'middleware' => [
        'enabled' => true,
        'group' => 'web',
    ],
];

通过以上配置，可以灵活控制设备跟踪的行为，确保设备信息的安全性和准确性。

laravel-device-tracking a library that allow to track different devices used 项目地址: https://gitcode.com/gh_mirrors/la/laravel-device-tracking