配置文件：.ut.config
1.基础配置
| 中文名称 | 配置项 | 示例值 | 说明 |
|---|---|---|---|
| 应用信息 | |||
| 首选语言 | LANG | zh | 后台/前端默认语言包 |
| 语言选项 | LANG_OPTION | zh,en | 可选语言列表，半角逗号分隔 |
| 应用地址 | APPURL | （空） | 站点访问地址，留空自动识别 |
| 应用名称 | APPNAME | UT框架 | 后台标题显示名 |
| 应用商店令牌 | UTCODE | 0 | 官网应用商店授权码，0 表示未绑定 |
| 路由与缓存 | |||
| 伪静态 | REWRITE | 0 | 0 显式路由（?m=&p=）；1 目录式路由（/模块/页面，需伪静态支持） |
| 缓存更新 | TEMPCACHE | 1 | 1 每次请求重新编译模板（开发用）；其他值只读缓存 |
| 模板工程 | |||
| 模板工程前端模板 | TEMPFRONT | 0 | 0 用模块化模板；填模板标志则启用整站模板工程（前端） |
| 模板工程后端模板 | TEMPADMIN | 0 | 同上，作用于后台端 |
| 公共模块 | DEFAULT_MOD | ut-frame | 访问未指定模块时的默认模块 |
| 默认页名 | DEFAULT_PAGE | index | 访问未指定页面时的默认页面 |
| 通讯与升级 API（frame.usualtool.com） | |||
| 通讯API | UTFURL | …/auth.php | 授权/通讯接口地址 |
| 下载API | DOWNURL | …/down | 模块、插件、模板包下载地址 |
| 更新API | UPDATEURL | …/down/update | 框架版本更新检查地址 |
| 调试 | |||
| 是否开启调试模式 | DEBUG | 0 | 开启后错误写入 log/debug.log 并可前台展示 |
| 是否开启调试工具栏 | DEBUG_BAR | 0 | 页面底部输出调试条 |
2.可视化配置
| 中文名称 | 配置项 | 示例值 | 说明 |
|---|---|---|---|
| 开发入口 | |||
| 开发/管理路径 | DEVELOP | /dev | 后台可视化开发入口路径 |
| 开发模式/底层模块是否显示 | DEVELOP_OPEN | 1 | 1 显示底层模块（ut-* 系统模块） |
| 权限验证（格式：模块名/front|admin/页面名，去 .php） | |||
| 前端权限验证路径 | FRONT_POWER_PAGE | （空） | 需登录才能访问的前端页面，多个用逗号分隔 |
| 前端权限验证排除路径 | FRONT_POWER_OUT | （空） | 免登录白名单（优先级高于验证路径） |
| 后端权限验证路径 | ADMIN_POWER_PAGE | （空） | 需鉴权的后台页面 |
| 后端权限验证排除路径 | ADMIN_POWER_OUT | （空） | 后台免登录白名单 |
| 界面 | |||
| 开发端自动锁屏 | LOCKSCREEN | 0 | 1 开启后台空闲自动锁屏 |
| 首选编辑器 | EDITOR | （空） | 在线代码编辑器类型，留空用默认 |
3.数据配置
| 中文名称 | 配置项 | 示例值 | 说明 |
|---|---|---|---|
| 数据库总控 | |||
| 首选数据库类型 | DBTYPE | mysql | 可选 mysql／pdo，选 pdo 时以下 PDO 段生效 |
| 首选缓存数据库类型 | DBCACHE | （空） | 数据缓存后端，留空不缓存 |
| 缓存数据有效期 | DBCACHE_TIME | 3600 | 单位：秒 |
| PDO（DBTYPE=pdo 时生效） | |||
| PDO驱动连接字符串 | PDO_DSN | （空） | 如 mysql:host__localhost;port__3306;dbname__test |
| PDO用户 / PDO密码 | PDO_USER / PDO_PASS | （空） | PDO 连接账号 |
| MySQL（默认主库） | |||
| Mysql服务器 | MYSQL_HOST | localhost | 主机名或 IP |
| Mysql端口 | MYSQL_PORT | 3306 | 服务端口 |
| Mysql用户 / Mysql密码 | MYSQL_USER / MYSQL_PASS | （空） | 数据库账号 |
| Mysql库名 | MYSQL_DB | （空） | 数据库名 |
| Mysql编码 | MYSQL_CHARSET | utf8mb4 | 建议 utf8mb4（完整支持 emoji／四字节字符） |
| SQL Server | |||
| Sqlserver服务器 / 端口 | MSSQL_HOST / MSSQL_PORT | 127.0.0.1 : 1433 | 需 sqlsrv 扩展 |
| Sqlserver库名 | MSSQL_DB | （空） | — |
| Sqlserver用户 / 密码 | MSSQL_USER / MSSQL_PASS | （空） | — |
| PostgreSQL | |||
| Pgsql服务器 / 端口 | PGSQL_HOST / PGSQL_PORT | 127.0.0.1 : 5432 | 需 pgsql 扩展 |
| Pgsql用户 / 密码 | PGSQL_USER / PGSQL_PASS | （空） | — |
| Pgsql库名 | PGSQL_DB | test | — |
| SQLite | |||
| Sqlite数据库 | SQLITE_DB | （空） | 数据库文件路径 |
| Redis 缓存 | |||
| Redis服务器 / 端口 | REDIS_HOST / REDIS_PORT | 127.0.0.1 : 6379 | — |
| Redis密码 | REDIS_PASS | （空） | 无密码留空 |
| MongoDB | |||
| Mongo服务器 / 端口 | MONGO_HOST / MONGO_PORT | 127.0.0.1 : 27017 | 需 mongodb 扩展 |
| Mongo库名 | MONGO_DB | （空） | — |
| Mongo用户 / Mongo密码 | MONGO_USER / MONGO_PASS | （空） | — |
| Memcached | |||
| Memcached服务器 / 端口 | MEMCACHE_HOST / MEMCACHE_PORT | 127.0.0.1 : 11211 | 注意键名是 MEMCACHE_*（无 d） |
| Memcached用户 / 密码 | MEMCACHE_USER / MEMCACHE_PASS | （空） | — |
| WebSocket（Swoole/Workerman 通讯） | |||
| Websocket内网IP | SOCKETS_HOST | 127.0.0.1 | 服务端监听地址 |
| Websocket外网IP | SOCKETS_WSIP | 127.0.0.1 | 对外推送地址（部署时改为公网 IP／域名） |
| Websocket通讯端口 | SOCKETS_PORT | 8080 | 需在防火墙放行 |
通信独立
通信独立就是模块、模板、插件不再经由UT官方下载、安装、更新，而是由开发者自己进行构建。
相当于开发者可以有自己的应用商店来实现通信。
自主应用商店的意义：复用模块、模板和插件，减少迭代的复杂性，有效保障插拔安全。
首先：
通讯（必须改） UTFURL=http://frame.usualtool.com/auth.php
下载（可忽略） DOWNURL=http://frame.usualtool.com/down
更新（可忽略） UPDATEURL=http://frame.usualtool.com/down/update
此三项API地址需要适当进行重新指向。
其中下载和更新两项可以忽略，主要是通讯API，它负责模块、模板、插件的资源输出逻辑。
具体如何开发应用商店请参考：
第一节：模块商店开发 第二节：模板商店开发 第三节：插件商店开发
相当于开发者可以有自己的应用商店来实现通信。
自主应用商店的意义：复用模块、模板和插件，减少迭代的复杂性，有效保障插拔安全。
首先：
通讯（必须改） UTFURL=http://frame.usualtool.com/auth.php
下载（可忽略） DOWNURL=http://frame.usualtool.com/down
更新（可忽略） UPDATEURL=http://frame.usualtool.com/down/update
此三项API地址需要适当进行重新指向。
其中下载和更新两项可以忽略，主要是通讯API，它负责模块、模板、插件的资源输出逻辑。
具体如何开发应用商店请参考：
第一节：模块商店开发 第二节：模板商店开发 第三节：插件商店开发