空白页面 / 错误 500

有时您将 Sitecake 上传到网站文件夹中，访问 domain.com/sitecake.php，然后...出现空白屏幕和错误 500。

这可能有多种原因，因此我们创建了一个检查清单。按照从明显到不明显的故障原因排列。

1. 您有 index.html 页面吗？

Sitecake 需要知道从哪里开始，这意味着您需要有 index.html 或 index.php 页面。

2. 您的 HTML 是否有效？

如果您没有正确关闭 HTML 标签，Sitecake 将无法工作。使用 W3C 验证器或 Validity Chrome 插件验证 HTML。

3. 检查是否已上传 Sitecake zip 中的所有文件

有时 FTP 软件可能无法上传所有文件。上传 zip 文件并在服务器上解压是最好的方法。

4. 您的基本服务器配置是否正常？

这很容易检查。访问

domain.com/sitecake/2.4.10/config/requirements.php

注意：如果您的版本不是 2.4.10，只需替换为其他版本号。

您应该得到 "Basic server configuration needed for Sitecake to run is OK" 的响应。如果出现错误，请尝试修复并反复检查上述 URL 直到一切正常。

对于 2.4.8 之前的 Sitecake 版本，请检查

domain.com/sitecake/2.4.7/config/check.php

5. 太多 PHP 文件、库、不必要的文件夹

Sitecake 是一个用于简单、少页面网站的简单 CMS。如果您想管理复杂的 Web 体验，请使用 .scignore 来排除文件和文件夹。

6. 太多、太大的图片

如果图片太多太大（直接从相机获取），Sitecake 处理可能需要太长时间。这是 PHP 最大执行时间问题，更多详情请参见下面的日志部分。

使用 TinyPNG 等在线服务优化图片。请不要在单个页面上放置数百张图片。

7. 不要混合使用 WordPress 博客和 Sitecake 网站

通常不要同时用两个不同的 CMS 管理一个网站。

如果您用 WordPress 管理网站博客，用 Sitecake 管理其他页面，不要把所有内容放在同一个文件夹中。Sitecake 会尝试处理 WordPress PHP 文件并失败。

只有将 WordPress 博客文件保存在单独的 blog/ 文件夹中才可能工作。另外，您需要通过 .scignore 文件告诉 Sitecake 忽略 blog/ 文件夹。了解更多请点击这里。

8. 不要在 Sitecake 根文件夹中放置多个网站

如果同一根目录中有多个网站，Sitecake 会尝试管理所有网站并可能失败。例如以下情况：

old-website/
my-wifes-website/
blog/
css/
images/
sitecake/
index.html
sitecake.php

删除 old-website/、my-wifes-website/ 和 blog/，在根目录中只保留您想用 Sitecake 管理的网站。

9. 权限问题

Sitecake 是 PHP CMS，需要读取、写入和执行权限。通常文件设置为 644、文件夹设置为 755 即可正常工作。

10. 如果其他方法都失败了，请打开 sitecake.log

Sitecake 将所有错误记录在日志文件中。在这里找到它：

sitecake-temp//logs/sitecake.log

以下是一些最常见的错误：

Maximum execution time of <X> seconds exceeded

这可能有多种原因：

通用（简单）解决方案是增加最大执行时间。有多种方法，搜索 "PHP Maximum execution time exceeded" 即可。

Allowed memory size of <X> bytes exhausted

这可能由上述相同原因引起，请修复问题或增加内存限制。

Open_basedir restriction in effect（无法通过登录时）

尝试使用其他支持的会话处理程序并在 'session.save_handler' 配置中设置它。或者保留 'files' 会话处理程序，将 'session.options' 中的 'save_path' 选项设置为 PHP 用户可读/可写的目录。

更多帮助