Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mochgani/crud-laravel


https://github.com/mochgani/crud-laravel

Last synced: 8 days ago
JSON representation

Awesome Lists containing this project

README

        

# Crud Generator Laravel 9 and 10 (your time saver)

Crud Generator Laravel is a package that you can integrate in your Laravel to create a REAL CRUD. It includes :

- **Controller** with all the code already written
- **Views** (index, create, edit, show)
- **Model** with relationships
- **Request** file with validation rules
- **Migration** file

## Installation

1\. Run the following composer command:

``` composer require mochgani/crud-laravel:dev-main ```

2\. If you don't use Laravel Collective Form package in your project, install it:

``` composer require laravelcollective/html ```

(Note: This step is not required if you don't need views.)

3\. Publish the configuration file, stubs and the default-theme directory for views:

``` php artisan vendor:publish --provider="Mochgani\CrudLaravel\CrudgenServiceProvider" ```

## Usage

### Create CRUD (or REST API)

Let's illustrate with a real life example : Building a blog

A `Post` has many (hasMany) `Comment` and belongs to many (belongsToMany) `Tag`

A `Post` can have a `title` and a `content` fields

Let's do this 🙂

If you need a REST API instead of CRUD, [read this wiki](https://github.com/misterdebug/crud-generator-laravel/wiki/Make-a-complete-REST-API-instead-of-CRUD)

#### CRUD generator command :

``` php artisan make:crud nameOfYourCrud "column1:type, column2" ``` (theory)

``` php artisan make:crud post "title:string, content:text" ``` (for our example)

[Available options](https://github.com/misterdebug/crud-generator-laravel/wiki/Available-options-when-you-use-make:crud-command)

[Generate CRUD with livewire datatable](https://github.com/misterdebug/crud-generator-laravel/wiki/Generate-CRUD-with-livewire-datatable)

When you call this command, the controller, views and request are generated with your fields (in this case, title and content).
![image](https://user-images.githubusercontent.com/23297600/192172786-1703f7b8-f577-45c1-b0f9-296999827af2.png)

Now let's add our relationships (`Comment` and `Tag` models) :

![image](https://user-images.githubusercontent.com/23297600/192173041-6c71d727-1e29-4edc-9397-bdb07f44a378.png)

We add a `hasMany` relationship between our `Post` and `Comment`
and a `belongsToMany` with `Tag`

Two migrations are created (`create_posts` AND `create_post_tag`).

`create_posts` is your table for your `Post` model

`create_post_tag` is a pivot table to handle the `belongsToMany` relationship

`Post` model is generated too with both relationships added

![image](https://user-images.githubusercontent.com/23297600/192173463-f3e61b41-373a-44a8-870f-fc837968a5c7.png)

### Migration

Both migration files are created in your **database/migrations** directory. If necessary edit them and run :

``` php artisan migrate ```

## Remove a CRUD

You can delete all files (except migrations) created by the `make:crud` command at any time. No need to remove files manually :

``` php artisan rm:crud nameOfYourCrud --force ```

``` php artisan rm:crud post --force ``` (in our example)

The `--force` flag (optional) deletes all files without confirmation

![image](https://user-images.githubusercontent.com/23297600/192183601-a4f8d206-3920-4f8a-8e0d-cf8442894e07.png)

## License

This package is licensed under the [license MIT](http://opensource.org/licenses/MIT).

## Source

- **[misterdebug/crud-generator-laravel](https://github.com/misterdebug/crud-generator-laravel/)**: Source Library CRUD Generator