vicgutt/laravel-models-finder

Find all models in your Laravel app or package

v0.1.1 2023-03-16 18:10 UTC

This package is auto-updated.

Last update: 2024-11-16 21:39:39 UTC


README

GitHub Tests Action Status GitHub PHPStan Action Status GitHub Code Style Action Status Latest Version on Packagist Total Downloads

This package allows you to find and retrieve all Laravel models in a given folder. A "model" is any class extending Illuminate\Database\Eloquent\Model.

Here's a quick example:

// On an app containing only the default Laravel "User" model, running:
$models = ModelsFinder::find()
    ->map(static fn (ModelData $model): array => [
        'path' => $model->path,
        'class' => $model->class,
    ])
    ->toArray();

// would return the following:
[
    [
        'path' => '/[...]/my-project/app/Models/User.php',
        'class' => '\App\Models\User',
    ],
]

Installation

You can install the package via composer:

composer require vicgutt/laravel-models-finder

Usage

You can initiate the discovery of models by using the find static method.

$models = ModelsFinder::find(
    directory: app_path('Models'),
    basePath: base_path(),
    baseNamespace: '',
);

This method accepts 3 optional arguments:

  • directory: The directory in which to recusively start searching for models. Defaults to app_path('Models').
  • basePath: The autoloaded entry directory of the project where the search will be initiated. Defaults to base_path().
  • baseNamespace: The autoloaded base namespace of the project where the search will be initiated. Defaults to ''.

The basePath & baseNamespace properties will most likely correspond to an autoloaded entry in a composer.json file. Example:

{
    "autoload": {
        "psr-4": {
            // Base namespace       |  Base path
            "Spatie\\MediaLibrary\\": "src"
        }
    }
}

Here's an example showcasing searching for a model in the vendor folder:

ModelsFinder::find(
    directory: base_path('vendor/spatie/laravel-medialibrary'),
    basePath: base_path('vendor/spatie/laravel-medialibrary/src'),
    baseNamespace: 'Spatie\MediaLibrary'
)->toArray(),

// would return the following:
[
    [
        'path' => '[...]/vendor/spatie/laravel-medialibrary/src/MediaCollections/Models/Media.php',
        'class' => 'Spatie\MediaLibrary\MediaCollections\Models\Media',
    ],
]

The return value of the method is a lazy collection (Illuminate\Support\LazyCollection).

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

If you're interested in contributing to the project, please read our contributing docs before submitting a pull request.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.