' . esc_html__( 'Configure PHP settings to optimize your WordPress site performance.', 'easy-php-settings' ) . '
'; }, 'easy_php_settings' ); $labels = array( 'memory_limit' => __( 'Memory Limit', 'easy-php-settings' ), 'upload_max_filesize' => __( 'Upload Max Filesize', 'easy-php-settings' ), 'post_max_size' => __( 'Post Max Size', 'easy-php-settings' ), 'max_execution_time' => __( 'Max Execution Time', 'easy-php-settings' ), 'max_input_vars' => __( 'Max Input Vars', 'easy-php-settings' ), ); foreach ( $this->plugin->get_settings_keys() as $key ) { add_settings_field( $key, $labels[ $key ] ?? ucwords( str_replace( array( '_', '.' ), ' ', $key ) ), array( $this, 'render_setting_field' ), 'easy_php_settings', 'easy_php_settings_section', array( 'key' => $key ) ); } $this->apply_settings(); } /* ─── Sanitize Callbacks ──────────────────── */ public function sanitize_callback( $input ) { $old_input = $this->plugin->get_option( 'easy_php_settings_settings', array() ); $new_input = array(); foreach ( $this->plugin->get_settings_keys() as $key ) { if ( isset( $input[ $key ] ) ) { $sanitized = Easy_Settings_Validator::sanitize_setting( $key, $input[ $key ] ); $validation = Easy_Settings_Validator::validate_setting( $key, $sanitized ); if ( is_wp_error( $validation ) ) { Easy_Error_Handler::add_settings_error( 'easy_php_settings_settings', 'validation_error_' . $key, $validation->get_error_message(), 'error' ); continue; } $new_input[ $key ] = $sanitized; } } if ( isset( $input['custom_php_ini'] ) ) { $new_input['custom_php_ini'] = trim( $input['custom_php_ini'] ); } foreach ( Easy_Settings_Validator::validate_settings_relationships( $new_input ) as $error ) { add_settings_error( 'easy_php_settings_settings', 'relationship_warning', $error, 'warning' ); } $this->validate_settings( $new_input ); Easy_Settings_History::add_entry( $old_input, $new_input, 'php_settings' ); Easy_Settings_Cache::invalidate( 'settings' ); if ( ! empty( $new_input ) ) { try { $this->generate_config_files( $new_input ); } catch ( Exception $e ) { Easy_Error_Handler::handle_exception( $e, 'generate_config_files' ); Easy_Error_Handler::add_settings_error( 'easy_php_settings_settings', 'config_generation_error', __( 'Failed to generate configuration files. Please check error log.', 'easy-php-settings' ), 'error' ); } } return $new_input; } public function sanitize_wp_memory_callback( $input ) { $old_input = $this->plugin->get_option( 'easy_php_settings_wp_memory_settings', array() ); $new_input = array(); foreach ( $this->plugin->get_wp_memory_settings_keys() as $key ) { if ( isset( $input[ $key ] ) ) { $sanitized = Easy_Settings_Validator::sanitize_setting( $key, $input[ $key ] ); $validation = Easy_Settings_Validator::validate_wp_memory_setting( $key, $sanitized ); if ( is_wp_error( $validation ) ) { Easy_Error_Handler::add_settings_error( 'easy_php_settings_wp_memory_settings', 'validation_error_' . $key, $validation->get_error_message(), 'error' ); continue; } $new_input[ $key ] = $sanitized; } } Easy_Settings_History::add_entry( $old_input, $new_input, 'wp_memory' ); if ( ! empty( $new_input ) ) { try { $this->update_wp_memory_constants( $new_input ); } catch ( Exception $e ) { Easy_Error_Handler::handle_exception( $e, 'update_wp_memory_constants' ); Easy_Error_Handler::add_settings_error( 'easy_php_settings_wp_memory_settings', 'config_update_error', __( 'Failed to update wp-config.php. Please check error log.', 'easy-php-settings' ), 'error' ); } } return $new_input; } /* ─── Validation ──────────────────────────── */ private function validate_settings( $settings ) { $warnings = array(); if ( isset( $settings['post_max_size'], $settings['upload_max_filesize'] ) ) { if ( $this->plugin->convert_to_bytes( $settings['post_max_size'] ) < $this->plugin->convert_to_bytes( $settings['upload_max_filesize'] ) ) { $warnings[] = __( 'post_max_size should be larger than upload_max_filesize.', 'easy-php-settings' ); } } if ( isset( $settings['memory_limit'], $settings['post_max_size'] ) ) { if ( $this->plugin->convert_to_bytes( $settings['memory_limit'] ) < $this->plugin->convert_to_bytes( $settings['post_max_size'] ) ) { $warnings[] = __( 'memory_limit should be larger than post_max_size.', 'easy-php-settings' ); } } if ( isset( $settings['max_execution_time'] ) && intval( $settings['max_execution_time'] ) < 30 ) { $warnings[] = __( 'max_execution_time is very low (less than 30 seconds) and may cause issues.', 'easy-php-settings' ); } if ( isset( $settings['memory_limit'] ) && $this->plugin->convert_to_bytes( $settings['memory_limit'] ) > 536870912 ) { $warnings[] = __( 'memory_limit is very high (over 512M). This may be excessive unless you have a specific need.', 'easy-php-settings' ); } foreach ( $warnings as $w ) { add_settings_error( 'easy_php_settings_settings', 'validation_warning', $w, 'warning' ); } } /* ─── Config file generation ──────────────── */ private function generate_config_files( $settings ) { $content = "; PHP Settings generated by Easy PHP Settings plugin\n"; $content .= "; Created By H M Shahadul Islam\n"; $content .= '; Generated on: ' . current_time( 'mysql' ) . "\n\n"; foreach ( $settings as $key => $value ) { if ( in_array( $key, $this->plugin->get_settings_keys(), true ) && ! empty( $value ) ) { $content .= "$key = $value\n"; } } if ( ! empty( $settings['custom_php_ini'] ) ) { $content .= "\n; Custom php.ini directives\n" . $settings['custom_php_ini'] . "\n"; } $result = EasyIniFile::write( $content ); if ( is_wp_error( $result ) ) { Easy_Error_Handler::add_settings_error( 'easy_php_settings_settings', 'config_files_error', $result->get_error_message(), 'error' ); } elseif ( ! empty( $result ) && is_array( $result ) ) { add_settings_error( 'easy_php_settings_settings', 'config_files_created', sprintf( __( 'Settings saved and written to: %s. Please restart your web server for changes to take effect.', 'easy-php-settings' ), implode( ', ', $result ) ), 'updated' ); } else { add_settings_error( 'easy_php_settings_settings', 'config_files_error', __( 'Settings saved, but could not write to INI files. Please check file permissions.', 'easy-php-settings' ), 'warning' ); } } /* ─── Apply runtime ini_set ───────────────── */ private function apply_settings() { $options = $this->plugin->get_option( 'easy_php_settings_settings' ); if ( empty( $options ) || ! is_array( $options ) ) { return; } $all = ini_get_all(); foreach ( $options as $key => $value ) { if ( ! in_array( $key, $this->plugin->get_settings_keys(), true ) || empty( $value ) ) { continue; } $access = $all[ $key ]['access'] ?? 0; if ( INI_USER !== $access && INI_ALL !== $access ) { continue; } // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged, WordPress.PHP.IniSet.Risky @ini_set( $key, $value ); } } /* ─── WP Memory Constants ─────────────────── */ private function update_wp_memory_constants( $input ) { global $wp_filesystem; if ( ! $wp_filesystem ) { require_once ABSPATH . 'wp-admin/includes/file.php'; WP_Filesystem(); } $config_path = ABSPATH . 'wp-config.php'; if ( ! $wp_filesystem->is_writable( $config_path ) ) { Easy_Error_Handler::add_settings_error( 'easy_php_settings_wp_memory_settings', 'config_not_writable', __( 'wp-config.php is not writable.', 'easy-php-settings' ), 'error' ); return; } $backup = Easy_Config_Backup::create_backup(); if ( is_wp_error( $backup ) ) { Easy_Error_Handler::log_error( $backup->get_error_message(), 'create_backup', 'warning' ); } $config_content = $wp_filesystem->get_contents( $config_path ); if ( false === $config_content ) { throw new Exception( __( 'Failed to read wp-config.php file.', 'easy-php-settings' ) ); } foreach ( array( 'WP_MEMORY_LIMIT', 'WP_MAX_MEMORY_LIMIT' ) as $const ) { $key = strtolower( $const ); if ( empty( $input[ $key ] ) ) { continue; } $trimmed = trim( $input[ $key ] ); if ( ! preg_match( '/^(\d+)([KMGT]?)$/i', $trimmed ) ) { throw new Exception( sprintf( __( 'Invalid value format for %s. Only numbers and K/M/G/T units are allowed.', 'easy-php-settings' ), $const ) ); } $sanitized = preg_replace( '/[^0-9KMGT]/i', '', $trimmed ); $validation = Easy_Settings_Validator::validate_wp_memory_setting( $key, $sanitized ); if ( is_wp_error( $validation ) ) { throw new Exception( $validation->get_error_message() ); } $result = Easy_Config_Parser::update_constant( $config_content, $const, $sanitized, 'string' ); if ( is_wp_error( $result ) ) { throw new Exception( $result->get_error_message() ); } $config_content = $result; } $validation = Easy_Config_Backup::validate_config_structure( $config_content ); if ( is_wp_error( $validation ) ) { $latest = Easy_Config_Backup::get_latest_backup(); if ( $latest ) { Easy_Config_Backup::restore_backup( $latest['key'] ); } throw new Exception( $validation->get_error_message() ); } if ( ! $wp_filesystem->put_contents( $config_path, $config_content ) ) { $latest = Easy_Config_Backup::get_latest_backup(); if ( $latest ) { Easy_Config_Backup::restore_backup( $latest['key'] ); } throw new Exception( __( 'Failed to write wp-config.php file.', 'easy-php-settings' ) ); } add_settings_error( 'easy_php_settings_wp_memory_settings', 'wp_memory_updated', __( 'WordPress memory settings updated successfully in wp-config.php.', 'easy-php-settings' ), 'updated' ); } /* ─── INI File Delete Action ──────────────── */ private function handle_ini_file_actions() { if ( ! isset( $_POST['easy_php_settings_delete_ini_files'] ) || ! check_admin_referer( 'easy_php_settings_delete_ini_nonce' ) ) { return; } if ( ! current_user_can( $this->plugin->get_capability() ) ) { return; } $result = EasyIniFile::remove_files(); if ( is_wp_error( $result ) ) { Easy_Error_Handler::add_settings_error( 'easy_php_settings_settings', 'files_deleted_error', $result->get_error_message(), 'error' ); } elseif ( ! empty( $result ) && is_array( $result ) ) { add_settings_error( 'easy_php_settings_settings', 'files_deleted_success', sprintf( __( 'Successfully deleted: %s.', 'easy-php-settings' ), implode( ', ', $result ) ), 'success' ); } else { add_settings_error( 'easy_php_settings_settings', 'files_deleted_error', __( 'Could not delete INI files. They may not exist or have permission issues.', 'easy-php-settings' ), 'warning' ); } } /* ─── Admin Tab ───────────────────────────── */ public function get_admin_tab() { return array( 'id' => 'general_settings', 'title' => __( 'General Settings', 'easy-php-settings' ), 'callback' => array( $this, 'render_tab' ), ); } /* ─── Field Renderers ─────────────────────── */ public function render_setting_field( $args ) { $options = $this->plugin->get_option( 'easy_php_settings_settings' ); $key = $args['key']; $value = isset( $options[ $key ] ) ? $options[ $key ] : ''; $current_value = ini_get( $key ); $all_settings = ini_get_all(); $recommended = $this->plugin->get_recommended_values(); $access = $all_settings[ $key ]['access'] ?? 0; $is_changeable = ( INI_USER === $access || INI_ALL === $access ); $tooltips = $this->plugin->get_tooltips(); $tooltip = isset( $tooltips[ $key ] ) ? $tooltips[ $key ] : ''; $field_id = 'easy_php_settings_' . esc_attr( $key ); $aria_label = sprintf( __( 'Enter value for %s', 'easy-php-settings' ), esc_attr( $key ) ); $aria_desc = $field_id . '_description'; if ( $tooltip ) { $aria_desc = $field_id . '_help ' . $aria_desc; } echo ''; echo ""; if ( $tooltip ) { echo ''; } echo ''; $this->render_status_indicator( $key, $current_value, $recommended ); if ( ! $is_changeable ) { echo '' . esc_html__( 'This setting cannot be changed at runtime. Use the configuration generator below.', 'easy-php-settings' ) . '
'; $this->show_alternative_instructions( $key, $recommended ); } } public function render_wp_memory_field( $args ) { $options = $this->plugin->get_option( 'easy_php_settings_wp_memory_settings' ); $key = $args['key']; $value = isset( $options[ $key ] ) ? $options[ $key ] : ''; $current_value = $this->get_wp_memory_value( $key ); $recommended = $this->plugin->get_wp_memory_recommended_values(); $tooltips = $this->plugin->get_tooltips(); $tooltip = isset( $tooltips[ $key ] ) ? $tooltips[ $key ] : ''; $field_id = 'easy_php_settings_wp_memory_' . esc_attr( $key ); $aria_label = sprintf( __( 'Enter value for %s', 'easy-php-settings' ), esc_attr( $key ) ); $aria_desc = $field_id . '_description'; if ( $tooltip ) { $aria_desc = $field_id . '_help ' . $aria_desc; } echo ''; echo ""; if ( $tooltip ) { echo ''; } echo ''; $this->render_memory_status_indicator( $key, $current_value, $recommended ); } /* ─── Status Indicators ───────────────────── */ /** * Get status label and CSS class for a setting value vs recommended. * Returns: 'low' | 'ok' | 'high' (too high / warning). */ private function get_status_for_value( $key, $current_value, $recommended ) { if ( ! isset( $recommended[ $key ] ) ) { return null; } $rec = $recommended[ $key ]; $is_size = in_array( $key, array( 'memory_limit', 'upload_max_filesize', 'post_max_size', 'wp_memory_limit', 'wp_max_memory_limit' ), true ); $current_bytes = $is_size ? $this->plugin->convert_to_bytes( $current_value ) : (int) $current_value; $rec_bytes = $is_size ? $this->plugin->convert_to_bytes( $rec ) : (int) $rec; if ( $current_bytes < $rec_bytes ) { return 'low'; } $threshold = $is_size ? 1.5 : 2; if ( $rec_bytes > 0 && $current_bytes > $rec_bytes * $threshold ) { return 'high'; } return 'ok'; } private function render_status_indicator( $key, $current_value, $recommended ) { $field_id = 'easy_php_settings_' . esc_attr( $key ); $description = sprintf( esc_html__( 'Current value: %s', 'easy-php-settings' ), esc_html( $current_value ) ); if ( isset( $recommended[ $key ] ) ) { $rec = $recommended[ $key ]; $desc = sprintf( esc_html__( ' | Recommended: %s', 'easy-php-settings' ), esc_html( $rec ) ); $status = $this->get_status_for_value( $key, $current_value, $recommended ); if ( 'low' === $status ) { $description .= $desc . ' ' . esc_html__( 'Low', 'easy-php-settings' ) . ''; } elseif ( 'high' === $status ) { $description .= $desc . ' ' . esc_html__( 'Higher than recommended', 'easy-php-settings' ) . ''; } else { $description .= $desc . ' ' . esc_html__( 'OK', 'easy-php-settings' ) . ''; } } echo '' . wp_kses_post( $description ) . '
'; } private function render_memory_status_indicator( $key, $current_value, $recommended ) { $field_id = 'easy_php_settings_wp_memory_' . esc_attr( $key ); $description = sprintf( esc_html__( 'Current value: %s', 'easy-php-settings' ), esc_html( $current_value ) ); if ( isset( $recommended[ $key ] ) ) { $rec = $recommended[ $key ]; $desc = sprintf( esc_html__( ' | Recommended: %s', 'easy-php-settings' ), esc_html( $rec ) ); $status = $this->get_status_for_value( $key, $current_value, $recommended ); if ( 'low' === $status ) { $description .= $desc . ' ' . esc_html__( 'Low', 'easy-php-settings' ) . ''; } elseif ( 'high' === $status ) { $description .= $desc . ' ' . esc_html__( 'Higher than recommended', 'easy-php-settings' ) . ''; } else { $description .= $desc . ' ' . esc_html__( 'OK', 'easy-php-settings' ) . ''; } } echo '' . wp_kses_post( $description ) . '
'; } /* ─── Helpers ─────────────────────────────── */ private function get_wp_memory_value( $key ) { switch ( $key ) { case 'wp_memory_limit': return defined( 'WP_MEMORY_LIMIT' ) ? WP_MEMORY_LIMIT : '40M'; case 'wp_max_memory_limit': return defined( 'WP_MAX_MEMORY_LIMIT' ) ? WP_MAX_MEMORY_LIMIT : '256M'; default: return 'N/A'; } } private function show_alternative_instructions( $key, $recommended ) { $options = $this->plugin->get_option( 'easy_php_settings_settings' ); $user_value = isset( $options[ $key ] ) ? $options[ $key ] : ( $recommended[ $key ] ?? '128M' ); $server_api = php_sapi_name(); $htaccess_line = 'php_value ' . $key . ' ' . $user_value; $user_ini_line = $key . ' = ' . $user_value; $php_ini_line = $key . ' = ' . $user_value; $block_id = 'easy-php-manual-' . esc_attr( $key ); $output = '' . esc_html( $htaccess_line ) . '';
$output .= '' . esc_html( $user_ini_line ) . '';
$output .= '' . esc_html( $php_ini_line ) . '';
$output .= '