97 lines
55 KiB
JavaScript
97 lines
55 KiB
JavaScript
import{_ as t,o as i,c as a,a2 as e}from"./chunks/framework.BbmSSMjL.js";const c=JSON.parse('{"title":"4.9 数据库设计","description":"","frontmatter":{},"headers":[],"relativePath":"zh/architecture/database-design.md","filePath":"zh/architecture/database-design.md"}'),d={name:"zh/architecture/database-design.md"};function n(l,s,h,p,r,k){return i(),a("div",null,[...s[0]||(s[0]=[e(`<h1 id="_4-9-数据库设计" tabindex="-1">4.9 数据库设计 <a class="header-anchor" href="#_4-9-数据库设计" aria-label="Permalink to "4.9 数据库设计""></a></h1><div class="tip custom-block"><p class="custom-block-title">概述</p><p>项目支持 MySQL、PostgreSQL、SQL Server、Oracle、SQLite 五种数据库，通过 <code>.env</code> 的 <code>DB_CONNECTION</code> 一键切换，<code>document/</code> 下提供五套初始化脚本。所有数据库共用同一套代码，无需修改业务逻辑。本章涵盖命名规范、表结构设计、字段说明、索引策略和多数据库适配。</p></div><h2 id="命名规范" tabindex="-1">命名规范 <a class="header-anchor" href="#命名规范" aria-label="Permalink to "命名规范""></a></h2><table tabindex="0"><thead><tr><th>对象</th><th>规范</th><th>示例</th></tr></thead><tbody><tr><td>表名</td><td>不含前缀的业务名 + <code>DB_PREFIX</code>（默认 <code>laravel_</code>）</td><td><code>laravel_user</code>、<code>laravel_article</code></td></tr><tr><td>模型 <code>$table</code></td><td><strong>不含前缀</strong></td><td><code>protected $table = 'user'</code></td></tr><tr><td>字段名</td><td>小写下划线</td><td><code>create_time</code>、<code>user_name</code></td></tr><tr><td>主键</td><td>统一 <code>id</code>，INT 自增</td><td><code>id INT PRIMARY KEY</code></td></tr><tr><td>外键</td><td><code>表名_id</code></td><td><code>user_id</code>、<code>role_id</code></td></tr><tr><td>索引</td><td><code>idx_字段名</code></td><td><code>idx_status</code>、<code>idx_tenant_id</code></td></tr><tr><td>唯一索引</td><td><code>uk_含义</code>（常含 <code>is_delete</code> 协同）</td><td><code>uk_tenant_username</code></td></tr></tbody></table><h2 id="公共字段" tabindex="-1">公共字段 <a class="header-anchor" href="#公共字段" aria-label="Permalink to "公共字段""></a></h2><p>所有业务表<strong>必须</strong>包含以下公共字段，由模型 Trait 自动维护：</p><div class="language-sql vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sql</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">-- MySQL 格式</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">id </span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;">INT</span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;"> PRIMARY KEY</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> AUTO_INCREMENT COMMENT </span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">主键</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">,</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">is_delete </span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;">TINYINT</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">(</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#2F798A;">1</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">) </span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;">DEFAULT</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#2F798A;"> 0</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> COMMENT </span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">软删除 0=正常 1=已删除</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">,</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">create_user </span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;">VARCHAR</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">(</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#2F798A;">50</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">) </span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;">DEFAULT</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> ''</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> COMMENT </span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">创建人</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">,</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">create_time </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DATETIME</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> COMMENT </span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">创建时间</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">,</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">update_user </span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;">VARCHAR</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">(</span><span style="--shiki-dark:#BF9EEE;--shiki-light:#2F798A;">50</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">) </span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;">DEFAULT</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> ''</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> COMMENT </span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">更新人</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">,</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">update_time </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DATETIME</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> COMMENT </span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">更新时间</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span></span></code></pre></div><table tabindex="0"><thead><tr><th>字段</th><th>自动维护方</th><th>说明</th></tr></thead><tbody><tr><td><code>is_delete</code></td><td><code>SoftDeletesByFlag</code></td><td><code>softDelete()</code> 设置为 1，<code>SoftDeleteFlagScope</code> 全局过滤</td></tr><tr><td><code>create_user</code></td><td><code>HasAuditColumns</code> creating 事件</td><td>取 <code>Auth::username()</code>，已传入则不覆盖</td></tr><tr><td><code>create_time</code></td><td><code>HasAuditColumns</code> creating 事件</td><td>取 <code>now()</code>，已传入则不覆盖</td></tr><tr><td><code>update_user</code></td><td><code>HasAuditColumns</code> updating 事件</td><td>取 <code>Auth::username()</code></td></tr><tr><td><code>update_time</code></td><td><code>HasAuditColumns</code> updating 事件</td><td>始终覆盖为当前时间</td></tr></tbody></table><h2 id="核心表清单-25-张-" tabindex="-1">核心表清单（25 张） <a class="header-anchor" href="#核心表清单-25-张-" aria-label="Permalink to "核心表清单（25 张）""></a></h2><h3 id="用户与权限-5-张-" tabindex="-1">用户与权限（5 张） <a class="header-anchor" href="#用户与权限-5-张-" aria-label="Permalink to "用户与权限（5 张）""></a></h3><table tabindex="0"><thead><tr><th>表名</th><th>说明</th><th>Service 基类</th></tr></thead><tbody><tr><td><code>laravel_user</code></td><td>用户表</td><td><code>BaseTenantService</code></td></tr><tr><td><code>laravel_user_role</code></td><td>用户角色关联表（N:N 中间表）</td><td>—</td></tr><tr><td><code>laravel_role</code></td><td>角色表</td><td><code>BaseTenantService</code></td></tr><tr><td><code>laravel_role_menu</code></td><td>角色菜单关联表（N:N 中间表）</td><td>—</td></tr><tr><td><code>laravel_menu</code></td><td>菜单/权限表（菜单即权限）</td><td><code>BaseService</code></td></tr></tbody></table><p><strong>关联关系：</strong></p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span>laravel_user ──┐</span></span>
|
||
<span class="line"><span> │ N:N (laravel_user_role)</span></span>
|
||
<span class="line"><span>laravel_role ──┤</span></span>
|
||
<span class="line"><span> │ N:N (laravel_role_menu)</span></span>
|
||
<span class="line"><span>laravel_menu ──┘</span></span>
|
||
<span class="line"><span></span></span>
|
||
<span class="line"><span>laravel_dept ←── laravel_user.dept_id</span></span>
|
||
<span class="line"><span>laravel_tenant ←── laravel_user.tenant_id</span></span></code></pre></div><h3 id="组织架构-3-张-" tabindex="-1">组织架构（3 张） <a class="header-anchor" href="#组织架构-3-张-" aria-label="Permalink to "组织架构（3 张）""></a></h3><table tabindex="0"><thead><tr><th>表名</th><th>说明</th><th>Service 基类</th></tr></thead><tbody><tr><td><code>laravel_dept</code></td><td>部门表（树形，parent_id）</td><td><code>BaseTenantService</code></td></tr><tr><td><code>laravel_position</code></td><td>岗位表</td><td><code>BaseTenantService</code></td></tr><tr><td><code>laravel_level</code></td><td>职级表</td><td><code>BaseTenantService</code></td></tr></tbody></table><h3 id="租户-1-张-" tabindex="-1">租户（1 张） <a class="header-anchor" href="#租户-1-张-" aria-label="Permalink to "租户（1 张）""></a></h3><table tabindex="0"><thead><tr><th>表名</th><th>说明</th><th>Service 基类</th></tr></thead><tbody><tr><td><code>laravel_tenant</code></td><td>租户表（状态、过期时间、用户数限制）</td><td><code>BaseService</code></td></tr></tbody></table><h3 id="系统配置-5-张-" tabindex="-1">系统配置（5 张） <a class="header-anchor" href="#系统配置-5-张-" aria-label="Permalink to "系统配置（5 张）""></a></h3><table tabindex="0"><thead><tr><th>表名</th><th>说明</th><th>Service 基类</th></tr></thead><tbody><tr><td><code>laravel_dict</code></td><td>字典表</td><td><code>BaseService</code></td></tr><tr><td><code>laravel_dict_item</code></td><td>字典项表</td><td><code>BaseService</code></td></tr><tr><td><code>laravel_config</code></td><td>配置组表</td><td><code>BaseService</code></td></tr><tr><td><code>laravel_config_item</code></td><td>配置项表</td><td><code>BaseService</code></td></tr><tr><td><code>laravel_param</code></td><td>系统参数表</td><td><code>BaseService</code></td></tr></tbody></table><p><strong>关联关系：</strong></p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span>laravel_dict ←── laravel_dict_item.dict_id</span></span>
|
||
<span class="line"><span>laravel_config ←── laravel_config_item.config_id</span></span></code></pre></div><h3 id="内容管理-4-张-" tabindex="-1">内容管理（4 张） <a class="header-anchor" href="#内容管理-4-张-" aria-label="Permalink to "内容管理（4 张）""></a></h3><table tabindex="0"><thead><tr><th>表名</th><th>说明</th><th>Service 基类</th></tr></thead><tbody><tr><td><code>laravel_article</code></td><td>文章表</td><td><code>BaseTenantService</code></td></tr><tr><td><code>laravel_category</code></td><td>文章分类表（树形）</td><td><code>BaseTenantService</code></td></tr><tr><td><code>laravel_link</code></td><td>友情链接表</td><td><code>BaseTenantService</code></td></tr><tr><td><code>laravel_notice</code></td><td>通知公告表</td><td><code>BaseTenantService</code></td></tr></tbody></table><h3 id="日志审计-2-张-" tabindex="-1">日志审计（2 张） <a class="header-anchor" href="#日志审计-2-张-" aria-label="Permalink to "日志审计（2 张）""></a></h3><table tabindex="0"><thead><tr><th>表名</th><th>说明</th><th>Service 基类</th></tr></thead><tbody><tr><td><code>laravel_login_log</code></td><td>登录日志表</td><td><code>BaseService</code></td></tr><tr><td><code>laravel_operation_log</code></td><td>操作日志表</td><td><code>BaseService</code></td></tr></tbody></table><h3 id="定时任务-2-张-" tabindex="-1">定时任务（2 张） <a class="header-anchor" href="#定时任务-2-张-" aria-label="Permalink to "定时任务（2 张）""></a></h3><table tabindex="0"><thead><tr><th>表名</th><th>说明</th><th>Service 基类</th></tr></thead><tbody><tr><td><code>laravel_job</code></td><td>定时任务表</td><td><code>BaseService</code></td></tr><tr><td><code>laravel_job_log</code></td><td>定时任务执行日志表</td><td><code>BaseService</code></td></tr></tbody></table><p><strong>关联关系：</strong></p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span>laravel_job ←── laravel_job_log.job_id</span></span></code></pre></div><h3 id="基础数据-3-张-" tabindex="-1">基础数据（3 张） <a class="header-anchor" href="#基础数据-3-张-" aria-label="Permalink to "基础数据（3 张）""></a></h3><table tabindex="0"><thead><tr><th>表名</th><th>说明</th><th>Service 基类</th></tr></thead><tbody><tr><td><code>laravel_city</code></td><td>城市行政区划表（树形）</td><td><code>BaseService</code></td></tr><tr><td><code>laravel_file_template</code></td><td>文件模板表</td><td><code>BaseService</code></td></tr><tr><td><code>laravel_example</code></td><td>案例演示表（生成器参考模板）</td><td><code>BaseService</code></td></tr></tbody></table><div class="tip custom-block"><p class="custom-block-title">租户隔离范围</p><p>继承 <code>BaseTenantService</code> 的 9 个服务：User / Role / Dept / Position / Level / Article / Category / Notice / Link——业务数据按租户隔离；系统共享数据（字典、配置、菜单、日志等）继承 <code>BaseService</code> 不隔离。</p></div><h2 id="关键表字段说明" tabindex="-1">关键表字段说明 <a class="header-anchor" href="#关键表字段说明" aria-label="Permalink to "关键表字段说明""></a></h2><h3 id="laravel-user-用户表-" tabindex="-1">laravel_user（用户表） <a class="header-anchor" href="#laravel-user-用户表-" aria-label="Permalink to "laravel_user（用户表）""></a></h3><table tabindex="0"><thead><tr><th>字段</th><th>类型</th><th>说明</th></tr></thead><tbody><tr><td><code>id</code></td><td>INT</td><td>主键</td></tr><tr><td><code>tenant_id</code></td><td>INT</td><td>租户 ID（0=平台用户）</td></tr><tr><td><code>code</code></td><td>VARCHAR(100)</td><td>用户编码</td></tr><tr><td><code>username</code></td><td>VARCHAR(30)</td><td>用户名（登录账号）</td></tr><tr><td><code>password</code></td><td>VARCHAR(255)</td><td>密码（bcrypt 加密）</td></tr><tr><td><code>salt</code></td><td>VARCHAR(30)</td><td>加密盐（外部盐，与 password 分离存储）</td></tr><tr><td><code>realname</code></td><td>VARCHAR(150)</td><td>用户姓名</td></tr><tr><td><code>gender</code></td><td>INT</td><td>性别：1-男 2-女 3-保密</td></tr><tr><td><code>mobile</code> / <code>email</code></td><td>VARCHAR(30)</td><td>手机号 / 邮箱</td></tr><tr><td><code>avatar</code></td><td>VARCHAR(255)</td><td>用户头像</td></tr><tr><td><code>status</code></td><td>INT</td><td>状态：1-正常 2-禁用</td></tr><tr><td><code>dept_id</code> / <code>level_id</code> / <code>position_id</code></td><td>INT</td><td>部门 / 职级 / 岗位 ID</td></tr><tr><td><code>province_code</code> / <code>city_code</code> / <code>district_code</code> / <code>street_code</code></td><td>VARCHAR(30)</td><td>省市县街道编码</td></tr><tr><td><code>city_info</code></td><td>VARCHAR(255)</td><td>省市区信息拼接</td></tr><tr><td><code>address</code></td><td>VARCHAR(255)</td><td>详细地址</td></tr><tr><td><code>intro</code> / <code>note</code></td><td>VARCHAR(255)</td><td>个人简介 / 备注</td></tr><tr><td><code>sort</code></td><td>INT</td><td>排序</td></tr><tr><td><code>is_delete</code> + 四个审计字段</td><td></td><td>公共字段</td></tr></tbody></table><p><strong>唯一索引（与软删除协同）：</strong></p><div class="language-sql vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sql</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">UNIQUE</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> uk_tenant_username (tenant_id, username, is_delete)</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">UNIQUE</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> uk_tenant_mobile (tenant_id, mobile, is_delete)</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">UNIQUE</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> uk_tenant_code (tenant_id, code, is_delete)</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">为什么唯一索引含 is_delete？</p><p>软删除的用户 <code>is_delete=1</code> 仍占唯一索引——把 <code>is_delete</code> 纳入联合唯一后，同名账号删除后可重新注册（新记录 <code>is_delete=0</code> 不与已删记录冲突），同时保证<strong>同租户内未删数据</strong>用户名唯一。业务层的 <code>uniqueFields</code> 校验与数据库索引双保险。</p></div><h3 id="laravel-role-角色表-" tabindex="-1">laravel_role（角色表） <a class="header-anchor" href="#laravel-role-角色表-" aria-label="Permalink to "laravel_role（角色表）""></a></h3><table tabindex="0"><thead><tr><th>字段</th><th>类型</th><th>说明</th></tr></thead><tbody><tr><td><code>id</code></td><td>INT</td><td>主键</td></tr><tr><td><code>name</code></td><td>VARCHAR(50)</td><td>角色名称</td></tr><tr><td><code>code</code></td><td>VARCHAR(50)</td><td>角色编码</td></tr><tr><td><code>tenant_id</code></td><td>INT</td><td>租户 ID（角色按租户隔离）</td></tr><tr><td><code>status</code></td><td>TINYINT</td><td>状态</td></tr><tr><td><code>remark</code> / <code>sort</code></td><td></td><td>备注 / 排序</td></tr></tbody></table><h3 id="laravel-menu-菜单-权限表-" tabindex="-1">laravel_menu（菜单/权限表） <a class="header-anchor" href="#laravel-menu-菜单-权限表-" aria-label="Permalink to "laravel_menu（菜单/权限表）""></a></h3><table tabindex="0"><thead><tr><th>字段</th><th>类型</th><th>说明</th></tr></thead><tbody><tr><td><code>id</code></td><td>INT</td><td>主键</td></tr><tr><td><code>parent_id</code></td><td>INT</td><td>父级 ID（0=顶级）</td></tr><tr><td><code>name</code></td><td>VARCHAR(50)</td><td>菜单名称</td></tr><tr><td><code>permission</code></td><td>VARCHAR(100)</td><td>权限标识（如 <code>sys:user:add</code>，<strong>菜单即权限</strong>）</td></tr><tr><td><code>type</code></td><td>TINYINT</td><td>类型：0=菜单/目录（可导航） 1=权限节点</td></tr><tr><td><code>path</code></td><td>VARCHAR(200)</td><td>路由路径</td></tr><tr><td><code>icon</code></td><td>VARCHAR(100)</td><td>图标</td></tr><tr><td><code>sort</code> / <code>status</code> / <code>remark</code></td><td></td><td>排序 / 状态 / 备注</td></tr></tbody></table><h3 id="laravel-tenant-租户表-" tabindex="-1">laravel_tenant（租户表） <a class="header-anchor" href="#laravel-tenant-租户表-" aria-label="Permalink to "laravel_tenant（租户表）""></a></h3><table tabindex="0"><thead><tr><th>字段</th><th>类型</th><th>说明</th></tr></thead><tbody><tr><td><code>id</code></td><td>INT</td><td>主键</td></tr><tr><td><code>name</code></td><td>VARCHAR(100)</td><td>租户名称</td></tr><tr><td><code>code</code></td><td>VARCHAR(50)</td><td>租户编码（系统自动生成）</td></tr><tr><td><code>status</code></td><td>TINYINT</td><td>状态（字典 tenant_status）：0=禁用 1=启用</td></tr><tr><td><code>expire_time</code></td><td>DATETIME</td><td>过期时间（ResolveTenant 中间件校验）</td></tr><tr><td><code>max_user_num</code></td><td>INT</td><td>最大用户数限制</td></tr><tr><td><code>contact_name</code> / <code>contact_phone</code></td><td></td><td>联系人 / 联系电话</td></tr></tbody></table><h3 id="laravel-article-文章表-" tabindex="-1">laravel_article（文章表） <a class="header-anchor" href="#laravel-article-文章表-" aria-label="Permalink to "laravel_article（文章表）""></a></h3><table tabindex="0"><thead><tr><th>字段</th><th>类型</th><th>说明</th></tr></thead><tbody><tr><td><code>id</code></td><td>INT</td><td>主键</td></tr><tr><td><code>title</code></td><td>VARCHAR(200)</td><td>标题</td></tr><tr><td><code>category_id</code></td><td>INT</td><td>分类 ID</td></tr><tr><td><code>cover</code></td><td>VARCHAR(500)</td><td>封面图路径</td></tr><tr><td><code>content</code></td><td>TEXT</td><td>内容（富文本，含 <code>[IMG_URL]</code> 占位符）</td></tr><tr><td><code>author</code></td><td>VARCHAR(50)</td><td>作者</td></tr><tr><td><code>status</code></td><td>TINYINT</td><td>状态（字典 article_status）</td></tr><tr><td><code>sort</code></td><td>INT</td><td>排序</td></tr><tr><td><code>tenant_id</code></td><td>INT</td><td>租户 ID</td></tr></tbody></table><h2 id="索引策略" tabindex="-1">索引策略 <a class="header-anchor" href="#索引策略" aria-label="Permalink to "索引策略""></a></h2><h3 id="推荐索引" tabindex="-1">推荐索引 <a class="header-anchor" href="#推荐索引" aria-label="Permalink to "推荐索引""></a></h3><div class="language-sql vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sql</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">-- 用户表：高频查询字段（联合唯一索引见上文）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_user </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_tenant_id (tenant_id);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_user </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_dept_id (dept_id);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_user </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_status (</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">status</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">);</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">-- 角色关联表：外键索引</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_user_role </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_user_id (user_id);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_user_role </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_role_id (role_id);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_role_menu </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_role_id (role_id);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_role_menu </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_menu_id (menu_id);</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">-- 文章表：常用过滤字段</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_article </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_category_id (category_id);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_article </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_status (</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">status</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_article </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_tenant_id (tenant_id);</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">-- 日志表：按时间查询</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_login_log </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_create_time (create_time);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_operation_log </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_create_time (create_time);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_job_log </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_job_id (job_id);</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">-- 菜单表：树形查询</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_menu </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_parent_id (parent_id);</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">-- 字典项表：按字典 ID 查询</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_dict_item </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_dict_id (dict_id);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_config_item </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_config_id (config_id);</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">-- 城市表：按编码查询</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_city </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_area_code (area_code);</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ALTER</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> TABLE</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> laravel_city </span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">ADD</span><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;"> INDEX</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> idx_parent_code (parent_code);</span></span></code></pre></div><h3 id="索引设计原则" tabindex="-1">索引设计原则 <a class="header-anchor" href="#索引设计原则" aria-label="Permalink to "索引设计原则""></a></h3><table tabindex="0"><thead><tr><th>原则</th><th>说明</th></tr></thead><tbody><tr><td>外键必加</td><td>所有 <code>_id</code> 外键字段都应加索引</td></tr><tr><td>过滤字段</td><td><code>pageEqFields</code> 中配置的精确匹配字段应加索引</td></tr><tr><td>模糊搜索</td><td><code>pageLikeFields</code> 中的字段可考虑全文索引，但 <code>LIKE '%xx%'</code> 无法用普通索引</td></tr><tr><td>排序字段</td><td><code>pageOrderBy</code> 中的默认排序字段可加索引</td></tr><tr><td>时间字段</td><td>日志表的 <code>create_time</code> 必加索引（按时间范围查询）</td></tr><tr><td>联合唯一</td><td>软删除表的唯一约束必须含 <code>is_delete</code>（见上文）</td></tr></tbody></table><h2 id="多数据库支持" tabindex="-1">多数据库支持 <a class="header-anchor" href="#多数据库支持" aria-label="Permalink to "多数据库支持""></a></h2><h3 id="支持的数据库" tabindex="-1">支持的数据库 <a class="header-anchor" href="#支持的数据库" aria-label="Permalink to "支持的数据库""></a></h3><table tabindex="0"><thead><tr><th>数据库</th><th><code>DB_CONNECTION</code> 值</th><th>默认端口</th><th>PHP 扩展</th></tr></thead><tbody><tr><td>MySQL</td><td><code>mysql</code></td><td>3306</td><td><code>pdo_mysql</code></td></tr><tr><td>PostgreSQL</td><td><code>pgsql</code></td><td>5432</td><td><code>pdo_pgsql</code></td></tr><tr><td>SQL Server</td><td><code>sqlsrv</code></td><td>1433</td><td><code>pdo_sqlsrv</code></td></tr><tr><td>Oracle</td><td><code>oracle</code></td><td>1521</td><td><code>pdo_oci</code>（自定义 oci 驱动接入）</td></tr><tr><td>SQLite</td><td><code>sqlite</code></td><td>-</td><td><code>pdo_sqlite</code></td></tr></tbody></table><h3 id="切换数据库" tabindex="-1">切换数据库 <a class="header-anchor" href="#切换数据库" aria-label="Permalink to "切换数据库""></a></h3><p>只需修改 <code>.env</code> 文件，无需改动任何代码：</p><div class="vp-code-group vp-adaptive-theme"><div class="tabs"><input type="radio" name="group-EieVJ" id="tab-Gr8PYo7" checked><label for="tab-Gr8PYo7">MySQL（默认）</label><input type="radio" name="group-EieVJ" id="tab-6z5fdNt"><label for="tab-6z5fdNt">PostgreSQL</label><input type="radio" name="group-EieVJ" id="tab-8Me-kq9"><label for="tab-8Me-kq9">SQL Server</label><input type="radio" name="group-EieVJ" id="tab-CGyr6kp"><label for="tab-CGyr6kp">Oracle</label><input type="radio" name="group-EieVJ" id="tab-HPsyAGF"><label for="tab-HPsyAGF">SQLite</label></div><div class="blocks"><div class="language-ini vp-adaptive-theme active"><button title="Copy Code" class="copy"></button><span class="lang">ini</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_CONNECTION</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">mysql</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_HOST</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">127.0.0.1</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PORT</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">3306</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_DATABASE</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">rxthinkcmf.laravel13.naivevue</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_USERNAME</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">root</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PASSWORD</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">root</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PREFIX</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">laravel_</span></span></code></pre></div><div class="language-ini vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ini</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_CONNECTION</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">pgsql</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_HOST</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">127.0.0.1</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PORT</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">5432</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_DATABASE</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">rxthinkcmf.laravel13.naivevue</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_USERNAME</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">postgres</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PASSWORD</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">root</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PREFIX</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">laravel_</span></span></code></pre></div><div class="language-ini vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ini</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_CONNECTION</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">sqlsrv</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_HOST</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">127.0.0.1</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PORT</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">1433</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_DATABASE</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">rxthinkcmf.laravel13.naivevue</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_USERNAME</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">sa</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PASSWORD</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">root</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PREFIX</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">laravel_</span></span></code></pre></div><div class="language-ini vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ini</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_CONNECTION</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">oracle</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_HOST</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">127.0.0.1</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PORT</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">1521</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_DATABASE</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">rxthinkcmf.laravel13.naivevue</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_USERNAME</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">root</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PASSWORD</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">root</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PREFIX</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">laravel_</span></span></code></pre></div><div class="language-ini vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ini</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_CONNECTION</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">sqlite</span></span>
|
||
<span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># DB_DATABASE 指向 database/database.sqlite（默认值）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">DB_PREFIX</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">=</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;">laravel_</span></span></code></pre></div></div></div><h3 id="配置文件结构" tabindex="-1">配置文件结构 <a class="header-anchor" href="#配置文件结构" aria-label="Permalink to "配置文件结构""></a></h3><div class="language-php vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">php</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;">// config/database.php</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">return</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"> [</span></span>
|
||
<span class="line"><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> '</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">default</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;"> =></span><span style="--shiki-dark:#62E884;--shiki-light:#59873A;"> env</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">(</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">DB_CONNECTION</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">,</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> '</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">mysql</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">),</span></span>
|
||
<span class="line"><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> '</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">connections</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;"> =></span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"> [</span></span>
|
||
<span class="line"><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> '</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">sqlite</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;"> =></span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"> [</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">...</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">],</span></span>
|
||
<span class="line"><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> '</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">mysql</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;"> =></span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"> [</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">...</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">],</span></span>
|
||
<span class="line"><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> '</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">pgsql</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;"> =></span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"> [</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">...</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">],</span></span>
|
||
<span class="line"><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> '</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">sqlsrv</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;"> =></span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"> [</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">...</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">],</span></span>
|
||
<span class="line"><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;"> '</span><span style="--shiki-dark:#E7EE98;--shiki-light:#B56959;">oracle</span><span style="--shiki-dark:#DEE492;--shiki-light:#B5695977;">'</span><span style="--shiki-dark:#F286C4;--shiki-light:#AB5959;"> =></span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"> [</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;">...</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">],</span><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"> // 自定义 oci 驱动（AppServiceProvider 注册 DB::extend）</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;"> ],</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F6F6F4;--shiki-light:#999999;">];</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">Oracle 接入说明</p><p>Laravel 核心不内置 Oracle 连接器，项目通过 <code>AppServiceProvider</code> 中 <code>DB::extend('oci', ...)</code> 注册自定义驱动，配套 <code>App\\Support\\Database\\{OracleConnection, OracleGrammar, OracleProcessor}</code> 完成分页语法与自增主键回填适配。切换前需安装 <code>pdo_oci</code> 扩展（见 <a href="/zh/quickstart/environment.html">2.1 开发环境准备</a>）。</p></div><h3 id="字段类型映射" tabindex="-1">字段类型映射 <a class="header-anchor" href="#字段类型映射" aria-label="Permalink to "字段类型映射""></a></h3><table tabindex="0"><thead><tr><th>通用类型</th><th>MySQL</th><th>PostgreSQL</th><th>SQL Server</th><th>Oracle</th><th>SQLite</th></tr></thead><tbody><tr><td>自增主键</td><td><code>INT AUTO_INCREMENT</code></td><td><code>SERIAL</code></td><td><code>INT IDENTITY</code></td><td><code>NUMBER</code> + 序列/触发器</td><td><code>INTEGER PRIMARY KEY</code></td></tr><tr><td>字符串</td><td><code>VARCHAR(n)</code></td><td><code>VARCHAR(n)</code></td><td><code>NVARCHAR(n)</code></td><td><code>VARCHAR2(n)</code></td><td><code>TEXT</code></td></tr><tr><td>文本</td><td><code>TEXT</code></td><td><code>TEXT</code></td><td><code>NVARCHAR(MAX)</code></td><td><code>CLOB</code></td><td><code>TEXT</code></td></tr><tr><td>布尔</td><td><code>TINYINT(1)</code></td><td><code>BOOLEAN</code></td><td><code>BIT</code></td><td><code>NUMBER(1)</code></td><td><code>INTEGER</code></td></tr><tr><td>日期时间</td><td><code>DATETIME</code></td><td><code>TIMESTAMP</code></td><td><code>DATETIME2</code></td><td><code>TIMESTAMP</code></td><td><code>TEXT</code></td></tr><tr><td>小数</td><td><code>DECIMAL(m,n)</code></td><td><code>NUMERIC(m,n)</code></td><td><code>DECIMAL(m,n)</code></td><td><code>NUMBER(m,n)</code></td><td><code>REAL</code></td></tr></tbody></table><div class="tip custom-block"><p class="custom-block-title">业务代码零修改</p><p>Eloquent 的方言层自动处理大部分 SQL 差异，切换数据库只需修改 <code>.env</code> 中的 <code>DB_CONNECTION</code>，业务代码无需任何修改。跨库 DDL 由 <code>DbSchemaBuilder</code> 按驱动生成（Oracle 自增序列与触发器自动创建）。</p></div><h3 id="各数据库安装" tabindex="-1">各数据库安装 <a class="header-anchor" href="#各数据库安装" aria-label="Permalink to "各数据库安装""></a></h3><p>数据库的安装与初始化步骤已在 <a href="/zh/quickstart/environment.html">2.1 开发环境准备</a>（含四平台安装命令、扩展启用、Oracle Instant Client）与 <a href="/zh/quickstart/database-init.html">2.5 数据库初始化</a>（建库、脚本导入、<code>.env</code> 配置）中完整说明，此处不再重复。</p><h2 id="SQL-脚本" tabindex="-1">SQL 脚本 <a class="header-anchor" href="#SQL-脚本" aria-label="Permalink to "SQL 脚本""></a></h2><p>项目为每种数据库提供了独立的 SQL 脚本，存放在 <code>document/</code> 目录下按数据库类型分组：</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span>document/</span></span>
|
||
<span class="line"><span>├── mysql/</span></span>
|
||
<span class="line"><span>│ └── rxthinkcmf.laravel13.naivevue.sql # MySQL 版本</span></span>
|
||
<span class="line"><span>├── postgresql/</span></span>
|
||
<span class="line"><span>│ └── rxthinkcmf.laravel13.naivevue.sql # PostgreSQL 版本</span></span>
|
||
<span class="line"><span>├── sqlserver/</span></span>
|
||
<span class="line"><span>│ └── rxthinkcmf.laravel13.naivevue.sql # SQL Server 版本</span></span>
|
||
<span class="line"><span>├── oracle/</span></span>
|
||
<span class="line"><span>│ └── rxthinkcmf.laravel13.naivevue.sql # Oracle 版本</span></span>
|
||
<span class="line"><span>└── sqlite/</span></span>
|
||
<span class="line"><span> └── rxthinkcmf.laravel13.naivevue.sql # SQLite 版本</span></span></code></pre></div><p>各数据库脚本包含完整的表结构定义和初始数据（用户、角色、菜单、字典、城市行政区划等），已针对各数据库的 SQL 语法做了适配，可直接导入使用。</p><div class="warning custom-block"><p class="custom-block-title">WARNING</p><p>本项目 <code>database/migrations/</code> 为空，<strong>建表以 SQL 脚本为准</strong>，<code>php artisan migrate</code> 不会创建业务表。导入方法详见 <a href="/zh/quickstart/database-init.html">2.5 数据库初始化</a>。</p></div><h2 id="慢查询排查" tabindex="-1">慢查询排查 <a class="header-anchor" href="#慢查询排查" aria-label="Permalink to "慢查询排查""></a></h2><div class="language-ini vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ini</span><pre class="shiki shiki-themes dracula-soft vitesse-light vp-code" tabindex="0"><code><span class="line"><span style="--shiki-dark:#7B7F8B;--shiki-light:#A0ADA0;"># MySQL my.cnf / my.ini</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">slow_query_log</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;"> =</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> 1</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">slow_query_log_file</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;"> =</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> /var/log/mysql/slow.log</span></span>
|
||
<span class="line"><span style="--shiki-dark:#F286C4;--shiki-light:#1E754F;">long_query_time</span><span style="--shiki-dark:#F286C4;--shiki-light:#999999;"> =</span><span style="--shiki-dark:#F6F6F4;--shiki-light:#393A34;"> 2</span></span></code></pre></div><div class="warning custom-block"><p class="custom-block-title">注意</p><p>项目所有查询都通过 Eloquent 查询构建器构建（参数绑定），不会出现原生 SQL 注入。如需排查慢查询，建议开启数据库慢查询日志，而非在代码层面埋点；同时核对 <a href="#索引策略">索引策略</a> 中的推荐索引是否缺失。</p></div>`,73)])])}const F=t(d,[["render",n]]);export{c as __pageData,F as default};
|