rxthinkcmf-wiki/RXThinkCMF_Laravel13_NaiveVue/zh/deploy/performance.md

11.7 性能调优

:::tip 概述 本节从 PHP、缓存、数据库、前端四个维度提供性能调优建议。 :::

PHP 层

OPcache（生产环境必须）

; =============================================================================
; php.ini — OPcache 字节码缓存配置
; =============================================================================
; OPcache 将 PHP 脚本编译为字节码并缓存在内存中，避免每次请求重复编译
; 启用后可提升 50%-80% 的 PHP 性能
; =============================================================================

opcache.enable = 1                      ; 启用 OPcache（0=关闭，1=启用）
opcache.memory_consumption = 256        ; OPcache 共享内存大小（MB），按项目规模调整
opcache.interned_strings_buffer = 16    ; 驻留字符串内存（MB），减少重复字符串存储
opcache.max_accelerated_files = 10000   ; 最大缓存文件数（需大于项目 PHP 文件总数）
opcache.validate_timestamps = 0         ; 不检查文件修改时间（性能最优，更新代码后需重启 PHP-FPM）
opcache.save_comments = 1               ; 保留注释（反射文档注释、调试栈追踪依赖此配置）

:::warning OPcache 注意事项 validate_timestamps = 0 时，更新代码后必须重启 PHP-FPM 或手动清除 OPcache，否则不会生效。 :::

PHP-FPM 进程池

; =============================================================================
; PHP-FPM 进程池配置
; 配置路径：/etc/php/8.3/fpm/pool.d/www.conf
; 根据服务器内存和并发量调整参数
; =============================================================================

pm = dynamic                    ; 动态进程管理（推荐）
pm.max_children = 50            ; 最大子进程数（每个约 30-50MB，根据内存调整）
pm.start_servers = 5            ; 启动时的进程数
pm.min_spare_servers = 5        ; 最小空闲进程（低于此值自动创建）
pm.max_spare_servers = 35       ; 最大空闲进程（高于此值自动销毁）
pm.max_requests = 500           ; 单进程最大请求数（达到后重启，防内存泄漏）

Composer 优化

# 生产环境安装依赖
# --no-dev              → 排除开发依赖（phpunit/phpunit、laravel/pint 等）
# --optimize-autoloader → 优化自动加载器（生成 classmap，减少文件查找）
composer install --no-dev --optimize-autoloader

Laravel 缓存命令

# 生产环境把配置、路由、视图编译进缓存，避免每次请求重新解析
php artisan config:cache
php artisan route:cache
php artisan view:cache

缓存层

使用 Redis

; .env — Redis 缓存配置（本项目默认即为 redis 驱动）
CACHE_STORE=redis                 ; 缓存驱动
SESSION_DRIVER=redis              ; 会话驱动
QUEUE_CONNECTION=redis            ; 队列驱动
REDIS_CLIENT=phpredis             ; Redis PHP 扩展
REDIS_HOST=127.0.0.1              ; Redis 服务器地址
REDIS_PORT=6379                   ; Redis 端口
REDIS_PASSWORD=your_redis_password ; Redis 密码

:::tip 缓存效果

• DictCacheService（字典）：两级缓存（请求级 + Laravel Cache），使用 Redis 后首次查库并写入 Redis，后续直接读缓存（TTL 3600 秒 / 1 小时），可减少 80%+ 的字典查询
• ParamService（参数）：仅请求级缓存（数据量小、变更即时生效，不落持久缓存） :::

数据库层

索引优化

项目 SQL 脚本已内置大量索引（uk_tenant_* 唯一索引、idx_* 普通索引，覆盖租户隔离、用户名、手机号、状态、分类等高频查询）。新增业务表或新增查询字段时，再按需补充索引：

-- =============================================================================
-- 为常用查询字段添加索引（提升查询速度）
-- =============================================================================
-- 索引原理：类似书的目录，数据库通过索引快速定位数据行，避免全表扫描
-- 注意：索引会占用额外存储空间，且降低写入速度，只在高频查询字段上创建
-- =============================================================================

-- 新增业务表：租户隔离 + 状态筛选（本项目标准索引命名习惯）
ALTER TABLE laravel_example ADD INDEX idx_tenant_status (tenant_id, status);

-- 操作日志表：按时间范围查询（当前 SQL 脚本未建此索引，日志量大时建议补充）
ALTER TABLE laravel_operation_log ADD INDEX idx_create_time (create_time);

-- 用户表：平台侧按用户名直查（租户内查询已有 uk_tenant_username 覆盖）
ALTER TABLE laravel_user ADD INDEX idx_username (username);

慢查询日志

; MySQL my.cnf — 慢查询日志配置
; 配置路径：/etc/mysql/my.cnf 或 /etc/my.cnf
; 生效命令：sudo systemctl restart mysql

slow_query_log = 1                          ; 启用慢查询日志
slow_query_log_file = /var/log/mysql/slow.log   ; 日志文件路径
long_query_time = 2                         ; 超过 2 秒的查询记录为慢查询

连接池

高并发场景建议配置持久连接：

; php.ini — 使用 Unix Socket 连接 MySQL（比 TCP 更快）
; 前提：PHP-FPM 和 MySQL 在同一台服务器上
pdo_mysql.default_socket = /var/run/mysqld/mysqld.sock

前端层

Gzip 压缩

# Nginx Gzip 压缩配置（添加到 http 或 server 块）
gzip            on;                                         ; 启用 Gzip 压缩
gzip_types      text/plain text/css application/json application/javascript text/xml;  ; 需要压缩的 MIME 类型
gzip_min_length 1024;                                       ; 小于 1KB 的响应不压缩（压缩收益低）

静态资源缓存

# 静态资源浏览器缓存配置（添加到 server 块）
# Vite 构建的文件名包含 content hash，可放心设置长期缓存
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
    expires 30d;                            ; 缓存 30 天
    add_header Cache-Control "public, immutable";   ; 公共缓存，内容不变
}

CDN 加速

将静态资源（JS/CSS/图片）部署到 CDN，减轻服务器压力。CDN 场景下注意配置 .env 的 TRUSTED_PROXIES 以获取真实客户端 IP（见 11.4 后端部署）。

性能检查清单

检查项	生产环境	开发环境
OPcache	启用	可选
Redis 缓存	必需（缓存/会话/队列）	必需
Laravel 缓存（config/route/view）	缓存（php artisan *:cache）	清除状态（*:clear）
Gzip 压缩	启用	可选
慢查询日志	启用	启用
Composer 优化	--no-dev --optimize-autoloader	默认
静态资源缓存	30天	不缓存