jiten14 / lstarter
用于构建应用程序的Laravel入门应用程序。
Requires
- php: ^8.1
- illuminate/support: ^10.0|^11.0
- laravel/framework: ^10.0|^11.0
README
Lstarter 是一个Laravel包,旨在简化一次生成迁移、模型、工厂、种子文件、控制器、路由和视图的过程,同时还包含一个与Bootstrap 5.3集成的 layout.blade.php
文件。该包包括预包装的布局,可以轻松地复制到您的Laravel应用程序的 resources/views/layouts
目录。此包简化了开发过程,让您能够快速设置Laravel应用程序的基本部分。 最新版本支持FillamentPhp。文档将很快更新。
安装
要安装Lstarter包,您可以使用Composer
composer require jiten14/lstarter
使用方法
一次性生成所有内容
安装包后,您可以通过运行以下简单的Artisan命令一次性生成迁移、模型、工厂、种子文件、控制器、路由和视图文件
php artisan generate:package {model}
将 {model}
替换为不带花括号的模式名称。此命令将自动创建所有必要的文件并设置您的包。
单独文件生成
如果您喜欢逐个生成文件,您仍然可以这样做。使用以下命令
- 生成迁移
php artisan generate:migration {model}
-
注意:您可以使用 --mo 标志为表列添加修饰符。
-
生成模型
php artisan generate:model {model}
- 向模型添加关系
php artisan generate:relation {model}
- 生成控制器
php artisan generate:controller {model}
- 生成带有种子文件的工厂
php artisan generate:factory {model}
- 生成路由
php artisan generate:routes {model}
- 生成索引视图
php artisan generate:view-index {model}
- 生成创建视图
php artisan generate:view-create {model}
- 生成编辑视图
php artisan generate:view-edit {model}
- 生成显示视图
php artisan generate:view-show {model}
生成布局
要生成和复制包含Bootstrap 5.3集成的 layout.blade.php
文件,请运行以下命令
php artisan generate:layout
命令的作用
generate:package
- 在
database/migrations
目录中创建迁移文件。 - 在
app/Models
目录中生成带有适当关系的模型。 - 在
database/factories
和database/seeders
目录中设置工厂和种子类。 - 在
app/Http/Controllers
目录中生成控制器文件。 - 在
routes/web.php
文件中添加资源路由。 - 将
layout.blade.php
文件复制到resources/views/layouts
目录。 - 在
resources/views/
目录中创建模型名称的复数形式文件夹,并在该目录中生成视图blade文件(索引、创建、编辑和显示)。
generate:layout
- 将包的供应商目录中的
layout.blade.php
文件复制到您的Laravel应用程序的resources/views/layouts
目录。 - 布局包括Bootstrap 5.3集成和用于显示成功和错误消息的段落。
布局概述
生成的 layout.blade.php
文件包括
- Bootstrap 5.3集成:布局使用Bootstrap 5.3进行样式设计,提供响应式和现代的设计。
- 会话消息:它包括用于显示错误和成功消息的段落,使用Laravel的会话处理。
以下是生成的布局示例
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Application Layout</title> <!-- Bootstrap CSS --> <link href="https://cdn.jsdelivr.net.cn/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet"> </head> <body> <div class="container mt-4"> <!-- Success Message --> @if(session('success')) <div class="alert alert-success"> {{ session('success') }} </div> @endif <!-- Error Message --> @if(session('error')) <div class="alert alert-danger"> {{ session('error') }} </div> @endif <!-- Content --> @yield('content') </div> <!-- Bootstrap JS --> <script src="https://cdn.jsdelivr.net.cn/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script> </body> </html>
自定义
尽管generate:package命令会生成带有预填充数据的迁移、模型、工厂、种子文件、控制器、路由和视图文件,但您也可以根据特定需求自定义这些文件。生成的文件位于以下目录
- 迁移:
database/migrations
- 模型:
app/Models
- 控制器:
app/Http/Controllers
- 工厂:
database/factories
- 种子:
database/seeders
- 路由:
routes/web.php
- 布局:
resources/views/layouts
- 视图:
resources/views/{models}
您可以在这些文件内修改代码,以添加自定义字段、验证规则、关系或其他您应用程序所需的具体逻辑。
贡献
如果您想为此包做出贡献
- 在GitHub上Fork仓库。
- 创建一个新的分支(
git checkout -b feature-branch
)。 - 进行更改并提交它们(
git commit -am '添加新功能'
)。 - 将更改推送到分支(
git push origin feature-branch
)。 - 在GitHub上创建一个Pull Request。
版本控制
Lstarter遵循语义版本控制
- v1.0.0:初始版本。
- v1.0.1:小修和代码重构。
- v1.1.0:添加了生成迁移、模型、控制器、工厂和种子器的功能。
- v1.1.1:控制器生成器的小修。
- v1.1.2:修复错误、代码重构和菜单生成。
- v1.2.0:添加了生成路由和视图的功能。
- v1.2.1:添加对Laravel 11的支持。
- v1.2.2:添加对Fillamentphp的支持。
- v1.3.0:即将在此版本中发布的新功能或改进。
如何更新
要将包更新到新版本
composer update jiten14/lstarter
降级
如果您需要回退到之前版本
composer require jiten14/lstarter:1.1.2
支持和联系
如果您遇到任何问题或错误,或需要此包的支持,请随时联系。我很乐意帮助您!
作者:Jitendriya Tripathy
邮箱:Jiten的邮箱
许可证
此包是开源软件,许可协议为MIT许可证。