first commit

2026-04-07 16:54:24 +08:00
commit 2c6a38c80d
399 changed files with 42205 additions and 0 deletions
--- a/Xboard/app/Helpers/Functions.php
+++ b/Xboard/app/Helpers/Functions.php
@@ -0,0 +1,82 @@
+<?php
+use App\Support\Setting;
+
+if (!function_exists('admin_setting')) {
+    /**
+     * 获取或保存配置参数.
+     *
+     * @param  string|array  $key
+     * @param  mixed  $default
+     * @return App\Support\Setting|mixed
+     */
+    function admin_setting($key = null, $default = null)
+    {
+        $setting = app(Setting::class);
+
+        if ($key === null) {
+            return $setting->toArray();
+        }
+
+        if (is_array($key)) {
+            $setting->save($key);
+            return '';
+        }
+
+        $default = config('v2board.' . $key) ?? $default;
+        return $setting->get($key) ?? $default;
+    }
+}
+
+if (!function_exists('subscribe_template')) {
+    /**
+     * Get subscribe template content by protocol name.
+     */
+    function subscribe_template(string $name): ?string
+    {
+        return \App\Models\SubscribeTemplate::getContent($name);
+    }
+}
+
+if (!function_exists('admin_settings_batch')) {
+    /**
+     * 批量获取配置参数，性能优化版本
+     *
+     * @param array $keys 配置键名数组
+     * @return array 返回键值对数组
+     */
+    function admin_settings_batch(array $keys): array
+    {
+        return app(Setting::class)->getBatch($keys);
+    }
+}
+
+if (!function_exists('source_base_url')) {
+    /**
+     * 获取来源基础URL，优先Referer，其次Host
+     * @param string $path
+     * @return string
+     */
+    function source_base_url(string $path = ''): string
+    {
+        $baseUrl = '';
+        $referer = request()->header('Referer');
+
+        if ($referer) {
+            $parsedUrl = parse_url($referer);
+            if (isset($parsedUrl['scheme']) && isset($parsedUrl['host'])) {
+                $baseUrl = $parsedUrl['scheme'] . '://' . $parsedUrl['host'];
+                if (isset($parsedUrl['port'])) {
+                    $baseUrl .= ':' . $parsedUrl['port'];
+                }
+            }
+        }
+
+        if (!$baseUrl) {
+            $baseUrl = request()->getSchemeAndHttpHost();
+        }
+
+        $baseUrl = rtrim($baseUrl, '/');
+        $path = ltrim($path, '/');
+        return $baseUrl . '/' . $path;
+    }
+}