README

🚀 Generate Eloquent Models Automatically from Database Tables

A powerful Laravel package that automatically generates Eloquent models from your database tables with professional PHPDoc, relationships, and casting.

✨ Features

• ✅ Auto-generate Eloquent models from database tables
• ✅ Professional PHPDoc with type hints and relationships
• ✅ Automatic relationship detection (hasMany, belongsTo, belongsToMany)
• ✅ Multi-database support (MySQL, PostgreSQL, SQLite)
• ✅ Smart model updating without overwriting custom code
• ✅ Custom namespaces and paths
• ✅ Beautiful console output with emojis
• ✅ Fillable properties & casting generation
• ✅ Table name singularization
• ✅ Many-to-Many relationships detection

🚀 Installation

You can install the package via Composer:

composer require amranibrahem/laravel-model-generator

📖 Usage

1- Generate All Models

php artisan models:generate

2- Generate Specific Tables

php artisan models:generate --tables=users,posts,comments

3- Generate with Relationships

php artisan models:generate --relationships

4- Update Existing Models

php artisan models:generate --force --relationships

5- Custom Path and Namespace

php artisan models:generate --path=app/Domain --namespace=App\\Domain

6- Combine Options

php artisan models:generate --tables=users,posts --relationships --force --path=app/Models

🎯 Examples

Generated Model Example

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Factories\HasFactory;

/**
 * @property int $id
 * @property string $name
 * @property string $email
 * @property string $password
 * @property \Carbon\Carbon|null $created_at
 * @property \Carbon\Carbon|null $updated_at
 * @property-read \App\Models\Comment[] $comments
 * @property-read \App\Models\Post[] $posts
 */
class User extends Model
{
    use HasFactory;

    protected $table = 'users';

    protected $fillable = [
        'name',
        'email',
        'password'
    ];

    protected $casts = [
        'created_at' => 'datetime',
        'updated_at' => 'datetime'
    ];

    /**
     * Get all the Comment for the User.
     */
    public function comments()
    {
        return $this->hasMany(Comment::class, 'user_id', 'id');
    }

    /**
     * Get all the Post for the User.
     */
    public function posts()
    {
        return $this->hasMany(Post::class, 'user_id', 'id');
    }
}

Many-to-Many Relationship Example

/**
* @property \App\Models\Tag[] $tags
  */
 class Post extends Model
{
  public function tags()
  {
  return $this->belongsToMany(Tag::class, 'post_tag', 'post_id', 'tag_id');
  }
}

⚙️ Options

🔧 Supported Databases

• MySQL - Full support with foreign key detection
• PostgreSQL - Complete support with schema information
• SQLite - Basic support with table info

🎨 Console Output

🚀 Starting Model Generation...
✅ Generated model: User
✅ Updated model with relationships: Post
⚠️ Model Comment already exists, skipping...
✅ Successfully generated 5 models!
✅ Updated 2 existing models with relationships!
📁 Models location: /path/to/app/Models

⚡ Comparison with Alternatives

🐛 Reporting Issues

If you discover any issues, please use the GitHub issue tracker.

🏆 Credits

• Amran iBrahem

💡 Why Use This Package?

• Save Development Time - Generate models in seconds instead of hours
• Reduce Errors - Automatic relationship detection prevents mistakes
• Professional Code - PHPDoc and proper Laravel conventions
• Flexible - Works with existing projects and new ones
• Safe Updates - --force option only adds missing properties
• Multi-Database - Works with MySQL, PostgreSQL, and SQLite

🔗 Links

• GitHub Repository
• Packagist
• Issue Tracker

⭐ Star us on GitHub if this package helped you!

🚀 Happy coding!