From 1eae4171f6cbbef20d56addbde7271b5cc1a8198 Mon Sep 17 00:00:00 2001
From: ctexthuang <ctexthuang@qq.com>
Date: Mon, 15 Sep 2025 14:45:34 +0800
Subject: [PATCH] feat : admin aspect

---
 .../Common/ClientIpRequestConstant.php        | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 app/Constants/Common/ClientIpRequestConstant.php

diff --git a/app/Constants/Common/ClientIpRequestConstant.php b/app/Constants/Common/ClientIpRequestConstant.php
new file mode 100644
index 0000000..c19b0b1
--- /dev/null
+++ b/app/Constants/Common/ClientIpRequestConstant.php
@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Constants\Common;
+
+
+final class ClientIpRequestConstant
+{
+    /**
+     * RFC 7239 标准的 Forwarded 头
+     */
+    public const int HEADER_FORWARDED = 0b000001;
+
+    /**
+     * 客户端原始 IP
+     */
+    public const int HEADER_X_FORWARDED_FOR = 0b000010;
+
+    /**
+     * 原始主机名
+     */
+    public const int HEADER_X_FORWARDED_HOST = 0b000100;
+
+    /**
+     * 原始协议 (http/https)
+     */
+    public const int HEADER_X_FORWARDED_PROTO = 0b001000;
+
+    /**
+     * 原始端口
+     */
+    public const int HEADER_X_FORWARDED_PORT = 0b010000;
+
+    /**
+     * 原始路径前缀
+     */
+    public const int HEADER_X_FORWARDED_PREFIX = 0b100000;
+
+    /**
+     * 将部分标志映射到 RFC 7239 Forwarded 头中的参数名
+     */
+    public const array FORWARDED_PARAMS = [
+        self::HEADER_X_FORWARDED_FOR => 'for',
+        self::HEADER_X_FORWARDED_HOST => 'host',
+        self::HEADER_X_FORWARDED_PROTO => 'proto',
+        self::HEADER_X_FORWARDED_PORT => 'host',
+    ];
+
+    /**
+     * 将标志映射到实际的 HTTP 头名称
+     */
+    public const array TRUSTED_HEADERS = [
+        self::HEADER_FORWARDED => 'forwarded',
+        self::HEADER_X_FORWARDED_FOR => 'x-forwarded-for',
+        self::HEADER_X_FORWARDED_HOST => 'x-forwarded-host',
+        self::HEADER_X_FORWARDED_PROTO => 'x-forwarded-proto',
+        self::HEADER_X_FORWARDED_PORT => 'x-forwarded-port',
+        self::HEADER_X_FORWARDED_PREFIX => 'x-forwarded-prefix',
+    ];
+}