Changeset 65182

Timestamp:

11/01/2026 07:19:44 PM (4 hours ago)

Author:

lancewillett

Message:

I18N: Correct the documented return type of translation entries.

Document WP_Translation_File::entries() as returning string values rather than arrays of strings. Remove the three PHPStan baseline suppressions resolved by this correction.

Developed in: ​https://github.com/WordPress/wordpress-develop/pull/15330

Props abcd95.

See #65817.

Location:

trunk

Files:

• src/wp-includes/l10n/class-wp-translation-file.php (modified) (1 diff)
• tests/phpstan/baselines/assign.propertyType.neon (modified) (1 diff)
• tests/phpstan/baselines/return.type.neon (modified) (1 diff)

trunk/src/wp-includes/l10n/class-wp-translation-file.php

@@ -159 +159 @@
          * @since 6.5.0
          *
-         * @return array<string, string[]> Entries.
+         * @return array<string, string> Entries.
          */
         public function entries(): array {

trunk/tests/phpstan/baselines/assign.propertyType.neon

@@ -105 +105 @@
                         path: ../../../src/wp-includes/customize/class-wp-customize-header-image-control.php
                 -
-                        message: '#^Property WP_Translation_File\:\:\$entries \(array\<string, string\>\) does not accept array\<string, array\<string\>\>\.$#'
-                        identifier: assign.propertyType
-                        count: 1
-                        path: ../../../src/wp-includes/l10n/class-wp-translation-file.php
-                -
                         message: '#^Property WP_REST_Autosaves_Controller\:\:\$revisions_controller \(WP_REST_Revisions_Controller\) does not accept WP_REST_Controller\.$#'
                         identifier: assign.propertyType

trunk/tests/phpstan/baselines/return.type.neon

@@ -70 +70 @@
                         path: ../../../src/wp-includes/fonts.php
                 -
-                        message: '#^Method WP_Translation_Controller\:\:get_entries\(\) should return array\<string, string\> but returns array\<string, array\<string\>\>\.$#'
-                        identifier: return.type
-                        count: 1
-                        path: ../../../src/wp-includes/l10n/class-wp-translation-controller.php
-                -
-                        message: '#^Method WP_Translation_File\:\:entries\(\) should return array\<string, array\<string\>\> but returns array\<string, string\>\.$#'
-                        identifier: return.type
-                        count: 1
-                        path: ../../../src/wp-includes/l10n/class-wp-translation-file.php
-                -
                         message: '#^Function update_meta_cache\(\) should return array\|false but returns bool\.$#'
                         identifier: return.type