dede安装后空白页面，问题出在哪？

核心排查思路：从简到繁，从服务器到程序

安装空白页的原因,99%是PHP执行出错，但服务器为了安全，默认不显示具体的错误信息，所以你就看到了一个空白的页面，我们的目标就是让服务器把错误信息显示出来，然后根据错误信息解决问题。

第一步：开启PHP错误显示（最关键的一步）

这是解决所有PHP页面空白的“万能钥匙”，请修改 php.ini 文件。

1. 找到 php.ini 文件：

   • 如果你使用的是虚拟主机,通常在主机控制面板的“PHP版本设置”或“文件管理”里可以找到和编辑它。
   • 如果你使用的是本地环境（如XAMPP, WAMP, phpStudy），这个文件通常在你的PHP安装目录下，C:\xampp\php\php.ini。

2. 修改以下配置项：

   • 找到 display_errors = Off，将其修改为 display_errors = On。
   • 找到 error_reporting = E_ALL & ~E_NOTICE，确保它是这个值或者 E_ALL。
   • 找到 log_errors = On，可以开启错误日志记录，方便查看。

   ; 将 Off 改为 On
   display_errors = On
   ; 确保是开启所有级别错误（除了Notice，但开启也无妨）
   error_reporting = E_ALL & ~E_NOTICE
   ; 建议开启日志，即使屏幕上显示了错误，日志也会记录下来
   log_errors = On

3. 保存文件并重启你的Web服务器：

   
   （图片来源网络，侵删）
   • 虚拟主机：保存后，控制面板通常会提示你重启PHP服务或整个Web服务。
   • 本地环境：重启Apache或Nginx。

4. 重新访问安装页面： 现在刷新你的DedeCMS安装页面（通常是 http://你的域名/install/），如果问题出在PHP执行层面，你应该能看到具体的错误提示信息了，根据错误提示，我们进行下一步。

第二步：常见错误及解决方案（基于第一步显示的错误信息）

如果第一步后你看到了错误信息,请对号入座：

错误类型1：PHP版本过低

• 错误提示：Fatal error: Uncaught Error: Call to undefined function session_start() 或类似关于 session、hash 等函数不存在的错误。
• 原因：DedeCMS 5.7版本及以下对PHP 7.0+的支持并不完美，很多函数在更高版本中被移除或改名。
• 解决方案：
  1. 最佳方案：将你的PHP版本降级到 PHP 5.6，这是与老版本DedeCMS最兼容的版本，联系你的虚拟主机服务商，或者在本地环境中切换PHP版本。
  2. 次选方案：如果你必须使用高版本PHP（如PHP 7.2+），你需要修改DedeCMS的源码文件，但这非常麻烦且不推荐，容易引发新的问题。

错误类型2：目录或文件权限不足

• 错误提示：Warning: is_dir(): open_basedir restriction in effect... 或 Permission denied。
• 原因：Web服务器（如Apache运行的用户 www-data 或 apache）没有权限读写DedeCMS的某些关键目录。
• 解决方案：
  1. 设置正确的目录权限：你需要确保以下目录及其子目录具有可写权限。
     • /data/ (存放缓存和配置文件)
     • /uploads/ (附件上传目录)
     • /templets/ (模板缓存目录)
     • /include/ (部分缓存文件)
     • /install/ (安装目录，安装完成后可以删除或设为只读)
     • /plus/ (部分功能需要写入权限)
  2. 如何设置权限：
     • Linux服务器：通过SSH连接，执行以下命令（假设Web用户是 www-data）：

       # 将这些目录的所有者改为Web用户
       chown -R www-data:www-data /path/to/your/dedecms
       # 设置目录权限为755，文件权限为644
       find /path/to/your/dedecms -type d -exec chmod 755 {} \;
       find /path/to/your/dedecms -type f -exec chmod 644 {} \;
       # 给关键目录添加可写权限
       chmod -R 777 /path/to/your/dedecms/data
       chmod -R 777 /path/to/your/dedecms/uploads

     • 虚拟主机/Windows：通常在文件管理器里右键点击文件夹，选择“权限”或“安全”，确保用户有“读取和写入”权限。

错误类型3：safe_mode 被启用

• 错误提示：Warning: safe_mode restriction in effect...
• 原因：这是一个过时的PHP安全模式，会限制很多函数的执行。
• 解决方案：
  • 联系你的虚拟主机服务商,要求他们关闭 safe_mode，在 php.ini 中找到 safe_mode = On，将其改为 safe_mode = Off。

错误类型4：open_basedir 路径限制

• 错误提示：Warning: open_basedir restriction in effect...
• 原因：服务器限制了PHP脚本只能访问指定的目录，DedeCMS试图访问被限制的目录（如 /tmp 用于缓存）。
• 解决方案：
  • 联系虚拟主机服务商,调整 open_basedir 的配置，将DedeCMS的网站根目录和必要的临时目录（如 /tmp/:/var/tmp/）添加进去。

错误类型5：缺少必要的PHP扩展

• 错误提示：Fatal error: Class 'mysqli' not found 或 Call to undefined function gd_info()
• 原因：你的PHP环境没有安装或启用必要的扩展库，如 mysqli (数据库连接) 或 gd (图片处理)。
• 解决方案：
  • 联系虚拟主机服务商,确保开启了 mysqli 和 gd 扩展。
  • 本地环境请检查你的 php.ini 文件，确保 extension=mysqli 和 extension=gd 前面的分号 被去掉了。

第三步：检查DedeCMS安装文件本身

如果以上步骤都无效,可能是安装包本身的问题。

1. 重新下载安装包：
   • 请务必从 DedeCMS官方网站 下载最新或你需要的版本。
   • 检查下载的安装包是否完整,有时候下载过程会损坏文件，可以重新解压，对比一下文件数量是否和官方一致。
2. 检查 install/index.php 文件：
   • 用代码编辑器（如VS Code, Sublime Text）打开 /install/index.php 文件。
   • 查看文件开头是否有意外字符、空行或BOM标记，BOM标记是导致PHP页面空白的常见元凶。
   • 如何去除BOM标记：大多数代码编辑器都有“另存为”并选择“UTF-8 无BOM”格式的选项，将所有相关文件都保存为此格式。
3. 检查 install/install_step1.php 文件：

   这个文件是安装的第一步,负责检测环境，如果它出错了，就会直接显示空白，用编辑器打开它，看是否有明显的语法错误或缺少代码块。

   
   （图片来源网络，侵删）

第四步：服务器配置问题

1. .htaccess 文件冲突：

   • 检查网站根目录下是否有 .htaccess 文件，这个文件是Apache服务器的配置文件，错误的规则可能导致页面无法执行。
   • 临时解决方案：将 .htaccess 文件重命名（例如改为 .htaccess.bak），然后刷新安装页面，看是否恢复正常，如果恢复了，说明就是这个文件的问题，你需要修改其中的规则。

2. URL重写（伪静态）问题：

   • 如果你开启了URL重写功能（如 rewrite），可能会干扰安装程序的正常流程，在安装前，请先在后台关闭URL重写功能。

总结与最终建议

1. 首选方案：开启PHP错误显示，这是解决问题的最快途径。
2. 最常见原因：PHP版本不兼容（建议用PHP 5.6）和目录权限不足。
3. 检查文件：确保安装包完整，没有BOM标记。
4. 联系服务商：如果涉及 safe_mode, open_basedir 等服务器级配置，自己无法修改时，联系虚拟主机客服是最高效的方式。

如果所有方法都试过了还是不行,可以尝试在DedeCMS官方论坛或相关技术社区搜索你的具体错误提示，那里有大量前人踩过的坑和解决方案。