HEX
Server: LiteSpeed
System: Linux server902.web-hosting.com 4.18.0-553.54.1.lve.el8.x86_64 #1 SMP Wed Jun 4 13:01:13 UTC 2025 x86_64
User: deshuvsd (2181)
PHP: 8.1.33
Disabled: NONE
Upload Files
File: /home/deshuvsd/www/wp-content/plugins/suremails/inc/emails/handler/connection-handler-factory.php
<?php
/**
 * Connection Handler Factory
 *
 * @since 0.0.1
 * @package suremails
 */

namespace SureMails\Inc\Emails\Handler;

use SureMails\Inc\API\SaveTestConnection;
use SureMails\Inc\Emails\Providers\Simulator\SimulationHandler;
use SureMails\Inc\Settings;

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly.
}

/**
 * Factory class to create appropriate connection handler based on type.
 */
class ConnectionHandlerFactory {
	/**
	 * Create appropriate connection handler based on type.
	 *
	 * @param array $connection_data Connection data.
	 * @since 0.0.1
	 * @return ConnectionHandler|null
	 */
	public static function create( array $connection_data ) {

		// Check if simulation is enabled. If enabled, return simulation handler.
		if ( self::should_use_simulation() ) {
			$handler = new SimulationHandler( [] );
			if ( $handler instanceof ConnectionHandler ) {
				return $handler;
			}
		}
		$handler_class = 'SureMails\\Inc\\Emails\\Providers\\' . strtoupper( $connection_data['type'] ) . '\\' . ucfirst( strtolower( $connection_data['type'] ) ) . 'Handler';

		if ( class_exists( $handler_class ) ) {
			$handler = new $handler_class( $connection_data );

			// Ensure the handler implements ConnectionHandler.
			if ( $handler instanceof ConnectionHandler ) {
				return $handler;
			}
		}

		return null;
	}

	/**
	 * Determine if simulation mode should be used and it's not a invokation from Save Test Connection.
	 * The simulation mode is used to test email sending without actually sending emails.
	 *
	 * @since 1.5.0
	 *
	 * @return bool
	 */
	private static function should_use_simulation() {
		return Settings::instance()->get_email_simulation_status()
			&& ! SaveTestConnection::instance()->saving_connection;
	}
}