Na}{

Path: ~/home/getwphos/public_html/sdp/wp-includes/

File Content: `class-wp-block-metadata-registry.php`

<?php
/**
 * Block Metadata Registry
 *
 * @package WordPress
 * @subpackage Blocks
 * @since 6.7.0
 */

/**
 * Class used for managing block metadata collections.
 *
 * The WP_Block_Metadata_Registry allows plugins to register metadata for large
 * collections of blocks (e.g., 50-100+) using a single PHP file. This approach
 * reduces the need to read and decode multiple `block.json` files, enhancing
 * performance through opcode caching.
 *
 * @since 6.7.0
 */
class WP_Block_Metadata_Registry {

	/**
	 * Container for storing block metadata collections.
	 *
	 * Each entry maps a base path to its corresponding metadata and callback.
	 *
	 * @since 6.7.0
	 * @var array<string, array<string, mixed>>
	 */
	private static $collections = array();

	/**
	 * Caches the last matched collection path for performance optimization.
	 *
	 * @since 6.7.0
	 * @var string|null
	 */
	private static $last_matched_collection = null;

	/**
	 * Stores the default allowed collection root paths.
	 *
	 * @since 6.7.2
	 * @var string[]|null
	 */
	private static $default_collection_roots = null;

	/**
	 * Registers a block metadata collection.
	 *
	 * This method allows registering a collection of block metadata from a single
	 * manifest file, improving performance for large sets of blocks.
	 *
	 * The manifest file should be a PHP file that returns an associative array, where
	 * the keys are the block identifiers (without their namespace) and the values are
	 * the corresponding block metadata arrays. The block identifiers must match the
	 * parent directory name for the respective `block.json` file.
	 *
	 * Example manifest file structure:
	 * ```
	 * return array(
	 *     'example-block' => array(
	 *         'title' => 'Example Block',
	 *         'category' => 'widgets',
	 *         'icon' => 'smiley',
	 *         // ... other block metadata
	 *     ),
	 *     'another-block' => array(
	 *         'title' => 'Another Block',
	 *         'category' => 'formatting',
	 *         'icon' => 'star-filled',
	 *         // ... other block metadata
	 *     ),
	 *     // ... more block metadata entries
	 * );
	 * ```
	 *
	 * @since 6.7.0
	 *
	 * @param string $path     The absolute base path for the collection ( e.g., WP_PLUGIN_DIR . '/my-plugin/blocks/' ).
	 * @param string $manifest The absolute path to the manifest file containing the metadata collection.
	 * @return bool True if the collection was registered successfully, false otherwise.
	 */
	public static function register_collection( $path, $manifest ) {
		$path = rtrim( wp_normalize_path( $path ), '/' );

		$collection_roots = self::get_default_collection_roots();

		/**
		 * Filters the root directory paths for block metadata collections.
		 *
		 * Any block metadata collection that is registered must not use any of these paths, or any parent directory
		 * path of them. Most commonly, block metadata collections should reside within one of these paths, though in
		 * some scenarios they may also reside in entirely different directories (e.g. in case of symlinked plugins).
		 *
		 * Example:
		 * * It is allowed to register a collection with path `WP_PLUGIN_DIR . '/my-plugin'`.
		 * * It is not allowed to register a collection with path `WP_PLUGIN_DIR`.
		 * * It is not allowed to register a collection with path `dirname( WP_PLUGIN_DIR )`.
		 *
		 * The default list encompasses the `wp-includes` directory, as well as the root directories for plugins,
		 * must-use plugins, and themes. This filter can be used to expand the list, e.g. to custom directories that
		 * contain symlinked plugins, so that these root directories cannot be used themselves for a block metadata
		 * collection either.
		 *
		 * @since 6.7.2
		 *
		 * @param string[] $collection_roots List of allowed metadata collection root paths.
		 */
		$collection_roots = apply_filters( 'wp_allowed_block_metadata_collection_roots', $collection_roots );

		$collection_roots = array_unique(
			array_map(
				static function ( $allowed_root ) {
					return rtrim( wp_normalize_path( $allowed_root ), '/' );
				},
				$collection_roots
			)
		);

		// Check if the path is valid:
		if ( ! self::is_valid_collection_path( $path, $collection_roots ) ) {
			_doing_it_wrong(
				__METHOD__,
				sprintf(
					/* translators: %s: list of allowed collection roots */
					__( 'Block metadata collections cannot be registered as one of the following directories or their parent directories: %s' ),
					esc_html( implode( wp_get_list_item_separator(), $collection_roots ) )
				),
				'6.7.2'
			);
			return false;
		}

		if ( ! file_exists( $manifest ) ) {
			_doing_it_wrong(
				__METHOD__,
				__( 'The specified manifest file does not exist.' ),
				'6.7.0'
			);
			return false;
		}

		self::$collections[ $path ] = array(
			'manifest' => $manifest,
			'metadata' => null,
		);

		return true;
	}

	/**
	 * Retrieves block metadata for a given block within a specific collection.
	 *
	 * This method uses the registered collections to efficiently lookup
	 * block metadata without reading individual `block.json` files.
	 *
	 * @since 6.7.0
	 *
	 * @param string $file_or_folder The path to the file or folder containing the block.
	 * @return array|null The block metadata for the block, or null if not found.
	 */
	public static function get_metadata( $file_or_folder ) {
		$file_or_folder = wp_normalize_path( $file_or_folder );

		$path = self::find_collection_path( $file_or_folder );
		if ( ! $path ) {
			return null;
		}

		$collection = &self::$collections[ $path ];

		if ( null === $collection['metadata'] ) {
			// Load the manifest file if not already loaded
			$collection['metadata'] = require $collection['manifest'];
		}

		// Get the block name from the path.
		$block_name = self::default_identifier_callback( $file_or_folder );

		return isset( $collection['metadata'][ $block_name ] ) ? $collection['metadata'][ $block_name ] : null;
	}

	/**
	 * Gets the list of absolute paths to all block metadata files that are part of the given collection.
	 *
	 * For instance, if a block metadata collection is registered with path `WP_PLUGIN_DIR . '/my-plugin/blocks/'`,
	 * and the manifest file includes metadata for two blocks `'block-a'` and `'block-b'`, the result of this method
	 * will be an array containing:
	 * * `WP_PLUGIN_DIR . '/my-plugin/blocks/block-a/block.json'`
	 * * `WP_PLUGIN_DIR . '/my-plugin/blocks/block-b/block.json'`
	 *
	 * @since 6.8.0
	 *
	 * @param string $path The absolute base path for a previously registered collection.
	 * @return string[] List of block metadata file paths, or an empty array if the given `$path` is invalid.
	 */
	public static function get_collection_block_metadata_files( $path ) {
		$path = rtrim( wp_normalize_path( $path ), '/' );

		if ( ! isset( self::$collections[ $path ] ) ) {
			_doing_it_wrong(
				__METHOD__,
				__( 'No registered block metadata collection was found for the provided path.' ),
				'6.8.0'
			);
			return array();
		}

		$collection = &self::$collections[ $path ];

		if ( null === $collection['metadata'] ) {
			// Load the manifest file if not already loaded.
			$collection['metadata'] = require $collection['manifest'];
		}

		return array_map(
			// No normalization necessary since `$path` is already normalized and `$block_name` is just a folder name.
			static function ( $block_name ) use ( $path ) {
				return "{$path}/{$block_name}/block.json";
			},
			array_keys( $collection['metadata'] )
		);
	}

	/**
	 * Finds the collection path for a given file or folder.
	 *
	 * @since 6.7.0
	 *
	 * @param string $file_or_folder The normalized path to the file or folder.
	 * @return string|null The normalized collection path if found, or null if not found.
	 */
	private static function find_collection_path( $file_or_folder ) {
		if ( empty( $file_or_folder ) ) {
			return null;
		}

		// Check the last matched collection first, since block registration usually happens in batches per plugin or theme.
		$path = rtrim( $file_or_folder, '/' );
		if ( self::$last_matched_collection && str_starts_with( $path, self::$last_matched_collection ) ) {
			return self::$last_matched_collection;
		}

		$collection_paths = array_keys( self::$collections );
		foreach ( $collection_paths as $collection_path ) {
			if ( str_starts_with( $path, $collection_path ) ) {
				self::$last_matched_collection = $collection_path;
				return $collection_path;
			}
		}
		return null;
	}

	/**
	 * Checks if metadata exists for a given block name in a specific collection.
	 *
	 * @since 6.7.0
	 *
	 * @param string $file_or_folder The path to the file or folder containing the block metadata.
	 * @return bool True if metadata exists for the block, false otherwise.
	 */
	public static function has_metadata( $file_or_folder ) {
		return null !== self::get_metadata( $file_or_folder );
	}

	/**
	 * Default identifier function to determine the block identifier from a given path.
	 *
	 * This function extracts the block identifier from the path:
	 * - For 'block.json' files, it uses the parent directory name.
	 * - For directories, it uses the directory name itself.
	 * - For empty paths, it returns an empty string.
	 *
	 * For example:
	 * - Path: '/wp-content/plugins/my-plugin/blocks/example/block.json'
	 *   Identifier: 'example'
	 * - Path: '/wp-content/plugins/my-plugin/blocks/another-block'
	 *   Identifier: 'another-block'
	 *
	 * This default behavior matches the standard WordPress block structure.
	 *
	 * @since 6.7.0
	 *
	 * @param string $path The normalized file or folder path to determine the block identifier from.
	 * @return string The block identifier, or an empty string if the path is empty.
	 */
	private static function default_identifier_callback( $path ) {
		// Ensure $path is not empty to prevent unexpected behavior.
		if ( empty( $path ) ) {
			return '';
		}

		if ( str_ends_with( $path, 'block.json' ) ) {
			// Return the parent directory name if it's a block.json file.
			return basename( dirname( $path ) );
		}

		// Otherwise, assume it's a directory and return its name.
		return basename( $path );
	}

	/**
	 * Checks whether the given block metadata collection path is valid against the list of collection roots.
	 *
	 * @since 6.7.2
	 *
	 * @param string   $path             Normalized block metadata collection path, without trailing slash.
	 * @param string[] $collection_roots List of normalized collection root paths, without trailing slashes.
	 * @return bool True if the path is allowed, false otherwise.
	 */
	private static function is_valid_collection_path( $path, $collection_roots ) {
		foreach ( $collection_roots as $allowed_root ) {
			// If the path matches any root exactly, it is invalid.
			if ( $allowed_root === $path ) {
				return false;
			}

			// If the path is a parent path of any of the roots, it is invalid.
			if ( str_starts_with( $allowed_root, $path ) ) {
				return false;
			}
		}

		return true;
	}

	/**
	 * Gets the default collection root directory paths.
	 *
	 * @since 6.7.2
	 *
	 * @return string[] List of directory paths within which metadata collections are allowed.
	 */
	private static function get_default_collection_roots() {
		if ( isset( self::$default_collection_roots ) ) {
			return self::$default_collection_roots;
		}

		$collection_roots = array(
			wp_normalize_path( ABSPATH . WPINC ),
			wp_normalize_path( WP_CONTENT_DIR ),
			wp_normalize_path( WPMU_PLUGIN_DIR ),
			wp_normalize_path( WP_PLUGIN_DIR ),
		);

		$theme_roots = get_theme_roots();
		if ( ! is_array( $theme_roots ) ) {
			$theme_roots = array( $theme_roots );
		}
		foreach ( $theme_roots as $theme_root ) {
			$collection_roots[] = trailingslashit( wp_normalize_path( WP_CONTENT_DIR ) ) . ltrim( wp_normalize_path( $theme_root ), '/' );
		}

		self::$default_collection_roots = array_unique( $collection_roots );
		return self::$default_collection_roots;
	}
}

Edit Rename Chmod Delete

FILE FOLDER

Name	Size	Permission
ID3	---	0755
IXR	---	0755
PHPMailer	---	0755
Requests	---	0755
SimplePie	---	0755
Text	---	0755
abilities-api	---	0755
assets	---	0755
block-bindings	---	0755
block-patterns	---	0755
block-supports	---	0755
blocks	---	0755
certificates	---	0755
css	---	0755
customize	---	0755
fonts	---	0755
html-api	---	0755
images	---	0755
interactivity-api	---	0755
js	---	0755
l10n	---	0755
php-compat	---	0755
pomo	---	0755
rest-api	---	0755
sitemaps	---	0755
sodium_compat	---	0755
style-engine	---	0755
theme-compat	---	0755
widgets	---	0755
abilities-api.php	24369 bytes	0644
abilities.php	7983 bytes	0644
admin-bar.php	36966 bytes	0644
atomlib.php	12181 bytes	0644
author-template.php	19391 bytes	0644
block-bindings.php	7526 bytes	0644
block-editor.php	29282 bytes	0644
block-i18n.json	316 bytes	0644
block-patterns.php	13213 bytes	0644
block-template-utils.php	62484 bytes	0644
block-template.php	15359 bytes	0644
blocks.php	114739 bytes	0644
bookmark-template.php	12768 bytes	0644
bookmark.php	15427 bytes	0644
cache-compat.php	10078 bytes	0644
cache.php	13486 bytes	0644
canonical.php	34645 bytes	0644
capabilities.php	43652 bytes	0644
category-template.php	57045 bytes	0644
category.php	12829 bytes	0644
class-IXR.php	2616 bytes	0644
class-avif-info.php	29615 bytes	0644
class-feed.php	539 bytes	0644
class-http.php	367 bytes	0644
class-json.php	43676 bytes	0644
class-oembed.php	401 bytes	0644
class-phpass.php	6771 bytes	0644
class-phpmailer.php	664 bytes	0644
class-pop3.php	21121 bytes	0644
class-requests.php	2237 bytes	0644
class-simplepie.php	453 bytes	0644
class-smtp.php	457 bytes	0644
class-snoopy.php	37715 bytes	0644
class-walker-category-dropdown.php	2469 bytes	0644
class-walker-category.php	8477 bytes	0644
class-walker-comment.php	14221 bytes	0644
class-walker-nav-menu.php	12044 bytes	0644
class-walker-page-dropdown.php	2710 bytes	0644
class-walker-page.php	7612 bytes	0644
class-wp-admin-bar.php	17874 bytes	0644
class-wp-ajax-response.php	5266 bytes	0644
class-wp-application-passwords.php	17099 bytes	0644
class-wp-block-bindings-registry.php	8482 bytes	0644
class-wp-block-bindings-source.php	2992 bytes	0644
class-wp-block-editor-context.php	1350 bytes	0644
class-wp-block-list.php	4713 bytes	0644
class-wp-block-metadata-registry.php	11895 bytes	0644
class-wp-block-parser-block.php	2555 bytes	0644
class-wp-block-parser-frame.php	2017 bytes	0644
class-wp-block-parser.php	11516 bytes	0644
class-wp-block-pattern-categories-registry.php	5450 bytes	0644
class-wp-block-patterns-registry.php	11253 bytes	0644
class-wp-block-processor.php	69959 bytes	0644
class-wp-block-styles-registry.php	6497 bytes	0644
class-wp-block-supports.php	5626 bytes	0644
class-wp-block-template.php	2033 bytes	0644
class-wp-block-templates-registry.php	7193 bytes	0644
class-wp-block-type-registry.php	5030 bytes	0644
class-wp-block-type.php	17265 bytes	0644
class-wp-block.php	24812 bytes	0644
class-wp-classic-to-block-menu-converter.php	4070 bytes	0644
class-wp-comment-query.php	48804 bytes	0644
class-wp-comment.php	9437 bytes	0644
class-wp-customize-control.php	26119 bytes	0644
class-wp-customize-manager.php	203139 bytes	0644
class-wp-customize-nav-menus.php	58013 bytes	0644
class-wp-customize-panel.php	10710 bytes	0644
class-wp-customize-section.php	11209 bytes	0644
class-wp-customize-setting.php	29962 bytes	0644
class-wp-customize-widgets.php	72607 bytes	0644
class-wp-date-query.php	36147 bytes	0644
class-wp-dependencies.php	17004 bytes	0644
class-wp-dependency.php	2633 bytes	0644
class-wp-duotone.php	40783 bytes	0644
class-wp-editor.php	72335 bytes	0644
class-wp-embed.php	15931 bytes	0644
class-wp-error.php	7502 bytes	0644
class-wp-exception.php	253 bytes	0644
class-wp-fatal-error-handler.php	8150 bytes	0644
class-wp-feed-cache-transient.php	3304 bytes	0644
class-wp-feed-cache.php	969 bytes	0644
class-wp-hook.php	16674 bytes	0644
class-wp-http-cookie.php	7389 bytes	0644
class-wp-http-curl.php	13261 bytes	0644
class-wp-http-encoding.php	6689 bytes	0644
class-wp-http-ixr-client.php	3506 bytes	0644
class-wp-http-proxy.php	5980 bytes	0644
class-wp-http-requests-hooks.php	2022 bytes	0644
class-wp-http-requests-response.php	4400 bytes	0644
class-wp-http-response.php	2977 bytes	0644
class-wp-http-streams.php	16859 bytes	0644
class-wp-http.php	41570 bytes	0644
class-wp-image-editor-gd.php	20705 bytes	0644
class-wp-image-editor-imagick.php	36977 bytes	0644
class-wp-image-editor.php	17415 bytes	0644
class-wp-list-util.php	7443 bytes	0644
class-wp-locale-switcher.php	6776 bytes	0644
class-wp-locale.php	16883 bytes	0644
class-wp-matchesmapregex.php	1828 bytes	0644
class-wp-meta-query.php	30533 bytes	0644
class-wp-metadata-lazyloader.php	6833 bytes	0644
class-wp-navigation-fallback.php	9193 bytes	0644
class-wp-network-query.php	19887 bytes	0644
class-wp-network.php	12296 bytes	0644
class-wp-object-cache.php	17524 bytes	0644
class-wp-oembed-controller.php	6905 bytes	0644
class-wp-oembed.php	31670 bytes	0644
class-wp-paused-extensions-storage.php	5111 bytes	0644
class-wp-phpmailer.php	4348 bytes	0644
class-wp-plugin-dependencies.php	25315 bytes	0644
class-wp-post-type.php	30680 bytes	0644
class-wp-post.php	6491 bytes	0644
class-wp-query.php	163744 bytes	0644
class-wp-recovery-mode-cookie-service.php	6877 bytes	0644
class-wp-recovery-mode-email-service.php	11183 bytes	0644
class-wp-recovery-mode-key-service.php	4884 bytes	0644
class-wp-recovery-mode-link-service.php	3463 bytes	0644
class-wp-recovery-mode.php	11453 bytes	0644
class-wp-rewrite.php	63687 bytes	0644
class-wp-role.php	2523 bytes	0644
class-wp-roles.php	9394 bytes	0644
class-wp-script-modules.php	32917 bytes	0644
class-wp-scripts.php	34864 bytes	0644
class-wp-session-tokens.php	7319 bytes	0644
class-wp-simplepie-file.php	3552 bytes	0644
class-wp-simplepie-sanitize-kses.php	1910 bytes	0644
class-wp-site-query.php	31655 bytes	0644
class-wp-site.php	7467 bytes	0644
class-wp-speculation-rules.php	7527 bytes	0644
class-wp-styles.php	12843 bytes	0644
class-wp-tax-query.php	19577 bytes	0644
class-wp-taxonomy.php	18559 bytes	0644
class-wp-term-query.php	40953 bytes	0644
class-wp-term.php	5298 bytes	0644
class-wp-text-diff-renderer-inline.php	979 bytes	0644
class-wp-text-diff-renderer-table.php	18880 bytes	0644
class-wp-textdomain-registry.php	10481 bytes	0644
class-wp-theme-json-data.php	1809 bytes	0644
class-wp-theme-json-resolver.php	35738 bytes	0644
class-wp-theme-json-schema.php	7367 bytes	0644
class-wp-theme-json.php	164347 bytes	0644
class-wp-theme.php	65810 bytes	0644
class-wp-token-map.php	28618 bytes	0644
class-wp-url-pattern-prefixer.php	4802 bytes	0644
class-wp-user-meta-session-tokens.php	3011 bytes	0644
class-wp-user-query.php	44166 bytes	0644
class-wp-user-request.php	2305 bytes	0644
class-wp-user.php	23044 bytes	0644
class-wp-walker.php	13322 bytes	0644
class-wp-widget-factory.php	3347 bytes	0644
class-wp-widget.php	18429 bytes	0644
class-wp-xmlrpc-server.php	215447 bytes	0644
class-wp.php	26481 bytes	0644
class-wpdb.php	118627 bytes	0644
class.wp-dependencies.php	373 bytes	0644
class.wp-scripts.php	343 bytes	0644
class.wp-styles.php	338 bytes	0644
comment-template.php	103145 bytes	0644
comment.php	134069 bytes	0644
compat-utf8.php	19554 bytes	0644
compat.php	17830 bytes	0644
cron.php	42988 bytes	0644
date.php	400 bytes	0644
default-constants.php	11365 bytes	0644
default-filters.php	37910 bytes	0644
default-widgets.php	2295 bytes	0644
deprecated.php	192644 bytes	0644
embed-template.php	338 bytes	0644
embed.php	38911 bytes	0644
error-protection.php	4121 bytes	0644
feed-atom-comments.php	5504 bytes	0644
feed-atom.php	3121 bytes	0644
feed-rss.php	1189 bytes	0644
feed-rss2-comments.php	4136 bytes	0644
feed-rss2.php	3799 bytes	0644
feed.php	25189 bytes	0644
fonts.php	9790 bytes	0644
formatting.php	354741 bytes	0644
functions.php	288600 bytes	0644
functions.wp-scripts.php	15311 bytes	0644
functions.wp-styles.php	8641 bytes	0644
general-template.php	173004 bytes	0644
global-styles-and-settings.php	21204 bytes	0644
http.php	25878 bytes	0644
https-detection.php	5857 bytes	0644
https-migration.php	4741 bytes	0644
kses.php	83693 bytes	0644
l10n.php	68797 bytes	0644
link-template.php	160117 bytes	0644
load.php	56510 bytes	0644
locale.php	162 bytes	0644
media-template.php	63197 bytes	0644
media.php	221247 bytes	0644
meta.php	66556 bytes	0644
ms-blogs.php	25845 bytes	0644
ms-default-constants.php	4921 bytes	0644
ms-default-filters.php	6636 bytes	0644
ms-deprecated.php	21759 bytes	0644
ms-files.php	2857 bytes	0644
ms-functions.php	91842 bytes	0644
ms-load.php	19887 bytes	0644
ms-network.php	3782 bytes	0644
ms-settings.php	4204 bytes	0644
ms-site.php	41717 bytes	0644
nav-menu-template.php	25990 bytes	0644
nav-menu.php	44347 bytes	0644
option.php	105035 bytes	0644
pluggable-deprecated.php	6324 bytes	0644
pluggable.php	127457 bytes	0644
plugin.php	36501 bytes	0644
post-formats.php	7102 bytes	0644
post-template.php	68648 bytes	0644
post-thumbnail-template.php	10879 bytes	0644
post.php	296072 bytes	0644
query.php	37095 bytes	0644
registration-functions.php	200 bytes	0644
registration.php	200 bytes	0644
rest-api.php	100654 bytes	0644
revision.php	30741 bytes	0644
rewrite.php	19490 bytes	0644
robots-template.php	5185 bytes	0644
rss-functions.php	255 bytes	0644
rss.php	23203 bytes	0644
script-loader.php	158344 bytes	0644
script-modules.php	9911 bytes	0644
session.php	258 bytes	0644
shortcodes.php	24050 bytes	0644
sitemaps.php	3238 bytes	0644
speculative-loading.php	8600 bytes	0644
spl-autoload-compat.php	441 bytes	0644
style-engine.php	7563 bytes	0644
taxonomy.php	177058 bytes	0644
template-canvas.php	544 bytes	0644
template-loader.php	4267 bytes	0644
template.php	36834 bytes	0644
theme-i18n.json	1730 bytes	0644
theme-previews.php	2910 bytes	0644
theme-templates.php	6238 bytes	0644
theme.json	8921 bytes	0644
theme.php	135008 bytes	0644
update.php	38353 bytes	0644
user.php	178062 bytes	0644
utf8.php	7260 bytes	0644
vars.php	6562 bytes	0644
version.php	1106 bytes	0644
widgets.php	71129 bytes	0644
wp-db.php	445 bytes	0644
wp-diff.php	799 bytes	0644

File Content: class-wp-block-metadata-registry.php

File Content: `class-wp-block-metadata-registry.php`