Discuz!Q多版本部署配置方法

Discuz! Q 对运行环境高度敏感，无法直接兼容 phpEnv 默认配置，必须手动精细调整多项核心设置：包括重写 config/app.php 和 config/database.php、修正 .env 文件内容、修改 Nginx 的 try_files 规则以支持前端路由、隔离各版本的 runtime 目录与 Redis database 编号，并调高 PHP 超时限制、禁用 CLI 模式下的 opcache——任一环节疏漏都可能导致数据库连接失败、页面白屏、404 刷新错误或后台任务卡死；本文直击部署痛点，提供可立即落地的多版本共存实操方案，帮你绕过那些隐藏极深、日志不报却让调试陷入僵局的关键陷阱。

Discuz! Q 的 config.php 必须手动覆盖，不能依赖 phpEnv 自带模板

phpEnv 默认不识别 Discuz! Q 的配置结构，它生成的 config.php 是为传统 PHP 应用（如 WordPress）设计的，直接套用会导致数据库连接失败或路由 404。Discuz! Q 的配置入口在 config/app.php 和 config/database.php，且必须启用 APP_DEBUG=true 才能暴露真实错误——否则你只看到空白页或“Service Unavailable”。

实操建议：

• 先用 phpEnv 启动一个干净的 PHP 7.4 + Nginx 环境（Discuz! Q 不支持 PHP 8.0+）
• 解压 Discuz! Q 源码后，立刻删除 config/app.php 并复制 config/app.example.php 重命名为 app.php
• 修改 config/database.php 中的 'host' 不填 localhost，而填 127.0.0.1（Windows 下 MySQL 服务默认绑定 IPv4，localhost 会走命名管道导致超时）
• 确保 .env 文件存在且权限为 644，内容至少包含：

  APP_ENV=production
  APP_DEBUG=false
  DB_HOST=127.0.0.1
  DB_PORT=3306
  DB_DATABASE=discuzq
  DB_USERNAME=root
  DB_PASSWORD=

Nginx 配置必须显式声明 try_files，否则静态资源 404

Discuz! Q 使用前端路由（Vue Router history 模式），所有非 API/静态文件请求都应 fallback 到 index.php。phpEnv 的默认 Nginx 配置只适配了 .php 后缀，没处理无后缀 URL，结果就是点击菜单后页面白屏、F5 刷新 404。

实操建议：

• 在 phpEnv 的站点配置中（路径类似 D:\phpEnv\nginx\vhosts\discuzq.conf），找到 location / { } 块
• 替换其内容为：

  location / {
      try_files $uri $uri/ /index.php?$query_string;
  }

• 删掉任何形如 location ~ \.php$ { ... } 的重复块——Discuz! Q 的入口统一由 index.php 处理，不需要额外匹配 .php
• 重启 Nginx：在 phpEnv 控制台点「重启 Nginx」，不要只刷新页面

多版本共存的关键是隔离 runtime 目录和 Redis 实例

同一台机器跑多个 Discuz! Q 站点（比如 v1.0 和 v1.1 测试版），若共用 runtime 目录或 Redis 数据库编号，会出现缓存污染、队列错乱、登录态互相踢出等问题。phpEnv 不自动隔离这些资源。

实操建议：

• 每个站点的 runtime 必须指向独立路径，例如：runtime_v1、runtime_v2，并在 config/app.php 中修改：

  'runtime_path' => __DIR__ . '/../runtime_v1/',

• Redis 连接配置里明确指定 database，不要用默认 0：

  'redis' => [
      'default' => [
          'host' => '127.0.0.1',
          'port' => 6379,
          'database' => 1, // v1.0 用 1，v1.1 用 2
      ],
  ],

• 清空旧 runtime 再部署新版本，避免旧缓存干扰：执行 del /s /q runtime_v1\*（Windows）或 rm -rf runtime_v1/*（Linux 子系统）

php.ini 必须调高 max_execution_time 和禁用 opcache.enable_cli

Discuz! Q 安装器和后台任务（如附件迁移、搜索重建）容易触发 PHP 超时；同时，opcache 在 CLI 模式下开启会导致 Artisan 命令反复报 Class not found 错误——这在 phpEnv 的命令行工具里极常见，但错误日志里不提示 opcache 问题。

实操建议：

• 编辑 phpEnv 当前使用的 PHP 版本的 php.ini（路径如 D:\phpEnv\php\php-7.4.33\php.ini）
• 调整以下三项：

  max_execution_time = 300
  memory_limit = 512M
  opcache.enable_cli = 0

• 改完后必须重启 phpEnv 的 PHP-FPM 服务（不只是 Nginx），否则配置不生效
• 验证是否生效：访问 /install.php 或运行 php artisan queue:work --once，观察是否还卡在“正在初始化…”

Discuz! Q 对环境敏感度远高于常规 Laravel 应用，很多问题表面是 500 错误，实际根因是 runtime 权限、Redis DB 编号冲突或 opcache.enable_cli 没关——这些点 phpEnv 界面里完全不体现，得靠日志逐项排除。

文中关于phpenv的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Discuz!Q多版本部署配置方法》文章吧，也可关注golang学习网公众号了解相关技术文章。