控制台
除了 Flarum 核心提供的 默认命令,我们还允许扩展程序的开发者添加自定义控制台命令。
使用控制台:
ssh
连接到安装 Flarum 的服务器cd
进入含有一个叫做flarum
的文件的文件夹中- 执行
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.