Add support for naming additional database connections

[JanneDeVos]

This pull request introduces the ability to name multiple database connections, improving the developer experience when working with multiple databases. By providing meaningful names for each connection, it becomes more intuitive to switch between different databases.

This feature adds an abstraction layer that decouples the database implementation from your code by allowing you to define multiple named connections in the database configuration:

/*
|--------------------------------------------------------------------------
| Default Database Connection Name
|--------------------------------------------------------------------------
|
| Here you may specify which of the database connections below you wish
| to use as your default connection for database operations. This is
| the connection which will be utilized unless another connection
| is explicitly specified when you execute a query / statement.
|
*/

'default' => env('DB_CONNECTION', 'sqlite'),
'other' => env('DB_CONNECTION_OTHER', 'mysql'),

Models can then specify which connection to use via the $connection property:

class Order extends Model
{
    protected $connection = 'other'; // Equals to mysql

Or you can use the connection directly in queries:

$orders = DB::connection('other')->table('orders')->get();

[github-actions]

Thanks for submitting a PR!

Note that draft PR's are not reviewed. If you would like a review, please mark your pull request as ready for review in the GitHub user interface.

Pull requests that are abandoned in draft may be closed due to inactivity.

[shaedrich]

What's wrong with naming additional connections under database.connections?

https://github.com/laravel/laravel/blob/f9bedb320cac1c77d78052c1355ea37709cd464b/config/database.php#L32-L113

There is already is a $connection property that can take connection names:

framework/src/Illuminate/Database/Eloquent/Model.php

Lines 44 to 49 in 61492a8

	/**
	* The connection name for the model.
	*
	* @var string|null
	*/
	protected $connection;