Database

Description: Injects a named database connection instance. Similar to #[DB] but also accepts enum values.

Namespace: Illuminate\Container\Attributes\Database

Added in: Laravel 11.20

Usage

use Illuminate\Support\Facades\DB;
use Illuminate\Database\Connection;

// Before (service provider):
$this->app->when(ReportService::class)
    ->needs(Connection::class)
    ->give(fn () => DB::connection('pgsql'));

use Illuminate\Container\Attributes\Database;
use Illuminate\Database\Connection;

// After:
class ReportService
{
    public function __construct(
        #[Database('pgsql')] private readonly Connection $connection
    ) {}
}

Enum values are also supported:

use App\Enums\DatabaseConnection;
use Illuminate\Database\Connection;

class ReportService
{
    public function __construct(
        #[Database(DatabaseConnection::Pgsql)] private readonly Connection $connection
    ) {}
}

---