deprecate: Déprécier l’usage des fichiers de langue peuplant une variable globale.

Refs: spip-galaxie/trad.spip.net#6 #5490

CHANGELOG.md

@@ -25,6 +25,7 @@
 
 ### Deprecated
 
+- Fichiers de langue peuplant une variable globale. Retourner directement un array (valide à partir de SPIP 4.1)
 - Filtre/fonction `abs_url`. Utiliser `url_absolue` ou `liens_absolus` selon.
 - Dans les fonctions `extraire_idiome` et `extraire_multi`, le 3è paramètre `$options` de type `bool` est déprécié. Utiliser un array `['echappe_span' => true]`
 - #5552 Constantes `_COOKIE_SECURE` et `_COOKIE_SECURE_LIST` (utiliser les options `secure` et/ou `httponly` de `spip_setcookie`)

UPGRADE_5.0.md

@@ -62,6 +62,40 @@ a[href] { background-image: url("#CHEMIN_IMAGE{img.svg}"); }
 
 # Nouvelles dépréciations
 
+## Gestion des traductions
+
+### Fichiers de langue avec `$GLOBALS` (déprécié en 5.0)
+
+Les fichiers de langue peuplant une variable globale sont dépréciés.
+Retourner directement le tableau PHP.
+Note: Cette syntaxe est valide à partir de SPIP 4.1
+
+#### avant
+
+
+```php
+<?php
+if (!defined('_ECRIRE_INC_VERSION')) {
+	return;
+}
+
+$GLOBALS[$GLOBALS['idx_lang']] = array(
+	'mots_description' => 'Mots et Groupes de mots',
+	'mots_slogan' => 'Gestion des mots et groupes de mots dans SPIP'
+);
+```
+
+#### Après
+
+```php
+<?php
+return [
+	'mots_description' => 'Mots et Groupes de mots',
+	'mots_slogan' => 'Gestion des mots et groupes de mots dans SPIP'
+];
+```
+
+
 Les éléments suivants sont dépréciés et seront supprimés dans une future version.
 
 ## Syntaxes de squelettes

ecrire/inc/traduire.php

@@ -149,6 +149,7 @@ function lire_fichier_langue(string $fichier): array {
 	$GLOBALS['idx_lang'] = $idx_lang_before;
 	if (!is_array($idx_lang)) {
 		if (isset($GLOBALS[$idx_lang_tmp]) && is_array($GLOBALS[$idx_lang_tmp])) {
+			trigger_deprecation('spip', '5.0', sprintf('Lang file "%s" populating a GLOBALS is deprecated. Return an array instead.', $fichier));
 			$idx_lang = $GLOBALS[$idx_lang_tmp];
 		} else {
 			$idx_lang = [];