EE_Registry::add_module() - Code Metrics - Inspection of "Daily Inspection: Merge remote-tracking branch 'gi..." - eventespresso/event-espresso-core - Measure and Improve Code Quality continuously with Scrutinizer

Completed
Branch — BUG-9871-email-validation (e62b1a)

unknown
created 2016-08-05 21:25 UTC
EE_Registry::add_module() A

↳ Parent: EE_Registry
Complexity

Conditions	3
Paths	3
Size

Total Lines	11
Code Lines	8
Duplication

Lines	0
Ratio	0 %
Importance

Changes
Metric	Value
cc	3
eloc	8
nc	3
nop	1
dl	0
loc	11
rs	9.4285
c	0
b	0
f	0
<?php if ( ! defined('EVENT_ESPRESSO_VERSION')) { exit('No direct script access allowed'); }
/**
 * EE_Registry Class
 *
 * Centralized Application Data Storage and Management
 *
 * @package                Event Espresso
 * @subpackage            core
 * @author                    Brent Christensen
 */
class EE_Registry {

	/**
	 *    EE_Registry Object
	 *
	 * @var EE_Registry $_instance
	 * @access    private
	 */
	private static $_instance = null;

	/**
	 * @var EE_Dependency_Map $_dependency_map
	 * @access    protected
	 */
	protected $_dependency_map = null;

	/**
	 * @var array $_class_abbreviations
	 * @access    protected
	 */
	protected $_class_abbreviations = array();

	/**
	 * @access public
	 * @var \EventEspresso\core\services\commands\CommandBusInterface $BUS
	 */
	public $BUS;

	/**
	 *    EE_Cart Object
	 * @access    public
	 * @var    EE_Cart $CART
	 */
	public $CART = null;

	/**
	 *    EE_Config Object
	 * @access    public
	 * @var    EE_Config $CFG
	 */
	public $CFG = null;

	/**
	 * EE_Network_Config Object
	 * @access public
	 * @var EE_Network_Config $NET_CFG
	 */
	public $NET_CFG = null;

	/**
	 *    StdClass object for storing library classes in
	 *
	 * @public LIB
	 * @var StdClass $LIB
	 */
	public $LIB = null;

	/**
	 *    EE_Request_Handler Object
	 * @access    public
	 * @var    EE_Request_Handler $REQ
	 */
	public $REQ = null;

	/**
	 *    EE_Session Object
	 * @access    public
	 * @var    EE_Session $SSN
	 */
	public $SSN = null;

	/**
	 * holds the ee capabilities object.
	 *
	 * @since 4.5.0
	 *
	 * @var EE_Capabilities
	 */
	public $CAP = null;

	/**
	 * holds the EE_Message_Resource_Manager object.
	 *
	 * @since 4.9.0
	 *
	 * @var EE_Message_Resource_Manager
	 */
	public $MRM = null;

	/**
	 *    $addons - StdClass object for holding addons which have registered themselves to work with EE core
	 * @access    public
	 * @var    EE_Addon[]
	 */
	public $addons = null;

	/**
	 *    $models
	 * @access    public
	 * @var    EEM_Base[] $models keys are 'short names' (eg Event), values are class names (eg 'EEM_Event')
	 */
	public $models = array();

	/**
	 *    $modules
	 * @access    public
	 * @var    EED_Module[] $modules
	 */
	public $modules = null;

	/**
	 *    $shortcodes
	 * @access    public
	 * @var    EES_Shortcode[] $shortcodes
	 */
	public $shortcodes = null;

	/**
	 *    $widgets
	 * @access    public
	 * @var    WP_Widget[] $widgets
	 */
	public $widgets = null;

	/**
	 * $non_abstract_db_models
	 * @access public
	 * @var array this is an array of all implemented model names (i.e. not the parent abstract models, or models
	 * which don't actually fetch items from the DB in the normal way (ie, are not children of EEM_Base)).
	 * Keys are model "short names" (eg "Event") as used in model relations, and values are
	 * classnames (eg "EEM_Event")
	 */
	public $non_abstract_db_models = array();

	/**
	 *    $i18n_js_strings - internationalization for JS strings
	 *    usage:   EE_Registry::i18n_js_strings['string_key'] = __( 'string to translate.', 'event_espresso' );
	 *    in js file:  var translatedString = eei18n.string_key;
	 *
	 * @access    public
	 * @var    array
	 */
	public static $i18n_js_strings = array();

	/**
	 *    $main_file - path to espresso.php
	 *
	 * @access    public
	 * @var    array
	 */
	public $main_file;

	/**
	 * array of ReflectionClass objects where the key is the class name
	 *
	 * @access    public
	 * @var ReflectionClass[]
	 */
	public $_reflectors;

	/**
	 * boolean flag to indicate whether or not to load/save dependencies from/to the cache
	 *
	 * @access    protected
	 * @var boolean $_cache_on
	 */
	protected $_cache_on = true;



	/**
	 * @singleton method used to instantiate class object
	 * @access    public
	 * @param  \EE_Dependency_Map $dependency_map
	 * @return \EE_Registry instance
	 */
	public static function instance( \EE_Dependency_Map $dependency_map = null ) {
		// check if class object is instantiated
		if ( ! self::$_instance instanceof EE_Registry ) {
			self::$_instance = new EE_Registry( $dependency_map );
function notNullable(stdClass $x) { }

// Unsafe
function withoutCheck(stdClass $x = null) {
    notNullable($x);
}

// Safe - Alternative 1: Adding Additional Type-Check
function withCheck(stdClass $x = null) {
    if ($x instanceof stdClass) {
        notNullable($x);
    }
}

// Safe - Alternative 2: Changing Parameter
function withNonNullableParam(stdClass $x) {
    notNullable($x);
}
		}
		return self::$_instance;
	}



	/**
	 *protected constructor to prevent direct creation
	 *
	 * @Constructor
	 * @access protected
	 * @param  \EE_Dependency_Map $dependency_map
	 * @return \EE_Registry

	 */
	protected function __construct( \EE_Dependency_Map $dependency_map ) {
		$this->_dependency_map = $dependency_map;
		add_action( 'EE_Load_Espresso_Core__handle_request__initialize_core_loading', array( $this, 'initialize' ) );
	}



	/**
	 * initialize
	 */
	public function initialize() {
		$this->_class_abbreviations = apply_filters(
			'FHEE__EE_Registry____construct___class_abbreviations',
			array(
				'EE_Config'                   => 'CFG',
				'EE_Session'                  => 'SSN',
				'EE_Capabilities'             => 'CAP',
				'EE_Cart'                     => 'CART',
				'EE_Network_Config'           => 'NET_CFG',
				'EE_Request_Handler'          => 'REQ',
				'EE_Message_Resource_Manager' => 'MRM',
				'EventEspresso\core\services\commands\CommandBus' => 'BUS',
			)
		);
		// class library
		$this->LIB = new stdClass();
		$this->addons = new stdClass();

		$this->modules = new stdClass();

		$this->shortcodes = new stdClass();

		$this->widgets = new stdClass();

		$this->load_core( 'Base', array(), true );
		// add our request and response objects to the cache
		$request_loader = $this->_dependency_map->class_loader( 'EE_Request' );
		$this->_set_cached_class(
			$request_loader(),
			'EE_Request'
		);
		$response_loader = $this->_dependency_map->class_loader( 'EE_Response' );
		$this->_set_cached_class(
			$response_loader(),
			'EE_Response'
		);
		add_action( 'AHEE__EE_System__set_hooks_for_core', array( $this, 'init' ) );
	}



	/**
	 *    init
	 *
	 * @access    public
	 * @return    void
	 */
	public function init() {
		// Get current page protocol
		$protocol = isset( $_SERVER[ 'HTTPS' ] ) ? 'https://' : 'http://';
		// Output admin-ajax.php URL with same protocol as current page
		self::$i18n_js_strings[ 'ajax_url' ] = admin_url( 'admin-ajax.php', $protocol );
		self::$i18n_js_strings[ 'wp_debug' ] = defined( 'WP_DEBUG' ) ? WP_DEBUG : false;
	}



	/**
	 * localize_i18n_js_strings
	 *
	 * @return string
	 */
	public static function localize_i18n_js_strings() {
		$i18n_js_strings = (array)EE_Registry::$i18n_js_strings;
		foreach ( $i18n_js_strings as $key => $value ) {
			if ( is_scalar( $value ) ) {
				$i18n_js_strings[ $key ] = html_entity_decode( (string)$value, ENT_QUOTES, 'UTF-8' );
			}
		}

		return "/* <![CDATA[ */ var eei18n = " . wp_json_encode( $i18n_js_strings ) . '; /* ]]> */';
	}



	/**
	 * @param mixed string | EED_Module $module
	 */
	public function add_module( $module ) {
		if ( $module instanceof EED_Module ) {
			$module_class = get_class( $module );
			$this->modules->{$module_class} = $module;
		} else {
			if ( ! class_exists( 'EE_Module_Request_Router' ) ) {
				$this->load_core( 'Module_Request_Router' );
			}
			$this->modules->{$module} = EE_Module_Request_Router::module_factory( $module );
		}
	}



	/**
	 * @param string $module_name
	 * @return mixed EED_Module | NULL
	 */
	public function get_module( $module_name = '' ) {
		return isset( $this->modules->{$module_name} ) ? $this->modules->{$module_name} : null;
	}



	/**
	 *    loads core classes - must be singletons
	 *
	 * @access    public
	 * @param string $class_name - simple class name ie: session
	 * @param mixed $arguments
	 * @param bool $load_only
	 * @return mixed
	 */
	public function load_core( $class_name, $arguments = array(), $load_only = false ) {
		$core_paths = apply_filters(
			'FHEE__EE_Registry__load_core__core_paths',
			array(
				EE_CORE,
				EE_ADMIN,
				EE_CPTS,
				EE_CORE . 'data_migration_scripts' . DS,
				EE_CORE . 'request_stack' . DS,
				EE_CORE . 'middleware' . DS,
			)
		);
		// retrieve instantiated class
		return $this->_load( $core_paths, 'EE_', $class_name, 'core', $arguments, false, true, $load_only );
	}



	/**
	 *    loads service classes
	 *
	 * @access    public
	 * @param string $class_name - simple class name ie: session
	 * @param mixed $arguments
	 * @param bool $load_only
	 * @return mixed
	 */
	public function load_service( $class_name, $arguments = array(), $load_only = false ) {
		$service_paths = apply_filters(
			'FHEE__EE_Registry__load_service__service_paths',
			array(
				EE_CORE . 'services' . DS,
			)
		);
		// retrieve instantiated class
		return $this->_load( $service_paths, 'EE_', $class_name, 'class', $arguments, false, true, $load_only );
	}



	/**
	 *    loads data_migration_scripts
	 *
	 * @access    public
	 * @param string $class_name - class name for the DMS ie: EE_DMS_Core_4_2_0
	 * @param mixed $arguments
	 * @return EE_Data_Migration_Script_Base
	 */
	public function load_dms( $class_name, $arguments = array() ) {
		// retrieve instantiated class
		return $this->_load( EE_Data_Migration_Manager::instance()->get_data_migration_script_folders(), 'EE_DMS_', $class_name, 'dms', $arguments, false, false, false );

	}



	/**
	 *    loads object creating classes - must be singletons
	 *
	 * @param string $class_name - simple class name ie: attendee
	 * @param mixed $arguments - an array of arguments to pass to the class
	 * @param bool $from_db - some classes are instantiated from the db and thus call a different method to instantiate
	 * @param bool $cache if you don't want the class to be stored in the internal cache (non-persistent) then set this to FALSE (ie. when instantiating model objects from client in a loop)
	 * @param bool $load_only whether or not to just load the file and NOT instantiate, or load AND instantiate (default)
	 * @return EE_Base_Class | bool
	 */
	public function load_class( $class_name, $arguments = array(), $from_db = false, $cache = true, $load_only = false ) {
		$paths = apply_filters( 'FHEE__EE_Registry__load_class__paths', array(
			EE_CORE,
			EE_CLASSES,
			EE_BUSINESS
		) );
		// retrieve instantiated class
		return $this->_load( $paths, 'EE_', $class_name, 'class', $arguments, $from_db, $cache, $load_only );

	}



	/**
	 *    loads helper classes - must be singletons
	 *
	 * @param string $class_name - simple class name ie: price
	 * @param mixed $arguments
	 * @param bool $load_only
	 * @return EEH_Base | bool
	 */
	public function load_helper( $class_name, $arguments = array(), $load_only = true ) {
		// todo: add doing_it_wrong() in a few versions after all addons have had calls to this method removed
		$helper_paths = apply_filters( 'FHEE__EE_Registry__load_helper__helper_paths', array( EE_HELPERS ) );
		// retrieve instantiated class
		return $this->_load( $helper_paths, 'EEH_', $class_name, 'helper', $arguments, false, true, $load_only );

	}



	/**
	 *    loads core classes - must be singletons
	 *
	 * @access    public
	 * @param string $class_name - simple class name ie: session
	 * @param mixed $arguments
	 * @param bool $load_only
	 * @param bool $cache  whether to cache the object or not.
	 * @return mixed
	 */
	public function load_lib( $class_name, $arguments = array(), $load_only = false, $cache = true ) {
		$paths = array(
			EE_LIBRARIES,
			EE_LIBRARIES . 'messages' . DS,
			EE_LIBRARIES . 'shortcodes' . DS,
			EE_LIBRARIES . 'qtips' . DS,
			EE_LIBRARIES . 'payment_methods' . DS,
		);
		// retrieve instantiated class
		return $this->_load( $paths, 'EE_', $class_name, 'lib', $arguments, false, $cache, $load_only );
	}



	/**
	 *    loads model classes - must be singletons
	 *
	 * @param string $class_name - simple class name ie: price
	 * @param mixed $arguments
	 * @param bool $load_only
	 * @return EEM_Base | bool
	 */
	public function load_model( $class_name, $arguments = array(), $load_only = false ) {
		$paths = apply_filters( 'FHEE__EE_Registry__load_model__paths', array(
			EE_MODELS,
			EE_CORE
		) );
		// retrieve instantiated class
		return $this->_load( $paths, 'EEM_', $class_name, 'model', $arguments, false, true, $load_only );

	}



	/**
	 *    loads model classes - must be singletons
	 *
	 * @param string $class_name - simple class name ie: price
	 * @param mixed $arguments
	 * @param bool $load_only
	 * @return mixed | bool
	 */
	public function load_model_class( $class_name, $arguments = array(), $load_only = true ) {
		$paths = array(
			EE_MODELS . 'fields' . DS,
			EE_MODELS . 'helpers' . DS,
			EE_MODELS . 'relations' . DS,
			EE_MODELS . 'strategies' . DS
		);
		// retrieve instantiated class
		return $this->_load( $paths, 'EE_', $class_name, '', $arguments, false, true, $load_only );
	}



	/**
	 * Determines if $model_name is the name of an actual EE model.
	 * @param string $model_name like Event, Attendee, Question_Group_Question, etc.
	 * @return boolean
	 */
	public function is_model_name( $model_name ) {
		return isset( $this->models[ $model_name ] ) ? true : false;
	}



	/**
	 *    generic class loader
	 *
	 * @param string $path_to_file - directory path to file location, not including filename
	 * @param string $file_name - file name  ie:  my_file.php, including extension
	 * @param string $type - file type - core? class? helper? model?
	 * @param mixed $arguments
	 * @param bool $load_only
	 * @return mixed
	 */
	public function load_file( $path_to_file, $file_name, $type = '', $arguments = array(), $load_only = true ) {
		// retrieve instantiated class
		return $this->_load( $path_to_file, '', $file_name, $type, $arguments, false, true, $load_only );
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
	}



	/**
	 *    load_addon
	 *
	 * @param string $path_to_file - directory path to file location, not including filename
	 * @param string $class_name - full class name  ie:  My_Class
	 * @param string $type - file type - core? class? helper? model?
	 * @param mixed $arguments
	 * @param bool $load_only
	 * @return EE_Addon
	 */
	public function load_addon( $path_to_file, $class_name, $type = 'class', $arguments = array(), $load_only = false ) {
		// retrieve instantiated class
		return $this->_load( $path_to_file, 'addon', $class_name, $type, $arguments, false, true, $load_only );
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
	}



	/**
	 * instantiates, caches, and automatically resolves dependencies
	 * for classes that use a Fully Qualified Class Name.
	 * if the class is not capable of being loaded using PSR-4 autoloading,
	 * then you need to use one of the existing load_*() methods
	 * which can resolve the classname and filepath from the passed arguments
	 *
	 * @param bool|string $class_name   Fully Qualified Class Name
	 * @param array       $arguments    an argument, or array of arguments to pass to the class upon instantiation
	 * @param bool        $cache        whether to cache the instantiated object for reuse
	 * @param bool        $from_db      some classes are instantiated from the db
	 *                                  and thus call a different method to instantiate
	 * @param bool        $load_only    if true, will only load the file, but will NOT instantiate an object
	 * @param bool|string $addon        if true, will cache the object in the EE_Registry->$addons array
	 * @return mixed                    null = failure to load or instantiate class object.
	 *                                  object = class loaded and instantiated successfully.
	 *                                  bool = fail or success when $load_only is true
	 */
	public function create(
		$class_name = false,
		$arguments = array(),
		$cache = false,
		$from_db = false,
		$load_only = false,
		$addon = false
	) {
		$class_name = $this->_dependency_map->get_alias( $class_name );
/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}
		if ( ! class_exists( $class_name ) ) {
			// maybe the class is registered with a preceding \
			$class_name = strpos( $class_name, '\\' ) !== 0 ? '\\' . $class_name : $class_name;
			// still doesn't exist ?
			if ( ! class_exists( $class_name ) ) {
				return null;
			}
		}
		// if we're only loading the class and it already exists, then let's just return true immediately
		if ( $load_only ) {
			return true;
		}
		$addon = $addon ? 'addon' : '';
		// $this->_cache_on is toggled during the recursive loading that can occur with dependency injection
		// $cache is controlled by individual calls to separate Registry loader methods like load_class()
		// $load_only is also controlled by individual calls to separate Registry loader methods like load_file()
		if ( $this->_cache_on && $cache && ! $load_only ) {
			// return object if it's already cached
			$cached_class = $this->_get_cached_class( $class_name, $addon );
/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}
			if ( $cached_class !== null ) {
				return $cached_class;
			}
		}
		// instantiate the requested object
		$class_obj = $this->_create_object( $class_name, $arguments, $addon, $from_db );
class A
{
    function getObject()
    {
        return null;
    }

}

$a = new A();
$object = $a->getObject();
		if ( $this->_cache_on && $cache ) {
			// save it for later... kinda like gum  { : $
			$this->_set_cached_class( $class_obj, $class_name, $addon, $from_db );
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
		}
		$this->_cache_on = true;
		return $class_obj;
	}



	/**
	 * instantiates, caches, and injects dependencies for classes
	 *
	 * @param array $file_paths         an array of paths to folders to look in
	 * @param string      $class_prefix EE  or EEM or... ???
	 * @param bool|string $class_name   $class name
	 * @param string      $type         file type - core? class? helper? model?
	 * @param mixed       $arguments    an argument or array of arguments to pass to the class upon instantiation
	 * @param bool        $from_db      some classes are instantiated from the db
	 *                                  and thus call a different method to instantiate
	 * @param bool        $cache        whether to cache the instantiated object for reuse
	 * @param bool        $load_only    if true, will only load the file, but will NOT instantiate an object
	 * @return null|object|bool         null = failure to load or instantiate class object.
	 *                                  object = class loaded and instantiated successfully.
	 *                                  bool = fail or success when $load_only is true
	 */
	protected function _load(
		$file_paths = array(),
		$class_prefix = 'EE_',
		$class_name = false,
		$type = 'class',
		$arguments = array(),
		$from_db = false,
		$cache = true,
		$load_only = false
	) {
		// strip php file extension
		$class_name = str_replace( '.php', '', trim( $class_name ) );
		// does the class have a prefix ?
		if ( ! empty( $class_prefix ) && $class_prefix != 'addon' ) {
			// make sure $class_prefix is uppercase
			$class_prefix = strtoupper( trim( $class_prefix ) );
			// add class prefix ONCE!!!
			$class_name = $class_prefix . str_replace( $class_prefix, '', $class_name );
		}
		$class_name = $this->_dependency_map->get_alias( $class_name );
		$class_exists = class_exists( $class_name );
		// if we're only loading the class and it already exists, then let's just return true immediately
		if ( $load_only && $class_exists ) {
			return true;
		}
		// $this->_cache_on is toggled during the recursive loading that can occur with dependency injection
		// $cache is controlled by individual calls to separate Registry loader methods like load_class()
		// $load_only is also controlled by individual calls to separate Registry loader methods like load_file()
		if ( $this->_cache_on && $cache && ! $load_only ) {
			// return object if it's already cached
			$cached_class = $this->_get_cached_class( $class_name, $class_prefix );
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
			if ( $cached_class !== null ) {
				return $cached_class;
			}
		}
		// if the class doesn't already exist.. then we need to try and find the file and load it
		if ( ! $class_exists ) {
			// get full path to file
			$path = $this->_resolve_path( $class_name, $type, $file_paths );
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
			// load the file
			$loaded = $this->_require_file( $path, $class_name, $type, $file_paths );
<?php

function getDate($date)
{
    if ($date !== null) {
        return new DateTime($date);
    }

    return false;
}
			// if loading failed, or we are only loading a file but NOT instantiating an object
			if ( ! $loaded || $load_only ) {
				// return boolean if only loading, or null if an object was expected
				return $load_only ? $loaded : null;
			}
		}
		// instantiate the requested object
		$class_obj = $this->_create_object( $class_name, $arguments, $type, $from_db );
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
		if ( $this->_cache_on && $cache ) {
			// save it for later... kinda like gum  { : $
			$this->_set_cached_class( $class_obj, $class_name, $class_prefix, $from_db );
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
		}
		$this->_cache_on = true;
		return $class_obj;
	}



	/**
	 * _get_cached_class
	 *
	 * attempts to find a cached version of the requested class
	 * by looking in the following places:
	 * 		$this->{$class_abbreviation} 		 	ie:   	$this->CART
	 * 		$this->{$class_name}           		 		ie:    $this->Some_Class
	 * 		$this->LIB->{$class_name}				ie: 	$this->LIB->Some_Class
	 * 		$this->addon->{$class_name}	ie: 	$this->addon->Some_Addon_Class
	 *
	 * @access protected
	 * @param string $class_name
	 * @param string $class_prefix
	 * @return null|object
	 */
	protected function _get_cached_class( $class_name, $class_prefix = '' ) {
		if ( isset( $this->_class_abbreviations[ $class_name ] ) ) {
			$class_abbreviation = $this->_class_abbreviations[ $class_name ];
		} else {
			// have to specify something, but not anything that will conflict
			$class_abbreviation = 'FANCY_BATMAN_PANTS';
		}
		// check if class has already been loaded, and return it if it has been
		if ( isset( $this->{$class_abbreviation} ) && ! is_null( $this->{$class_abbreviation} ) ) {
			return $this->{$class_abbreviation};
		} else if ( isset ( $this->{$class_name} ) ) {
			return $this->{$class_name};
		} else if ( isset ( $this->LIB->{$class_name} ) ) {
			return $this->LIB->{$class_name};
		} else if ( $class_prefix == 'addon' && isset ( $this->addons->{$class_name} ) ) {
			return $this->addons->{$class_name};
		}
		return null;
	}



	/**
	 * _resolve_path
	 *
	 * attempts to find a full valid filepath for the requested class.
	 * loops thru each of the base paths in the $file_paths array and appends : "{classname} . {file type} . php"
	 * then returns that path if the target file has been found and is readable
	 *
	 * @access protected
	 * @param string $class_name
	 * @param string $type
	 * @param array $file_paths
	 * @return string | bool
	 */
	protected function _resolve_path( $class_name, $type = '', $file_paths = array() ) {
		// make sure $file_paths is an array
		$file_paths = is_array( $file_paths ) ? $file_paths : array( $file_paths );
		// cycle thru paths
		foreach ( $file_paths as $key => $file_path ) {
			// convert all separators to proper DS, if no filepath, then use EE_CLASSES
			$file_path = $file_path ? str_replace( array( '/', '\\' ), DS, $file_path ) : EE_CLASSES;
			// prep file type
			$type = ! empty( $type ) ? trim( $type, '.' ) . '.' : '';
			// build full file path
			$file_paths[ $key ] = rtrim( $file_path, DS ) . DS . $class_name . '.' . $type . 'php';
			//does the file exist and can be read ?
			if ( is_readable( $file_paths[ $key ] ) ) {
				return $file_paths[ $key ];
			}
		}
		return false;
	}



	/**
	 * _require_file
	 *
	 * basically just performs a require_once()
	 * but with some error handling
	 *
	 * @access protected
	 * @param  string $path
	 * @param  string $class_name
	 * @param  string $type
	 * @param  array $file_paths
	 * @return boolean
	 * @throws \EE_Error
	 */
	protected function _require_file( $path, $class_name, $type = '', $file_paths = array() ) {
		// don't give up! you gotta...
		try {
			//does the file exist and can it be read ?
			if ( ! $path ) {
				// so sorry, can't find the file
				throw new EE_Error (
					sprintf(
						__( 'The %1$s file %2$s could not be located or is not readable due to file permissions. Please ensure that the following filepath(s) are correct: %3$s', 'event_espresso' ),
						trim( $type, '.' ),
						$class_name,
						'<br />' . implode( ',<br />', $file_paths )
					)
				);
			}
			// get the file
			require_once( $path );
			// if the class isn't already declared somewhere
			if ( class_exists( $class_name, false ) === false ) {
				// so sorry, not a class
				throw new EE_Error(
					sprintf(
						__( 'The %s file %s does not appear to contain the %s Class.', 'event_espresso' ),
						$type,
						$path,
						$class_name
					)
				);
			}

		} catch ( EE_Error $e ) {
			$e->get_error();
			return false;
		}
		return true;
	}



	/**
	 * _create_object
	 * Attempts to instantiate the requested class via any of the
	 * commonly used instantiation methods employed throughout EE.
	 * The priority for instantiation is as follows:
	 * 		- abstract classes or any class flagged as "load only" (no instantiation occurs)
	 * 	 	- model objects via their 'new_instance_from_db' method
	 * 	 	- model objects via their 'new_instance' method
	 * 	 	- "singleton" classes" via their 'instance' method
	 *  	- standard instantiable classes via their __constructor
	 * Prior to instantiation, if the classname exists in the dependency_map,
	 * then the constructor for the requested class will be examined to determine
	 * if any dependencies exist, and if they can be injected.
	 * If so, then those classes will be added to the array of arguments passed to the constructor
	 *
	 * @access protected
	 * @param string $class_name
	 * @param array $arguments
	 * @param string $type
	 * @param bool $from_db
	 * @return null | object
	 * @throws \EE_Error
	 */
	protected function _create_object( $class_name, $arguments = array(), $type = '', $from_db = false ) {
		$class_obj = null;
		$instantiation_mode = '0) none';
		// don't give up! you gotta...
		try {
			// create reflection
			$reflector = $this->get_ReflectionClass( $class_name );
			// make sure arguments are an array
			$arguments = is_array( $arguments ) ? $arguments : array( $arguments );
			// and if arguments array is numerically and sequentially indexed, then we want it to remain as is,
			// else wrap it in an additional array so that it doesn't get split into multiple parameters
			$arguments = $this->_array_is_numerically_and_sequentially_indexed( $arguments )
				? $arguments
				: array( $arguments );
			// attempt to inject dependencies ?
			if ( $this->_dependency_map->has( $class_name ) ) {
				$arguments = $this->_resolve_dependencies( $reflector, $class_name, $arguments );
			}
			// instantiate the class if possible
			if ( $reflector->isAbstract() ) {
				// nothing to instantiate, loading file was enough
				// does not throw an exception so $instantiation_mode is unused
				// $instantiation_mode = "1) no constructor abstract class";
				$class_obj = true;
			} else if ( $reflector->getConstructor() === null && $reflector->isInstantiable() && empty( $arguments ) ) {
				// no constructor = static methods only... nothing to instantiate, loading file was enough
				$instantiation_mode = "2) no constructor but instantiable";
				$class_obj = $reflector->newInstance();
			} else if ( $from_db && method_exists( $class_name, 'new_instance_from_db' ) ) {
				$instantiation_mode = "3) new_instance_from_db()";
				$class_obj = call_user_func_array( array( $class_name, 'new_instance_from_db' ), $arguments );
			} else if ( method_exists( $class_name, 'new_instance' ) ) {
				$instantiation_mode = "4) new_instance()";
				$class_obj = call_user_func_array( array( $class_name, 'new_instance' ), $arguments );
			} else if ( method_exists( $class_name, 'instance' ) ) {
				$instantiation_mode = "5) instance()";
				$class_obj = call_user_func_array( array( $class_name, 'instance' ), $arguments );
			} else if ( $reflector->isInstantiable() ) {
				$instantiation_mode = "6) constructor";
				$class_obj = $reflector->newInstanceArgs( $arguments );
			} else {
				// heh ? something's not right !
				throw new EE_Error(
					sprintf(
						__( 'The %s file %s could not be instantiated.', 'event_espresso' ),
						$type,
						$class_name
					)
				);
			}
		} catch ( Exception $e ) {
			if ( ! $e instanceof EE_Error ) {
				$e = new EE_Error(
					sprintf(
						__( 'The following error occurred while attempting to instantiate "%1$s": %2$s %3$s %2$s instantiation mode : %4$s', 'event_espresso' ),
						$class_name,
						'<br />',
						$e->getMessage(),
						$instantiation_mode
					)
				);
			}
			$e->get_error();
		}
		return $class_obj;
	}



	/**
	 * @see http://stackoverflow.com/questions/173400/how-to-check-if-php-array-is-associative-or-sequential
	 * @param array $array
	 * @return bool
	 */
	protected function _array_is_numerically_and_sequentially_indexed( array $array ) {
		return ! empty( $array ) ? array_keys( $array ) === range( 0, count( $array ) - 1 ) : true;
	}



	/**
	 * getReflectionClass
	 *
	 * checks if a ReflectionClass object has already been generated for a class
	 * and returns that instead of creating a new one
	 *
	 * @access public
	 * @param string $class_name
	 * @return ReflectionClass
	 */
	public function get_ReflectionClass( $class_name ) {

		if (
			! isset( $this->_reflectors[ $class_name ] )
			|| ! $this->_reflectors[ $class_name ] instanceof ReflectionClass
		) {
			$this->_reflectors[ $class_name ] = new ReflectionClass( $class_name );
		}
		return $this->_reflectors[ $class_name ];
	}



	/**
	 * _resolve_dependencies
	 * examines the constructor for the requested class to determine
	 * if any dependencies exist, and if they can be injected.
	 * If so, then those classes will be added to the array of arguments passed to the constructor
	 * PLZ NOTE: this is achieved by type hinting the constructor params
	 * For example:
	 *        if attempting to load a class "Foo" with the following constructor:
	 *        __construct( Bar $bar_class, Fighter $grohl_class )
	 *        then $bar_class and $grohl_class will be added to the $arguments array,
	 *        but only IF they are NOT already present in the incoming arguments array,
	 *        and the correct classes can be loaded
	 *
	 * @access protected
	 * @param ReflectionClass $reflector
	 * @param string          $class_name
	 * @param array           $arguments
	 * @return array
	 * @throws \ReflectionException
	 */
	protected function _resolve_dependencies( ReflectionClass $reflector, $class_name, $arguments = array() ) {
		// let's examine the constructor
		$constructor = $reflector->getConstructor();
		// whu? huh? nothing?
		if ( ! $constructor ) {
			return $arguments;
		}
		// get constructor parameters
		$params = $constructor->getParameters();
		// and the keys for the incoming arguments array so that we can compare existing arguments with what is expected
		$argument_keys = array_keys( $arguments );
		// now loop thru all of the constructors expected parameters
		foreach ( $params as $index => $param ) {
			// is this a dependency for a specific class ?
			$param_class = $param->getClass() ? $param->getClass()->name : null;
			if (
				// param is not even a class
				empty( $param_class )
				// and something already exists in the incoming arguments for this param
				&& isset( $argument_keys[ $index ], $arguments[ $argument_keys[ $index ] ] )
			) {
				// so let's skip this argument and move on to the next
				continue;
			} else if (
				// parameter is type hinted as a class, exists as an incoming argument, AND it's the correct class
				! empty( $param_class )
				&& isset( $argument_keys[ $index ], $arguments[ $argument_keys[ $index ] ] )
				&& $arguments[ $argument_keys[ $index ] ] instanceof $param_class
			) {
				// skip this argument and move on to the next
				continue;
			} else if (
				// parameter is type hinted as a class, and should be injected
				! empty( $param_class )
				&& $this->_dependency_map->has_dependency_for_class( $class_name, $param_class )
			) {
				$arguments = $this->_resolve_dependency( $class_name, $param_class, $arguments, $index );
			} else {
				try {
					$arguments[ $index ] = $param->getDefaultValue();
				} catch ( ReflectionException $e ) {
					throw new ReflectionException(
						sprintf(
							__( '%1$s for parameter "$%2$s"', 'event_espresso' ),
							$e->getMessage(),
							$param->getName()
						)
					);
				}
			}

		}
		return $arguments;
	}



	/**
	 * @access protected
	 * @param string $class_name
	 * @param string $param_class
	 * @param array $arguments
	 * @param mixed $index
	 * @return array
	 */
	protected function _resolve_dependency( $class_name, $param_class , $arguments, $index ) {
		$dependency = null;
		// should dependency be loaded from cache ?
		$cache_on = $this->_dependency_map->loading_strategy_for_class_dependency( $class_name, $param_class )
		            !== EE_Dependency_Map::load_new_object
			? true
			: false;
		// we might have a dependency...
		// let's MAYBE try and find it in our cache if that's what's been requested
		$cached_class = $cache_on ? $this->_get_cached_class( $param_class ) : null;
		// and grab it if it exists
		if ( $cached_class instanceof $param_class ) {
			$dependency = $cached_class;
		} else if ( $param_class != $class_name ) {
			// obtain the loader method from the dependency map
			$loader = $this->_dependency_map->class_loader( $param_class );
			// is loader a custom closure ?
			if ( $loader instanceof Closure ) {
				$dependency = $loader();
			} else {
				// set the cache on property for the recursive loading call
				$this->_cache_on = $cache_on;
				// if not, then let's try and load it via the registry
				if ( method_exists( $this, $loader ) ) {
					$dependency = $this->{$loader}($param_class);
				} else {
					$dependency = $this->create($param_class, array(), $cache_on);
				}
			}
		}
		// did we successfully find the correct dependency ?
		if ( $dependency instanceof $param_class ) {
			// then let's inject it into the incoming array of arguments at the correct location
			if ( isset( $argument_keys[ $index ] ) ) {

				$arguments[ $argument_keys[ $index ] ] = $dependency;
			} else {
				$arguments[ $index ] = $dependency;
			}
		}
		return $arguments;
	}



	/**
	 * _set_cached_class
	 *
	 * attempts to cache the instantiated class locally
	 * in one of the following places, in the following order:
	 *        $this->{class_abbreviation}   ie:    $this->CART
	 *        $this->{$class_name}          ie:    $this->Some_Class
	 *        $this->addon->{$$class_name} 	ie:    $this->addon->Some_Addon_Class
	 *        $this->LIB->{$class_name}     ie:    $this->LIB->Some_Class
	 *
	 * @access protected
	 * @param object $class_obj
	 * @param string $class_name
	 * @param string $class_prefix
	 * @param bool $from_db
	 * @return void
	 */
	protected function _set_cached_class( $class_obj, $class_name, $class_prefix = '', $from_db = false ) {
		if ( empty( $class_obj ) ) {
			return;
		}
		// return newly instantiated class
		if ( isset( $this->_class_abbreviations[ $class_name ] ) ) {
			$class_abbreviation = $this->_class_abbreviations[ $class_name ];
			$this->{$class_abbreviation} = $class_obj;
		} else if ( property_exists( $this, $class_name ) ) {
			$this->{$class_name} = $class_obj;
		} else if ( $class_prefix == 'addon' ) {
			$this->addons->{$class_name} = $class_obj;
		} else if ( ! $from_db ) {
			$this->LIB->{$class_name} = $class_obj;
		}
	}



	/**
	 * call any loader that's been registered in the EE_Dependency_Map::$_class_loaders array
	 *
	 *
	 * @param string $classname PLEASE NOTE: the class name needs to match what's registered
	 *                          in the EE_Dependency_Map::$_class_loaders array,
	 *                          including the class prefix, ie: "EE_", "EEM_", "EEH_", etc
	 * @param array  $arguments
	 * @return object
	 */
	public static function factory( $classname, $arguments = array() ) {
		$loader = self::instance()->_dependency_map->class_loader( $classname );
		if ( $loader instanceof Closure ) {
			return $loader( $arguments );
		} else if ( method_exists( EE_Registry::instance(), $loader ) ) {
			return EE_Registry::instance()->{$loader}( $classname, $arguments );
		}
		return null;
	}



	/**
	 * Gets the addon by its name/slug (not classname. For that, just
	 * use the classname as the property name on EE_Config::instance()->addons)
	 * @param string $name
	 * @return EE_Addon
	 */
	public function get_addon_by_name( $name ) {
		foreach ( $this->addons as $addon ) {
			if ( $addon->name() == $name ) {
				return $addon;
			}
		}
		return null;
	}



	/**
	 * Gets an array of all the registered addons, where the keys are their names. (ie, what each returns for their name() function) They're already available on EE_Config::instance()->addons as properties, where each property's name is the addon's classname. So if you just want to get the addon by classname, use EE_Config::instance()->addons->{classname}
	 *
	 * @return EE_Addon[] where the KEYS are the addon's name()
	 */
	public function get_addons_by_name() {
		$addons = array();
		foreach ( $this->addons as $addon ) {
			$addons[ $addon->name() ] = $addon;
		}
		return $addons;
	}



	/**
	 * Resets the specified model's instance AND makes sure EE_Registry doesn't keep
	 * a stale copy of it around
	 *
	 * @param string $model_name
	 * @return \EEM_Base
	 * @throws \EE_Error
	 */
	public function reset_model( $model_name ) {
		$model = $this->load_model( $model_name );
		$model_class_name = get_class( $model );
		//get that model reset it and make sure we nuke the old reference to it
		if ( $model instanceof $model_class_name && is_callable( array( $model_class_name, 'reset' ))) {
			$this->LIB->{$model_class_name} = $model::reset();
		} else {
			throw new EE_Error( sprintf( __( 'Model %s does not have a method "reset"', 'event_espresso' ), $model_name ) );
		}
		return $this->LIB->{$model_class_name};
	}



	/**
	 * Resets the registry.
	 *
	 * The criteria for what gets reset is based on what can be shared between sites on the same request when switch_to_blog
	 * is used in a multisite install.  Here is a list of things that are NOT reset.
	 *
	 * - $_dependency_map
	 * - $_class_abbreviations
	 * - $NET_CFG (EE_Network_Config): The config is shared network wide so no need to reset.
	 * - $REQ:  Still on the same request so no need to change.
	 * - $CAP: There is no site specific state in the EE_Capability class.
	 * - $SSN: Although ideally, the session should not be shared between site switches, we can't reset it because only one Session
	 *         can be active in a single request.  Resetting could resolve in "headers already sent" errors.
	 * - $addons:  In multisite, the state of the addons is something controlled via hooks etc in a normal request.  So
	 *             for now, we won't reset the addons because it could break calls to an add-ons class/methods in the
	 *             switch or on the restore.
	 * - $modules
	 * - $shortcodes
	 * - $widgets
	 *
	 * @param boolean $hard whether to reset data in the database too, or just refresh
	 * the Registry to its state at the beginning of the request
	 * @param boolean $reinstantiate whether to create new instances of EE_Registry's singletons too,
	 * or just reset without re-instantiating (handy to set to FALSE if you're not sure if you CAN
	 * currently reinstantiate the singletons at the moment)
	 * @param   bool    $reset_models    Defaults to true.  When false, then the models are not reset.  This is so client
	 *                                  code instead can just change the model context to a different blog id if necessary
	 *
	 * @return EE_Registry
	 */
	public static function reset( $hard = false, $reinstantiate = true, $reset_models = true ) {
		$instance = self::instance();
		EEH_Activation::reset();

		//properties that get reset
		$instance->_cache_on = true;
		$instance->CFG = EE_Config::reset( $hard, $reinstantiate );
		$instance->CART = null;
		$instance->MRM = null;
		$instance->LIB = new stdClass();

		//messages reset
		EED_Messages::reset();

		if ( $reset_models ) {
			foreach ( array_keys( $instance->non_abstract_db_models ) as $model_name ) {
				$instance->reset_model( $model_name );
			}
		}

		return $instance;
	}



	/**
	 * @override magic methods
	 * @return void
	 */
	final function __destruct() {
	}



	/**
	 * @param $a
	 * @param $b
	 */
	final function __call( $a, $b ) {
	}



	/**
	 * @param $a
	 */
	final function __get( $a ) {

	}



	/**
	 * @param $a
	 * @param $b
	 */
	final function __set( $a, $b ) {

	}



	/**
	 * @param $a
	 */
	final function __isset( $a ) {

	}



	/**
	 * @param $a
	 */
	final function __unset( $a ) {

	}



	/**
	 * @return array
	 */
	final function __sleep() {
		return array();
	}



	final function __wakeup() {
	}



	/**
	 * @return string
	 */
	final function __toString() {
		return '';
	}



	final function __invoke() {
	}



	final function __set_state() {
	}



	final function __clone() {
	}



	/**
	 * @param $a
	 * @param $b
	 */
	final static function __callStatic( $a, $b ) {

	}

	/**
	 * Gets all the custom post type models defined
	 * @return array keys are model "short names" (Eg "Event") and keys are classnames (eg "EEM_Event")
	 */
	public function cpt_models() {
		$cpt_models = array();
		foreach( $this->non_abstract_db_models as $short_name => $classname ) {
			if( is_subclass_of(  $classname, 'EEM_CPT_Base' ) ) {
				$cpt_models[ $short_name ] = $classname;
			}
		}
		return $cpt_models;
	}



	/**
	 * @return \EE_Config
	 */
	public static function CFG() {
		return self::instance()->CFG;
	}


}
// End of file EE_Registry.core.php
// Location: ./core/EE_Registry.core.php

eventespresso / event-espresso-core

Branch — BUG-9871-email-validation (e62b1a)

EE_Registry::add_module() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
