【亲测免费】 DokuWiki 安装与使用教程

2026-01-16 09:59:47作者：翟江哲Frasier

本文将指导您了解并设置开源项目DokuWiki。

1. 项目目录结构及介绍

以下是DokuWiki项目的基本目录结构：

.
├── _test            # 测试目录
├── bin              # 包含可执行脚本
├── conf             # 配置文件存储位置
├── data             # 存储实际wiki内容的地方
├── inc              # 核心源代码
├── lib              # 类库和函数
└── vendor           # 第三方依赖包

_test: 用于存放测试相关的文件。
bin: 包含如doku.php这样的入口脚本和其他辅助工具。
conf: 存放DokuWiki的配置文件，比如local.conf。
data: 存储wiki页面和附件的内容。
inc: 包含核心PHP类和函数库。
lib: 各种辅助函数和类库。
vendor: 使用Composer管理的第三方库。

2. 项目的启动文件介绍

DokuWiki的启动文件是bin/doku.php。这个文件是DokuWiki运行的基础，负责加载必要的组件、处理HTTP请求以及显示网页。在Web服务器中，通常通过配置URL重定向或索引文件设置，将所有请求指向此文件。

例如，如果你的DokuWiki安装在域名为http://example.com/wiki/下，用户请求的每个页面都会指向http://example.com/wiki/doku.php。

3. 项目的配置文件介绍

DokuWiki的主要配置文件是conf/local.conf。这是一个PHP文件，用于自定义您的DokuWiki实例的行为。以下是一些关键配置项的示例：

# 数据库存储路径
$conf['datadir'] = '/path/to/your/dokuwiki/data';

# 是否启用搜索引擎友好URL
$conf['usemutex'] = true;

# 默认语言
$conf['lang'] = 'zh_CN';

# 允许匿名用户编辑
$conf['allowrecentchanges'] = false;

# 设置默认主题
$conf['skin'] = 'default';