make:model - Lyger PHP Framework

The make:model command generates a new model class in the App/Models directory with optional migration.

Syntax

php rawr make:model <Name> [--migration]

string

required

The name of the model class (use PascalCase, singular)

flag

Automatically create a migration file for the model

Basic Usage

Create a new model:

php rawr make:model User

Output:

Model created: App/Models/User.php

With Migration

Create a model and migration together:

php rawr make:model Product --migration

Output:

Model created: App/Models/Product.php
Migration created: database/migrations/2026_03_08_143022_create_products_table.php

Using the --migration flag automatically generates both the model and a matching migration file, saving you time.

Generated Model

The command creates a model that extends Lyger’s base Model class:

App/Models/User.php

<?php

declare(strict_types=1);

namespace App\Models;

use Lyger\Database\Model as BaseModel;

class User extends BaseModel
{
    protected string $table = 'users';
    protected array $fillable = [];
}

Table Name Convention

The table name is automatically derived from the model name using snake_case pluralization:

Model Name	Generated Table Name
`User`	`users`
`Product`	`products`
`BlogPost`	`blog_posts`
`OrderItem`	`order_items`

rawr (line 246)

$tableName = strtolower(preg_replace('/(?<!^)[A-Z]/', '_', $name)) . 's';

Model Properties

$table

Specifies the database table for the model:

protected string $table = 'users';

You can override this if your table name doesn’t follow the convention.

$fillable

Defines which attributes can be mass-assigned:

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

This protects against mass-assignment vulnerabilities:

// Safe - only fillable attributes are assigned
$user = new User(['name' => 'John', 'email' => 'john@example.com']);

Naming Conventions

Model names should:

Use PascalCase (e.g., User, Product, BlogPost)
Be singular (the table will be automatically pluralized)
Represent a single entity or record

Valid Names

php rawr make:model User
php rawr make:model Product
php rawr make:model BlogPost
php rawr make:model OrderItem

Invalid Names

php rawr make:model Users        # Should be singular (User)
php rawr make:model user         # Should use PascalCase (User)
php rawr make:model user-model   # No hyphens allowed

Error Handling

Missing Name

php rawr make:model

Output:

Error: Model name required

Duplicate Model

php rawr make:model User
# Run again
php rawr make:model User

Output:

Error: Model User already exists

Complete Example

Create a model with all common properties:

php rawr make:model Product --migration

<?php

declare(strict_types=1);

namespace App\Models;

use Lyger\Database\Model as BaseModel;

class Product extends BaseModel
{
    protected string $table = 'products';
    
    protected array $fillable = [
        'name',
        'description',
        'price',
        'stock',
        'category_id'
    ];
    
    // Relationships
    public function category()
    {
        return $this->belongsTo(Category::class);
    }
    
    public function orders()
    {
        return $this->belongsToMany(Order::class);
    }
    
    // Accessors
    public function getFormattedPriceAttribute(): string
    {
        return '$' . number_format($this->price, 2);
    }
    
    // Scopes
    public function scopeInStock($query)
    {
        return $query->where('stock', '>', 0);
    }
}

<?php

declare(strict_types=1);

use Lyger\Database\Migration;

class CreateProductsTable extends Migration
{
    public function up(): void
    {
        $this->getSchema()->create('products', function ($table) {
            $table->id();
            $table->string('name');
            $table->text('description')->nullable();
            $table->decimal('price', 10, 2);
            $table->integer('stock')->default(0);
            $table->foreignId('category_id')->constrained();
            $table->timestamps();
        });
    }

    public function down(): void
    {
        $this->getSchema()->drop('products');
    }
}

Common Patterns

User Model

App/Models/User.php

<?php

declare(strict_types=1);

namespace App\Models;

use Lyger\Database\Model as BaseModel;

class User extends BaseModel
{
    protected string $table = 'users';
    
    protected array $fillable = [
        'name',
        'email',
        'password'
    ];
    
    protected array $hidden = [
        'password',
        'remember_token'
    ];
    
    // Hash password before saving
    public function setPasswordAttribute(string $value): void
    {
        $this->attributes['password'] = password_hash($value, PASSWORD_DEFAULT);
    }
    
    // Relationships
    public function posts()
    {
        return $this->hasMany(Post::class);
    }
}

Pivot Model

For many-to-many relationships:

php rawr make:model OrderProduct

App/Models/OrderProduct.php

<?php

declare(strict_types=1);

namespace App\Models;

use Lyger\Database\Model as BaseModel;

class OrderProduct extends BaseModel
{
    protected string $table = 'order_product';
    
    protected array $fillable = [
        'order_id',
        'product_id',
        'quantity',
        'price'
    ];
    
    public $timestamps = false;
}

Polymorphic Model

For polymorphic relationships:

php rawr make:model Comment

App/Models/Comment.php

<?php

declare(strict_types=1);

namespace App\Models;

use Lyger\Database\Model as BaseModel;

class Comment extends BaseModel
{
    protected string $table = 'comments';
    
    protected array $fillable = [
        'content',
        'commentable_id',
        'commentable_type'
    ];
    
    public function commentable()
    {
        return $this->morphTo();
    }
}

Using Models

After creating a model, you can use it to interact with the database:

Create Records

use App\Models\Product;

// Create a new product
$product = new Product();
$product->name = 'Laptop';
$product->price = 999.99;
$product->save();

// Or use mass assignment
$product = Product::create([
    'name' => 'Laptop',
    'price' => 999.99
]);

Query Records

// Find by ID
$product = Product::find(1);

// Get all products
$products = Product::all();

// Query with conditions
$expensive = Product::where('price', '>', 500)->get();

// Use scopes
$inStock = Product::inStock()->get();

Update Records

$product = Product::find(1);
$product->price = 899.99;
$product->save();

// Or update directly
Product::where('id', 1)->update(['price' => 899.99]);

Delete Records

$product = Product::find(1);
$product->delete();

// Or delete directly
Product::where('price', '<', 10)->delete();

Source Code

The model generation logic:

rawr (lines 227-270)

function makeModel(string $basePath, ?string $name, bool $withMigration = false): void
{
    if ($name === null) {
        echo "Error: Model name required\n";
        exit(1);
    }

    $modelsPath = $basePath . '/App/Models';
    if (!is_dir($modelsPath)) {
        mkdir($modelsPath, 0755, true);
    }

    $modelPath = $modelsPath . '/' . $name . '.php';

    if (file_exists($modelPath)) {
        echo "Error: Model {$name} already exists\n";
        exit(1);
    }

    $tableName = strtolower(preg_replace('/(?<!^)[A-Z]/', '_', $name)) . 's';

    $content = <<<PHP
<?php

declare(strict_types=1);

namespace App\Models;

use Lyger\Database\Model as BaseModel;

class {$name} extends BaseModel
{
    protected string \$table = '{$tableName}';
    protected array \$fillable = [];
}
PHP;

    file_put_contents($modelPath, $content);
    echo "Model created: App/Models/{$name}.php\n";

    if ($withMigration) {
        makeMigration($basePath, 'create_' . $tableName . '_table');
    }
}

Workflow Example

php rawr make:model Order --migration

// App/Models/Order.php
protected array $fillable = [
    'user_id',
    'total',
    'status'
];

// database/migrations/..._create_orders_table.php
public function up(): void
{
    $this->getSchema()->create('orders', function ($table) {
        $table->id();
        $table->foreignId('user_id')->constrained();
        $table->decimal('total', 10, 2);
        $table->string('status')->default('pending');
        $table->timestamps();
    });
}

php rawr migrate

$order = Order::create([
    'user_id' => 1,
    'total' => 149.99,
    'status' => 'completed'
]);

Next Steps

Make Migration

Create database migrations

Eloquent ORM

Learn about the ORM features

Relationships

Define model relationships

Query Builder

Build complex queries

​Syntax

​Basic Usage

​With Migration

​Generated Model

​Table Name Convention

​Model Properties

​$table

​$fillable

​Naming Conventions

​Valid Names

​Invalid Names

​Error Handling

​Missing Name

​Duplicate Model

​Complete Example

​Common Patterns

​User Model

​Pivot Model

​Polymorphic Model

​Using Models

​Create Records

​Query Records

​Update Records

​Delete Records

​Source Code

​Workflow Example

​Next Steps

Make Migration

Eloquent ORM

Relationships

Query Builder

Syntax

Basic Usage

With Migration

Generated Model

Table Name Convention

Model Properties

$table

$fillable

Naming Conventions

Valid Names

Invalid Names

Error Handling

Missing Name

Duplicate Model

Complete Example

Common Patterns

User Model

Pivot Model

Polymorphic Model

Using Models

Create Records

Query Records

Update Records

Delete Records

Source Code

Workflow Example

Next Steps