文件管理器

编辑：class-wp-textdomain-registry.php

<?php
/**
 * Locale API: WP_Textdomain_Registry class.
 *
 * This file uses rtrim() instead of untrailingslashit() and trailingslashit()
 * to avoid formatting.php dependency.
 *
 * @package WordPress
 * @subpackage i18n
 * @since 6.1.0
 */

/**
 * Core class used for registering text domains.
 *
 * @since 6.1.0
 */
#[AllowDynamicProperties]
class WP_Textdomain_Registry {
	/**
	 * List of domains and all their language directory paths for each locale.
	 *
	 * @since 6.1.0
	 *
	 * @var array
	 */
	protected $all = array();

/**
	 * List of domains and their language directory path for the current (most recent) locale.
	 *
	 * @since 6.1.0
	 *
	 * @var array
	 */
	protected $current = array();

/**
	 * List of domains and their custom language directory paths.
	 *
	 * @see load_plugin_textdomain()
	 * @see load_theme_textdomain()
	 *
	 * @since 6.1.0
	 *
	 * @var array
	 */
	protected $custom_paths = array();

/**
	 * Holds a cached list of available .mo files to improve performance.
	 *
	 * @since 6.1.0
	 * @since 6.5.0 This property is no longer used.
	 *
	 * @var array
	 *
	 * @deprecated
	 */
	protected $cached_mo_files = array();

/**
	 * Holds a cached list of domains with translations to improve performance.
	 *
	 * @since 6.2.0
	 *
	 * @var string[]
	 */
	protected $domains_with_translations = array();

/**
	 * Initializes the registry.
	 *
	 * Hooks into the {@see 'upgrader_process_complete'} filter
	 * to invalidate MO files caches.
	 *
	 * @since 6.5.0
	 */
	public function init() {
		add_action( 'upgrader_process_complete', array( $this, 'invalidate_mo_files_cache' ), 10, 2 );
	}

/**
	 * Returns the languages directory path for a specific domain and locale.
	 *
	 * @since 6.1.0
	 *
	 * @param string $domain Text domain.
	 * @param string $locale Locale.
	 *
	 * @return string|false Languages directory path or false if there is none available.
	 */
	public function get( $domain, $locale ) {
		$path = $this->all[ $domain ][ $locale ] ?? $this->get_path_from_lang_dir( $domain, $locale );

/**
		 * Filters the determined languages directory path for a specific domain and locale.
		 *
		 * @since 6.6.0
		 *
		 * @param string|false $path   Languages directory path for the given domain and locale.
		 * @param string       $domain Text domain.
		 * @param string       $locale Locale.
		 */
		return apply_filters( 'lang_dir_for_domain', $path, $domain, $locale );
	}

/**
	 * Determines whether any MO file paths are available for the domain.
	 *
	 * This is the case if a path has been set for the current locale,
	 * or if there is no information stored yet, in which case
	 * {@see _load_textdomain_just_in_time()} will fetch the information first.
	 *
	 * @since 6.1.0
	 *
	 * @param string $domain Text domain.
	 * @return bool Whether any MO file paths are available for the domain.
	 */
	public function has( $domain ) {
		return (
			isset( $this->current[ $domain ] ) ||
			empty( $this->all[ $domain ] ) ||
			in_array( $domain, $this->domains_with_translations, true )
		);
	}

/**
	 * Sets the language directory path for a specific domain and locale.
	 *
	 * Also sets the 'current' property for direct access
	 * to the path for the current (most recent) locale.
	 *
	 * @since 6.1.0
	 *
	 * @param string       $domain Text domain.
	 * @param string       $locale Locale.
	 * @param string|false $path   Language directory path or false if there is none available.
	 */
	public function set( $domain, $locale, $path ) {
		$this->all[ $domain ][ $locale ] = $path ? rtrim( $path, '/' ) . '/' : false;
		$this->current[ $domain ]        = $this->all[ $domain ][ $locale ];
	}

/**
	 * Sets the custom path to the plugin's/theme's languages directory.
	 *
	 * Used by {@see load_plugin_textdomain()} and {@see load_theme_textdomain()}.
	 *
	 * @since 6.1.0
	 *
	 * @param string $domain Text domain.
	 * @param string $path   Language directory path.
	 */
	public function set_custom_path( $domain, $path ) {
		// If just-in-time loading was triggered before, reset the entry so it can be tried again.

if ( isset( $this->all[ $domain ] ) ) {
			$this->all[ $domain ] = array_filter( $this->all[ $domain ] );
		}

if ( empty( $this->current[ $domain ] ) ) {
			unset( $this->current[ $domain ] );
		}

$this->custom_paths[ $domain ] = rtrim( $path, '/' );
	}

/**
	 * Retrieves translation files from the specified path.
	 *
	 * Allows early retrieval through the {@see 'pre_get_mo_files_from_path'} filter to optimize
	 * performance, especially in directories with many files.
	 *
	 * @since 6.5.0
	 *
	 * @param string $path The directory path to search for translation files.
	 * @return array Array of translation file paths. Can contain .mo and .l10n.php files.
	 */
	public function get_language_files_from_path( $path ) {
		$path = rtrim( $path, '/' ) . '/';

/**
		 * Filters the translation files retrieved from a specified path before the actual lookup.
		 *
		 * Returning a non-null value from the filter will effectively short-circuit
		 * the MO files lookup, returning that value instead.
		 *
		 * This can be useful in situations where the directory contains a large number of files
		 * and the default glob() function becomes expensive in terms of performance.
		 *
		 * @since 6.5.0
		 *
		 * @param null|array $files List of translation files. Default null.
		 * @param string     $path  The path from which translation files are being fetched.
		 */
		$files = apply_filters( 'pre_get_language_files_from_path', null, $path );

if ( null !== $files ) {
			return $files;
		}

$cache_key = md5( $path );
		$files     = wp_cache_get( $cache_key, 'translation_files' );

if ( false === $files ) {
			$files = glob( $path . '*.mo' );
			if ( false === $files ) {
				$files = array();
			}

$php_files = glob( $path . '*.l10n.php' );
			if ( is_array( $php_files ) ) {
				$files = array_merge( $files, $php_files );
			}

wp_cache_set( $cache_key, $files, 'translation_files', HOUR_IN_SECONDS );
		}

return $files;
	}

/**
	 * Invalidate the cache for .mo files.
	 *
	 * This function deletes the cache entries related to .mo files when triggered
	 * by specific actions, such as the completion of an upgrade process.
	 *
	 * @since 6.5.0
	 *
	 * @param WP_Upgrader $upgrader   Unused. WP_Upgrader instance. In other contexts this might be a
	 *                                Theme_Upgrader, Plugin_Upgrader, Core_Upgrade, or Language_Pack_Upgrader instance.
	 * @param array       $hook_extra {
	 *     Array of bulk item update data.
	 *
	 *     @type string $action       Type of action. Default 'update'.
	 *     @type string $type         Type of update process. Accepts 'plugin', 'theme', 'translation', or 'core'.
	 *     @type bool   $bulk         Whether the update process is a bulk update. Default true.
	 *     @type array  $plugins      Array of the basename paths of the plugins' main files.
	 *     @type array  $themes       The theme slugs.
	 *     @type array  $translations {
	 *         Array of translations update data.
	 *
	 *         @type string $language The locale the translation is for.
	 *         @type string $type     Type of translation. Accepts 'plugin', 'theme', or 'core'.
	 *         @type string $slug     Text domain the translation is for. The slug of a theme/plugin or
	 *                                'default' for core translations.
	 *         @type string $version  The version of a theme, plugin, or core.
	 *     }
	 * }
	 */
	public function invalidate_mo_files_cache( $upgrader, $hook_extra ) {
		if (
			! isset( $hook_extra['type'] ) ||
			'translation' !== $hook_extra['type'] ||
			array() === $hook_extra['translations']
		) {
			return;
		}

$translation_types = array_unique( wp_list_pluck( $hook_extra['translations'], 'type' ) );

foreach ( $translation_types as $type ) {
			switch ( $type ) {
				case 'plugin':
					wp_cache_delete( md5( WP_LANG_DIR . '/plugins/' ), 'translation_files' );
					break;
				case 'theme':
					wp_cache_delete( md5( WP_LANG_DIR . '/themes/' ), 'translation_files' );
					break;
				default:
					wp_cache_delete( md5( WP_LANG_DIR . '/' ), 'translation_files' );
					break;
			}
		}
	}

/**
	 * Returns possible language directory paths for a given text domain.
	 *
	 * @since 6.2.0
	 *
	 * @param string $domain Text domain.
	 * @return string[] Array of language directory paths.
	 */
	private function get_paths_for_domain( $domain ) {
		$locations = array(
			WP_LANG_DIR . '/plugins',
			WP_LANG_DIR . '/themes',
		);

if ( isset( $this->custom_paths[ $domain ] ) ) {
			$locations[] = $this->custom_paths[ $domain ];
		}

return $locations;
	}

/**
	 * Gets the path to the language directory for the current domain and locale.
	 *
	 * Checks the plugins and themes language directories as well as any
	 * custom directory set via {@see load_plugin_textdomain()} or {@see load_theme_textdomain()}.
	 *
	 * @since 6.1.0
	 *
	 * @see _get_path_to_translation_from_lang_dir()
	 *
	 * @param string $domain Text domain.
	 * @param string $locale Locale.
	 * @return string|false Language directory path or false if there is none available.
	 */
	private function get_path_from_lang_dir( $domain, $locale ) {
		$locations = $this->get_paths_for_domain( $domain );

$found_location = false;

foreach ( $locations as $location ) {
			$files = $this->get_language_files_from_path( $location );

$mo_path  = "$location/$domain-$locale.mo";
			$php_path = "$location/$domain-$locale.l10n.php";

foreach ( $files as $file_path ) {
				if (
					! in_array( $domain, $this->domains_with_translations, true ) &&
					str_starts_with( str_replace( "$location/", '', $file_path ), "$domain-" )
				) {
					$this->domains_with_translations[] = $domain;
				}

if ( $file_path === $mo_path || $file_path === $php_path ) {
					$found_location = rtrim( $location, '/' ) . '/';
					break 2;
				}
			}
		}

if ( $found_location ) {
			$this->set( $domain, $locale, $found_location );

return $found_location;
		}

/*
		 * If no path is found for the given locale and a custom path has been set
		 * using load_plugin_textdomain/load_theme_textdomain, use that one.
		 */
		if ( isset( $this->custom_paths[ $domain ] ) ) {
			$fallback_location = rtrim( $this->custom_paths[ $domain ], '/' ) . '/';
			$this->set( $domain, $locale, $fallback_location );
			return $fallback_location;
		}

$this->set( $domain, $locale, false );

return false;
	}
}

名称	权限	大小	修改时间	操作
↑ 返回上级	-	-	-	-
ID3	drwxr-xr-x	-	2024-04-03 10:16	删除
IXR	drwxr-xr-x	-	2026-04-17 05:01	删除
PHPMailer	drwxr-xr-x	-	2025-12-08 18:52	删除
Requests	drwxr-xr-x	-	2023-03-30 09:26	删除
SimplePie	drwxr-xr-x	-	2026-04-17 16:44	删除
Text	drwxr-xr-x	-	2024-11-13 13:00	删除
abilities-api	drwxr-xr-x	-	2026-04-17 16:32	删除
assets	drwxr-xr-x	-	2024-11-13 13:01	删除
block-bindings	drwxr-xr-x	-	2025-12-04 05:41	删除
block-patterns	drwxr-xr-x	-	2024-12-19 23:58	删除
block-supports	drwxr-xr-x	-	2025-12-04 05:41	删除
blocks	drwxr-xr-x	-	2025-12-04 05:41	删除
certificates	drwxr-xr-x	-	2022-11-15 19:03	删除
css	drwxr-xr-x	-	2025-04-16 11:06	删除
customize	drwxr-xr-x	-	2024-11-20 16:49	删除
fonts	drwxr-xr-x	-	2024-04-03 10:16	删除
html-api	drwxr-xr-x	-	2024-12-20 00:03	删除
images	drwxr-xr-x	-	2023-08-09 11:43	删除
interactivity-api	drwxr-xr-x	-	2024-12-20 00:12	删除
js	drwxr-xr-x	-	2025-12-04 05:42	删除
l10n	drwxr-xr-x	-	2024-12-20 00:12	删除
php-compat	drwxr-xr-x	-	2022-11-15 19:03	删除
pomo	drwxr-xr-x	-	2022-11-15 19:03	删除
rest-api	drwxr-xr-x	-	2024-11-20 16:51	删除
sitemaps	drwxr-xr-x	-	2022-11-15 19:03	删除
sodium_compat	drwxr-xr-x	-	2022-11-15 19:03	删除
style-engine	drwxr-xr-x	-	2022-11-15 19:03	删除
theme-compat	drwxr-xr-x	-	2025-12-08 18:51	删除
widgets	drwxr-xr-x	-	2023-06-26 16:12	删除
block-i18n.json	-rw-r--r--	316 B	2021-08-11 09:08	编辑下载删除
bookmark-template.php	-rw-r--r--	12.47 KB	2025-04-16 11:06	编辑下载删除
canonical.php	-rw-r--r--	33.83 KB	2025-12-04 05:41	编辑下载删除
class-smtp.php	-rw-r--r--	457 B	2021-01-26 13:45	编辑下载删除
class-walker-category-dropdown.php	-rw-r--r--	2.41 KB	2023-11-08 10:55	编辑下载删除
class-walker-category.php	-rw-r--r--	8.28 KB	2023-11-08 10:55	编辑下载删除
class-wp-ajax-response.php	-rw-r--r--	5.14 KB	2022-09-12 15:47	编辑下载删除
class-wp-block-bindings-registry.php	-rw-r--r--	8.28 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-bindings-source.php	-rw-r--r--	2.92 KB	2024-11-13 13:01	编辑下载删除
class-wp-block-editor-context.php	-rw-r--r--	1.32 KB	2022-09-12 15:47	编辑下载删除
class-wp-block-list.php	-rw-r--r--	4.6 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-metadata-registry.php	-rw-r--r--	11.62 KB	2025-04-16 11:06	编辑下载删除
class-wp-block-parser-block.php	-rw-r--r--	2.5 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-parser-frame.php	-rw-r--r--	1.97 KB	2024-11-13 13:00	编辑下载删除
class-wp-block-pattern-categories-registry.php	-rw-r--r--	5.32 KB	2025-12-04 05:42	编辑下载删除
class-wp-block-patterns-registry.php	-rw-r--r--	10.99 KB	2026-03-11 06:39	编辑下载删除
class-wp-block-styles-registry.php	-rw-r--r--	6.34 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-templates-registry.php	-rw-r--r--	7.02 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-type-registry.php	-rw-r--r--	4.91 KB	2025-12-04 05:41	编辑下载删除
class-wp-block-type.php	-rw-r--r--	16.86 KB	2024-07-17 11:51	编辑下载删除
class-wp-classic-to-block-menu-converter.php	-rw-r--r--	3.97 KB	2025-12-04 05:41	编辑下载删除
class-wp-customize-control.php	-rw-r--r--	25.51 KB	2025-12-04 05:41	编辑下载删除
class-wp-customize-nav-menus.php	-rw-r--r--	56.65 KB	2025-12-04 05:42	编辑下载删除
class-wp-duotone.php	-rw-r--r--	39.83 KB	2024-07-17 11:51	编辑下载删除
class-wp-fatal-error-handler.php	-rw-r--r--	7.96 KB	2024-11-13 13:00	编辑下载删除
class-wp-feed-cache-transient.php	-rw-r--r--	3.23 KB	2025-12-04 05:41	编辑下载删除
class-wp-http-ixr-client.php	-rw-r--r--	3.42 KB	2026-03-11 06:39	编辑下载删除
class-wp-http-requests-hooks.php	-rw-r--r--	1.97 KB	2023-03-30 09:26	编辑下载删除
class-wp-http-requests-response.php	-rw-r--r--	4.3 KB	2023-11-08 10:55	编辑下载删除
class-wp-http-streams.php	-rw-r--r--	16.46 KB	2023-11-08 10:55	编辑下载删除
class-wp-image-editor-gd.php	-rw-r--r--	20.22 KB	2025-12-04 05:41	编辑下载删除
class-wp-image-editor-imagick.php	-rw-r--r--	36.11 KB	2025-12-04 05:41	编辑下载删除
class-wp-list-util.php	-rw-r--r--	7.27 KB	2023-11-08 10:55	编辑下载删除
class-wp-locale-switcher.php	-rw-r--r--	6.62 KB	2025-12-04 05:41	编辑下载删除
class-wp-paused-extensions-storage.php	-rw-r--r--	4.99 KB	2024-11-13 13:00	编辑下载删除
class-wp-plugin-dependencies.php	-rw-r--r--	24.72 KB	2025-04-16 11:06	编辑下载删除
class-wp-post-type.php	-rw-r--r--	29.96 KB	2025-04-16 11:06	编辑下载删除
class-wp-post.php	-rw-r--r--	6.34 KB	2025-12-04 05:42	编辑下载删除
class-wp-recovery-mode-cookie-service.php	-rw-r--r--	6.72 KB	2022-10-04 03:59	编辑下载删除
class-wp-recovery-mode-email-service.php	-rw-r--r--	10.92 KB	2023-08-09 11:43	编辑下载删除
class-wp-recovery-mode-key-service.php	-rw-r--r--	4.77 KB	2025-04-16 11:06	编辑下载删除
class-wp-recovery-mode-link-service.php	-rw-r--r--	3.38 KB	2022-09-12 15:47	编辑下载删除
class-wp-recovery-mode.php	-rw-r--r--	11.18 KB	2025-04-16 11:06	编辑下载删除
class-wp-simplepie-file.php	-rw-r--r--	3.47 KB	2025-12-04 05:42	编辑下载删除
class-wp-simplepie-sanitize-kses.php	-rw-r--r--	1.87 KB	2025-04-16 11:06	编辑下载删除
class-wp-tax-query.php	-rw-r--r--	19.12 KB	2025-12-04 05:41	编辑下载删除
class-wp-text-diff-renderer-inline.php	-rw-r--r--	979 B	2024-04-03 10:16	编辑下载删除
class-wp-text-diff-renderer-table.php	-rw-r--r--	18.44 KB	2025-04-16 11:06	编辑下载删除
class-wp-textdomain-registry.php	-rw-r--r--	10.24 KB	2024-11-22 11:55	编辑下载删除
class-wp-theme-json-data.php	-rw-r--r--	1.77 KB	2024-07-17 11:51	编辑下载删除
class-wp-theme-json-resolver.php	-rw-r--r--	34.9 KB	2025-04-16 11:06	编辑下载删除
class-wp-theme-json-schema.php	-rw-r--r--	7.19 KB	2024-07-17 11:51	编辑下载删除
class-wp-url-pattern-prefixer.php	-rw-r--r--	4.69 KB	2025-04-16 11:06	编辑下载删除
class-wp-user-meta-session-tokens.php	-rw-r--r--	2.94 KB	2025-12-04 05:42	编辑下载删除
class-wp.php	-rw-r--r--	25.86 KB	2025-12-04 05:41	编辑下载删除
compat.php	-rw-r--r--	17.41 KB	2025-12-04 05:41	编辑下载删除
default-constants.php	-rw-r--r--	11.1 KB	2024-11-13 13:00	编辑下载删除
default-filters.php	-rw-r--r--	37.02 KB	2025-12-04 05:41	编辑下载删除
feed-rdf.php	-rw-r--r--	2.61 KB	2020-01-29 00:45	编辑下载删除
global-styles-and-settings.php	-rw-r--r--	20.71 KB	2025-12-04 05:41	编辑下载删除
http.php	-rw-r--r--	25.27 KB	2025-12-04 05:41	编辑下载删除
link-template.php	-rw-r--r--	156.36 KB	2025-12-04 05:42	编辑下载删除
media-template.php	-rw-r--r--	61.72 KB	2025-12-04 05:42	编辑下载删除
ms-default-filters.php	-rw-r--r--	6.48 KB	2023-03-30 09:26	编辑下载删除
ms-site.php	-rw-r--r--	40.74 KB	2025-12-04 05:41	编辑下载删除
robots-template.php	-rw-r--r--	5.06 KB	2022-04-06 15:33	编辑下载删除
theme-i18n.json	-rw-r--r--	1.69 KB	2026-02-27 10:54	编辑下载删除
theme-templates.php	-rw-r--r--	6.09 KB	2025-04-16 11:06	编辑下载删除
vars.php	-rw-r--r--	6.41 KB	2025-04-16 11:06	编辑下载删除