wikkawiki.org

WikkaWiki是什么网站?

WikkaWiki 是一个用 PHP 编写、以 MySQL 存储页面的轻量级 Wiki 引擎，采用 GPL 许可证开源，从 WakkaWiki 分支而来，主打速度、可扩展性和安全性。它本身是建站软件，不是内容型网站：你把它装在自己的服务器上，就能搭出一个支持多人协作编辑的 Wiki 站点。

主要用途

• 搭建内部知识库：团队文档、流程手册、项目笔记集中存放，成员按页面协作维护。
• 建公开 Wiki 站点：官网资料称有 37 种语言的 Wikka 站点案例，适合做多语言资料站。
• 二次开发与集成：提供插件与扩展机制，也说明了如何与博客、论坛集成。

典型使用场景

• 小型团队想要一个部署简单、资源占用低的 Wiki，而不是重型协作平台。
• 开发者需要一个可读源码、可写扩展的 PHP Wiki 内核。
• 从旧 WakkaWiki 迁移过来的站点，官方专门提供了迁移说明。

使用前要知道的条件

• 环境要求：官方公告称 1.4.2 版在 MySQL 5.7.21 和 PHP 7.2.4 下测试，PHP 低于 7.0 不再支持。
• 升级必须先读升级说明并备份数据库，这是官网用大写强调的。
• 遇到问题可通过 GitHub 提交 issue，或订阅邮件列表；社区注册免费账号即可参与讨论。

和其他 Wiki 方案的取舍

• 与 DokuWiki 相比：两者都不需要数据库，但 WikkaWiki 使用 MySQL 存页面，DokuWiki 直接存文件，备份和迁移方式不同；WikkaWiki 更强调轻量与可扩展代码结构。
• 与 MediaWiki 相比：MediaWiki 面向大型百科协作，功能与生态更重；WikkaWiki 更轻，适合小团队或嵌入式知识站。
• 与 Wikidot 这类托管服务相比：WikkaWiki 需要自己准备 PHP + MySQL 环境并自行维护，换来的是数据与代码完全自控。

如果只是想快速上线一个 Wiki，先确认服务器满足 PHP 7.0 以上和 MySQL 条件，再按官方安装文档部署；已有 WakkaWiki 站点则优先看迁移指南。

WikkaWiki从WakkaWiki分叉后有哪些关键差异?

WikkaWiki 是从 WakkaWiki 分叉出来的 PHP + MySQL 轻量 wiki 引擎，官方资料对分叉后的定位写得很明确：面向速度、可扩展性和安全性，遵循标准，并以 GPL 发布。就现有资料能确认的关键差异，主要落在工程取向和维护状态上，而不是逐条功能对照。

分叉后的关键差异

谁需要关注这些差异

• 仍在跑 WakkaWiki、想继续维护的老站点：重点看 PHP/MySQL 版本要求和“从 WakkaWiki 迁移”文档，升级前备份数据库。
• 想搭轻量 wiki 的新项目：如果看重 PHP+MySQL 的简单部署、插件扩展和安全更新，WikkaWiki 是分叉后仍在维护的那一支；需要多语言支持时可查它的本地化页面。
• 需要二次开发或集成到博客/论坛的团队：官方提供扩展下载和集成说明，并有 GitHub 仓库可提 issue、参与开发。

资料没有给出 WakkaWiki 与 WikkaWiki 的逐项功能对照表，因此具体功能差异建议以官方文档和迁移说明为准，不要仅凭“分叉”推断兼容性。

安装WikkaWiki前需要确认哪些系统要求?

安装 WikkaWiki 前，先确认服务器能跑 PHP + MySQL，并达到当前版本要求。根据官网资料，最新发布版为 1.4.2，测试环境是 MySQL 5.7.21 和 PHP 7.2.4，且 PHP 低于 7.0 已不再支持。

需要确认的项目

• PHP 版本：至少 7.0；按官网测试基线，建议 7.2.4 或更高兼容版本。
• 数据库：MySQL，官网测试版本为 5.7.21。
• Web 服务器：能运行 PHP 的环境即可，官网未在摘录中列出具体服务器软件版本。
• 安装方式：WikkaWiki 是 PHP 脚本包，需要上传到服务器并配置数据库连接；官网另列有系统要求页，安装前应逐项对照。

升级场景的额外条件

如果是从旧版升级，官网特别提醒必须先阅读升级说明，并备份数据库。这比新装更容易因数据库结构变化出问题。

下一步

先到官网系统要求页核对 PHP 与 MySQL 的精确版本，再决定是否直接安装 1.4.2；若服务器 PHP 仍为 5.x，需要先升级 PHP 环境。

从旧版本升级到WikkaWiki 1.4.2时需要注意什么?

升级到 WikkaWiki 1.4.2 时，官方页面把两件事列为“必须”：阅读升级说明，并在操作前备份数据库。除此之外，1.4.2 对运行环境有明确门槛，旧版 PHP 环境需要先处理。

升级前先确认运行环境

页面资料显示，1.4.2 已在 MySQL 5.7.21 和 PHP 7.2.4 上测试，并明确 PHP 低于 7.0 的版本不再受支持。因此，如果旧站还跑在 PHP 5.x 上，应先升级服务器 PHP 环境，再执行 Wikka 升级；否则新版本无法正常运行。具体依赖项可对照官方的系统要求页面核对。

按顺序执行的操作

1. 备份数据库：官方用大写强调“BACK UP YOUR DATABASE”，这是升级回滚的基础。
2. 读升级说明：升级说明中会列出该版本涉及的配置或数据变更，跳过容易在升级后出现页面异常。
3. 核对 PHP/MySQL 版本：确认满足 PHP 7.0 以上、MySQL 5.7 系列的要求。
4. 升级后检查扩展与插件：Wikka 有不少用户贡献的扩展，旧扩展可能与新版本不兼容，升级后应逐一验证常用插件。
5. 遇到问题走官方渠道：可在 GitHub 提交 issue，或订阅邮件列表获取支持。

适合谁参考

仍在维护老 WakkaWiki 派生站点、或从更早 Wikka 版本迁移的个人站长和小团队，最需要留意上述环境门槛；如果站点依赖大量第三方扩展，建议先在测试环境完整走一遍升级流程，再动生产站。

如何把WakkaWiki的数据迁移到WikkaWiki?

WikkaWiki 官方在首页把“从 WakkaWiki 迁移”列为独立帮助入口，说明这是它支持的升级路径。具体步骤在官方文档的迁移页，首页只强调两件事：迁移前阅读升级说明，并且务必备份数据库。

迁移前要确认的条件

• 版本与运行环境：WikkaWiki 1.4.2 已在 MySQL 5.7.21 和 PHP 7.2.4 下测试；PHP 低于 7.0 不再受支持。老 WakkaWiki 站点常跑在旧版 PHP 上，迁移前先把运行环境升到受支持版本。
• 数据存储：WikkaWiki 用 MySQL 存页面，迁移主要是把 WakkaWiki 的页面数据导入 WikkaWiki 的库结构，而不是简单复制文件。
• 先备份：官方用大写强调“BACK UP YOUR DATABASE”，迁移和后续升级前都先做数据库全量备份。

建议的操作顺序

1. 在测试环境复制一份 WakkaWiki 数据库，不要直接动生产库。
2. 按官方升级/迁移说明执行，重点看表结构变化和需要保留的页面、用户、修订记录。
3. 迁移后逐项检查：页面能否正常显示、历史版本是否完整、链接和分类是否可用。
4. 确认无误后再对生产环境操作，并保留回滚用的备份。

遇到问题时

官方支持渠道是 GitHub 提交 issue 和订阅邮件列表；插件与扩展另有下载页。迁移脚本或表结构差异导致的报错，优先在 GitHub 仓库里检索是否已有同类问题。

补充一个选择条件：如果站点页面量很大、或改过 WakkaWiki 核心代码，迁移前先评估自定义修改是否需要重写为 WikkaWiki 的插件或动作，否则迁移后这些功能会丢失。

遇到WikkaWiki运行问题时可以去哪里寻求支持或报告bug?

遇到运行问题，先查官方文档；需要人工介入时，走 GitHub 提交 issue 或订阅邮件列表。

具体渠道

提交前的注意事项

• 升级后出问题，官方页面明确要求先读升级说明，并备份数据库；该版本测试环境为 MySQL 5.7.21 和 PHP 7.2.4，PHP 低于 7.0 已不受支持。先核对环境再报 bug，能排除大量“非缺陷”问题。
• 报 bug 前先在 GitHub 的 open issues 里搜一下，避免重复提交。
• 想贡献代码的话，官方建议先读其 welcome page 了解流程，再动手。

例如需要判断某个报错是环境不兼容还是程序缺陷，可以先对照系统要求页面，再去 GitHub 搜索相同关键词；确认无人报告后再新建 issue，并附上 PHP、MySQL 版本和复现步骤。