跳到主要内容

控制台

除了后台管理面板,Flarum 还提供控制台命令,通过终端管理论坛。

使用步骤:

  1. ssh 连接到安装 Flarum 的服务器
  2. cd 进入 Flarum 安装根目录(可以看到名为 flarum 的文件)
  3. 命令行执行 php flarum <命令名>

默认命令#

list#

列出可用命令和使用说明。

help#

php flarum help <命令名>

输出指定命令的帮助信息。

要以其他格式输出,请在命令名前添加 --format 参数:

php flarum help --format=xml list

此示例命令含义:以 xml 格式输出 list 命令的帮助信息。

info#

php flarum info

输出 Flarum 核心及已安装扩展程序的信息。此命令多在调试问题,或提交报告时使用。

cache:clear#

php flarum cache:clear

清除 Flarum 后端缓存,包括已生成的 js/css,文本格式化缓存、翻译缓存。在安装或卸载扩展程序后,应当运行此命令。在遇到 Flarum 运行问题时,亦可运行此命令尝试解决。

assets:publish#

php flarum assets:publish

发布核心和扩展的资源文件(JS/CSS、bootstrap 图标、logo 等)。当静态资源损坏,或更换 flarum-assets 磁盘的 文件系统驱动 时,需要使用此命令。

migrate#

php flarum migrate

执行数据库变更。安装或更新的扩展程序需要修改数据库时,需要使用此命令。

migrate:reset#

php flarum migrate:reset --extension <扩展程序 ID>

撤销指定扩展程序的所有数据库变更。此命令主要面向开发者使用。如果您想卸载一个扩展程序,并删除其存储在数据库中的所有数据,可以使用此命令。但务必注意,此命令必须在扩展程序移除前执行。

schedule:run#

php flarum schedule:run

执行一次所有扩展程序的定时任务,如数据库清理、发布草稿、生成站点地图等。添加一个 Cron 定时任务 定期运行此命令。

* * * * * cd /<Flarum 安装根目录> && php flarum schedule:run >> /dev/null 2>&1

此命令一般不手动执行,而是通过定时任务自动执行。

如果服务器未开放定时任务配置功能,请自行咨询服务商解决。

schedule:list#

php flarum schedule:list

列出所有计划任务(详见 schedule:run)。用于确认扩展程序是否成功提交计划任务给 Flarum。输出结果 不能说明 相关计划任务的执行状态。