[5.8] Database Connection URLs

[ahinkle]

PR adds note about the url option within the connection configuration.

laravel/framework#28308

[mathieutu]

Thanks for this! As I'm not a really good english speaker, I was afraid of doing it... 😅

I've added some explanations, and let you correct them if needed.

[mathieutu]

Maybe should we add more explanations, and some examples?

Suggested change

	Scheme:
	DATABASE_URL=driver://username:password@host:port/database?options
	Examples:
	DATABASE_URL=sqlite:///path/to/database.sqlite
	DATABASE_URL=sqlite:///:memory:
	DATABASE_URL=mysql://forge:@localhost/forge?charset=UTF-8
	All the non null parts of the url will overwrite the standard config keys.
	As an example, this config:
	[
	'url' => 'mysql://root:pass@db/local',
	'driver' => 'mysql',
	'host' => '127.0.0.1',
	'port' => '3306',
	'database' => 'forge',
	'username' => 'forge',
	'password' => '',
	'charset' => 'utf8mb4',
	'collation' => 'utf8mb4_unicode_ci',
	'strict' => true,
	'options' => ['foo' => 'bar'],
	]
	Will be read as:
	[
	'driver' => 'mysql',
	'host' => 'db',
	'port' => '3306',
	'database' => 'local',
	'username' => 'root',
	'password' => 'pass',
	'charset' => 'utf8mb4',
	'collation' => 'utf8mb4_unicode_ci',
	'strict' => true,
	'options' => ['foo' => 'bar'],
	]

[mathieutu]

Suggested change

	Using Heroku or another "cloud" database provider, you may need to specify the database connection URL. The `url` option is an *optional* value that can be used to specify the URL of your database connection. You can configure the database connection URL by setting the `DATABASE_URL` value within your `.env` environment file.
	Using Heroku or another "cloud" database provider, you may need to specify the database connection URL. The `url` option is an *optional* value that can be used to specify the URL of your database connection. You can configure the database connection URL by setting the `DATABASE_URL` value within your `.env` environment file or in your system environment.

[taylorotwell]

I don't think this makes a lot of sense nested under "Read / Write" connections since it has nothing to do with that. Also I think an example as suggested could be useful.

[taylorotwell]

I massaged it a bit and moved it.