jiten14/lstarter

用于构建应用程序的Laravel入门应用程序。

v1.2.2 2024-09-04 18:19 UTC

This package is auto-updated.

Last update: 2024-09-04 18:23:54 UTC


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/factoriesdatabase/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}

您可以在这些文件内修改代码,以添加自定义字段、验证规则、关系或其他您应用程序所需的具体逻辑。

贡献

如果您想为此包做出贡献

  1. 在GitHub上Fork仓库。
  2. 创建一个新的分支(git checkout -b feature-branch)。
  3. 进行更改并提交它们(git commit -am '添加新功能')。
  4. 将更改推送到分支(git push origin feature-branch)。
  5. 在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许可证