DokuWiki中韩文字符搜索引发TypeError问题的分析与解决

问题现象

在使用DokuWiki进行韩文字符搜索时（如搜索"한글"），系统会抛出TypeError异常，错误信息显示array_keys()函数期望接收数组参数但实际收到了布尔值false。该问题仅出现在stable版本中，而在oldstable版本中表现正常。

技术背景

DokuWiki是一个基于PHP开发的wiki系统，其全文搜索功能通过inc/fulltext.php文件实现。当用户发起搜索请求时，系统会触发ft_pageSearch函数，该函数通过事件机制调用_ft_pageSearch函数执行实际搜索逻辑。

错误分析

核心错误发生在fulltext.php文件的第102行，当处理韩文字符搜索时，某个预期返回数组的函数返回了false，导致后续array_keys()函数调用失败。这种类型不匹配通常意味着：

1. 数据库查询失败返回了false而非空数组
2. 字符编码处理过程中出现异常
3. 分词逻辑对韩文字符支持不足

解决方案

该问题已在最新代码提交中被修复。修复方案主要涉及：

1. 增强字符编码处理逻辑，确保韩文字符能正确被解析
2. 添加对数据库查询结果的类型检查，避免false值直接传递给array_keys()
3. 完善分词器对多字节字符的支持

技术建议

对于遇到类似多语言搜索问题的开发者，建议：

1. 始终检查数据库查询返回值，处理异常情况
2. 在处理多字节字符时，确保使用mbstring等扩展
3. 对可能返回多种类型的函数结果进行类型验证
4. 考虑使用try-catch块捕获可能的异常

版本兼容性

值得注意的是，该问题表现出明显的版本差异性：

• stable版本：存在此问题
• oldstable版本：运行正常

这表明该问题可能是新版本引入的回归错误，建议用户在升级时充分测试多语言搜索功能。

总结

多语言支持是wiki系统的重要特性，DokuWiki通过持续改进解决了韩文字符搜索的问题。开发者在使用类似系统时，应当特别关注多字节字符处理的边界情况，确保系统的国际兼容性。