跳到主要内容
版本:2.x

控制台

除了 Flarum 核心提供的 默认命令,我们还允许扩展程序的开发者添加自定义控制台命令。

使用控制台:

  1. ssh 连接到安装 Flarum 的服务器
  2. cd 进入含有一个叫做 flarum 的文件的文件夹中
  3. 执行 php flarum [命令名]

注册控制台命令

list

要注册控制台命令,请在您插件的 extend.php 文件中使用 Flarum\Extend\Console 扩展器:

help

php flarum help [命令名]

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

要以其他格式输出,请添加 --format 参数:

php flarum help --format=xml list

要显示可用的命令列表,请使用 list 命令。

info

php flarum info

获取 Flarum 核心及已安装插件的信息。 调试问题时这个命令会很有用,在您提交的问题报告中也应当附上该输出内容。

cache:clear

php flarum cache:clear

清楚后端 Flarum 缓存,包括已生成的 js/css,文本格式器缓存、翻译缓存。 这应当在每次安装或移除扩展后运行,在出现问题时这应该是第一步。

assets:publish

php flarum migrate:reset --extension [插件ID]

发布核心和扩展插件中的资源文件(例如编译的 JS/CSS、bootstrap 图标、logos 等)。 这在您的资源文件发生损坏,或者您切换了 文件系统驱动程序flarum-assets 存储磁盘时可以帮助您。

迁移

php flarum migrate

执行所有未完成的迁移。 当安装或更新一个要修改数据库的插件时,会用到此命令。

migrate:reset

php flarum migrate:reset --extension [插件ID]

重置指定插件的所有迁移。 这个命令大多被插件开发人员使用,如果您要卸载插件,并且想要从数据库中清除该插件的所有数据,也会需要用它。 请注意,该命令的被执行插件必须处于已安装状态(插件启用不启用都行)。

schedule:run

php flarum schedule:run

许多扩展使用预定作业定期执行任务。 包括清理数据库缓存,定时发布草稿,生成站点地图等。 If any of your extensions use scheduled jobs, you should add a cron job to run this command on a regular interval:

* * * * * cd /path-to-your-flarum-install && php flarum schedule:run >> /dev/null 2>&1

这个命令一般不应被手动执行。

Note that some hosts do not allow you to edit cron configuration directly. In this case, you should consult your host for more information on how to schedule cron jobs.

schedule:list

php flarum schedule:list

此命令将返回已计划命令的列表(更多信息请参阅 schedule:run)。 这有助于确认扩展程序提供的命令已正确注册。 This can not check that cron jobs have been scheduled successfully, or are being run.