From a5513f5cd2f36bbcfd66499bac039e84b2b74ee9 Mon Sep 17 00:00:00 2001 From: Ben Johnson Date: Fri, 11 Dec 2020 09:38:41 -0500 Subject: [PATCH] Add PostgreSQL changes to Upgrade Guide --- upgrade.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/upgrade.md b/upgrade.md index d5575677894..47636a217f8 100644 --- a/upgrade.md +++ b/upgrade.md @@ -127,6 +127,17 @@ Next, in your `composer.json` file, remove `classmap` block from the `autoload` } }, + +#### PostgreSQL Configuration Changes + +**Likelihood Of Impact: Low** + +In previous Laravel versions, the term "schema" (a single schema) was used when "search path" (a list of schemas) was intended. Accordingly, variable names, comments, and configuration directives were updated to correct the terminology and intent. + +This change will not affect most users, however, the `schema` configuration key on PostgreSQL database connections has been renamed to `search_path`, so if you are not using the default `pgsql` connection, exclusively, you will need to update your database configuration(s) accordingly. + +Finally, you may now specify a `search_path` that contains more than one schema in your `.env` file using a comma-separated string, e.g., `DB_SEARCH_PATH='"$user", "laravel"'`. (In previous Laravel versions, this was possible only by adding parsing logic to the array in your configuration file.) + ### Eloquent