feat(nginx-log): 新增 6 张表 phinx migration + Scheme + model

app/admin/model/NginxAccessLog.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id
+ * @property string $file_path 来源日志文件路径
+ * @property string $remote_addr 客户端 IP
+ * @property string $remote_user HTTP 认证用户名
+ * @property int $time_local 请求时间戳
+ * @property string $method HTTP 方法
+ * @property string $uri 请求 URI
+ * @property string $query_string 查询字符串
+ * @property string $http_version HTTP 协议版本
+ * @property int $status HTTP 状态码
+ * @property int $body_bytes_sent 响应体字节数
+ * @property string $http_referer Referer
+ * @property string $http_user_agent User-Agent
+ * @property float $request_time 请求总耗时(秒)
+ * @property float $upstream_response_time upstream 响应时间(秒)
+ * @property int $bytes_sent 总发送字节数
+ * @property string $country 国家
+ * @property string $province 省份
+ * @property string $city 城市
+ * @property int $create_time 入库时间戳
+ */
+class NginxAccessLog extends TimeModel
+{
+    protected $name = 'nginx_access_log';
+
+    protected $deleteTime = false;
+}

app/admin/model/NginxLogPosition.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id
+ * @property string $file_path 日志文件绝对路径
+ * @property int $inode 文件 inode
+ * @property int $offset 字节偏移
+ * @property int $last_read_time 上次读取时间戳
+ * @property string $last_line_hash 上次最后一行 md5
+ * @property int $parse_fail_count 解析失败累计次数
+ * @property string $parse_fail_samples 解析失败样本
+ * @property int $create_time 创建时间戳
+ * @property int $update_time 更新时间戳
+ */
+class NginxLogPosition extends TimeModel
+{
+    protected $name = 'nginx_log_position';
+
+    protected $deleteTime = false;
+}

app/admin/model/NginxStatHour.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id
+ * @property int $stat_date 统计日期(YYYYMMDD)
+ * @property int $stat_hour 小时(0-23)
+ * @property int $pv 页面浏览量
+ * @property int $uv 独立访客数
+ * @property int $total_bytes 总流量(字节)
+ * @property int $status_2xx 2xx 响应数
+ * @property int $status_3xx 3xx 响应数
+ * @property int $status_4xx 4xx 响应数
+ * @property int $status_5xx 5xx 响应数
+ * @property int $status_other 其他状态码响应数
+ * @property float $avg_request_time 平均请求耗时(秒)
+ */
+class NginxStatHour extends TimeModel
+{
+    protected $name = 'nginx_stat_hour';
+
+    protected $deleteTime = false;
+}

app/admin/model/NginxStatReferer.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id
+ * @property int $stat_date 统计日期(YYYYMMDD)
+ * @property string $referer_domain Referer 来源域名
+ * @property int $pv 页面浏览量
+ * @property int $uv 独立访客数
+ */
+class NginxStatReferer extends TimeModel
+{
+    protected $name = 'nginx_stat_referer';
+
+    protected $deleteTime = false;
+}

app/admin/model/NginxStatUa.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id
+ * @property int $stat_date 统计日期(YYYYMMDD)
+ * @property string $ua_type UA 类型(browser/spider/unknown)
+ * @property string $ua_name UA 名称
+ * @property int $pv 页面浏览量
+ * @property int $uv 独立访客数
+ */
+class NginxStatUa extends TimeModel
+{
+    protected $name = 'nginx_stat_ua';
+
+    protected $deleteTime = false;
+}

app/admin/model/NginxStatUrl.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace app\admin\model;
+
+use app\common\model\TimeModel;
+
+/**
+ * @property int $id
+ * @property int $stat_date 统计日期(YYYYMMDD)
+ * @property string $uri 请求 URI
+ * @property int $pv 页面浏览量
+ * @property int $uv 独立访客数
+ * @property int $total_bytes 总流量(字节)
+ * @property float $avg_request_time 平均请求耗时(秒)
+ */
+class NginxStatUrl extends TimeModel
+{
+    protected $name = 'nginx_stat_url';
+
+    protected $deleteTime = false;
+}

app/admin/scheme/NginxAccessLog.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'nginx_access_log', comment: 'nginx 访问日志明细（解析入库）')]
+#[Index(columns: ['time_local'], name: 'idx_time_local', type: 'NORMAL')]
+#[Index(columns: ['remote_addr'], name: 'idx_remote_addr', type: 'NORMAL')]
+#[Index(columns: ['status'], name: 'idx_status', type: 'NORMAL')]
+#[Index(columns: ['uri'], name: 'idx_uri', type: 'NORMAL')]
+#[Index(columns: ['file_path'], name: 'idx_file_path', type: 'NORMAL')]
+class NginxAccessLog extends BaseScheme
+{
+    #[Field(type: 'bigint', nullable: false, unsigned: true, autoIncrement: true, primary: true, comment: '主键ID')]
+    public $id;
+
+    #[Field(type: 'varchar', length: 500, nullable: false, comment: '来源日志文件路径')]
+    public $file_path;
+
+    #[Field(type: 'varchar', length: 45, nullable: false, comment: '客户端 IP（含 IPv6）')]
+    public $remote_addr;
+
+    #[Field(type: 'varchar', length: 100, nullable: true, comment: 'HTTP 认证用户名')]
+    public $remote_user;
+
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, comment: '请求时间戳（业务时区）')]
+    public $time_local;
+
+    #[Field(type: 'varchar', length: 10, nullable: true, comment: 'HTTP 方法')]
+    public $method;
+
+    #[Field(type: 'varchar', length: 255, nullable: false, comment: '请求 URI（超 255 截断）')]
+    public $uri;
+
+    #[Field(type: 'varchar', length: 500, nullable: false, default: '', comment: '查询字符串')]
+    public $query_string;
+
+    #[Field(type: 'varchar', length: 10, nullable: true, comment: 'HTTP 协议版本')]
+    public $http_version;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: 'HTTP 状态码')]
+    public $status;
+
+    #[Field(type: 'bigint', default: '0', comment: '响应体字节数')]
+    public $body_bytes_sent;
+
+    #[Field(type: 'varchar', length: 500, nullable: false, default: '', comment: 'Referer')]
+    public $http_referer;
+
+    #[Field(type: 'varchar', length: 500, nullable: false, default: '', comment: 'User-Agent（超 500 截断）')]
+    public $http_user_agent;
+
+    #[Field(type: 'decimal', precision: 10, scale: 3, default: '0.000', comment: 'nginx 请求总耗时(秒)')]
+    public $request_time;
+
+    #[Field(type: 'decimal', precision: 10, scale: 3, default: '0.000', comment: 'upstream 响应时间(秒)')]
+    public $upstream_response_time;
+
+    #[Field(type: 'bigint', default: '0', comment: '总发送字节数（含 header）')]
+    public $bytes_sent;
+
+    #[Field(type: 'varchar', length: 50, nullable: true, comment: '国家（GeoIP 预留）')]
+    public $country;
+
+    #[Field(type: 'varchar', length: 50, nullable: true, comment: '省份（GeoIP 预留）')]
+    public $province;
+
+    #[Field(type: 'varchar', length: 50, nullable: true, comment: '城市（GeoIP 预留）')]
+    public $city;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '入库时间戳')]
+    public $create_time;
+}

app/admin/scheme/NginxLogPosition.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'nginx_log_position', comment: 'nginx 日志文件读取位置（增量读取状态）')]
+#[Index(columns: ['file_path'], name: 'uniq_file_path', type: 'UNIQUE')]
+class NginxLogPosition extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'varchar', length: 500, nullable: false, comment: '日志文件绝对路径')]
+    public $file_path;
+
+    #[Field(type: 'bigint', default: '0', unsigned: true, comment: '文件 inode，用于检测日志轮转')]
+    public $inode;
+
+    #[Field(type: 'bigint', default: '0', unsigned: true, comment: '上次读取到的字节偏移')]
+    public $offset;
+
+    #[Field(type: 'int', length: 11, default: '0', unsigned: true, comment: '上次读取时间戳')]
+    public $last_read_time;
+
+    #[Field(type: 'varchar', length: 32, default: '', comment: '上次最后一行的 md5 哈希（容错校验）')]
+    public $last_line_hash;
+
+    #[Field(type: 'int', length: 11, default: '0', unsigned: true, comment: '解析失败累计次数')]
+    public $parse_fail_count;
+
+    #[Field(type: 'text', nullable: true, comment: '解析失败样本行（最多保留若干条）')]
+    public $parse_fail_samples;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '创建时间戳')]
+    public $create_time;
+
+    #[Field(type: 'int', length: 11, unsigned: true, comment: '更新时间戳')]
+    public $update_time;
+}

app/admin/scheme/NginxStatHour.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'nginx_stat_hour', comment: 'nginx 按小时聚合统计')]
+#[Index(columns: ['stat_date', 'stat_hour'], name: 'uniq_date_hour', type: 'UNIQUE')]
+#[Index(columns: ['stat_date'], name: 'idx_stat_date', type: 'NORMAL')]
+class NginxStatHour extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, comment: '统计日期(YYYYMMDD)')]
+    public $stat_date;
+
+    #[Field(type: 'tinyint', length: 2, default: '0', unsigned: true, comment: '小时(0-23)')]
+    public $stat_hour;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '页面浏览量')]
+    public $pv;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '独立访客数')]
+    public $uv;
+
+    #[Field(type: 'bigint', default: '0', comment: '总流量(字节)')]
+    public $total_bytes;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '2xx 响应数')]
+    public $status_2xx;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '3xx 响应数')]
+    public $status_3xx;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '4xx 响应数')]
+    public $status_4xx;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '5xx 响应数')]
+    public $status_5xx;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '其他状态码响应数')]
+    public $status_other;
+
+    #[Field(type: 'decimal', precision: 10, scale: 3, default: '0.000', comment: '平均请求耗时(秒)')]
+    public $avg_request_time;
+}

app/admin/scheme/NginxStatReferer.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'nginx_stat_referer', comment: 'nginx 按 Referer 来源域名聚合统计')]
+#[Index(columns: ['stat_date', 'referer_domain'], name: 'uniq_date_referer', type: 'UNIQUE')]
+#[Index(columns: ['stat_date'], name: 'idx_stat_date', type: 'NORMAL')]
+class NginxStatReferer extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, comment: '统计日期(YYYYMMDD)')]
+    public $stat_date;
+
+    #[Field(type: 'varchar', length: 255, nullable: false, comment: 'Referer 来源域名(direct/unknown)')]
+    public $referer_domain;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '页面浏览量')]
+    public $pv;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '独立访客数')]
+    public $uv;
+}

app/admin/scheme/NginxStatUa.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'nginx_stat_ua', comment: 'nginx 按 User-Agent 聚合统计')]
+#[Index(columns: ['stat_date', 'ua_type', 'ua_name'], name: 'uniq_date_type_name', type: 'UNIQUE')]
+#[Index(columns: ['stat_date'], name: 'idx_stat_date', type: 'NORMAL')]
+class NginxStatUa extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, comment: '统计日期(YYYYMMDD)')]
+    public $stat_date;
+
+    #[Field(type: 'varchar', length: 20, default: 'unknown', comment: 'UA 类型(browser/spider/unknown)')]
+    public $ua_type;
+
+    #[Field(type: 'varchar', length: 255, nullable: false, comment: 'UA 名称(具体型号)')]
+    public $ua_name;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '页面浏览量')]
+    public $pv;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '独立访客数')]
+    public $uv;
+}

app/admin/scheme/NginxStatUrl.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace app\admin\scheme;
+
+use app\common\scheme\BaseScheme;
+use app\common\scheme\attribute\Table;
+use app\common\scheme\attribute\Field;
+use app\common\scheme\attribute\Index;
+
+#[Table(name: 'nginx_stat_url', comment: 'nginx 按 URL 聚合统计')]
+#[Index(columns: ['stat_date', 'uri'], name: 'uniq_date_uri', type: 'UNIQUE')]
+#[Index(columns: ['stat_date'], name: 'idx_stat_date', type: 'NORMAL')]
+class NginxStatUrl extends BaseScheme
+{
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, autoIncrement: true, primary: true)]
+    public $id;
+
+    #[Field(type: 'int', length: 11, nullable: false, unsigned: true, comment: '统计日期(YYYYMMDD)')]
+    public $stat_date;
+
+    #[Field(type: 'varchar', length: 255, nullable: false, comment: '请求 URI')]
+    public $uri;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '页面浏览量')]
+    public $pv;
+
+    #[Field(type: 'int', length: 11, default: '0', comment: '独立访客数')]
+    public $uv;
+
+    #[Field(type: 'bigint', default: '0', comment: '总流量(字节)')]
+    public $total_bytes;
+
+    #[Field(type: 'decimal', precision: 10, scale: 3, default: '0.000', comment: '平均请求耗时(秒)')]
+    public $avg_request_time;
+}