🔸 Flarum 新人必看,注意事项以及 FAQ,此文章内容不定期更新。
🔹 在发言前,请仔细阅读并遵守 中文社区准则
🔸 Flarum 已发布正式版,大量测试年代的魔改教程很可能已失效,请在魔改前注意备份。
在提问前,请务必要阅读《提问的智慧》精读注解版。不仅仅是在 Flarum 社区,以后在任何社区提问,都要遵守提问的智慧。
🚦 你不应该
如果你随意提问,而没有做功课,只能得到大家的鄙视,就像这样。
- “哪位大神帮我远程看看到底哪儿出错了吗?”
- “如何创建社区”
- “请问这是什么原因啊?[结果/报错截图]”
- “为什么我安装完后和官网不一样啊?”
- “git 怎么用啊?”
- “怎么进入后台啊?”
- “谁可以帮忙解决一下”
- “为啥我的报这个错啊:Class XXXX not found…”
- “Fatal error: Maximum execution time of 30 seconds exceeded in”
- …
👾 开启自检错误
使用调试模式自行检查报错详情,无法解决时发帖。
如果,您必须要贴出部分代码提问,请善用 代码块 格式 ,例如这样:
我是一串代码块格式,而不是一段普通文本格式
📚️ FAQ
🔅 Flarum 客制化路线
📌 Flarum 安装中部分大概率遇到的问题
正在遇见问题并尽可能的汇总,需要用户反馈,这里才可以进行编辑和更新,请耐心等待补充…
0.安装 Flarum 遇到「require(../site.php): failed to open stream」
Warning: require(../site.php): failed to open stream: No such file or directory in /www/wwwroot/helpbooks.org/index.php on line 10
Fatal error: require(): Failed opening required '../site.php' (include_path='.:/www/server/php/72/lib/php') in /www/wwwroot/helpbooks.org/index.php on line 10
1.安装 Flarum 遇到 “vendor/autoload.php” 缺失等相关 autoload 问题
- 确保 Composer 安装正确,建议全局安装。在你想要的目录下重新运行 Composer 命令
composer create-project flarum/flarum . –stability=beta
来获取 Flarum,之后会看到 Flarum 相关文件。
如果 Composer 无法正常获取文件或超时,请切换到 Composer 国内源后重试。
2.注册时出现 Oops! 不能注册或者注册不正常,显示
Oops! Something went wrong. Please reload the page and try again.
3. 为什么根据重写规则,还是404或者无法打开网页?
- 一般情况下,请确保运行目录是 /public 即可正常运行 Flarum,Flarum 自带
.htaccess
或.nginx.conf
文件,将 Flarum 自带的定向文件包含在服务器总rewrite配置内即可。
- 重定向不正确,特别是 Nginx 的 Beta 11+ 重定向项设置,需要删除一段关于 admin 的重定向
当您的重定向不正确,才需要使用上文的 “URL 重写规则” 进行参考补全,而非全局/全部替换覆盖 !!
同时,请确保您修改的重写规则文件的位置正确且主次不冲突,视具体情况而不同。
4.遇到PHP函数被禁用/不可用的问题
The Process class relies on ... ,which is not available on your PHP in stallation
- 请将禁用的PHP函数打开,如下所示的
proc_open
函数报错,若后面如果出现类似提示,
则以此类推逐一打开被禁函数,或者安装需要的php相关功能。安装指南中也有提到,请仔细阅读需要的函数功能。
- Installing flarum/flarum (v0.1.0-beta.11): Downloading (100%)
The Process class relies on proc_open, which is not available on your PHP in stallation.
The archive may contain identical file names with different capitalization (which fails on case insensitive filesystems)
Unzip with unzip command failed, falling back to ZipArchive class
5. 左下角显示"请求的资源不存在" The requested resource was not found
6. 首页打开无样式,只有文字
- 请检查伪静态是否设置正确,以及目录结构与目录权限有无调整。
- 确认根地址配置正确,特别是
http
转为 https
,需要重新配置文件 config
中的站点根地址
7.实际上消息已经发送成功了,但需要刷新才能显示。
- Filter插件的过滤词格式设置有问题,请重新配置。
如果你加入了 QQ 群,请不要直接通过 QQ 找我,并贴上一堆的代码。谢谢。
请务必要阅读《提问的智慧》
请务必要阅读《提问的智慧》
请务必要阅读《提问的智慧》
重要的话说三遍。