空白页 / 500 错误

有时你把 Sitecake 上传到网站文件夹后，访问 domain.com/sitecake.php，看到的却是一个 空白页面或 500 错误。这份清单涵盖了从明显到隐蔽的常见 原因。

1. 你有首页文件吗？

Sitecake 需要一个起点 — 同一文件夹中必须存在 index.html 或 index.php。

2. 你的 HTML 是否有效？

Sitecake 要求 HTML 标签正确闭合。可以用 W3C 验证器 或 Validity Chrome 插件 验证你的 HTML。

3. 你上传了所有文件吗？

有时 FTP 无法上传全部文件。最稳妥的做法是上传 ZIP 压 缩包，再用 cPanel 文件管理器在服务器上解压。

4. 服务器配置是否正常？

访问 domain.com/sitecake/<version>/config/requirements.php （把 <version> 替换为你安装的 Sitecake 版本，例如 4.0.19 — 如果不确定，可以查看 sitecake/ 文件夹的名称）。你应该会看到：

“Basic server configuration needed for Sitecake to run is OK”

如果看到的是错误信息，请修复它并重新检查，直到全部显 示为绿色。

5. PHP 文件或库太多？

Sitecake 是为简单网站设计的简单 CMS。如果站点根目录中 有很多 PHP 文件，可以使用 .scignore 文件 来排除不需要处理的文件和文件夹。

6. 大图片太多？

直接来自相机的大图片可能导致 PHP 最长执行时间超限。可 以用 TinyPNG 之类的服务优化图片。避免在单个页面上放数百张图片。

7. 不要同时使用 WordPress 和 Sitecake

不支持用两个 CMS 同时管理一个网站。如果你把 WordPress 放在单独的 blog/ 文件夹中，请 用 .scignore 排除它。更多信息请见 这里。

8. 每个根目录只能有一个网站

如果同一个根目录下有多个网站，Sitecake 会尝试全部管理 它们，很可能因此失败。请移除不属于你想管理的那个站点 的所有内容。

9. 权限问题

Sitecake 需要读、写和执行权限。通常 文件 644、文件夹 755 就能开箱即用。

10. 检查日志文件

Sitecake 会把错误记录在 cms-temp/logs/sitecake.log 中。常见的错 误有：

Maximum execution time exceeded — 可能是文件太多、图片太大、页面上的 sc-content 区域太多，或服务器较慢导致。 请增加最长执行时间，或减少负载。

Allowed memory size exhausted — 原因与上面相同。请增加内存限制或减少负载。

Open_basedir restriction in effect — 尝试更换会话处理器。在 config.php 中设置 session.save_handler，保持为 files，然后将 save_path 设为一个可写目录。