82 lines
2.4 KiB
ReStructuredText
82 lines
2.4 KiB
ReStructuredText
.. include:: /Includes.rst.txt
|
|
|
|
.. _deprecation-105297-1728836814:
|
|
|
|
============================================================================
|
|
Deprecation: #105297 - `tableoptions` and `collate` connection configuration
|
|
============================================================================
|
|
|
|
See :issue:`105297`
|
|
|
|
Description
|
|
===========
|
|
|
|
The possibility to configure default table options like charset and collation for the database
|
|
analyzer has been introduced using the array
|
|
:php:`$GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['tableoptions']` with
|
|
sub-array keys :php:`charset` and :php:`collate`. These were only used for MySQL and MariaDB
|
|
connections.
|
|
|
|
Since TYPO3 v11 the :php:`tableoptions` keys were silently migrated to
|
|
:php:`defaultTableOptions`, which is the proper Doctrine DBAL connection option for
|
|
for MariaDB and MySQL.
|
|
|
|
Furthermore, Doctrine DBAL 3.x switched from using they array key :php:`collate` to
|
|
:php:`collation`, ignoring the old array key with Doctrine DBAL 4.x. This was silently
|
|
migrated by TYPO3, too.
|
|
|
|
These options and migration are now deprecated in favor of using the final array
|
|
keys and will be removed with TYPO3 v15 (or later) as breaking change.
|
|
|
|
.. note::
|
|
|
|
When migrating, make sure to remove the old :php:`tableoptions` array key, otherwise
|
|
it will take precedence over setting the new :php:`defaultTableOptions` key in TYPO3 v13.
|
|
|
|
Impact
|
|
======
|
|
|
|
Instances using the database connection options in
|
|
:php:`$GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']['tableoptions']`
|
|
array, or using the :php:`collate` key will trigger a :php:`E_USER_DEPRECATED`
|
|
notification.
|
|
|
|
|
|
Affected installations
|
|
======================
|
|
|
|
All instances using the mentioned options.
|
|
|
|
Migration
|
|
=========
|
|
|
|
Review :php:`settings.php` and :php:`additional.php` and adapt the deprecated
|
|
configuration by renaming affected array keys.
|
|
|
|
.. code-block:: php
|
|
|
|
# before
|
|
'DB' => [
|
|
'Connections' => [
|
|
'Default' => [
|
|
'tableoptions' => [
|
|
'collate' => 'utf8mb4_unicode_ci',
|
|
],
|
|
],
|
|
],
|
|
],
|
|
|
|
# after
|
|
'DB' => [
|
|
'Connections' => [
|
|
'Default' => [
|
|
'defaultTableOptions' => [
|
|
'collation' => 'utf8mb4_unicode_ci',
|
|
],
|
|
],
|
|
],
|
|
],
|
|
|
|
|
|
.. index:: Database, LocalConfiguration, NotScanned, ext:core
|