控制台演示（中英文 + 主题）

PHP 示例：基础 Dashboard 布局，支持在页面内无刷新切换中英文语言包与主题色；偏好保存在服务端 Session，刷新后保持。

应用场景

• 管理后台、运营控制台、SaaS 产品内嵌页需要 多语言 与 多套主题色（品牌/深色浅色）切换。
• 希望用户偏好 跨刷新保持，且不依赖浏览器本地存储作为唯一来源。

用户痛点

• 前端硬编码文案导致改版成本高；主题散落各处难以统一变量。
• 仅前端 i18n 时 SEO 与首屏一致性差；仅后端渲染又难做到无刷新切换。

本项目解决的问题

• 语言包以 PHP 文件维护，通过 api/prefs.php 读写 Session，前端按 [data-i18n] 批量替换文案与 data-theme 切换 CSS 变量主题。
• 对外 JSON 带 version 字段，便于与部署版本对齐。

项目价值说明

• 提供可复制的 「服务端偏好 + 轻量前端」 模式，便于扩展到更多语言与主题 token。

运行方式

将 dashboard-i18n-theme-php-cn-sample 置于已配置 PHP 的 Web 目录，浏览器访问 index.php 即可。可选：复制 config.example.php 为 config.php，在其中 define('DBDASH_APP_VERSION', '…') 覆盖版本号（须在 require inc/dbd_version.php 之前定义，见 index.php 加载顺序）。

版本号

默认版本由常量 DBDASH_APP_VERSION 定义，默认值为 inc/dbd_version.php 中的 1.1.0。对外 JSON 见 api/prefs.php 响应字段 version。

接口说明

• GET api/prefs.php：返回当前 lang、theme、完整 strings 及允许值列表。
• POST api/prefs.php：JSON 体如 { "lang": "en" }、{ "theme": "ocean" } 或两者同时提交；响应含更新后的 strings 供前端替换 [data-i18n] 文案。

扩展语言 / 主题

• 语言：在 lang/ 下增加 PHP 文件并在 inc/dbd_common.php 的 dbd_allowed_langs() 中注册键名；键集合需与现有语言包一致。
• 主题：在 assets/theme.css 增加 html[data-theme="…"] 变量块，并在 dbd_allowed_themes() 与首页下拉里同步选项。

Project: PHPDisk - 私有云存储解决方案
This is NOT a freeware, use is subject to license terms.
Website: https://www.phpdisk.com
Author: PHPDisk Team ( admin@phpdisk.com )
Copyright (C) 2008-2026 PHPDisk Team. All Rights Reserved.

如需定制功能，或查看更多示例与源码索引，请访问：https://code.phpdisk.com/?utm_source=dashboard-i18n-theme-php-cn-sample