← All changes | webp/class-wp-optimize-webp.php +379 -111 3.3.1 → 4.7.0 View file →

		@@ -1,53 +1,215 @@
1	1	<?php
2	2
3		-if (!defined('WPO_VERSION')) die('No direct access allowed');
	3	+if (!defined('ABSPATH')) die('No direct access allowed');
4	4
5	5	if (!class_exists('WP_Optimize_WebP')) :
6	6
7	7	class WP_Optimize_WebP {
8	8
9		- private $_htaccess = null;
	9	+ /**
	10	+ * @var WP_Optimize_Htaccess
	11	+ */
	12	+ private $_htaccess;
10	13
11	14	/**
12		- * Set to true when webp is enabled and vice-versa
	15	+ * Set to true when webp is enabled and vice versa
13	16	*
14	17	* @var boolean
15	18	*/
16		- private $_should_use_webp = false;
	19	+ private $_should_use_webp;
17	20
18	21	/**
	22	+ * The logger for this instance
	23	+ *
	24	+ * @var Updraft_File_Logger
	25	+ */
	26	+ private $logger;
	27	+
	28	+ /**
19	29	* Constructor
20	30	*/
21	31	private function __construct() {
22	32	$this->_should_use_webp = (bool) WP_Optimize()->get_options()->get_option('webp_conversion');
23	33
24		- if ($this->_should_use_webp && $this->get_webp_conversion_test_result()) {
25		- if (!is_admin()) {
26		- $this->maybe_decide_webp_serve_method();
27		- }
28		- }
	34	+ $this->logger = new Updraft_File_Logger($this->get_logfile_path());
29	35
30	36	add_action('wpo_reset_webp_conversion_test_result', array($this, 'reset_webp_serving_method'));
	37	+ add_action('wpo_prune_webp_logs', array($this, 'prune_webp_logs'));
	38	+ $task_manager = WPO_Webp_Task_Manager::get_instance();
	39	+ add_action('wpo_webp_convert_compressed_images', array($task_manager, 'webp_convert_compressed_images'));
31	40	}
32	41
33	42	/**
34	43	* Returns singleton instance
35	44	*
36		- * @return WP_Optimize_WebP
	45	+ * @return self
37	46	*/
38		- public static function get_instance() {
	47	+ public static function get_instance(): self {
39	48	static $instance = null;
40	49	if (null === $instance) {
41		- $instance = new WP_Optimize_WebP();
	50	+ $instance = new self();
42	51	}
43	52	return $instance;
44	53	}
45	54
46	55	/**
	56	+ * Evaluate WebP conversion capability.
	57	+ *
	58	+ * @return array{is_available: bool, reason: string, message: string, converter_status: array<string, array<string>>, test_ran: bool}
	59	+ */
	60	+ public function evaluate_webp_capability(): array {
	61	+ $converter_status = array();
	62	+ $test_ran = false;
	63	+ if ($this->is_only_shell_converters_available() && !$this->shell_functions_available()) {
	64	+ return array(
	65	+ 'is_available' => false,
	66	+ 'reason' => 'update_failed_no_shell_functions',
	67	+ 'message' => __('Required WebP shell functions are not available on the server.', 'wp-optimize'),
	68	+ 'converter_status' => $converter_status,
	69	+ 'test_ran' => $test_ran,
	70	+ );
	71	+ }
	72	+
	73	+ if ($this->should_run_webp_conversion_test()) {
	74	+ $test_ran = true;
	75	+ $converter_status = WPO_WebP_Test_Run::get_converter_status();
	76	+ if (!$this->is_webp_conversion_successful()) {
	77	+ return array(
	78	+ 'is_available' => false,
	79	+ 'reason' => 'update_failed_no_working_webp_converter',
	80	+ 'message' => __('No working WebP converter was found on the server.', 'wp-optimize'),
	81	+ 'converter_status' => $converter_status,
	82	+ 'test_ran' => $test_ran,
	83	+ );
	84	+ }
	85	+ }
	86	+
	87	+ return array(
	88	+ 'is_available' => true,
	89	+ 'reason' => '',
	90	+ 'message' => '',
	91	+ 'converter_status' => $converter_status,
	92	+ 'test_ran' => $test_ran,
	93	+ );
	94	+ }
	95	+
	96	+ /**
	97	+ * Try to enable webp conversion, upon failure disable webp conversion
	98	+ *
	99	+ * @param array<string, string> $data - Data webp_conversion (true|false)
	100	+ * @return WP_Error|bool - information about the operation or WP_Error object on failure
	101	+ */
	102	+ private function configure_webp_conversion($data) {
	103	+
	104	+ $options = array();
	105	+ $options['webp_conversion'] = isset($data['webp_conversion']) ? filter_var($data['webp_conversion'], FILTER_VALIDATE_BOOLEAN) : false;
	106	+
	107	+ if ($options['webp_conversion']) {
	108	+ $capability = $this->evaluate_webp_capability();
	109	+
	110	+ if (!$capability['is_available']) {
	111	+ $this->disable_webp_conversion();
	112	+ $message = $capability['message'];
	113	+ $reason = $capability['reason'];
	114	+ $this->log($message);
	115	+ return new WP_Error($reason, $message);
	116	+ }
	117	+
	118	+ // Only update the test result and converters if the test actually ran
	119	+ if ($capability['test_ran']) {
	120	+ $options['webp_conversion_test'] = true;
	121	+ $options['webp_converters'] = $capability['converter_status']['working_converters'] ?? array();
	122	+ }
	123	+
	124	+ // Run serving methods tests and set necessary option values
	125	+ // Not possible to test alter HTML since the test is browser-based
	126	+ $this->save_htaccess_rules();
	127	+ if (!$this->is_webp_redirection_possible()) {
	128	+ $this->empty_htaccess_file();
	129	+ $options['redirection_possible'] = 'false';
	130	+ } else {
	131	+ $options['redirection_possible'] = 'true';
	132	+ }
	133	+ }
	134	+ $smush_manager = Updraft_Smush_Manager::instance();
	135	+ $success = $smush_manager->update_smush_options($options);
	136	+
	137	+ if (!$success) {
	138	+ $this->disable_webp_conversion();
	139	+ $message = __('WebP options could not be updated.', 'wp-optimize');
	140	+ $this->log($message);
	141	+ return new WP_Error('update_failed', $message);
	142	+ }
	143	+
	144	+ // Set up daily CRON only when enabling WebP and Delete daily CRON when disabling WebP
	145	+ if ($options['webp_conversion']) {
	146	+ $this->init_webp_cron_scheduler();
	147	+ } else {
	148	+ $this->remove_webp_cron_schedules();
	149	+ $this->empty_htaccess_file();
	150	+ }
	151	+ return $success;
	152	+ }
	153	+
	154	+ /**
	155	+ * Save WebP settings and trigger related actions.
	156	+ *
	157	+ * @param array<string, string> $data WebP settings (expects 'webp_conversion').
	158	+ * @return bool|WP_Error True on success, WP_Error on failure.
	159	+ */
	160	+ public function save_webp_settings($data) {
	161	+
	162	+ if (!is_array($data)) {
	163	+ return new WP_Error('invalid_data', __('Invalid WebP settings data.', 'wp-optimize'));
	164	+ }
	165	+
	166	+ $result = $this->configure_webp_conversion($data);
	167	+
	168	+ if (!is_wp_error($result)) {
	169	+ do_action('wpo_save_images_settings');
	170	+ }
	171	+
	172	+ return $result;
	173	+ }
	174	+
	175	+ /**
	176	+ * Returns the path to the logfile
	177	+ *
	178	+ * @return string - file path
	179	+ */
	180	+ private function get_logfile_path(): string {
	181	+ return WP_Optimize_Utils::get_log_file_path('webp');
	182	+ }
	183	+
	184	+ /**
	185	+ * Logging of interesting messages related to WebP.
	186	+ *
	187	+ * @param string $message Log message
	188	+ * @param string $level Log level (e.g., 'info', 'warning', 'error')
	189	+ *
	190	+ * @return void
	191	+ */
	192	+ public function log(string $message, string $level = 'info'): void {
	193	+ $this->logger->log($message, $level);
	194	+ }
	195	+
	196	+ /**
	197	+ * Prunes the log file
	198	+ *
	199	+ * @return void
	200	+ */
	201	+ public function prune_webp_logs(): void {
	202	+ $this->log("Pruning the WebP log file");
	203	+ $this->logger->prune_logs();
	204	+ }
	205	+
	206	+ /**
47	207	* Test Run and find converter status
	208	+ *
	209	+ * @return void
48	210	*/
49		- private function set_converter_status() {
	211	+ private function set_converter_status(): void {
50	212	$converter_status = WPO_WebP_Test_Run::get_converter_status();
51	213	if ($this->is_webp_conversion_successful()) {
52	214	WP_Optimize()->get_options()->update_option('webp_conversion_test', true);
53	215	WP_Optimize()->get_options()->update_option('webp_converters', $converter_status['working_converters']);
		@@ -54,48 +216,59 @@
54	216	}
55	217	}
56	218
57	219	/**
58		- * If webp images should be used, then decide whether it is possible to server webp
59		- * using rewrite rules or using altered html method
	220	+ * If .htaccess redirection is not possible, attempts to use the alter_html method.
	221	+ *
	222	+ * @param string $buffer Page HTML
	223	+ *
	224	+ * @return string
60	225	*/
61		- private function maybe_decide_webp_serve_method() {
62		- $this->save_htaccess_rules();
	226	+ public function maybe_decide_webp_serve_method(string $buffer): string {
63	227	if (!$this->is_webp_redirection_possible()) {
64		- $this->empty_htaccess_file();
65		- $this->maybe_use_alter_html();
	228	+ $buffer = $this->maybe_use_alter_html($buffer);
66	229	}
	230	+ return $buffer;
67	231	}
68	232
69	233	/**
70		- * If alter html method is possible, then use it
	234	+ * If alter HTML method is possible, apply it to the buffer.
	235	+ *
	236	+ * @param string $buffer Page HTML
	237	+ *
	238	+ * @return string
71	239	*/
72		- private function maybe_use_alter_html() {
	240	+ private function maybe_use_alter_html(string $buffer): string {
73	241	if ($this->is_alter_html_possible()) {
74		- $this->use_alter_html();
	242	+ $this->empty_htaccess_file();
	243	+ $buffer = WPO_WebP_Alter_HTML::get_instance()->alter_html($buffer);
75	244	}
	245	+ return $buffer;
76	246	}
77	247
78	248	/**
79		- * Even if server support .htaccess rewrite, sometimes it is not possible
80		- * to serve webp images. So, find it webp redirection is possible or not
	249	+ * Even if the server supports .htaccess rewrite, sometimes it is not possible
	250	+ * to serve webp images. This method determines whether webp redirection is possible.
81	251	*
	252	+ * Also applies `wpo_force_webp_serve_using_altered_html` filter for users to be able to
	253	+ * force the Altered HTML method.
	254	+ *
82	255	* @return bool
83	256	*/
84		- public function is_webp_redirection_possible() {
	257	+ public function is_webp_redirection_possible(): bool {
	258	+ if (apply_filters('wpo_force_webp_serve_using_altered_html', false)) {
	259	+ return false;
	260	+ }
	261	+
85	262	$redirection_possible = WP_Optimize()->get_options()->get_option('redirection_possible');
86		- if (!empty($redirection_possible)) return 'true' === $redirection_possible;
	263	+
	264	+ // If a previous test result exists, use it; otherwise, run the self test
	265	+ if (!empty($redirection_possible)) {
	266	+ return 'true' === $redirection_possible;
	267	+ }
	268	+
87	269	return $this->run_webp_serving_self_test();
88	270	}
89		-
90		- /**
91		- * Decide whether the browser requesting the URL can accept webp images or not
92		- *
93		- * @return bool
94		- */
95		- private function is_browser_accepting_webp() {
96		- return (isset($_SERVER['HTTP_ACCEPT']) && false !== strpos($_SERVER['HTTP_ACCEPT'], 'image/webp'));
97		- }
98	271
99	272	/**
100	273	* Detect whether using alter HTML method is possible or not
101	274	*
		@@ -100,26 +273,18 @@
100	273	* Detect whether using alter HTML method is possible or not
101	274	*
102	275	* @return bool
103	276	*/
104		- private function is_alter_html_possible() {
105		- if ($this->is_browser_accepting_webp()) {
106		- return true;
107		- }
108		- return false;
	277	+ private function is_alter_html_possible(): bool {
	278	+ return WPO_WebP_Utils::is_browser_accepting_webp();
109	279	}
110	280
111	281	/**
112		- * Setup alter html method
113		- */
114		- private function use_alter_html() {
115		- WPO_WebP_Alter_HTML::get_instance();
116		- }
117		-
118		- /**
119	282	* Initialize .htaccess
	283	+ *
	284	+ * @return void
120	285	*/
121		- private function setup_htaccess_file() {
	286	+ private function setup_htaccess_file(): void {
122	287	if (null !== $this->_htaccess) return;
123	288	$wp_uploads = wp_get_upload_dir();
124	289	$htaccess_file = $wp_uploads['basedir'] . '/.htaccess';
125	290	if (!file_exists($htaccess_file)) {
		@@ -132,9 +297,9 @@
132	297	* Save .htaccess rules
133	298	*
134	299	* @return void
135	300	*/
136		- public function save_htaccess_rules() {
	301	+ private function save_htaccess_rules(): void {
137	302	$this->setup_htaccess_file();
138	303	$this->add_webp_mime_type();
139	304	$htaccess_comment_section = 'WP-Optimize WebP Rules';
140	305	if ($this->_htaccess->is_commented_section_exists($htaccess_comment_section)) return;
		@@ -139,14 +304,19 @@
139	304	$htaccess_comment_section = 'WP-Optimize WebP Rules';
140	305	if ($this->_htaccess->is_commented_section_exists($htaccess_comment_section)) return;
141	306	$this->_htaccess->update_commented_section($this->prepare_webp_htaccess_rules(), $htaccess_comment_section);
142	307	$this->_htaccess->write_file();
	308	+ WP_Optimize()->get_options()->update_option('htaccess_has_webp_rules', true);
143	309	}
144	310
145	311	/**
146	312	* Empty .htaccess file
	313	+ *
	314	+ * @return void
147	315	*/
148		- public function empty_htaccess_file() {
	316	+ private function empty_htaccess_file(): void {
	317	+ // Setting default to true, so on initial run (when option is not yet present in the DB) we don't break the function here
	318	+ if (!WP_Optimize()->get_options()->get_option('htaccess_has_webp_rules', true)) return;
149	319	$this->setup_htaccess_file();
150	320	$htaccess_comment_sections = array(
151	321	'WP-Optimize WebP Rules',
152	322	'Register webp mime type',
		@@ -151,17 +321,19 @@
151	321	'WP-Optimize WebP Rules',
152	322	'Register webp mime type',
153	323	);
154	324	foreach ($htaccess_comment_sections as $htaccess_comment_section) {
	325	+ if (!$this->_htaccess->is_commented_section_exists($htaccess_comment_section)) continue;
155	326	$this->_htaccess->remove_commented_section($htaccess_comment_section);
156	327	$this->_htaccess->write_file();
157	328	}
	329	+ WP_Optimize()->get_options()->update_option('htaccess_has_webp_rules', false);
158	330	}
159	331
160	332	/**
161	333	* Prepare array of htaccess rules to use webp images.
162	334	*
163		- * @return array
	335	+ * @return array<int, array<array<array<string>|string>|string>>
164	336	*/
165	337	private function prepare_webp_htaccess_rules() {
166	338	return array(
167	339	array(
		@@ -215,10 +387,12 @@
215	387	}
216	388
217	389	/**
218	390	* Add webp mime type to htaccess rules.
	391	+ *
	392	+ * @return void
219	393	*/
220		- private function add_webp_mime_type() {
	394	+ private function add_webp_mime_type(): void {
221	395	$htaccess_comment_section = 'Register webp mime type';
222	396	if ($this->_htaccess->is_exists() && !$this->_htaccess->is_commented_section_exists($htaccess_comment_section)) {
223	397	$webp_mime_type = array(
224	398	array(
		@@ -232,34 +406,41 @@
232	406	}
233	407	}
234	408
235	409	/**
236		- * Checks whether webp conversion test is successful or not
	410	+ * Returns the path to the WebP test image file.
237	411	*
	412	+ * @return string
	413	+ */
	414	+ private function get_webp_test_image_path(): string {
	415	+ $upload_dir = wp_upload_dir();
	416	+ return $upload_dir['basedir'] . '/wpo/images/wpo_logo_small.png.webp';
	417	+ }
	418	+
	419	+ /**
	420	+ * Checks whether a webp conversion test is successful or not
	421	+ *
238	422	* @return bool
239	423	*/
240		- public function is_webp_conversion_successful() {
241		- $upload_dir = wp_upload_dir();
242		- $destination = $upload_dir['basedir']. '/wpo/images/wpo_logo_small.png.webp';
243		- return file_exists($destination);
	424	+ private function is_webp_conversion_successful(): bool {
	425	+ return file_exists($this->get_webp_test_image_path());
244	426	}
245	427
246	428	/**
247		- * Checks whether sample webp conversion test should be run or not
	429	+ * Checks whether a sample webp conversion test should be run or not
248	430	*
249		- * @return bool Returns true if sample test should be run, false otherwise
	431	+ * @return bool Returns true if the sample test should be run, false otherwise
250	432	*/
251		- public function should_run_webp_conversion_test() {
252		- $webp_conversion_test = $this->get_webp_conversion_test_result();
253		- return (true !== $webp_conversion_test);
	433	+ private function should_run_webp_conversion_test(): bool {
	434	+ return !$this->get_webp_conversion_test_result();
254	435	}
255	436
256	437	/**
257	438	* Returns webp conversion test result
258	439	*
259		- * @return boolean Returns the value of the webp_conversion_test saved in the options table
	440	+ * @return bool Returns the value of the webp_conversion_test saved in the options table
260	441	*/
261		- private function get_webp_conversion_test_result() {
	442	+ public function get_webp_conversion_test_result(): bool {
262	443	return (bool) WP_Optimize()->get_options()->get_option('webp_conversion_test');
263	444	}
264	445
265	446	/**
		@@ -266,9 +447,9 @@
266	447	* Checks whether the webp redirection is possible or not and sets flag
267	448	*
268	449	* @return bool Returns true if webp is served successfully, false otherwise
269	450	*/
270		- private function run_webp_serving_self_test() {
	451	+ private function run_webp_serving_self_test(): bool {
271	452	$self_test = WPO_WebP_Self_Test::get_instance();
272	453
273	454	if ($self_test->is_webp_served()) {
274	455	WP_Optimize()->get_options()->update_option('redirection_possible', 'true');
		@@ -280,25 +461,27 @@
280	461	}
281	462
282	463	/**
283	464	* Resets webp serving method by running self test, if needed purges cache and empties `uploads/.htaccess` file
	465	+ *
	466	+ * @return void
284	467	*/
285		- public function reset_webp_serving_method() {
286		- if (self::is_shell_functions_available() && $this->_should_use_webp) {
	468	+ public function reset_webp_serving_method(): void {
	469	+ if ($this->_should_use_webp) {
287	470	$this->reset_webp_options();
288	471	$this->run_self_test();
289	472	list($old_redirection_possible, $new_redirection_possible) = $this->get_old_and_new_redirection_possibility();
290	473	$this->maybe_purge_cache($old_redirection_possible, $new_redirection_possible);
291	474	$this->maybe_empty_htaccess_file($new_redirection_possible);
292		- } else {
293		- $this->disable_webp_conversion();
294	475	}
295	476	}
296	477
297	478	/**
298	479	* Resets WebP related options
	480	+ *
	481	+ * @return void
299	482	*/
300		- private function reset_webp_options() {
	483	+ private function reset_webp_options(): void {
301	484	$options = WP_Optimize()->get_options();
302	485	$options->update_option('old_redirection_possible', $options->get_option('redirection_possible'));
303	486	$options->update_option('webp_conversion_test', false);
304	487	$options->update_option('webp_converters', false);
		@@ -307,10 +490,12 @@
307	490	}
308	491
309	492	/**
310	493	* Running self test to find available converters and possibility of serving webp using redirection method
	494	+ *
	495	+ * @return void
311	496	*/
312		- private function run_self_test() {
	497	+ private function run_self_test(): void {
313	498	$this->set_converter_status();
314	499	if ($this->get_webp_conversion_test_result()) {
315	500	$this->save_htaccess_rules();
316	501	$this->run_webp_serving_self_test();
		@@ -315,8 +500,9 @@
315	500	$this->save_htaccess_rules();
316	501	$this->run_webp_serving_self_test();
317	502	} else {
318	503	$this->disable_webp_conversion();
	504	+ $this->log("No working WebP converter was found on the server when running self-test, disabling WebP conversion");
319	505	}
320	506	}
321	507
322	508	/**
		@@ -321,9 +507,9 @@
321	507
322	508	/**
323	509	* Gets old and new redirection possibility values
324	510	*
325		- * @return array
	511	+ * @return array<string>
326	512	*/
327	513	private function get_old_and_new_redirection_possibility() {
328	514	$options = WP_Optimize()->get_options();
329	515	return array(
		@@ -334,15 +520,25 @@
334	520
335	521	/**
336	522	* Cache is cleared when there is a change in the potential for serving WebP using redirection.
337	523	*
338		- * @param string $old_redirection_possible
339		- * @param string $new_redirection_possible
	524	+ * @param string $old_redirection_possible Previous redirection possibility value
	525	+ * @param string $new_redirection_possible Current redirection possibility value
	526	+ * @return void
340	527	*/
341		- private function maybe_purge_cache($old_redirection_possible, $new_redirection_possible) {
342		- if ($old_redirection_possible !== $new_redirection_possible) {
343		- WP_Optimize()->get_page_cache()->purge();
	528	+ private function maybe_purge_cache($old_redirection_possible, $new_redirection_possible): void {
	529	+ if ($old_redirection_possible === $new_redirection_possible) {
	530	+ return;
344	531	}
	532	+
	533	+ $is_cache_purged = WP_Optimize()->get_page_cache()->purge();
	534	+ $log_old_value = empty($old_redirection_possible) ? 'null' : $old_redirection_possible;
	535	+ $log_new_value = empty($new_redirection_possible) ? 'null' : $new_redirection_possible;
	536	+ $this->log("Purging cache because redirection_possible value changed from: {$log_old_value} to {$log_new_value}");
	537	+
	538	+ if ($is_cache_purged) {
	539	+ WP_Optimize()->get_page_cache()->file_log('Full Cache Purge due to change in the value of WebP redirection');
	540	+ }
345	541	}
346	542
347	543	/**
348	544	* Remove redirection rules from `uploads/.htaccess` file if redirection is not possible
		@@ -347,10 +543,11 @@
347	543	/**
348	544	* Remove redirection rules from `uploads/.htaccess` file if redirection is not possible
349	545	*
350	546	* @param string $new_redirection_possible
	547	+ * @return void
351	548	*/
352		- private function maybe_empty_htaccess_file($new_redirection_possible) {
	549	+ private function maybe_empty_htaccess_file($new_redirection_possible): void {
353	550	if ('false' === $new_redirection_possible) {
354	551	$this->empty_htaccess_file();
355	552	}
356	553	}
		@@ -356,91 +553,162 @@
356	553	}
357	554
358	555	/**
359	556	* Initialize cron scheduler
	557	+ *
	558	+ * @return void
360	559	*/
361		- public function init_webp_cron_scheduler() {
	560	+ public function init_webp_cron_scheduler(): void {
362	561	if (!wp_next_scheduled('wpo_reset_webp_conversion_test_result')) {
363	562	wp_schedule_event(time(), 'wpo_daily', 'wpo_reset_webp_conversion_test_result');
364	563	}
	564	+ if (!wp_next_scheduled('wpo_prune_webp_logs')) {
	565	+ wp_schedule_event(time(), 'weekly', 'wpo_prune_webp_logs');
	566	+ }
	567	+ if (!wp_next_scheduled('wpo_webp_convert_compressed_images')) {
	568	+ wp_schedule_event(strtotime('midnight'), 'daily', 'wpo_webp_convert_compressed_images');
	569	+ }
365	570	}
366	571
367	572	/**
368	573	* Remove all cron schedules
	574	+ *
	575	+ * @return void
369	576	*/
370		- public function remove_webp_cron_schedules() {
	577	+ public function remove_webp_cron_schedules(): void {
371	578	wp_clear_scheduled_hook('wpo_reset_webp_conversion_test_result');
	579	+ wp_clear_scheduled_hook('wpo_prune_webp_logs');
	580	+ wp_clear_scheduled_hook('wpo_webp_convert_compressed_images');
372	581	}
373	582
374	583	/**
375		- * Return the true if webp conversion is enabled and vice-versa
	584	+ * Return the true if webp conversion is enabled and vice versa
376	585	*
377	586	* @return bool
378	587	*/
379		- public function is_webp_conversion_enabled() {
	588	+ public function is_webp_conversion_enabled(): bool {
380	589	return $this->_should_use_webp;
381	590	}
382	591
383	592	/**
384	593	* Set the webp_conversion option value to false and remove webp cron schedules
	594	+ *
	595	+ * @return void
385	596	*/
386		- public function disable_webp_conversion() {
	597	+ public function disable_webp_conversion(): void {
387	598	$this->empty_htaccess_file();
388	599	WP_Optimize()->get_options()->update_option("webp_conversion", false);
389	600	$this->remove_webp_cron_schedules();
	601	+ $message = __('Disabling the webp conversion.', 'wp-optimize');
	602	+ $this->log($message);
390	603	}
391	604
392	605	/**
393	606	* Remove webp converted test image file
	607	+ *
	608	+ * @return void
394	609	*/
395		- private function remove_webp_test_image_file() {
396		- $upload_dir = wp_upload_dir();
397		- $destination = $upload_dir['basedir']. '/wpo/images/wpo_logo_small.png.webp';
398		- if (@file_exists($destination)) { // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- suppress PHP warning in case of failure
399		- @unlink($destination); // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- suppress PHP warning in case of failure
400		- }
	610	+ private function remove_webp_test_image_file(): void {
	611	+ $destination = $this->get_webp_test_image_path();
	612	+ wp_delete_file($destination);
401	613	}
402	614
403	615	/**
404	616	* Run during plugin deactivation
	617	+ *
	618	+ * @return void
405	619	*/
406		- public function plugin_deactivate() {
	620	+ public function plugin_deactivate(): void {
407	621	$this->empty_htaccess_file();
408	622	$this->remove_webp_test_image_file();
409	623	}
410	624
411	625	/**
412		- * Determines whether the php shell functions are available or not
	626	+ * Determines whether one of the PHP shell functions required for WebP conversion is available or not.
413	627	*
414	628	* @return bool
415	629	*/
416		- public static function is_shell_functions_available() {
417		- $shell_functions = self::get_shell_functions();
418		- foreach ($shell_functions as $shell_function) {
419		- if (!function_exists($shell_function)) return false;
	630	+ public function shell_functions_available(): bool {
	631	+ $has_escapeshellarg = function_exists('escapeshellarg');
	632	+ $has_exec_or_passthru = $this->any_function_exists(array('exec', 'passthru'));
	633	+ $has_proc_functions = $this->all_functions_exist(array('proc_open', 'proc_close'));
	634	+ $has_popen_functions = $this->all_functions_exist(array('popen', 'pclose'));
	635	+
	636	+ return $has_escapeshellarg && ($has_exec_or_passthru || $has_proc_functions || $has_popen_functions);
	637	+ }
	638	+
	639	+ /**
	640	+ * Checks if only shell converters available for WebP conversion.
	641	+ *
	642	+ * @return boolean
	643	+ */
	644	+ private function is_only_shell_converters_available(): bool {
	645	+ $available_converters = WP_Optimize()->get_options()->get_option('webp_converters');
	646	+ /** @var array<string> $available_converters */
	647	+ $available_converters = is_array($available_converters) ? $available_converters : array();
	648	+ $converters_with_shell = WPO_WebP_Test_Run::get_converters_with_shell();
	649	+ $available_with_shell = array_intersect($available_converters, $converters_with_shell);
	650	+
	651	+ return count($available_converters) > 0 && count($available_converters) === count($available_with_shell);
	652	+ }
	653	+
	654	+ /**
	655	+ * Determines whether one of the PHP shell functions required for WebP conversion is available or not.
	656	+ *
	657	+ * @deprecated 3.6.0
	658	+ * @return bool
	659	+ */
	660	+ public static function is_shell_functions_available(): bool {
	661	+ _deprecated_function(__METHOD__, '3.6.0', 'WP_Optimize_WebP::shell_functions_available');
	662	+ return WP_Optimize_WebP::get_instance()->shell_functions_available();
	663	+ }
	664	+
	665	+ /**
	666	+ * Check if all the functions from the list is available.
	667	+ *
	668	+ * @param array<string> $functions
	669	+ * @return bool
	670	+ */
	671	+ private function all_functions_exist($functions): bool {
	672	+ foreach ($functions as $function) {
	673	+ if (!function_exists($function)) return false;
420	674	}
421	675	return true;
422	676	}
423	677
424	678	/**
425		- * List of php shell function names
	679	+ * Check if one of the functions from the list is available.
426	680	*
427		- * @return string[]
	681	+ * @param array<string> $functions
	682	+ * @return bool
428	683	*/
429		- private static function get_shell_functions() {
430		- return array(
431		- 'escapeshellarg',
432		- 'escapeshellcmd',
433		- 'exec',
434		- 'passthru',
435		- 'proc_close',
436		- 'proc_get_status',
437		- 'proc_nice',
438		- 'proc_open',
439		- 'proc_terminate',
440		- 'shell_exec',
441		- 'system',
442		- );
	684	+ private function any_function_exists($functions): bool {
	685	+ foreach ($functions as $function) {
	686	+ if (function_exists($function)) return true;
	687	+ }
	688	+ return false;
	689	+ }
	690	+
	691	+ /**
	692	+ * Return true if webp conversion is enabled and vice versa.
	693	+ *
	694	+ * @return bool
	695	+ */
	696	+ public function is_webp_enabled(): bool {
	697	+ _deprecated_function(__METHOD__, '4.5.4', 'WP_Optimize_WebP::is_webp_conversion_enabled');
	698	+ return $this->is_webp_conversion_enabled();
	699	+ }
	700	+
	701	+ /**
	702	+ * Actions to be performed upon plugin activation
	703	+ *
	704	+ * @return void
	705	+ */
	706	+ public function plugin_activate(): void {
	707	+ if ($this->is_webp_conversion_enabled()) {
	708	+ $this->init_webp_cron_scheduler();
	709	+ $this->reset_webp_serving_method();
	710	+ }
443	711	}
444	712	}
445	713
446	714	endif;