下载解压某个论坛程序后，双击 forum.php 只弹出一个空白页或一堆源码；用浏览器打开却提示 404。这不是文件坏了，而是它压根不是一个能“打开”的文档——它是论坛程序里负责渲染帖子列表的入口脚本，必须由 PHP 解释器执行、还要有数据库支持。

一、先判断你手上是什么

forum.php 是 PHP 项目里的常见文件名，出现在这些地方：

• Discuz! X 系列：/forum.php 是论坛主入口，URL 形如 forum.php?mod=viewthread&tid=123；同一目录往往还有 home.php、group.php、space.php；
• phpBB / PhpWind / UBB 等其它论坛：也有同名或类似的入口；
• 某些采集/整站的“forum.php”：本质是打包好的成品站。

用文本编辑器打开文件看头部就能确认：Discuz 的 forum.php 里会有类似 require './include/common.inc.php';、$modspace、$_G['forum']['tid'] 的字样。

判断依据：只有当文件被 Web 服务器解析执行后，浏览器才会看到论坛页面。直接双击或走 file:// 协议，PHP 代码块会被当作未知 HTML 标签忽略，看起来就是空白。

二、本地跑起来：最小可行路径

1. 准备环境：PHP（版本要和程序匹配，Discuz X3.4 兼容 PHP 5.5~7.x，X3.5 推荐 PHP 7.4+；老版本论坛千万别上 PHP 8，会满屏 fatal error）+ MySQL 5.7/8.0（或 MariaDB）。

2. 启动服务器（调试用）：解压到某个目录，在该目录执行：

php -S 127.0.0.1:8080
# 浏览器访问 http://127.0.0.1:8080/forum.php

首次访问如果没有安装过，程序通常会自动跳到 /install/ 向导；若没跳，手动访问 http://127.0.0.1:8080/install/。

3. 建库与配 DB：登录 phpMyAdmin（或命令行）建库：

CREATE DATABASE bbs DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

Discuz 的数据库配置在 config/config_global.php 与 config/config_ucenter.php，安装向导会自动写入。老版论坛（如 PhpWind）则改 data/config.global.php 一类文件，键名形如 dbhost / dbuser / dbpw / dbname / tablepre。

4. 权限：Linux 下 config/、data/、uc_server/data/ 必须可写；chown -R www-data:www-data 站点目录，目录 755、文件 644，别用 777。

三、正式部署该用 Nginx 还是 Apache

伪静态（把 forum.php?mod=viewthread&tid=1 变成 thread-1-1-1.html）是 Discuz 的核心需求：

• Apache：官方提供 .htaccess 规则，放站点根目录即可，需要 AllowOverride All；
• Nginx：官方给的 rewrite 片段形如
  rewrite ^/thread-([0-9]+)-([0-9]+)-([0-9]+)\.html$ /forum.php?mod=viewthread&tid=$1&extra=page%3D$3&page=$2 last;
  写在 server 块里，同时必须加 try_files $uri $uri/ /index.php?$query_string; 一类的兜底。

URL 重写只对入口文件生效，如果 index.php 缺失（有些整包只有 forum.php），需要在 Nginx 里显式 location / { index forum.php; }。

四、报错排查

• 404 Not Found：站点根目录没指对（指到了上层目录），或者用了 Apache 但虚拟主机 DocumentRoot 配错。
• 500 白屏：临时在文件顶部加
  error_reporting(E_ALL); ini_set('display_errors','1');
  看具体错误。高频原因是 PHP 版本过高（老程序用了已移除的 mysql_* 函数）、short_open_tag=Off（老代码里用 <?= 与 <%）、或 php.ini 缺 mbstring/json 扩展。
• Database access denied / Can not connect to MySQL：库名、账号、tablepre 前缀不匹配，或 dbhost 写成 localhost 时 Unix socket 路径不对（改成 127.0.0.1 走 TCP 通常更快恢复）。
• “请检查 config_global.php 文件是否正确”：install 已经跑过但配置写坏了，删掉 install/ 目录前先备份配置。
• 页面显示源码而不是执行：PHP 处理器没关联（Nginx 缺 fastcgi_pass 段）。

五、安全提醒

论坛程序是攻击重灾区，上线前必做：删除 /install/ 目录；后台地址改名（Discuz 支持在 config_global.php 里改 adminid 入口路径 / 用 LC_HOME 类变量改后台目录）；把 config 权限收紧到 640；开启后台登录二次验证与 IP 限制；data/ 目录用 Nginx 禁止 PHP 执行（location ~ ^/data/.*\.php$ { deny all; }）——因为攻击者常把 webshell 传进缓存目录。

六、常见问题 FAQ

问：我只想看看这套论坛长什么样，不想装数据库？
答：用 SQLite 方案（部分程序支持）或装 phpSqliteAdmin；也可以找带演示数据的整合包。但 Discuz 强依赖 MySQL，最省事还是用集成环境。

问：forum.php 和 index.php 有什么区别？
答：index.php 是站点首页/门户（Space 或 Portal），forum.php 是论坛模块入口，两者共用 include/common.inc.php 的初始化逻辑。

问：能直接把 forum.php 单独拿出来运行吗？
答：不能。它依赖整个程序的 source/module/forum/ 目录与数据库结构，孤立文件毫无意义。

一句话：forum.php 是“需要被执行的入口”，不是“需要被打开的文件”。先把 PHP+MySQL 跑起来，剩下的都是配置问题。

• PHP
• 建站教程
• 论坛程序