discuz! q 不支持 phpenv 默认模板，必须手动配置 config/app.php、config/database.php 和 .env 文件，并修改 nginx 的 try_files 规则、runtime 路径及 redis database 编号，同时禁用 opcache.enable_cli 并调高 max_execution_time。
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，观察是否还卡在“正在初始化…”
runtime 权限、Redis DB 编号冲突或 opcache.enable_cli 没关——这些点 phpEnv 界面里完全不体现，得靠日志逐项排除。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
