|
@@ -138,50 +138,17 @@ $databases = [];
|
|
|
* request as needed. The fourth line creates a new database with a name of
|
|
|
* "extra".
|
|
|
*
|
|
|
- * You can optionally set prefixes for some or all database table names
|
|
|
- * by using the 'prefix' setting. If a prefix is specified, the table
|
|
|
- * name will be prepended with its value. Be sure to use valid database
|
|
|
- * characters only, usually alphanumeric and underscore. If no prefixes
|
|
|
- * are desired, leave it as an empty string ''.
|
|
|
+ * You can optionally set a prefix for all database table names by using the
|
|
|
+ * 'prefix' setting. If a prefix is specified, the table name will be prepended
|
|
|
+ * with its value. Be sure to use valid database characters only, usually
|
|
|
+ * alphanumeric and underscore. If no prefix is desired, do not set the 'prefix'
|
|
|
+ * key or set its value to an empty string ''.
|
|
|
*
|
|
|
- * To have all database names prefixed, set 'prefix' as a string:
|
|
|
+ * For example, to have all database table prefixed with 'main_', set:
|
|
|
* @code
|
|
|
* 'prefix' => 'main_',
|
|
|
* @endcode
|
|
|
*
|
|
|
- * Per-table prefixes are deprecated as of Drupal 8.2, and will be removed in
|
|
|
- * Drupal 9.0. After that, only a single prefix for all tables will be
|
|
|
- * supported.
|
|
|
- *
|
|
|
- * To provide prefixes for specific tables, set 'prefix' as an array.
|
|
|
- * The array's keys are the table names and the values are the prefixes.
|
|
|
- * The 'default' element is mandatory and holds the prefix for any tables
|
|
|
- * not specified elsewhere in the array. Example:
|
|
|
- * @code
|
|
|
- * 'prefix' => [
|
|
|
- * 'default' => 'main_',
|
|
|
- * 'users' => 'shared_',
|
|
|
- * 'sessions' => 'shared_',
|
|
|
- * 'role' => 'shared_',
|
|
|
- * 'authmap' => 'shared_',
|
|
|
- * ],
|
|
|
- * @endcode
|
|
|
- * You can also use a reference to a schema/database as a prefix. This may be
|
|
|
- * useful if your Drupal installation exists in a schema that is not the default
|
|
|
- * or you want to access several databases from the same code base at the same
|
|
|
- * time.
|
|
|
- * Example:
|
|
|
- * @code
|
|
|
- * 'prefix' => [
|
|
|
- * 'default' => 'main.',
|
|
|
- * 'users' => 'shared.',
|
|
|
- * 'sessions' => 'shared.',
|
|
|
- * 'role' => 'shared.',
|
|
|
- * 'authmap' => 'shared.',
|
|
|
- * ];
|
|
|
- * @endcode
|
|
|
- * NOTE: MySQL and SQLite's definition of a schema is a database.
|
|
|
- *
|
|
|
* Advanced users can add or override initial commands to execute when
|
|
|
* connecting to the database server, as well as PDO connection settings. For
|
|
|
* example, to enable MySQL SELECT queries to exceed the max_join_size system
|