class-plugin-locator.php — Jetpack – WP Security, Backup, Speed, & Growth 12.6.4

jetpack / vendor / jetpack-autoloader / class-plugin-locator.php

jetpack / vendor / jetpack-autoloader Last commit date

class-plugin-locator.php

157 lines

1	<?php
2	/**
3	* This file was automatically generated by automattic/jetpack-autoloader.
4	*
5	* @package automattic/jetpack-autoloader
6	*/
7
8	namespace Automattic\Jetpack\Autoloader\jpf11009ded9fc4592b6a05b61ce272b3c_jetpackⓥ12_6_2;
9
10	// phpcs:ignore
11
12	/**
13	* This class scans the WordPress installation to find active plugins.
14	*/
15	class Plugin_Locator {
16
17	/**
18	* The path processor for finding plugin paths.
19	*
20	* @var Path_Processor
21	*/
22	private $path_processor;
23
24	/**
25	* The constructor.
26	*
27	* @param Path_Processor $path_processor The Path_Processor instance.
28	*/
29	public function __construct( $path_processor ) {
30	$this->path_processor = $path_processor;
31	}
32
33	/**
34	* Finds the path to the current plugin.
35	*
36	* @return string $path The path to the current plugin.
37	*
38	* @throws \RuntimeException If the current plugin does not have an autoloader.
39	*/
40	public function find_current_plugin() {
41	// Escape from `vendor/__DIR__` to root plugin directory.
42	$plugin_directory = dirname( dirname( __DIR__ ) );
43
44	// Use the path processor to ensure that this is an autoloader we're referencing.
45	$path = $this->path_processor->find_directory_with_autoloader( $plugin_directory, array() );
46	if ( false === $path ) {
47	throw new \RuntimeException( 'Failed to locate plugin ' . $plugin_directory );
48	}
49
50	return $path;
51	}
52
53	/**
54	* Checks a given option for plugin paths.
55	*
56	* @param string $option_name The option that we want to check for plugin information.
57	* @param bool $site_option Indicates whether or not we want to check the site option.
58	*
59	* @return array $plugin_paths The list of absolute paths we've found.
60	*/
61	public function find_using_option( $option_name, $site_option = false ) {
62	$raw = $site_option ? get_site_option( $option_name ) : get_option( $option_name );
63	if ( false === $raw ) {
64	return array();
65	}
66
67	return $this->convert_plugins_to_paths( $raw );
68	}
69
70	/**
71	* Checks for plugins in the `action` request parameter.
72	*
73	* @param string[] $allowed_actions The actions that we're allowed to return plugins for.
74	*
75	* @return array $plugin_paths The list of absolute paths we've found.
76	*/
77	public function find_using_request_action( $allowed_actions ) {
78	// phpcs:disable WordPress.Security.NonceVerification.Recommended
79
80	/**
81	* Note: we're not actually checking the nonce here because it's too early
82	* in the execution. The pluggable functions are not yet loaded to give
83	* plugins a chance to plug their versions. Therefore we're doing the bare
84	* minimum: checking whether the nonce exists and it's in the right place.
85	* The request will fail later if the nonce doesn't pass the check.
86	*/
87	if ( empty( $_REQUEST['_wpnonce'] ) ) {
88	return array();
89	}
90
91	// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Validated just below.
92	$action = isset( $_REQUEST['action'] ) ? wp_unslash( $_REQUEST['action'] ) : false;
93	if ( ! in_array( $action, $allowed_actions, true ) ) {
94	return array();
95	}
96
97	$plugin_slugs = array();
98	switch ( $action ) {
99	case 'activate':
100	case 'deactivate':
101	if ( empty( $_REQUEST['plugin'] ) ) {
102	break;
103	}
104
105	// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Validated by convert_plugins_to_paths.
106	$plugin_slugs[] = wp_unslash( $_REQUEST['plugin'] );
107	break;
108
109	case 'activate-selected':
110	case 'deactivate-selected':
111	if ( empty( $_REQUEST['checked'] ) ) {
112	break;
113	}
114
115	// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Validated by convert_plugins_to_paths.
116	$plugin_slugs = wp_unslash( $_REQUEST['checked'] );
117	break;
118	}
119
120	// phpcs:enable WordPress.Security.NonceVerification.Recommended
121	return $this->convert_plugins_to_paths( $plugin_slugs );
122	}
123
124	/**
125	* Given an array of plugin slugs or paths, this will convert them to absolute paths and filter
126	* out the plugins that are not directory plugins. Note that array keys will also be included
127	* if they are plugin paths!
128	*
129	* @param string[] $plugins Plugin paths or slugs to filter.
130	*
131	* @return string[]
132	*/
133	private function convert_plugins_to_paths( $plugins ) {
134	if ( ! is_array( $plugins ) \|\| empty( $plugins ) ) {
135	return array();
136	}
137
138	// We're going to look for plugins in the standard directories.
139	$path_constants = array( WP_PLUGIN_DIR, WPMU_PLUGIN_DIR );
140
141	$plugin_paths = array();
142	foreach ( $plugins as $key => $value ) {
143	$path = $this->path_processor->find_directory_with_autoloader( $key, $path_constants );
144	if ( $path ) {
145	$plugin_paths[] = $path;
146	}
147
148	$path = $this->path_processor->find_directory_with_autoloader( $value, $path_constants );
149	if ( $path ) {
150	$plugin_paths[] = $path;
151	}
152	}
153
154	return $plugin_paths;
155	}
156	}
157