import{_ as a,o as s,c as n,a2 as e}from"./chunks/framework.BbmSSMjL.js";const u=JSON.parse('{"title":"11.2 环境规划","description":"","frontmatter":{},"headers":[],"relativePath":"zh/deploy/env-plan.md","filePath":"zh/deploy/env-plan.md"}'),d={name:"zh/deploy/env-plan.md"};function p(i,t,l,o,r,c){return s(),n("div",null,[...t[0]||(t[0]=[e(`

11.2 环境规划

概述

本节提供不同规模项目的服务器配置建议和环境规划方案。

组件	版本	说明
PHP	8.3+	必需（Laravel 13 要求）
Laravel	13.x	后端框架
MySQL	8.0+	主数据库（也支持 PostgreSQL、SQL Server、Oracle、SQLite）
Redis	6.0+	缓存 / 会话 / 队列 / JWT 会话存储（必需，phpredis 扩展）
Nginx	1.18+	Web 服务器
Node.js	18+（建议 22 LTS）	前端构建（`ui/` 为 Vite 3；根目录资源构建为 Vite 7）
Composer	2.x	PHP 依赖
pnpm	9+	前端依赖（`ui/` 目录，含 pnpm-lock.yaml）

服务器配置建议

规模	CPU	内存	磁盘	说明
小型	2核	4GB	50GB	单机部署，日活 < 1000（数据库初始化导入约 226MB，建议 ≥4GB）
中型	4核	8GB	100GB	单机部署，日活 1000~10000
大型	8核+	16GB+	200GB+	分离部署，日活 > 10000

部署架构

小型项目（单机）

text

┌─────────────────────────────┐
│         单台服务器           │
│                             │
│  Nginx + PHP-FPM + MySQL    │
│  + Redis（必需）             │
│  + 前端静态文件              │
└─────────────────────────────┘

中型项目（单机优化）

text

┌─────────────────────────────┐
│         单台服务器           │
│                             │
│  Nginx（前端 + API 代理）    │
│  PHP-FPM（多进程）           │
│  MySQL（主库）               │
│  Redis（缓存/队列）          │
│  Supervisor（队列/守护进程）  │
└─────────────────────────────┘

大型项目（分离部署）

text

┌──────────┐  ┌──────────┐  ┌──────────┐
│  Nginx   │  │  Nginx   │  │  Nginx   │
│  前端CDN │  │  API-1   │  │  API-2   │
└──────────┘  └──────────┘  └──────────┘
                    │              │
                    └──────┬───────┘
                           │
                    ┌──────┴──────┐
                    ▼             ▼
              ┌──────────┐  ┌──────────┐
              │  MySQL   │  │  Redis   │
              │  主从     │  │  集群    │
              └──────────┘  └──────────┘

环境变量规划

本项目 .env 为扁平键名（无分段式配置），核心项规划如下：

环境	APP_DEBUG	APP_ENV	CACHE_STORE / SESSION_DRIVER	JWT_SECRET	CORS_ALLOW_ORIGIN
开发	true	local	redis	开发密钥	*
测试	true	testing	redis	测试密钥	*
生产	false	production	redis	强随机密钥（≥32 字符）	指定域名

生成强随机 JWT 密钥：

bash

php -r "echo bin2hex(random_bytes(32));"

其它生产必检项

DB_PREFIX=laravel_ 与 SQL 脚本表前缀一致，不要随意修改
FILE_DOMAIN_URL 留空时按当前请求域名补全文件地址；跨域部署时应配置为前端可访问的文件域名
TRUSTED_PROXIES 按反向代理层级配置（默认信任 127.0.0.1 / ::1）
队列常驻进程：php artisan queue:work（生产用 Supervisor 托管）

`,20)])])}const b=a(d,[["render",p]]);export{u as __pageData,b as default};

11.2 环境规划 ​

推荐配置 ​

服务器配置建议 ​

部署架构 ​

小型项目（单机） ​

中型项目（单机优化） ​

大型项目（分离部署） ​

环境变量规划 ​

11.2 环境规划

推荐配置

服务器配置建议

部署架构

小型项目（单机）

中型项目（单机优化）

大型项目（分离部署）

环境变量规划