craftable：实践指南

真正理解craftable，要从它处理的任务开始：Laravel 的管理面板构建器/CRUD 生成器。从日常自动化的使用方式看，输入边界、依赖和失败处理如果不清楚就很难稳定复用是采用前必须回答的问题。短测时我会用一项范围明确的真实任务完成最小试跑，并保留配置时间、输出质量、异常信息和维护痕迹的结果，方便团队复盘。我会把它列入愿意先做小范围验证并复查原始文档的团队的候选清单，而不是仅凭项目介绍直接纳入生产。

BIG NEWS

我们刚刚发布了 Craftable PRO - 这个流行的开源 laravel 管理面板构建器的高级版本。 Pro版本配备了基于Tailwind之上的新UI，它使用最新的Laravel和InertiaJS，并附带许多新功能。

Craftable - 使用 Laravel 构建管理面板

• 关于
  • 演示
  • 使用的封装
• 要求
• 安装
  • 新项目
  • 添加到现有项目
• 基础知识
• 文档
• 接下来去哪里？

关于##

你好 Crafter，欢迎来到 Craftable 6 的官方文档 - 一个基于 Laravel 的开源工具包，用于构建管理界面。这是一个管理区域简约模板。开发后台系统、内部网或 CMS 系统的起点。

您可以将其称为 CMS，但它非常精简，需要管理的内容尽可能少。它有：

• UI - 基于 CoreUI (http://coreui.io/) 的漂亮管理模板
• CRUD发电机
• 授权、我的个人资料和用户 CRUD
• 翻译经理
• 其他帮助快速引导您的新管理区域（媒体库、管理列表等）

演示

我们在 https://demo.getcraftable.com. 创建了一个演示供您试用

使用这些凭据登录：

• 邮箱：[email protected]
• 密码：demo123

您可以看到以下管理：

• 帖子 - 这是使用 admin-generator 包生成的标准 CRUD
• 可翻译文章 - 这是 translatableeloquent 模型的展示
• 管理访问 - 是 CRUD 的扩展，用于用户（您现有的 eloquent 模型）管理
• 翻译 - 您可以在其中管理数据库中存储的翻译

由组件组成

我们的目的是将所有内容分成几个包，并尽可能减少依赖关系。这就是我们目前要做的：

• 管理员 UI - 管理模板（CoreUI 资产、刀片、Vue）
• Admin Generator - 用于 Eloquent 模型的 CRUD 生成器
• 管理员身份验证 - 能够在管理区域进行身份验证
• 可翻译 - 具有可翻译内容的能力（扩展 Laravel 的默认本地化）
• 管理列表 - 能够为 Eloquent 模型快速构建管理列表查询
• 媒体库 - 将媒体附加到 eloquent 模型的能力
• 管理员翻译 - 翻译管理器（使用 UI）

Craftable 使用上述所有软件包。它还使用一些其他第 3 方软件包（例如 Spatie 的 spatie/laravel-permission）并提供一些基本的默认配置以加快典型管理界面的开发。

要求##

可制作要求：

• PHP 7.4+
• 支持的数据库：
  • MySQL 5.7+
  • PostgreSQL 9.5+
• npm 5.3+
• node 8.4+

Craftable 使用 Laravel，因此您也应该检查它的要求。它与 Laravel 8 兼容：

• https://laravel.com/docs/8.x/installation#server-requirements

安装##

新的可制作项目

如果你想开始使用新的 Laravel，你可以使用我们的 brackets/craftable-installer 来为你完成所有的技巧。让我们全局安装它：

composer global require "brackets/craftable-installer"

创建您选择的空数据库（PostgreSQL 或 MySQL）。

现在您可以创建一个新的 Craftable 项目：

craftable new my_project

这将使用最新的 Laravel 版本（当前为 6）安装 Craftable。如果您更喜欢使用最新的 LTS Laravel 版本（目前也是 6），请使用 --lts 标志：

craftable new --lts my_project

这些命令将要求数据库设置，然后它将设置所有内容（安装所有依赖项、发布所有重要的供应商配置、迁移、设置一些配置、webpack 配置并运行迁移）。

命令将生成并打印默认管理员帐户的密码。将此密码保存到剪贴板，我们很快就会需要它。

将 Craftable 添加到现有项目

或者，您也可以使用现有的 Laravel 应用程序。首先需要这两个主要包：

composer require brackets/craftable
composer require --dev brackets/admin-generator

要安装此软件包，请使用：

php artisan craftable:install

这将安装所有依赖项、发布所有重要的供应商配置、迁移、设置一些配置、webpack 配置并运行迁移。

命令将生成并打印默认管理员帐户的密码。将此密码保存到剪贴板，我们很快就会需要它。

基础知识##

安装后，将浏览器导航至 /admin/login。您应该能够看到登录屏幕。

使用这些凭据登录：

• 邮箱：[email protected]
• 密码：使用剪贴板中的密码（它打印在 craftable:install 命令的末尾）

授权后，您应该能够看到默认主页和两个菜单项：

• 管理访问权限
• 翻译

文档##

您可以在 https://docs.getcraftable.com/#/craftable. 找到此软件包和 Craftable 其他软件包的完整文档

接下来去哪里？

此时，您已准备好开始构建您的管理区域。您可能想开始为您的雄辩模型构建一个典型的 CRUD 界面。您一定应该查看我们的 管理生成器 文档。

如果您想创建一些非典型的定制管理，那么您可能需要转到 Admin UI 包。

玩得开心并制作一些很棒的东西！