# Artisan CLI

Blessing Skin 允许您通过命令行对皮肤站进行一些操作。

TIP

这里的 CLI 是指服务器上的真实 Shell,不是 Blessing Skin Shell(即 Web CLI)。

# 启用插件

通过以下命令可以启用一个插件:

$ php artisan plugin:enable <name>

其中 name 参数是必须的,为插件的唯一标识符(即插件信息中的 name 字段),如 mojang-verification

# 禁用插件

通过以下命令可以禁用一个插件:

$ php artisan plugin:disable <name>

其中 name 参数是必须的,为插件的唯一标识符(即插件信息中的 name 字段),如 mojang-verification

# 缓存站点选项

此命令没有参数,用法如下:

$ php artisan options:cache

执行此命令后,Blessing Skin 将在 storage 目录下生成一个 options.php 文件。此文件即为缓存。

以后每次访问站点时,Blessing Skin 都会从这里加载所有的站点选项,而不读取数据库。

提示:

在生成缓存之后,你在站点管理面板中对任何设置进行的一切修改都不会生效(因为它们是写进数据库的)。如果你希望在更改设置后使新设置生效,重新执行这条命令就可以更新缓存。

如果希望停止缓存,直接删除 storage/options.php 文件即可。

# (重新)生成 APP_KEY

APP_KEY 用于对用户的 Session 等数据进行加密,因此它是必须的。

在首次安装 Blessing Skin 之前,您应该执行以下命令来生成 APP_KEY:

$ php artisan key:generate

如果对现有的站点执行上述命令,则会重新生成 APP_KEY,但要注意用户登录状态会失效。(密码不会受到影响)

# (重新)生成盐

如果您使用的密码加密算法使用了盐,则可以通过下面的命令来生成新的盐:

$ php artisan salt:random

# 安装 Blessing Skin

您可以以命令行的方式来安装 Blessing Skin。要注意的是,在执行安装前,请手动配置好 .env 文件,包括数据库连接等信息。

命令用法如下:

$ php artisan bs:install <email> <password> <nickname>

这将自动完成 Blessing Skin 的安装,并根据您给定的邮箱、密码和昵称来创建一个超级管理员。