W3cubDocs

/WordPress

wp_get_active_and_valid_plugins()

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Retrieve an array of active and valid plugin files.

Description

While upgrading or installing WordPress, no plugins are returned.

The default directory is wp-content/plugins. To change the default directory manually, define WP_PLUGIN_DIR and WP_PLUGIN_URL in wp-config.php.

Return

(string[]) Array of paths to plugin files relative to the plugins directory.

Source

File: wp-includes/load.php 

function wp_get_active_and_valid_plugins() {
	$plugins        = array();
	$active_plugins = (array) get_option( 'active_plugins', array() );

	// Check for hacks file if the option is enabled.
	if ( get_option( 'hack_file' ) && file_exists( ABSPATH . 'my-hacks.php' ) ) {
		_deprecated_file( 'my-hacks.php', '1.5.0' );
		array_unshift( $plugins, ABSPATH . 'my-hacks.php' );
	}

	if ( empty( $active_plugins ) || wp_installing() ) {
		return $plugins;
	}

	$network_plugins = is_multisite() ? wp_get_active_network_plugins() : false;

	foreach ( $active_plugins as $plugin ) {
		if ( ! validate_file( $plugin )                     // $plugin must validate as file.
			&& '.php' === substr( $plugin, -4 )             // $plugin must end with '.php'.
			&& file_exists( WP_PLUGIN_DIR . '/' . $plugin ) // $plugin must exist.
			// Not already included as a network plugin.
			&& ( ! $network_plugins || ! in_array( WP_PLUGIN_DIR . '/' . $plugin, $network_plugins, true ) )
			) {
			$plugins[] = WP_PLUGIN_DIR . '/' . $plugin;
		}
	}

	/*
	 * Remove plugins from the list of active plugins when we're on an endpoint
	 * that should be protected against WSODs and the plugin is paused.
	 */
	if ( wp_is_recovery_mode() ) {
		$plugins = wp_skip_paused_plugins( $plugins );
	}

	return $plugins;
}

Uses

Uses Description
wp-includes/load.php: wp_is_recovery_mode()

Is WordPress in Recovery Mode.
wp-includes/load.php: wp_skip_paused_plugins()

Filters a given list of plugins, removing any paused plugins from it.
wp-includes/load.php: wp_installing()

Check or set whether WordPress is in “installation” mode.
wp-includes/load.php: is_multisite()

If Multisite is enabled.
wp-includes/functions.php: _deprecated_file()

Mark a file as deprecated and inform when it has been used.
wp-includes/functions.php: validate_file()

Validates a file name and path against an allowed set of rules.
wp-includes/option.php: get_option()

Retrieves an option value based on an option name.
wp-includes/ms-load.php: wp_get_active_network_plugins()

Returns array of network plugin files to be included in global scope.

Changelog

Version Description
3.0.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_get_active_and_valid_plugins