Fresns 的常用指令确实以 php artisan 为核心。不过插件开发相关的指令需要先启用开发模式,且执行环境会在“项目根目录”和“插件目录”之间切换,这一点容易混淆。
终端清理缓存
#一键清理 php artisan cache:clear #清除数据缓存 php artisan config:clear #清除框架配置缓存 php artisan route:clear #清除路由缓存 php artisan config:cache #清除并重新生成框架配置缓存 php artisan route:cache #清除并重新生成路由缓存
下面按使用场景整理了核心指令,并补充了官方文档中的关键执行流程。
这类指令在项目根目录执行,用于日常运维和故障排查。
| 指令 | 用途 | 关键说明 |
|---|---|---|
php artisan fresns:reset-password | 重置管理员密码 | 忘记后台密码时,可通过终端直接重置 |
php artisan fresns:panel | 查看管理面板入口 | 确认后台登录地址 |
php artisan cache:clear | 清除数据缓存 | 修改后台设置不生效时使用 |
php artisan config:clear | 清除配置缓存 | 修改 .env 后必须执行,否则新配置不生效 |
php artisan route:clear | 清除路由缓存 | 开发插件时,执行后路由才会生效 |
使用前需在项目根目录执行 php artisan fresns 启用开发模式 。
关键流程:启用开发模式后,指令的执行环境会区分“项目根目录”和“插件目录”。进入插件目录后,后续的 fresns 指令都作用于该插件 。
# 1. 在项目根目录启用开发模式 php artisan fresns # 2. 创建新插件(可选) fresns new DemoPlugin # 3. 进入插件目录(关键步骤) fresns enter DemoPlugin # ... 在插件目录内执行开发指令 ... # 4. 退出插件目录,返回根目录 fresns back 5.在 Fresns 项目根目录执行: php artisan plugin:install AiGeo --is_dir php artisan plugin:activate AiGeo php artisan migrate php artisan migrate --force 6. ## 定时发布 php artisan your-article:publish-scheduled 7.
常用指令如下:
| 指令 | 用途 |
|---|---|
fresns new <插件名> | 创建一个新插件 |
fresns enter <插件名> | 进入插件目录,后续指令作用于该插件 |
fresns back | 退出插件目录,返回项目根目录 |
fresns plugin:activate <插件名> | 激活指定插件 |
fresns plugin:deactivate <插件名> | 停用指定插件 |
在项目根目录执行,从官方市场安装或管理插件。
| 指令 | 用途 | 示例 |
|---|---|---|
php artisan market:require <标识符> | 从市场安装插件 | php artisan market:require Placeholder |
部分插件会提供自己的 Artisan 指令,通常由插件作者在文档中说明。例如:
ChatGPT 插件:安装后可能需要通过 php artisan app:chatgpt 来启动其服务进程。
DcatSaaS 插件:安装后会提供 php artisan saas 等系列命令 。