Improve the documentation and check in DB_CONNECTON in laravelPostSta…

…rtAction additionally to DB_HOST

docs/users/cli-usage.md

@@ -303,6 +303,7 @@ Note that Magento 2 is a huge codebase and using `nfs_mount_enabled: true` is re
 ### Laravel Quickstart
 
 Get started with Laravel projects on ddev either using a new or existing composer project or by cloning a git repository.
+The Laravel project type can be used for Lumen same as for Laravel.
 
 #### Laravel Composer Setup Example
 
@@ -326,8 +327,54 @@ git clone https://github.com/example/example-site
 cd example-site
 ddev config --project-type=laravel
 ddev composer install
+ddev exec "cat .env.example | sed  -E 's/DB_(HOST|DATABASE|USERNAME|PASSWORD)=(.*)/DB_\1=db/g' > .env"
+ddev exec "php artisan key:generate"
+ddev launch
+```
+
+#### Laravel Database connection
+
+In the examples above we used a one liner to copy `.env.example` as `env`and set the `DB_HOST`, `DB_DATABASE`, `DB_USERNAME` and `DB_PASSWORD` environment variables to the value of `db`.
+These values are DDEV's default settings for the Database connection.
+
+Instead of setting each connection variable we can add a ddev to the `connections` array in `config/databases.php` like this:
+
+```
+<?php
+
+return [
+
+    ...
+
+    'connections' => [
+
+        ...
+
+        'ddev' => [
+            'driver' => 'mysql',
+            'host' => 'db',
+            'port' => 3306,
+            'database' => 'db',
+            'username' => 'db',
+            'password' => 'db',
+            'unix_socket' => '',
+            'charset' => 'utf8mb4',
+            'collation' => 'utf8mb4_unicode_ci',
+            'prefix' => '',
+            'strict' => true,
+            'engine' => null,
+        ],
+
+    ],
+
+  ...
+
+];
 ```
 
+This way we only need to change the value of `DB_CONNECTION` to `ddev` in the `.env` to work with the `db` service.
+This is very handy if you have a local database installed and you want to switch between the connections faster by changing only one variable in `.env`
+
 ### Database Imports
 
 Import a database with just one command; We offer support for several file formats, including: **.sql, sql.gz, mysql, mysql.gz, tar, tar.gz, and zip**.

pkg/ddevapp/laravel.go

@@ -28,12 +28,14 @@ func envSettingsWarning(status int) {
 	util.Warning(message)
 	util.Warning("You can do it with this one-liner:")
 	util.Warning("ddev exec \"cat %v | sed  -E 's/DB_(HOST|DATABASE|USERNAME|PASSWORD)=(.*)/DB_\\1=db/g' > .env\"", srcFile)
+	util.Warning("Read more on https://ddev.readthedocs.io/en/stable/users/cli-usage/#laravel-quickstart")
 }
 
 func laravelPostStartAction(app *DdevApp) error {
 	if fileutil.FileExists(filepath.Join(app.AppRoot, ".env")) {
-		isConfigured, err := fileutil.FgrepStringInFile(app.SiteSettingsPath, `DB_HOST=db`)
-		if err == nil && !isConfigured {
+		isConfiguredDbHost, err := fileutil.FgrepStringInFile(app.SiteSettingsPath, `DB_HOST=db`)
+		isConfiguredDbConnection, _ := fileutil.FgrepStringInFile(app.SiteSettingsPath, `DB_CONNECTION=ddev`)
+		if err == nil && !isConfiguredDbHost && !isConfiguredDbConnection {
 			envSettingsWarning(WarnTypeNotConfigured)
 		}
 	} else {