← All changes | webp/class-wp-optimize-webp.php +378 -108 3.3.2 → 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,45 +216,59 @@
54	216	}
55	217	}
56	218
57	219	/**
58		- * If .htaccess redirection is not possible, attempts to use the alter_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
59	225	*/
60		- private function maybe_decide_webp_serve_method() {
	226	+ public function maybe_decide_webp_serve_method(string $buffer): string {
61	227	if (!$this->is_webp_redirection_possible()) {
62		- $this->maybe_use_alter_html();
	228	+ $buffer = $this->maybe_use_alter_html($buffer);
63	229	}
	230	+ return $buffer;
64	231	}
65	232
66	233	/**
67		- * 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
68	239	*/
69		- private function maybe_use_alter_html() {
	240	+ private function maybe_use_alter_html(string $buffer): string {
70	241	if ($this->is_alter_html_possible()) {
71		- $this->use_alter_html();
	242	+ $this->empty_htaccess_file();
	243	+ $buffer = WPO_WebP_Alter_HTML::get_instance()->alter_html($buffer);
72	244	}
	245	+ return $buffer;
73	246	}
74	247
75	248	/**
76		- * Even if server support .htaccess rewrite, sometimes it is not possible
77		- * 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.
78	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	+ *
79	255	* @return bool
80	256	*/
81		- 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	+
82	262	$redirection_possible = WP_Optimize()->get_options()->get_option('redirection_possible');
83		- 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	+
84	269	return $this->run_webp_serving_self_test();
85	270	}
86		-
87		- /**
88		- * Decide whether the browser requesting the URL can accept webp images or not
89		- *
90		- * @return bool
91		- */
92		- private function is_browser_accepting_webp() {
93		- return (isset($_SERVER['HTTP_ACCEPT']) && false !== strpos($_SERVER['HTTP_ACCEPT'], 'image/webp'));
94		- }
95	271
96	272	/**
97	273	* Detect whether using alter HTML method is possible or not
98	274	*
		@@ -97,26 +273,18 @@
97	273	* Detect whether using alter HTML method is possible or not
98	274	*
99	275	* @return bool
100	276	*/
101		- private function is_alter_html_possible() {
102		- if ($this->is_browser_accepting_webp()) {
103		- return true;
104		- }
105		- return false;
	277	+ private function is_alter_html_possible(): bool {
	278	+ return WPO_WebP_Utils::is_browser_accepting_webp();
106	279	}
107	280
108	281	/**
109		- * Setup alter html method
110		- */
111		- private function use_alter_html() {
112		- WPO_WebP_Alter_HTML::get_instance();
113		- }
114		-
115		- /**
116	282	* Initialize .htaccess
	283	+ *
	284	+ * @return void
117	285	*/
118		- private function setup_htaccess_file() {
	286	+ private function setup_htaccess_file(): void {
119	287	if (null !== $this->_htaccess) return;
120	288	$wp_uploads = wp_get_upload_dir();
121	289	$htaccess_file = $wp_uploads['basedir'] . '/.htaccess';
122	290	if (!file_exists($htaccess_file)) {
		@@ -129,9 +297,9 @@
129	297	* Save .htaccess rules
130	298	*
131	299	* @return void
132	300	*/
133		- public function save_htaccess_rules() {
	301	+ private function save_htaccess_rules(): void {
134	302	$this->setup_htaccess_file();
135	303	$this->add_webp_mime_type();
136	304	$htaccess_comment_section = 'WP-Optimize WebP Rules';
137	305	if ($this->_htaccess->is_commented_section_exists($htaccess_comment_section)) return;
		@@ -136,14 +304,19 @@
136	304	$htaccess_comment_section = 'WP-Optimize WebP Rules';
137	305	if ($this->_htaccess->is_commented_section_exists($htaccess_comment_section)) return;
138	306	$this->_htaccess->update_commented_section($this->prepare_webp_htaccess_rules(), $htaccess_comment_section);
139	307	$this->_htaccess->write_file();
	308	+ WP_Optimize()->get_options()->update_option('htaccess_has_webp_rules', true);
140	309	}
141	310
142	311	/**
143	312	* Empty .htaccess file
	313	+ *
	314	+ * @return void
144	315	*/
145		- 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;
146	319	$this->setup_htaccess_file();
147	320	$htaccess_comment_sections = array(
148	321	'WP-Optimize WebP Rules',
149	322	'Register webp mime type',
		@@ -152,14 +325,15 @@
152	325	if (!$this->_htaccess->is_commented_section_exists($htaccess_comment_section)) continue;
153	326	$this->_htaccess->remove_commented_section($htaccess_comment_section);
154	327	$this->_htaccess->write_file();
155	328	}
	329	+ WP_Optimize()->get_options()->update_option('htaccess_has_webp_rules', false);
156	330	}
157	331
158	332	/**
159	333	* Prepare array of htaccess rules to use webp images.
160	334	*
161		- * @return array
	335	+ * @return array<int, array<array<array<string>|string>|string>>
162	336	*/
163	337	private function prepare_webp_htaccess_rules() {
164	338	return array(
165	339	array(
		@@ -213,10 +387,12 @@
213	387	}
214	388
215	389	/**
216	390	* Add webp mime type to htaccess rules.
	391	+ *
	392	+ * @return void
217	393	*/
218		- private function add_webp_mime_type() {
	394	+ private function add_webp_mime_type(): void {
219	395	$htaccess_comment_section = 'Register webp mime type';
220	396	if ($this->_htaccess->is_exists() && !$this->_htaccess->is_commented_section_exists($htaccess_comment_section)) {
221	397	$webp_mime_type = array(
222	398	array(
		@@ -230,34 +406,41 @@
230	406	}
231	407	}
232	408
233	409	/**
234		- * Checks whether webp conversion test is successful or not
	410	+ * Returns the path to the WebP test image file.
235	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	+ *
236	422	* @return bool
237	423	*/
238		- public function is_webp_conversion_successful() {
239		- $upload_dir = wp_upload_dir();
240		- $destination = $upload_dir['basedir']. '/wpo/images/wpo_logo_small.png.webp';
241		- return file_exists($destination);
	424	+ private function is_webp_conversion_successful(): bool {
	425	+ return file_exists($this->get_webp_test_image_path());
242	426	}
243	427
244	428	/**
245		- * Checks whether sample webp conversion test should be run or not
	429	+ * Checks whether a sample webp conversion test should be run or not
246	430	*
247		- * @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
248	432	*/
249		- public function should_run_webp_conversion_test() {
250		- $webp_conversion_test = $this->get_webp_conversion_test_result();
251		- return (true !== $webp_conversion_test);
	433	+ private function should_run_webp_conversion_test(): bool {
	434	+ return !$this->get_webp_conversion_test_result();
252	435	}
253	436
254	437	/**
255	438	* Returns webp conversion test result
256	439	*
257		- * @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
258	441	*/
259		- private function get_webp_conversion_test_result() {
	442	+ public function get_webp_conversion_test_result(): bool {
260	443	return (bool) WP_Optimize()->get_options()->get_option('webp_conversion_test');
261	444	}
262	445
263	446	/**
		@@ -264,9 +447,9 @@
264	447	* Checks whether the webp redirection is possible or not and sets flag
265	448	*
266	449	* @return bool Returns true if webp is served successfully, false otherwise
267	450	*/
268		- private function run_webp_serving_self_test() {
	451	+ private function run_webp_serving_self_test(): bool {
269	452	$self_test = WPO_WebP_Self_Test::get_instance();
270	453
271	454	if ($self_test->is_webp_served()) {
272	455	WP_Optimize()->get_options()->update_option('redirection_possible', 'true');
		@@ -278,25 +461,27 @@
278	461	}
279	462
280	463	/**
281	464	* Resets webp serving method by running self test, if needed purges cache and empties `uploads/.htaccess` file
	465	+ *
	466	+ * @return void
282	467	*/
283		- public function reset_webp_serving_method() {
284		- if (self::is_shell_functions_available() && $this->_should_use_webp) {
	468	+ public function reset_webp_serving_method(): void {
	469	+ if ($this->_should_use_webp) {
285	470	$this->reset_webp_options();
286	471	$this->run_self_test();
287	472	list($old_redirection_possible, $new_redirection_possible) = $this->get_old_and_new_redirection_possibility();
288	473	$this->maybe_purge_cache($old_redirection_possible, $new_redirection_possible);
289	474	$this->maybe_empty_htaccess_file($new_redirection_possible);
290		- } else {
291		- $this->disable_webp_conversion();
292	475	}
293	476	}
294	477
295	478	/**
296	479	* Resets WebP related options
	480	+ *
	481	+ * @return void
297	482	*/
298		- private function reset_webp_options() {
	483	+ private function reset_webp_options(): void {
299	484	$options = WP_Optimize()->get_options();
300	485	$options->update_option('old_redirection_possible', $options->get_option('redirection_possible'));
301	486	$options->update_option('webp_conversion_test', false);
302	487	$options->update_option('webp_converters', false);
		@@ -305,10 +490,12 @@
305	490	}
306	491
307	492	/**
308	493	* Running self test to find available converters and possibility of serving webp using redirection method
	494	+ *
	495	+ * @return void
309	496	*/
310		- private function run_self_test() {
	497	+ private function run_self_test(): void {
311	498	$this->set_converter_status();
312	499	if ($this->get_webp_conversion_test_result()) {
313	500	$this->save_htaccess_rules();
314	501	$this->run_webp_serving_self_test();
		@@ -313,8 +500,9 @@
313	500	$this->save_htaccess_rules();
314	501	$this->run_webp_serving_self_test();
315	502	} else {
316	503	$this->disable_webp_conversion();
	504	+ $this->log("No working WebP converter was found on the server when running self-test, disabling WebP conversion");
317	505	}
318	506	}
319	507
320	508	/**
		@@ -319,9 +507,9 @@
319	507
320	508	/**
321	509	* Gets old and new redirection possibility values
322	510	*
323		- * @return array
	511	+ * @return array<string>
324	512	*/
325	513	private function get_old_and_new_redirection_possibility() {
326	514	$options = WP_Optimize()->get_options();
327	515	return array(
		@@ -332,15 +520,25 @@
332	520
333	521	/**
334	522	* Cache is cleared when there is a change in the potential for serving WebP using redirection.
335	523	*
336		- * @param string $old_redirection_possible
337		- * @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
338	527	*/
339		- private function maybe_purge_cache($old_redirection_possible, $new_redirection_possible) {
340		- if ($old_redirection_possible !== $new_redirection_possible) {
341		- 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;
342	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	+ }
343	541	}
344	542
345	543	/**
346	544	* Remove redirection rules from `uploads/.htaccess` file if redirection is not possible
		@@ -345,10 +543,11 @@
345	543	/**
346	544	* Remove redirection rules from `uploads/.htaccess` file if redirection is not possible
347	545	*
348	546	* @param string $new_redirection_possible
	547	+ * @return void
349	548	*/
350		- private function maybe_empty_htaccess_file($new_redirection_possible) {
	549	+ private function maybe_empty_htaccess_file($new_redirection_possible): void {
351	550	if ('false' === $new_redirection_possible) {
352	551	$this->empty_htaccess_file();
353	552	}
354	553	}
		@@ -354,91 +553,162 @@
354	553	}
355	554
356	555	/**
357	556	* Initialize cron scheduler
	557	+ *
	558	+ * @return void
358	559	*/
359		- public function init_webp_cron_scheduler() {
	560	+ public function init_webp_cron_scheduler(): void {
360	561	if (!wp_next_scheduled('wpo_reset_webp_conversion_test_result')) {
361	562	wp_schedule_event(time(), 'wpo_daily', 'wpo_reset_webp_conversion_test_result');
362	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	+ }
363	570	}
364	571
365	572	/**
366	573	* Remove all cron schedules
	574	+ *
	575	+ * @return void
367	576	*/
368		- public function remove_webp_cron_schedules() {
	577	+ public function remove_webp_cron_schedules(): void {
369	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');
370	581	}
371	582
372	583	/**
373		- * Return the true if webp conversion is enabled and vice-versa
	584	+ * Return the true if webp conversion is enabled and vice versa
374	585	*
375	586	* @return bool
376	587	*/
377		- public function is_webp_conversion_enabled() {
	588	+ public function is_webp_conversion_enabled(): bool {
378	589	return $this->_should_use_webp;
379	590	}
380	591
381	592	/**
382	593	* Set the webp_conversion option value to false and remove webp cron schedules
	594	+ *
	595	+ * @return void
383	596	*/
384		- public function disable_webp_conversion() {
	597	+ public function disable_webp_conversion(): void {
385	598	$this->empty_htaccess_file();
386	599	WP_Optimize()->get_options()->update_option("webp_conversion", false);
387	600	$this->remove_webp_cron_schedules();
	601	+ $message = __('Disabling the webp conversion.', 'wp-optimize');
	602	+ $this->log($message);
388	603	}
389	604
390	605	/**
391	606	* Remove webp converted test image file
	607	+ *
	608	+ * @return void
392	609	*/
393		- private function remove_webp_test_image_file() {
394		- $upload_dir = wp_upload_dir();
395		- $destination = $upload_dir['basedir']. '/wpo/images/wpo_logo_small.png.webp';
396		- if (@file_exists($destination)) { // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- suppress PHP warning in case of failure
397		- @unlink($destination); // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- suppress PHP warning in case of failure
398		- }
	610	+ private function remove_webp_test_image_file(): void {
	611	+ $destination = $this->get_webp_test_image_path();
	612	+ wp_delete_file($destination);
399	613	}
400	614
401	615	/**
402	616	* Run during plugin deactivation
	617	+ *
	618	+ * @return void
403	619	*/
404		- public function plugin_deactivate() {
	620	+ public function plugin_deactivate(): void {
405	621	$this->empty_htaccess_file();
406	622	$this->remove_webp_test_image_file();
407	623	}
408	624
409	625	/**
410		- * 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.
411	627	*
412	628	* @return bool
413	629	*/
414		- public static function is_shell_functions_available() {
415		- $shell_functions = self::get_shell_functions();
416		- foreach ($shell_functions as $shell_function) {
417		- 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;
418	674	}
419	675	return true;
420	676	}
421	677
422	678	/**
423		- * List of php shell function names
	679	+ * Check if one of the functions from the list is available.
424	680	*
425		- * @return string[]
	681	+ * @param array<string> $functions
	682	+ * @return bool
426	683	*/
427		- private static function get_shell_functions() {
428		- return array(
429		- 'escapeshellarg',
430		- 'escapeshellcmd',
431		- 'exec',
432		- 'passthru',
433		- 'proc_close',
434		- 'proc_get_status',
435		- 'proc_nice',
436		- 'proc_open',
437		- 'proc_terminate',
438		- 'shell_exec',
439		- 'system',
440		- );
	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	+ }
441	711	}
442	712	}
443	713
444	714	endif;