web-chefs/laravel-app-spawn

Laravel custom application instance bootstrap creator. Used predominantly for doing Laravel specific testing.

LaraAppSpawn

![Software License][ico-license] , _(*1)

Laravel Custom Application Spawner is primarily used for creating a Application instance in a unit testing environment, allowing you to interact with Laravel in your tests., _(*2)

By default it will use a SQLite in memory database, allowing you to run migrations and use a fully functional database during your tests., _(*3)

It is up to you to migration and seed this test database., _(*4)

Install

Via Composer, _(*5)

``` bash $ composer require web-chefs/laravel-app-spawn --dev, <sub>(*6)</sub>

## Basic usage example

```php

use Illuminate\Foundation\Testing\TestCase;
use WebChefs\LaraAppSpawn\ApplicationResolver;

class MyTest extends TestCase
{
    /**
     * Creates the application.
     *
     * @return \Illuminate\Foundation\Application
     */
    public function createApplication()
    {
        // Root of my app, used as a fallback for location of /database when
        // database.path in config is null.
        $appRoutePath = __DIR__;

        // Resolve Application
        $resolver  = ApplicationResolver::makeApp($appRoutePath);
        $this->app = $resolver->app();

        // Run our database migrations if required
        $this->artisan('migrate:refresh', [ '--force' => 1 ]);

        return $this->app;
    }

}

Example with custom configs

use Illuminate\Support\Arr;
use Illuminate\Foundation\Testing\TestCase;
use WebChefs\LaraAppSpawn\ApplicationResolver;

class MyTest extends TestCase
{
    /**
     * Creates the application.
     *
     * @return \Illuminate\Foundation\Application
     */
    public function createApplication()
    {
        // Root of my app, used as a fallback for location of /database when
        // database.path in config is null.
        $appRoutePath = __DIR__;

        // Build Resolver config
        $config = ApplicationResolver::defaultConfig();
        Arr::set($config, 'database.connection', $this->connectionName);
        Arr::set($config, 'queue.connection', $this->connectionName);

        // Resolve Application
        $resolver  = ApplicationResolver::makeApp($appRoutePath, $config);
        $this->app = $resolver->app();

        // Run our database migrations if required
        $this->artisan('migrate:refresh', [ '--force' => 1 ]);

        return $this->app;
    }

}

TravisCI

This was originally developed for WebChefs\QueueButler and for testing multiple version of Laravel using the same tests., <sub>(*7)</sub>

To see how that is possible see WebChefs\QueueButler .travis.yml., <sub>(*8)</sub>

Contributing

All code submissions will only be evaluated and accepted as pull-requests. If you have any questions or find any bugs please feel free to open an issue., <sub>(*9)</sub>

Credits

• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*10)</sub>