C. 配置项速查
后端 .env 配置
:::tip 格式说明
本项目 .env 为扁平键名（无分组段），遵循 Laravel 约定；键名与 config/*.php 中的 env() 读取一一对应。
:::
应用配置
| 变量 |
默认值 |
说明 |
APP_ENV |
local（示例） |
运行环境（生产设为 production） |
APP_DEBUG |
true |
调试模式（生产环境设为 false） |
APP_KEY |
- |
应用密钥（php artisan key:generate 生成） |
APP_URL |
http://localhost |
应用地址 |
DEMO_MODE |
false |
演示模式开关 |
TRUSTED_PROXIES |
（空） |
受信代理 IP（逗号分隔，支持 CIDR），未配置时默认信任 127.0.0.1 和 ::1 |
DEFAULT_TENANT_ID |
1 |
默认租户ID，超管操作租户隔离表时自动代入（config/tenant.php） |
数据库配置
| 变量 |
默认值 |
说明 |
DB_CONNECTION |
sqlite |
数据库类型：mysql / pgsql / sqlsrv / oracle / sqlite |
DB_HOST |
127.0.0.1 |
数据库主机 |
DB_DATABASE |
- |
数据库名（SQLite 为文件路径） |
DB_USERNAME |
- |
数据库用户 |
DB_PASSWORD |
- |
数据库密码 |
DB_PORT |
3306 |
数据库端口 |
DB_CHARSET |
utf8mb4 |
字符集 |
DB_PREFIX |
laravel_ |
表前缀（与 SQL 脚本一致，勿改） |
各数据库默认端口：
| 数据库 |
默认端口 |
默认用户 |
| MySQL |
3306 |
root |
| PostgreSQL |
5432 |
postgres |
| SQL Server |
1433 |
sa |
| Oracle |
1521 |
- |
| SQLite |
- |
- |
JWT 配置（config/jwt.php）
| 变量 |
默认值 |
说明 |
JWT_SECRET |
（空） |
签名密钥（≥32 字符，缺失/过短 fail-close，生产环境务必修改） |
JWT_ACCESS_TTL |
7200 |
access_token 有效期（秒） |
JWT_REFRESH_TTL |
604800 |
refresh_token 有效期（秒） |
JWT_PERMS_TTL |
7200 |
权限缓存有效期（秒） |
JWT_ISSUER |
rxthinkcmf |
签发者标识 |
文件上传配置（config/file.php）
| 变量 |
默认值 |
说明 |
FILE_UPLOAD_DIR |
uploads |
上传根目录（相对 public/） |
FILE_DOMAIN_URL |
（空） |
文件访问域名（留空按当前请求域名补全） |
FILE_IMAGE_EXT |
gif,jpg,jpeg,png,bmp,webp |
图片允许后缀 |
FILE_EXT |
多种后缀 |
文件允许后缀 |
FILE_MAX_SIZE |
10 |
最大文件大小（MB） |
会话 / 缓存 / 队列（Redis 必需）
| 变量 |
默认值 |
说明 |
SESSION_DRIVER |
redis |
会话驱动 |
SESSION_LIFETIME |
120 |
会话过期（分钟） |
CACHE_STORE |
redis |
缓存驱动 |
QUEUE_CONNECTION |
redis |
队列驱动 |
REDIS_CLIENT |
phpredis |
Redis PHP 扩展 |
REDIS_HOST |
127.0.0.1 |
Redis 主机 |
REDIS_PORT |
6379 |
Redis 端口 |
REDIS_PASSWORD |
null |
Redis 密码 |
CORS 配置（config/cors.php）
| 变量 |
默认值 |
说明 |
CORS_ALLOW_ORIGIN |
* |
允许的跨域来源（生产环境限制为实际域名） |
API 配置（config/api.php）
| 变量 |
默认值 |
说明 |
API_CAMEL_SNAKE_CONVERT |
true |
驼峰/下划线自动转换 |
验证码配置（config/captcha.php）
| 变量 |
默认值 |
说明 |
CAPTCHA_BYPASS_CODE |
（空） |
万能验证码，仅开发调试用，生产环境务必留空 |
CAPTCHA_LENGTH |
6 |
验证码字符长度（4-6位） |
CAPTCHA_EXPIRE |
300 |
过期时间（秒） |
CAPTCHA_RATE_WINDOW |
60 |
防刷窗口期（秒） |
CAPTCHA_RATE_LIMIT |
10 |
窗口期内最大获取次数 |
CAPTCHA_CHARS |
ABCDEFGHJKLMNPQRSTUVWXYZ2346789 |
字符集 |
CAPTCHA_FONT_PATH |
static/fonts/Vera.ttf |
字体路径 |
CAPTCHA_IMAGE_WIDTH / HEIGHT |
160 / 50 |
图片尺寸（像素） |
CAPTCHA_FONT_SIZE |
28 |
字体大小 |
CAPTCHA_NOISE_LINES |
6 |
干扰线数量 |
CAPTCHA_NOISE_DOTS |
300 |
噪点数量 |
代码生成器配置（config/generator.php）
| 变量 |
默认值 |
说明 |
GENERATOR_PARENT_MENU_ID |
189 |
生成模块的父菜单ID |
GENERATOR_APP_NAME |
tool |
模块应用名（路由前缀、前端目录） |
前端环境变量（ui/.env*）
| 变量 |
说明 |
VITE_GLOB_API_URL |
API 基础路径（留空表示同源） |
VITE_GLOB_API_URL_PREFIX |
API 前缀（默认 /api） |
VITE_GLOB_UPLOAD_URL |
图片上传地址（跨域部署时配置） |
VITE_GLOB_IMG_URL |
图片前缀地址 |
VITE_PORT |
开发端口（默认 8001） |
VITE_DROP_CONSOLE |
构建时删除 console |
配置文件对照
| .env 变量前缀 |
配置文件 |
主要配置键 |
DB_* |
config/database.php |
default / connections.* |
JWT_* |
config/jwt.php |
secret / access_ttl / refresh_ttl / perms_ttl / issuer |
FILE_* |
config/file.php |
upload_dir / domain_url / temp_dir / image_ext / file_ext / max_size |
CACHE_STORE / REDIS_* |
config/cache.php、config/database.php |
default / stores.redis |
CORS_ALLOW_ORIGIN |
config/cors.php |
allow_origin |
API_CAMEL_SNAKE_CONVERT |
config/api.php |
camel_snake_convert / convert_except_params |
CAPTCHA_* |
config/captcha.php |
全部验证码参数 |
GENERATOR_* |
config/generator.php |
parent_menu_id / app_name / template_dir / backend_outputs |
DEFAULT_TENANT_ID |
config/tenant.php |
default_tenant_id |
TRUSTED_PROXIES |
config/app.php |
trusted_proxies |
APP_TIMEZONE |
config/app.php |
timezone |
租户配置
| 配置文件 |
配置键 |
默认值 |
说明 |
config/tenant.php |
default_tenant_id |
1 |
默认租户ID，超管操作租户隔离表时自动代入 |
