alablaster / architect
Laravel 的脚手架工具
Requires
- laravel/framework: ^8
- symfony/yaml: ^5.1
Requires (Dev)
- orchestra/testbench: ^6
- phpunit/phpunit: ^9.2
This package is auto-updated.
Last update: 2024-09-06 17:54:01 UTC
README
一个应用脚手架工具。
它是什么
此包旨在根据简单的 YAML 文件构建您的应用程序。大多数设置都是可覆盖的,但一切都有默认值,允许快速原型设计。
例如,一旦您定义了一个具有其键的实体,例如 Family/Parent
,Architect 现在将知道它的命名空间是 Family,它的名称是 Parent,它的表名是 parents,并且假设它应该有 'id'、'name'、'created_at' 和 'updated_at' 等字段。当您构建您的基础时,Architect 将能够创建不仅模型,带有可批量赋值的字段,还可以创建迁移、存储和更新请求以及模型工厂。一切只需两步。
版本和 Laravel 支持
发布 | 日期 | Laravel | 标签 |
---|---|---|---|
Beta 0.2 | 6-1-2021 | v.8.0 | 0.2 |
Beta 0.1 | 20-11-2020 | v.8.0 | 0.1.3 |
Beta 警告
这是一个 Beta 版本,主要是因为这是此包的第一个版本,所以您的反馈非常受欢迎。请在 GitLab 中创建一个问题来报告发现的错误。
最新版本中仍有一些未记录的功能。虽然一些功能确实有效,但它们尚未完全测试,可能存在尚未实现的差距。
虽然这个包仍在 beta 版本中,但它实际上永远不会 '在生产中' 使用,而是一个帮助您更快地构建项目的工具。因此,Architect 在构建应用程序时可能出现的任何错误都希望尽早出现在您的开发过程中。我的建议是在第一次运行 Architect 之前进行 git 提交,这样您就可以更好地看到已创建的文件以及它们是否符合您的需求。如果它们符合,那么您就可以继续开发应用程序,而不用担心任何 beta 错误进入您的系统。
如何安装
在 Laravel 的全新安装中,运行以下命令。
composer install-dev Alablaster/Architect
;
接下来发布供应商文件
php artisan vendor:publish --provider="Vendor\Alablaster\ArchitectServiceProvider"
接下来生成您的蓝图文件,蓝图.yaml 在项目的根目录中运行
php artisan architect:blueprints
如何使用它
在您的路由文件夹中打开 blueprint.yaml 文件。它已经包含了一些设计应用程序的简单示例。该文件被拆分为几个顶级域,包括 entities
和 relationships
,
在其中的每个域中,您都可以定义一个具有 'key' 的对象。基于该键,会假定一些默认值,但可以通过传递该设置的名称和新值来覆盖这些值。
要了解您有哪些选项,请访问文档 https://laravel-architect.readthedocs.io/en/latest/
一旦您编辑了项目的蓝图,您可以使用以下命令构建它
php artisan architect:foundation
变更日志
当前
- 从实体定义创建 API 脚手架
- 向实体添加方法以定义将生成哪些文件。可以在配置中设置应用程序的默认值。
- 添加对 JSON 资源的支持
- 允许占位符链式过滤
0.2 (6-1-2021)
- 创建 Livewire 'Directory' 路由类型
- 添加输出以跟踪已创建的文件并更好地显示错误
- 创建新的 StubBuilder,它更干净地创建文件
- 向网站图添加路由模型绑定
- 将WebsiteBuilder重构为根据文档中定义的更新定义样式生成路由,文档链接为:文档。
0.1.4 (22-12-2020)
- 修复了关于必需请求规则的错误。
- 改进了请求规则的缩进。
- 引入了基于Web和基于API的路由,尽管API部分尚未实现。
0.1.3 (20-12-2020)
- 修复了Factories中的格式错误。
- 添加了对工厂中忽略字段的支持。
0.1.2 (18-12-2020)
- 为大多数字段类型添加了默认的模拟数据生成器。如果字段类型不受支持,则不会设置模拟数据值。
- 修复了添加多对多关系外键的关系迁移中的各种错误。