配置

Sitecake 的配置文件位于 sitecake/ 文件夹 中。有三个主要的配置文件你可能需要编辑。

文件夹结构如下：

sitecake/
  <version>/
    client/
    config/
      ...
      config.php
  credentials.php.default
  credentials.php
  editor.cnf

三个配置文件分别是：

• sitecake/credentials.php — 包含 CMS 管理员密码
• sitecake/editor.cnf — 编辑器和 工具栏配置
• sitecake/<version>/config/config.php — 通用 CMS 配置

管理员密码

credentials.php 文件以 bcrypt 哈希形式保 存管理员密码：

<?php $credentials = "$2y$12$XXXXXXXXXXXXXXXXXXXXXXeXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; ?>

默认密码是 admin。请通过登录对话框 中的修改密码选项来修改它 — 不要手动编辑哈希值。

如果忘记了密码，把 credentials.php 替换为 credentials.php.default 即可将其重置为 admin。 查看重置密码指南。

编辑器配置

editor.cnf 文件控制工具栏和编辑器行为：

# Toolbar.components - 工具栏上的内容类型列表
# 可选值：HEADING1..6, TEXT, TEXTLIST, IMAGE, FLASH, VIDEO, MAP, HTML, FILE, SEP
Toolbar.components = HEADING1,HEADING2,HEADING3,TEXTLIST,TEXT,SEP,IMAGE,VIDEO,SEP,FLASH,MAP,HTML,FILE

# 上传大小限制（KB）
FileUploaderItem.uploadSizeLimit = 20000

# 界面语言 (en, sl, sr, es, de, fr, dk, it, jp, ru, cs, sk, pt, pt-br, nl, auto)
Locale.code = auto

Toolbar.components 列出了可供编辑的 项目。默认只显示 H1–H3 标题。这个列表可以重新排 序，并用 SEP（分隔符）分隔。

FileUploaderItem.uploadSizeLimit 设置图片/文件上传的最大大小（KB）。默认值为 20000 KB （约 19.5 MB），如有需要可以调大。

Locale.code 设置界面语言。默认值 auto 会根据编辑器所在的 IP 检测语言。更多 细节参见多语言支持。

通用配置

config.php 文件（位于 sitecake/<version>/config/）设置通 用 CMS 选项：

• debug — Sitecake 是否处于 调试模式，影响错误显示和日志记录。
• entry_point_file_name — 入口文件（sitecake.php）。出于安全 考虑可以重命名。
• session.save_handler — 会话处理方式：files、 memcache、memcached 或 redis。
• session.options — 会话存 储的选项。服务器必须启用 ini_set。
• log.size — 日志文件归档 前的最大体积（默认：2 MB）。
• log.archive_size — 保留的 归档日志文件数量（默认：5）。
• error.level — PHP 错误级 别。
• site.default_pages — Sitecake 查找的默认首页扩展名数组（例如 index.html、 index.php）。
• site.number_of_backups — 保留的发布备份数量（默认：2）。
• site.images_directory_name — 上传图片的文件夹（默认： images）。
• image.valid_extensions — 接受的图片格式（默认：jpg、 jpeg、png、 gif、webp）。
• image.srcset_widths — 生成响应式 srcset 图片时使用的宽度 （像素，默认：1280, 960, 640, 320）。
• image.srcset_qualities — 生成 srcset 图片时使用的 JPEG 质量 （0–100，默认：75）。
• upload.directory_name — 上传文件的文件夹（默认：files）。
• upload.allowed_extensions — 非图片上传（PDF、文档、压缩包等）接受的 扩展名白名单。
• pages.prioritize_manual_changes — 如果一个页面既通过 Sitecake 编辑（未发布） 又被手动上传过，当此项为 true（默认）时，手动上 传的版本优先。
• pages.use_document_relative_paths — 在生成的导航链接中使用文档相对路径而非站 点相对路径。

文件系统适配器

默认情况下，Sitecake 直接向磁盘上的网站文件写入 （local 适配器）。如果 PHP 进程无法写入 站点根目录 — 这在部分共享主机上很常见 — 可以改用 ftp 适配器：

$config['filesystem.adapter'] = 'ftp';
$config['filesystem.adapter.config'] = [
    'host' => 'ftp.example.com',
    'username' => 'username',
    'password' => 'password',
    'root' => '/path/to/root',
    'passive' => true,
    'ssl' => true,
    'timeout' => 30,
    'port' => 21,
];