Completed
Branch Gutenberg/event-attendees-bloc... (5a8aa8)
by
unknown
91:34 queued 76:32
created

EE_Dependency_Map::class_loader()   B

Complexity

Conditions 5
Paths 4

Size

Total Lines 16
Code Lines 8

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 5
eloc 8
nc 4
nop 1
dl 0
loc 16
rs 8.8571
c 0
b 0
f 0
1
<?php
2
3
use EventEspresso\core\domain\DomainFactory;
4
use EventEspresso\core\services\loaders\ClassInterfaceCache;
5
use EventEspresso\core\services\loaders\LoaderFactory;
6
use EventEspresso\core\services\loaders\LoaderInterface;
7
use EventEspresso\core\services\request\LegacyRequestInterface;
8
use EventEspresso\core\services\request\RequestInterface;
9
use EventEspresso\core\services\request\ResponseInterface;
10
11
/**
12
 * Class EE_Dependency_Map
13
 * info about how to load classes required by other classes
14
 *
15
 * @package       Event Espresso
16
 * @subpackage    core
17
 * @author        Brent Christensen
18
 * @since         4.9.0
19
 */
20
class EE_Dependency_Map
21
{
22
23
    /**
24
     * This means that the requested class dependency is not present in the dependency map
25
     */
26
    const not_registered = 0;
27
28
    /**
29
     * This instructs class loaders to ALWAYS return a newly instantiated object for the requested class.
30
     */
31
    const load_new_object = 1;
32
33
    /**
34
     * This instructs class loaders to return a previously instantiated and cached object for the requested class.
35
     * IF a previously instantiated object does not exist, a new one will be created and added to the cache.
36
     */
37
    const load_from_cache = 2;
38
39
    /**
40
     * When registering a dependency,
41
     * this indicates to keep any existing dependencies that already exist,
42
     * and simply discard any new dependencies declared in the incoming data
43
     */
44
    const KEEP_EXISTING_DEPENDENCIES = 0;
45
46
    /**
47
     * When registering a dependency,
48
     * this indicates to overwrite any existing dependencies that already exist using the incoming data
49
     */
50
    const OVERWRITE_DEPENDENCIES = 1;
51
52
53
    /**
54
     * @type EE_Dependency_Map $_instance
55
     */
56
    protected static $_instance;
57
58
    /**
59
     * @var ClassInterfaceCache $class_cache
60
     */
61
    private $class_cache;
62
63
    /**
64
     * @type RequestInterface $request
65
     */
66
    protected $request;
67
68
    /**
69
     * @type LegacyRequestInterface $legacy_request
70
     */
71
    protected $legacy_request;
72
73
    /**
74
     * @type ResponseInterface $response
75
     */
76
    protected $response;
77
78
    /**
79
     * @type LoaderInterface $loader
80
     */
81
    protected $loader;
82
83
    /**
84
     * @type array $_dependency_map
85
     */
86
    protected $_dependency_map = array();
87
88
    /**
89
     * @type array $_class_loaders
90
     */
91
    protected $_class_loaders = array();
92
93
94
    /**
95
     * EE_Dependency_Map constructor.
96
     *
97
     * @param ClassInterfaceCache $class_cache
98
     */
99
    protected function __construct(ClassInterfaceCache $class_cache)
100
    {
101
        $this->class_cache = $class_cache;
102
        do_action('EE_Dependency_Map____construct', $this);
103
    }
104
105
106
    /**
107
     * @return void
108
     */
109
    public function initialize()
110
    {
111
        $this->_register_core_dependencies();
112
        $this->_register_core_class_loaders();
113
        $this->_register_core_aliases();
114
    }
115
116
117
    /**
118
     * @singleton method used to instantiate class object
119
     * @param ClassInterfaceCache|null $class_cache
120
     * @return EE_Dependency_Map
121
     */
122
    public static function instance(ClassInterfaceCache $class_cache = null)
123
    {
124
        // check if class object is instantiated, and instantiated properly
125
        if (! self::$_instance instanceof EE_Dependency_Map
126
            && $class_cache instanceof ClassInterfaceCache
127
        ) {
128
            self::$_instance = new EE_Dependency_Map($class_cache);
129
        }
130
        return self::$_instance;
131
    }
132
133
134
    /**
135
     * @param RequestInterface $request
136
     */
137
    public function setRequest(RequestInterface $request)
138
    {
139
        $this->request = $request;
140
    }
141
142
143
    /**
144
     * @param LegacyRequestInterface $legacy_request
145
     */
146
    public function setLegacyRequest(LegacyRequestInterface $legacy_request)
147
    {
148
        $this->legacy_request = $legacy_request;
149
    }
150
151
152
    /**
153
     * @param ResponseInterface $response
154
     */
155
    public function setResponse(ResponseInterface $response)
156
    {
157
        $this->response = $response;
158
    }
159
160
161
    /**
162
     * @param LoaderInterface $loader
163
     */
164
    public function setLoader(LoaderInterface $loader)
165
    {
166
        $this->loader = $loader;
167
    }
168
169
170
    /**
171
     * @param string $class
172
     * @param array  $dependencies
173
     * @param int    $overwrite
174
     * @return bool
175
     */
176
    public static function register_dependencies(
177
        $class,
178
        array $dependencies,
179
        $overwrite = EE_Dependency_Map::KEEP_EXISTING_DEPENDENCIES
180
    ) {
181
        return self::$_instance->registerDependencies($class, $dependencies, $overwrite);
182
    }
183
184
185
    /**
186
     * Assigns an array of class names and corresponding load sources (new or cached)
187
     * to the class specified by the first parameter.
188
     * IMPORTANT !!!
189
     * The order of elements in the incoming $dependencies array MUST match
190
     * the order of the constructor parameters for the class in question.
191
     * This is especially important when overriding any existing dependencies that are registered.
192
     * the third parameter controls whether any duplicate dependencies are overwritten or not.
193
     *
194
     * @param string $class
195
     * @param array  $dependencies
196
     * @param int    $overwrite
197
     * @return bool
198
     */
199
    public function registerDependencies(
200
        $class,
201
        array $dependencies,
202
        $overwrite = EE_Dependency_Map::KEEP_EXISTING_DEPENDENCIES
203
    ) {
204
        $class = trim($class, '\\');
205
        $registered = false;
206
        if (empty(self::$_instance->_dependency_map[ $class ])) {
207
            self::$_instance->_dependency_map[ $class ] = array();
208
        }
209
        // we need to make sure that any aliases used when registering a dependency
210
        // get resolved to the correct class name
211
        foreach ($dependencies as $dependency => $load_source) {
212
            $alias = self::$_instance->getFqnForAlias($dependency);
213
            if ($overwrite === EE_Dependency_Map::OVERWRITE_DEPENDENCIES
214
                || ! isset(self::$_instance->_dependency_map[ $class ][ $alias ])
215
            ) {
216
                unset($dependencies[ $dependency ]);
217
                $dependencies[ $alias ] = $load_source;
218
                $registered = true;
219
            }
220
        }
221
        // now add our two lists of dependencies together.
222
        // using Union (+=) favours the arrays in precedence from left to right,
223
        // so $dependencies is NOT overwritten because it is listed first
224
        // ie: with A = B + C, entries in B take precedence over duplicate entries in C
225
        // Union is way faster than array_merge() but should be used with caution...
226
        // especially with numerically indexed arrays
227
        $dependencies += self::$_instance->_dependency_map[ $class ];
228
        // now we need to ensure that the resulting dependencies
229
        // array only has the entries that are required for the class
230
        // so first count how many dependencies were originally registered for the class
231
        $dependency_count = count(self::$_instance->_dependency_map[ $class ]);
232
        // if that count is non-zero (meaning dependencies were already registered)
233
        self::$_instance->_dependency_map[ $class ] = $dependency_count
234
            // then truncate the  final array to match that count
235
            ? array_slice($dependencies, 0, $dependency_count)
236
            // otherwise just take the incoming array because nothing previously existed
237
            : $dependencies;
238
        return $registered;
239
    }
240
241
242
    /**
243
     * @param string $class_name
244
     * @param string $loader
245
     * @return bool
246
     * @throws DomainException
247
     */
248
    public static function register_class_loader($class_name, $loader = 'load_core')
249
    {
250
        if (! $loader instanceof Closure && strpos($class_name, '\\') !== false) {
251
            throw new DomainException(
252
                esc_html__('Don\'t use class loaders for FQCNs.', 'event_espresso')
253
            );
254
        }
255
        // check that loader is callable or method starts with "load_" and exists in EE_Registry
256
        if (! is_callable($loader)
257
            && (
258
                strpos($loader, 'load_') !== 0
259
                || ! method_exists('EE_Registry', $loader)
260
            )
261
        ) {
262
            throw new DomainException(
263
                sprintf(
264
                    esc_html__(
265
                        '"%1$s" is not a valid loader method on EE_Registry.',
266
                        'event_espresso'
267
                    ),
268
                    $loader
269
                )
270
            );
271
        }
272
        $class_name = self::$_instance->getFqnForAlias($class_name);
273
        if (! isset(self::$_instance->_class_loaders[ $class_name ])) {
274
            self::$_instance->_class_loaders[ $class_name ] = $loader;
275
            return true;
276
        }
277
        return false;
278
    }
279
280
281
    /**
282
     * @return array
283
     */
284
    public function dependency_map()
285
    {
286
        return $this->_dependency_map;
287
    }
288
289
290
    /**
291
     * returns TRUE if dependency map contains a listing for the provided class name
292
     *
293
     * @param string $class_name
294
     * @return boolean
295
     */
296
    public function has($class_name = '')
297
    {
298
        // all legacy models have the same dependencies
299
        if (strpos($class_name, 'EEM_') === 0) {
300
            $class_name = 'LEGACY_MODELS';
301
        }
302
        return isset($this->_dependency_map[ $class_name ]) ? true : false;
303
    }
304
305
306
    /**
307
     * returns TRUE if dependency map contains a listing for the provided class name AND dependency
308
     *
309
     * @param string $class_name
310
     * @param string $dependency
311
     * @return bool
312
     */
313
    public function has_dependency_for_class($class_name = '', $dependency = '')
314
    {
315
        // all legacy models have the same dependencies
316
        if (strpos($class_name, 'EEM_') === 0) {
317
            $class_name = 'LEGACY_MODELS';
318
        }
319
        $dependency = $this->getFqnForAlias($dependency, $class_name);
320
        return isset($this->_dependency_map[ $class_name ][ $dependency ])
321
            ? true
322
            : false;
323
    }
324
325
326
    /**
327
     * returns loading strategy for whether a previously cached dependency should be loaded or a new instance returned
328
     *
329
     * @param string $class_name
330
     * @param string $dependency
331
     * @return int
332
     */
333
    public function loading_strategy_for_class_dependency($class_name = '', $dependency = '')
334
    {
335
        // all legacy models have the same dependencies
336
        if (strpos($class_name, 'EEM_') === 0) {
337
            $class_name = 'LEGACY_MODELS';
338
        }
339
        $dependency = $this->getFqnForAlias($dependency);
340
        return $this->has_dependency_for_class($class_name, $dependency)
341
            ? $this->_dependency_map[ $class_name ][ $dependency ]
342
            : EE_Dependency_Map::not_registered;
343
    }
344
345
346
    /**
347
     * @param string $class_name
348
     * @return string | Closure
349
     */
350
    public function class_loader($class_name)
351
    {
352
        // all legacy models use load_model()
353
        if (strpos($class_name, 'EEM_') === 0) {
354
            return 'load_model';
355
        }
356
        // EE_CPT_*_Strategy classes like EE_CPT_Event_Strategy, EE_CPT_Venue_Strategy, etc
357
        // perform strpos() first to avoid loading regex every time we load a class
358
        if (strpos($class_name, 'EE_CPT_') === 0
359
            && preg_match('/^EE_CPT_([a-zA-Z]+)_Strategy$/', $class_name)
360
        ) {
361
            return 'load_core';
362
        }
363
        $class_name = $this->getFqnForAlias($class_name);
364
        return isset($this->_class_loaders[ $class_name ]) ? $this->_class_loaders[ $class_name ] : '';
365
    }
366
367
368
    /**
369
     * @return array
370
     */
371
    public function class_loaders()
372
    {
373
        return $this->_class_loaders;
374
    }
375
376
377
    /**
378
     * adds an alias for a classname
379
     *
380
     * @param string $fqcn      the class name that should be used (concrete class to replace interface)
381
     * @param string $alias     the class name that would be type hinted for (abstract parent or interface)
382
     * @param string $for_class the class that has the dependency (is type hinting for the interface)
383
     */
384
    public function add_alias($fqcn, $alias, $for_class = '')
385
    {
386
        $this->class_cache->addAlias($fqcn, $alias, $for_class);
387
    }
388
389
390
    /**
391
     * Returns TRUE if the provided fully qualified name IS an alias
392
     * WHY?
393
     * Because if a class is type hinting for a concretion,
394
     * then why would we need to find another class to supply it?
395
     * ie: if a class asks for `Fully/Qualified/Namespace/SpecificClassName`,
396
     * then give it an instance of `Fully/Qualified/Namespace/SpecificClassName`.
397
     * Don't go looking for some substitute.
398
     * Whereas if a class is type hinting for an interface...
399
     * then we need to find an actual class to use.
400
     * So the interface IS the alias for some other FQN,
401
     * and we need to find out if `Fully/Qualified/Namespace/SomeInterface`
402
     * represents some other class.
403
     *
404
     * @param string $fqn
405
     * @param string $for_class
406
     * @return bool
407
     */
408
    public function isAlias($fqn = '', $for_class = '')
409
    {
410
        return $this->class_cache->isAlias($fqn, $for_class);
411
    }
412
413
414
    /**
415
     * Returns a FQN for provided alias if one exists, otherwise returns the original $alias
416
     * functions recursively, so that multiple aliases can be used to drill down to a FQN
417
     *  for example:
418
     *      if the following two entries were added to the _aliases array:
419
     *          array(
420
     *              'interface_alias'           => 'some\namespace\interface'
421
     *              'some\namespace\interface'  => 'some\namespace\classname'
422
     *          )
423
     *      then one could use EE_Registry::instance()->create( 'interface_alias' )
424
     *      to load an instance of 'some\namespace\classname'
425
     *
426
     * @param string $alias
427
     * @param string $for_class
428
     * @return string
429
     */
430
    public function getFqnForAlias($alias = '', $for_class = '')
431
    {
432
        return (string) $this->class_cache->getFqnForAlias($alias, $for_class);
433
    }
434
435
436
    /**
437
     * Registers the core dependencies and whether a previously instantiated object should be loaded from the cache,
438
     * if one exists, or whether a new object should be generated every time the requested class is loaded.
439
     * This is done by using the following class constants:
440
     *        EE_Dependency_Map::load_from_cache - loads previously instantiated object
441
     *        EE_Dependency_Map::load_new_object - generates a new object every time
442
     */
443
    protected function _register_core_dependencies()
444
    {
445
        $this->_dependency_map = array(
446
            'EE_Request_Handler'                                                                                          => array(
447
                'EE_Request' => EE_Dependency_Map::load_from_cache,
448
            ),
449
            'EE_System'                                                                                                   => array(
450
                'EE_Registry'                                 => EE_Dependency_Map::load_from_cache,
451
                'EventEspresso\core\services\loaders\Loader'  => EE_Dependency_Map::load_from_cache,
452
                'EventEspresso\core\services\request\Request' => EE_Dependency_Map::load_from_cache,
453
                'EE_Maintenance_Mode'                         => EE_Dependency_Map::load_from_cache,
454
            ),
455
            'EE_Session'                                                                                                  => array(
456
                'EventEspresso\core\services\cache\TransientCacheStorage'  => EE_Dependency_Map::load_from_cache,
457
                'EventEspresso\core\domain\values\session\SessionLifespan' => EE_Dependency_Map::load_from_cache,
458
                'EventEspresso\core\services\request\Request'              => EE_Dependency_Map::load_from_cache,
459
                'EE_Encryption'                                            => EE_Dependency_Map::load_from_cache,
460
            ),
461
            'EE_Cart'                                                                                                     => array(
462
                'EE_Session' => EE_Dependency_Map::load_from_cache,
463
            ),
464
            'EE_Front_Controller'                                                                                         => array(
465
                'EE_Registry'              => EE_Dependency_Map::load_from_cache,
466
                'EE_Request_Handler'       => EE_Dependency_Map::load_from_cache,
467
                'EE_Module_Request_Router' => EE_Dependency_Map::load_from_cache,
468
            ),
469
            'EE_Messenger_Collection_Loader'                                                                              => array(
470
                'EE_Messenger_Collection' => EE_Dependency_Map::load_new_object,
471
            ),
472
            'EE_Message_Type_Collection_Loader'                                                                           => array(
473
                'EE_Message_Type_Collection' => EE_Dependency_Map::load_new_object,
474
            ),
475
            'EE_Message_Resource_Manager'                                                                                 => array(
476
                'EE_Messenger_Collection_Loader'    => EE_Dependency_Map::load_new_object,
477
                'EE_Message_Type_Collection_Loader' => EE_Dependency_Map::load_new_object,
478
                'EEM_Message_Template_Group'        => EE_Dependency_Map::load_from_cache,
479
            ),
480
            'EE_Message_Factory'                                                                                          => array(
481
                'EE_Message_Resource_Manager' => EE_Dependency_Map::load_from_cache,
482
            ),
483
            'EE_messages'                                                                                                 => array(
484
                'EE_Message_Resource_Manager' => EE_Dependency_Map::load_from_cache,
485
            ),
486
            'EE_Messages_Generator'                                                                                       => array(
487
                'EE_Messages_Queue'                    => EE_Dependency_Map::load_new_object,
488
                'EE_Messages_Data_Handler_Collection'  => EE_Dependency_Map::load_new_object,
489
                'EE_Message_Template_Group_Collection' => EE_Dependency_Map::load_new_object,
490
                'EEH_Parse_Shortcodes'                 => EE_Dependency_Map::load_from_cache,
491
            ),
492
            'EE_Messages_Processor'                                                                                       => array(
493
                'EE_Message_Resource_Manager' => EE_Dependency_Map::load_from_cache,
494
            ),
495
            'EE_Messages_Queue'                                                                                           => array(
496
                'EE_Message_Repository' => EE_Dependency_Map::load_new_object,
497
            ),
498
            'EE_Messages_Template_Defaults'                                                                               => array(
499
                'EEM_Message_Template_Group' => EE_Dependency_Map::load_from_cache,
500
                'EEM_Message_Template'       => EE_Dependency_Map::load_from_cache,
501
            ),
502
            'EE_Message_To_Generate_From_Request'                                                                         => array(
503
                'EE_Message_Resource_Manager' => EE_Dependency_Map::load_from_cache,
504
                'EE_Request_Handler'          => EE_Dependency_Map::load_from_cache,
505
            ),
506
            'EventEspresso\core\services\commands\CommandBus'                                                             => array(
507
                'EventEspresso\core\services\commands\CommandHandlerManager' => EE_Dependency_Map::load_from_cache,
508
            ),
509
            'EventEspresso\services\commands\CommandHandler'                                                              => array(
510
                'EE_Registry'         => EE_Dependency_Map::load_from_cache,
511
                'CommandBusInterface' => EE_Dependency_Map::load_from_cache,
512
            ),
513
            'EventEspresso\core\services\commands\CommandHandlerManager'                                                  => array(
514
                'EventEspresso\core\services\loaders\Loader' => EE_Dependency_Map::load_from_cache,
515
            ),
516
            'EventEspresso\core\services\commands\CompositeCommandHandler'                                                => array(
517
                'EventEspresso\core\services\commands\CommandBus'     => EE_Dependency_Map::load_from_cache,
518
                'EventEspresso\core\services\commands\CommandFactory' => EE_Dependency_Map::load_from_cache,
519
            ),
520
            'EventEspresso\core\services\commands\CommandFactory'                                                         => array(
521
                'EventEspresso\core\services\loaders\Loader' => EE_Dependency_Map::load_from_cache,
522
            ),
523
            'EventEspresso\core\services\commands\middleware\CapChecker'                                                  => array(
524
                'EventEspresso\core\domain\services\capabilities\CapabilitiesChecker' => EE_Dependency_Map::load_from_cache,
525
            ),
526
            'EventEspresso\core\domain\services\capabilities\CapabilitiesChecker'                                         => array(
527
                'EE_Capabilities' => EE_Dependency_Map::load_from_cache,
528
            ),
529
            'EventEspresso\core\domain\services\capabilities\RegistrationsCapChecker'                                     => array(
530
                'EE_Capabilities' => EE_Dependency_Map::load_from_cache,
531
            ),
532
            'EventEspresso\core\services\commands\registration\CreateRegistrationCommandHandler'                          => array(
533
                'EventEspresso\core\domain\services\registration\CreateRegistrationService' => EE_Dependency_Map::load_from_cache,
534
            ),
535
            'EventEspresso\core\services\commands\registration\CopyRegistrationDetailsCommandHandler'                     => array(
536
                'EventEspresso\core\domain\services\registration\CopyRegistrationService' => EE_Dependency_Map::load_from_cache,
537
            ),
538
            'EventEspresso\core\services\commands\registration\CopyRegistrationPaymentsCommandHandler'                    => array(
539
                'EventEspresso\core\domain\services\registration\CopyRegistrationService' => EE_Dependency_Map::load_from_cache,
540
            ),
541
            'EventEspresso\core\services\commands\registration\CancelRegistrationAndTicketLineItemCommandHandler'         => array(
542
                'EventEspresso\core\domain\services\registration\CancelTicketLineItemService' => EE_Dependency_Map::load_from_cache,
543
            ),
544
            'EventEspresso\core\services\commands\registration\UpdateRegistrationAndTransactionAfterChangeCommandHandler' => array(
545
                'EventEspresso\core\domain\services\registration\UpdateRegistrationService' => EE_Dependency_Map::load_from_cache,
546
            ),
547
            'EventEspresso\core\services\commands\ticket\CreateTicketLineItemCommandHandler'                              => array(
548
                'EventEspresso\core\domain\services\ticket\CreateTicketLineItemService' => EE_Dependency_Map::load_from_cache,
549
            ),
550
            'EventEspresso\core\services\commands\ticket\CancelTicketLineItemCommandHandler'                              => array(
551
                'EventEspresso\core\domain\services\ticket\CancelTicketLineItemService' => EE_Dependency_Map::load_from_cache,
552
            ),
553
            'EventEspresso\core\domain\services\registration\CancelRegistrationService'                                   => array(
554
                'EventEspresso\core\domain\services\ticket\CancelTicketLineItemService' => EE_Dependency_Map::load_from_cache,
555
            ),
556
            'EventEspresso\core\services\commands\attendee\CreateAttendeeCommandHandler'                                  => array(
557
                'EEM_Attendee' => EE_Dependency_Map::load_from_cache,
558
            ),
559
            'EventEspresso\core\services\database\TableManager'                                                           => array(
560
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
561
            ),
562
            'EE_Data_Migration_Class_Base'                                                                                => array(
563
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
564
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
565
            ),
566
            'EE_DMS_Core_4_1_0'                                                                                           => array(
567
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
568
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
569
            ),
570
            'EE_DMS_Core_4_2_0'                                                                                           => array(
571
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
572
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
573
            ),
574
            'EE_DMS_Core_4_3_0'                                                                                           => array(
575
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
576
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
577
            ),
578
            'EE_DMS_Core_4_4_0'                                                                                           => array(
579
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
580
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
581
            ),
582
            'EE_DMS_Core_4_5_0'                                                                                           => array(
583
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
584
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
585
            ),
586
            'EE_DMS_Core_4_6_0'                                                                                           => array(
587
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
588
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
589
            ),
590
            'EE_DMS_Core_4_7_0'                                                                                           => array(
591
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
592
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
593
            ),
594
            'EE_DMS_Core_4_8_0'                                                                                           => array(
595
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
596
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
597
            ),
598
            'EE_DMS_Core_4_9_0'                                                                                           => array(
599
                'EventEspresso\core\services\database\TableAnalysis' => EE_Dependency_Map::load_from_cache,
600
                'EventEspresso\core\services\database\TableManager'  => EE_Dependency_Map::load_from_cache,
601
            ),
602
            'EventEspresso\core\services\assets\I18nRegistry'                                                             => array(
603
                array(),
604
                'EventEspresso\core\domain\Domain' => EE_Dependency_Map::load_from_cache,
605
            ),
606
            'EventEspresso\core\services\assets\Registry'                                                                 => array(
607
                'EventEspresso\core\services\assets\AssetCollection' => EE_Dependency_Map::load_from_cache,
608
                'EventEspresso\core\services\assets\I18nRegistry'    => EE_Dependency_Map::load_from_cache,
609
            ),
610
            'EventEspresso\core\domain\entities\shortcodes\EspressoCancelled'                                             => array(
611
                'EventEspresso\core\services\cache\PostRelatedCacheManager' => EE_Dependency_Map::load_from_cache,
612
            ),
613
            'EventEspresso\core\domain\entities\shortcodes\EspressoCheckout'                                              => array(
614
                'EventEspresso\core\services\cache\PostRelatedCacheManager' => EE_Dependency_Map::load_from_cache,
615
            ),
616
            'EventEspresso\core\domain\entities\shortcodes\EspressoEventAttendees'                                        => array(
617
                'EventEspresso\core\services\cache\PostRelatedCacheManager' => EE_Dependency_Map::load_from_cache,
618
            ),
619
            'EventEspresso\core\domain\entities\shortcodes\EspressoEvents'                                                => array(
620
                'EventEspresso\core\services\cache\PostRelatedCacheManager' => EE_Dependency_Map::load_from_cache,
621
            ),
622
            'EventEspresso\core\domain\entities\shortcodes\EspressoThankYou'                                              => array(
623
                'EventEspresso\core\services\cache\PostRelatedCacheManager' => EE_Dependency_Map::load_from_cache,
624
            ),
625
            'EventEspresso\core\domain\entities\shortcodes\EspressoTicketSelector'                                        => array(
626
                'EventEspresso\core\services\cache\PostRelatedCacheManager' => EE_Dependency_Map::load_from_cache,
627
            ),
628
            'EventEspresso\core\domain\entities\shortcodes\EspressoTxnPage'                                               => array(
629
                'EventEspresso\core\services\cache\PostRelatedCacheManager' => EE_Dependency_Map::load_from_cache,
630
            ),
631
            'EventEspresso\core\services\cache\BasicCacheManager'                                                         => array(
632
                'EventEspresso\core\services\cache\TransientCacheStorage' => EE_Dependency_Map::load_from_cache,
633
            ),
634
            'EventEspresso\core\services\cache\PostRelatedCacheManager'                                                   => array(
635
                'EventEspresso\core\services\cache\TransientCacheStorage' => EE_Dependency_Map::load_from_cache,
636
            ),
637
            'EventEspresso\core\domain\services\validation\email\EmailValidationService'                                  => array(
638
                'EE_Registration_Config'                     => EE_Dependency_Map::load_from_cache,
639
                'EventEspresso\core\services\loaders\Loader' => EE_Dependency_Map::load_from_cache,
640
            ),
641
            'EventEspresso\core\domain\values\EmailAddress'                                                               => array(
642
                null,
643
                'EventEspresso\core\domain\services\validation\email\EmailValidationService' => EE_Dependency_Map::load_from_cache,
644
            ),
645
            'EventEspresso\core\services\orm\ModelFieldFactory'                                                           => array(
646
                'EventEspresso\core\services\loaders\Loader' => EE_Dependency_Map::load_from_cache,
647
            ),
648
            'LEGACY_MODELS'                                                                                               => array(
649
                null,
650
                'EventEspresso\core\services\database\ModelFieldFactory' => EE_Dependency_Map::load_from_cache,
651
            ),
652
            'EE_Module_Request_Router'                                                                                    => array(
653
                'EE_Request' => EE_Dependency_Map::load_from_cache,
654
            ),
655
            'EE_Registration_Processor'                                                                                   => array(
656
                'EE_Request' => EE_Dependency_Map::load_from_cache,
657
            ),
658
            'EventEspresso\core\services\notifications\PersistentAdminNoticeManager'                                      => array(
659
                null,
660
                'EventEspresso\core\domain\services\capabilities\CapabilitiesChecker' => EE_Dependency_Map::load_from_cache,
661
                'EE_Request'                                                          => EE_Dependency_Map::load_from_cache,
662
            ),
663
            'EventEspresso\core\services\licensing\LicenseService'                                                        => array(
664
                'EventEspresso\core\domain\services\pue\Stats'  => EE_Dependency_Map::load_from_cache,
665
                'EventEspresso\core\domain\services\pue\Config' => EE_Dependency_Map::load_from_cache,
666
            ),
667
            'EE_Admin_Transactions_List_Table'                                                                            => array(
668
                null,
669
                'EventEspresso\core\domain\values\session\SessionLifespan' => EE_Dependency_Map::load_from_cache,
670
            ),
671
            'EventEspresso\core\domain\services\pue\Stats'                                                                => array(
672
                'EventEspresso\core\domain\services\pue\Config'        => EE_Dependency_Map::load_from_cache,
673
                'EE_Maintenance_Mode'                                  => EE_Dependency_Map::load_from_cache,
674
                'EventEspresso\core\domain\services\pue\StatsGatherer' => EE_Dependency_Map::load_from_cache,
675
            ),
676
            'EventEspresso\core\domain\services\pue\Config'                                                               => array(
677
                'EE_Network_Config' => EE_Dependency_Map::load_from_cache,
678
                'EE_Config'         => EE_Dependency_Map::load_from_cache,
679
            ),
680
            'EventEspresso\core\domain\services\pue\StatsGatherer'                                                        => array(
681
                'EEM_Payment_Method' => EE_Dependency_Map::load_from_cache,
682
                'EEM_Event'          => EE_Dependency_Map::load_from_cache,
683
                'EEM_Datetime'       => EE_Dependency_Map::load_from_cache,
684
                'EEM_Ticket'         => EE_Dependency_Map::load_from_cache,
685
                'EEM_Registration'   => EE_Dependency_Map::load_from_cache,
686
                'EEM_Transaction'    => EE_Dependency_Map::load_from_cache,
687
                'EE_Config'          => EE_Dependency_Map::load_from_cache,
688
            ),
689
            'EventEspresso\core\domain\services\admin\ExitModal'                                                          => array(
690
                'EventEspresso\core\services\assets\Registry' => EE_Dependency_Map::load_from_cache,
691
            ),
692
            'EventEspresso\core\domain\services\admin\PluginUpsells'                                                      => array(
693
                'EventEspresso\core\domain\Domain' => EE_Dependency_Map::load_from_cache,
694
            ),
695
            'EventEspresso\caffeinated\modules\recaptcha_invisible\InvisibleRecaptcha'                                    => array(
696
                'EE_Registration_Config' => EE_Dependency_Map::load_from_cache,
697
                'EE_Session'             => EE_Dependency_Map::load_from_cache,
698
            ),
699
            'EventEspresso\caffeinated\modules\recaptcha_invisible\RecaptchaAdminSettings'                                => array(
700
                'EE_Registration_Config' => EE_Dependency_Map::load_from_cache,
701
            ),
702
            'EventEspresso\modules\ticket_selector\ProcessTicketSelector'                                                 => array(
703
                'EE_Core_Config'                                                          => EE_Dependency_Map::load_from_cache,
704
                'EventEspresso\core\services\request\Request'                             => EE_Dependency_Map::load_from_cache,
705
                'EE_Session'                                                              => EE_Dependency_Map::load_from_cache,
706
                'EEM_Ticket'                                                              => EE_Dependency_Map::load_from_cache,
707
                'EventEspresso\modules\ticket_selector\TicketDatetimeAvailabilityTracker' => EE_Dependency_Map::load_from_cache,
708
            ),
709
            'EventEspresso\modules\ticket_selector\TicketDatetimeAvailabilityTracker'                                     => array(
710
                'EEM_Datetime' => EE_Dependency_Map::load_from_cache,
711
            ),
712
            'EventEspresso\core\domain\entities\custom_post_types\CustomPostTypeDefinitions'                              => array(
713
                'EE_Core_Config'                             => EE_Dependency_Map::load_from_cache,
714
                'EventEspresso\core\services\loaders\Loader' => EE_Dependency_Map::load_from_cache,
715
            ),
716
            'EventEspresso\core\domain\services\custom_post_types\RegisterCustomPostTypes'                                => array(
717
                'EventEspresso\core\domain\entities\custom_post_types\CustomPostTypeDefinitions' => EE_Dependency_Map::load_from_cache,
718
            ),
719
            'EventEspresso\core\domain\services\custom_post_types\RegisterCustomTaxonomies'                               => array(
720
                'EventEspresso\core\domain\entities\custom_post_types\CustomTaxonomyDefinitions' => EE_Dependency_Map::load_from_cache,
721
            ),
722
            'EE_CPT_Strategy'                                                                                             => array(
723
                'EventEspresso\core\domain\entities\custom_post_types\CustomPostTypeDefinitions' => EE_Dependency_Map::load_from_cache,
724
                'EventEspresso\core\domain\entities\custom_post_types\CustomTaxonomyDefinitions' => EE_Dependency_Map::load_from_cache,
725
            ),
726
            'EventEspresso\core\services\loaders\ObjectIdentifier'                                                        => array(
727
                'EventEspresso\core\services\loaders\ClassInterfaceCache' => EE_Dependency_Map::load_from_cache,
728
            ),
729
            'EventEspresso\core\domain\services\assets\CoreAssetManager'                                                  => array(
730
                'EventEspresso\core\services\assets\AssetCollection' => EE_Dependency_Map::load_from_cache,
731
                'EE_Currency_Config'                                 => EE_Dependency_Map::load_from_cache,
732
                'EE_Template_Config'                                 => EE_Dependency_Map::load_from_cache,
733
                'EventEspresso\core\domain\Domain'                   => EE_Dependency_Map::load_from_cache,
734
                'EventEspresso\core\services\assets\Registry'        => EE_Dependency_Map::load_from_cache,
735
            ),
736
            'EventEspresso\core\domain\services\admin\privacy\policy\PrivacyPolicy' => array(
737
                'EEM_Payment_Method' => EE_Dependency_Map::load_from_cache,
738
                'EventEspresso\core\domain\values\session\SessionLifespan' => EE_Dependency_Map::load_from_cache
739
            ),
740
            'EventEspresso\core\domain\services\admin\privacy\export\ExportAttendee' => array(
741
                'EEM_Attendee' => EE_Dependency_Map::load_from_cache,
742
            ),
743
            'EventEspresso\core\domain\services\admin\privacy\export\ExportAttendeeBillingData' => array(
744
                'EEM_Attendee' => EE_Dependency_Map::load_from_cache,
745
                'EEM_Payment_Method' => EE_Dependency_Map::load_from_cache
746
            ),
747
            'EventEspresso\core\domain\services\admin\privacy\export\ExportCheckins' => array(
748
                'EEM_Checkin' => EE_Dependency_Map::load_from_cache,
749
            ),
750
            'EventEspresso\core\domain\services\admin\privacy\export\ExportRegistration' => array(
751
                'EEM_Registration' => EE_Dependency_Map::load_from_cache,
752
            ),
753
            'EventEspresso\core\domain\services\admin\privacy\export\ExportTransaction' => array(
754
                'EEM_Transaction' => EE_Dependency_Map::load_from_cache,
755
            ),
756
            'EventEspresso\core\domain\services\admin\privacy\erasure\EraseAttendeeData' => array(
757
                'EEM_Attendee' => EE_Dependency_Map::load_from_cache,
758
            ),
759
            'EventEspresso\core\domain\services\admin\privacy\erasure\EraseAnswers' => array(
760
                'EEM_Answer' => EE_Dependency_Map::load_from_cache,
761
                'EEM_Question' => EE_Dependency_Map::load_from_cache,
762
            ),
763
            'EventEspresso\core\CPTs\CptQueryModifier' => array(
764
                null,
765
                null,
766
                null,
767
                'EE_Request_Handler'                          => EE_Dependency_Map::load_from_cache,
768
                'EventEspresso\core\services\request\Request' => EE_Dependency_Map::load_from_cache,
769
                'EventEspresso\core\services\loaders\Loader'  => EE_Dependency_Map::load_from_cache,
770
            ),
771
            'EventEspresso\core\services\editor\BlockRegistrationManager'                                                 => array(
772
                'EventEspresso\core\services\assets\BlockAssetManagerCollection' => EE_Dependency_Map::load_from_cache,
773
                'EventEspresso\core\domain\entities\editor\BlockCollection'      => EE_Dependency_Map::load_from_cache,
774
                'EventEspresso\core\services\request\Request'                    => EE_Dependency_Map::load_from_cache,
775
            ),
776
            'EventEspresso\core\domain\entities\editor\blocks\CoreBlocksAssetManager' => array(
777
                'EventEspresso\core\domain\Domain'                   => EE_Dependency_Map::load_from_cache,
778
                'EventEspresso\core\services\assets\AssetCollection' => EE_Dependency_Map::load_from_cache,
779
                'EventEspresso\core\services\assets\Registry'        => EE_Dependency_Map::load_from_cache,
780
            ),
781
            'EventEspresso\core\domain\entities\editor\blocks\widgets\EventAttendees' => array(
782
                'EventEspresso\core\domain\entities\editor\blocks\CoreBlocksAssetManager' => self::load_from_cache,
783
                'EventEspresso\core\domain\entities\shortcodes\EspressoEventAttendees' => self::load_from_cache,
784
            ),
785
        );
786
    }
787
788
789
    /**
790
     * Registers how core classes are loaded.
791
     * This can either be done by simply providing the name of one of the EE_Registry loader methods such as:
792
     *        'EE_Request_Handler' => 'load_core'
793
     *        'EE_Messages_Queue'  => 'load_lib'
794
     *        'EEH_Debug_Tools'    => 'load_helper'
795
     * or, if greater control is required, by providing a custom closure. For example:
796
     *        'Some_Class' => function () {
797
     *            return new Some_Class();
798
     *        },
799
     * This is required for instantiating dependencies
800
     * where an interface has been type hinted in a class constructor. For example:
801
     *        'Required_Interface' => function () {
802
     *            return new A_Class_That_Implements_Required_Interface();
803
     *        },
804
     */
805
    protected function _register_core_class_loaders()
806
    {
807
        // for PHP5.3 compat, we need to register any properties called here in a variable because `$this` cannot
808
        // be used in a closure.
809
        $request = &$this->request;
810
        $response = &$this->response;
811
        $legacy_request = &$this->legacy_request;
812
        // $loader = &$this->loader;
813
        $this->_class_loaders = array(
814
            // load_core
815
            'EE_Capabilities'                              => 'load_core',
816
            'EE_Encryption'                                => 'load_core',
817
            'EE_Front_Controller'                          => 'load_core',
818
            'EE_Module_Request_Router'                     => 'load_core',
819
            'EE_Registry'                                  => 'load_core',
820
            'EE_Request'                                   => function () use (&$legacy_request) {
821
                return $legacy_request;
822
            },
823
            'EventEspresso\core\services\request\Request'  => function () use (&$request) {
824
                return $request;
825
            },
826
            'EventEspresso\core\services\request\Response' => function () use (&$response) {
827
                return $response;
828
            },
829
            'EE_Base'                                      => 'load_core',
830
            'EE_Request_Handler'                           => 'load_core',
831
            'EE_Session'                                   => 'load_core',
832
            'EE_Cron_Tasks'                                => 'load_core',
833
            'EE_System'                                    => 'load_core',
834
            'EE_Maintenance_Mode'                          => 'load_core',
835
            'EE_Register_CPTs'                             => 'load_core',
836
            'EE_Admin'                                     => 'load_core',
837
            'EE_CPT_Strategy'                              => 'load_core',
838
            // load_lib
839
            'EE_Message_Resource_Manager'                  => 'load_lib',
840
            'EE_Message_Type_Collection'                   => 'load_lib',
841
            'EE_Message_Type_Collection_Loader'            => 'load_lib',
842
            'EE_Messenger_Collection'                      => 'load_lib',
843
            'EE_Messenger_Collection_Loader'               => 'load_lib',
844
            'EE_Messages_Processor'                        => 'load_lib',
845
            'EE_Message_Repository'                        => 'load_lib',
846
            'EE_Messages_Queue'                            => 'load_lib',
847
            'EE_Messages_Data_Handler_Collection'          => 'load_lib',
848
            'EE_Message_Template_Group_Collection'         => 'load_lib',
849
            'EE_Payment_Method_Manager'                    => 'load_lib',
850
            'EE_Messages_Generator'                        => function () {
851
                return EE_Registry::instance()->load_lib(
852
                    'Messages_Generator',
853
                    array(),
854
                    false,
855
                    false
856
                );
857
            },
858
            'EE_Messages_Template_Defaults'                => function ($arguments = array()) {
859
                return EE_Registry::instance()->load_lib(
860
                    'Messages_Template_Defaults',
861
                    $arguments,
862
                    false,
863
                    false
864
                );
865
            },
866
            // load_helper
867
            'EEH_Parse_Shortcodes'                         => function () {
868
                if (EE_Registry::instance()->load_helper('Parse_Shortcodes')) {
869
                    return new EEH_Parse_Shortcodes();
870
                }
871
                return null;
872
            },
873
            'EE_Template_Config'                           => function () {
874
                return EE_Config::instance()->template_settings;
875
            },
876
            'EE_Currency_Config'                           => function () {
877
                return EE_Config::instance()->currency;
878
            },
879
            'EE_Registration_Config'                       => function () {
880
                return EE_Config::instance()->registration;
881
            },
882
            'EE_Core_Config'                               => function () {
883
                return EE_Config::instance()->core;
884
            },
885
            'EventEspresso\core\services\loaders\Loader'   => function () {
886
                return LoaderFactory::getLoader();
887
            },
888
            'EE_Network_Config'                            => function () {
889
                return EE_Network_Config::instance();
890
            },
891
            'EE_Config'                                    => function () {
892
                return EE_Config::instance();
893
            },
894
            'EventEspresso\core\domain\Domain'             => function () {
895
                return DomainFactory::getEventEspressoCoreDomain();
896
            },
897
            'EE_Admin_Config'                              => function () {
898
                return EE_Config::instance()->admin;
899
            },
900
        );
901
    }
902
903
904
    /**
905
     * can be used for supplying alternate names for classes,
906
     * or for connecting interface names to instantiable classes
907
     */
908
    protected function _register_core_aliases()
909
    {
910
        $aliases = array(
911
            'CommandBusInterface'                                                          => 'EventEspresso\core\services\commands\CommandBusInterface',
912
            'EventEspresso\core\services\commands\CommandBusInterface'                     => 'EventEspresso\core\services\commands\CommandBus',
913
            'CommandHandlerManagerInterface'                                               => 'EventEspresso\core\services\commands\CommandHandlerManagerInterface',
914
            'EventEspresso\core\services\commands\CommandHandlerManagerInterface'          => 'EventEspresso\core\services\commands\CommandHandlerManager',
915
            'CapChecker'                                                                   => 'EventEspresso\core\services\commands\middleware\CapChecker',
916
            'AddActionHook'                                                                => 'EventEspresso\core\services\commands\middleware\AddActionHook',
917
            'CapabilitiesChecker'                                                          => 'EventEspresso\core\domain\services\capabilities\CapabilitiesChecker',
918
            'CapabilitiesCheckerInterface'                                                 => 'EventEspresso\core\domain\services\capabilities\CapabilitiesCheckerInterface',
919
            'EventEspresso\core\domain\services\capabilities\CapabilitiesCheckerInterface' => 'EventEspresso\core\domain\services\capabilities\CapabilitiesChecker',
920
            'CreateRegistrationService'                                                    => 'EventEspresso\core\domain\services\registration\CreateRegistrationService',
921
            'CreateRegistrationCommandHandler'                                             => 'EventEspresso\core\services\commands\registration\CreateRegistrationCommand',
922
            'CopyRegistrationDetailsCommandHandler'                                        => 'EventEspresso\core\services\commands\registration\CopyRegistrationDetailsCommand',
923
            'CopyRegistrationPaymentsCommandHandler'                                       => 'EventEspresso\core\services\commands\registration\CopyRegistrationPaymentsCommand',
924
            'CancelRegistrationAndTicketLineItemCommandHandler'                            => 'EventEspresso\core\services\commands\registration\CancelRegistrationAndTicketLineItemCommandHandler',
925
            'UpdateRegistrationAndTransactionAfterChangeCommandHandler'                    => 'EventEspresso\core\services\commands\registration\UpdateRegistrationAndTransactionAfterChangeCommandHandler',
926
            'CreateTicketLineItemCommandHandler'                                           => 'EventEspresso\core\services\commands\ticket\CreateTicketLineItemCommand',
927
            'CreateTransactionCommandHandler'                                              => 'EventEspresso\core\services\commands\transaction\CreateTransactionCommandHandler',
928
            'CreateAttendeeCommandHandler'                                                 => 'EventEspresso\core\services\commands\attendee\CreateAttendeeCommandHandler',
929
            'TableManager'                                                                 => 'EventEspresso\core\services\database\TableManager',
930
            'TableAnalysis'                                                                => 'EventEspresso\core\services\database\TableAnalysis',
931
            'EspressoShortcode'                                                            => 'EventEspresso\core\services\shortcodes\EspressoShortcode',
932
            'ShortcodeInterface'                                                           => 'EventEspresso\core\services\shortcodes\ShortcodeInterface',
933
            'EventEspresso\core\services\shortcodes\ShortcodeInterface'                    => 'EventEspresso\core\services\shortcodes\EspressoShortcode',
934
            'EventEspresso\core\services\cache\CacheStorageInterface'                      => 'EventEspresso\core\services\cache\TransientCacheStorage',
935
            'LoaderInterface'                                                              => 'EventEspresso\core\services\loaders\LoaderInterface',
936
            'EventEspresso\core\services\loaders\LoaderInterface'                          => 'EventEspresso\core\services\loaders\Loader',
937
            'CommandFactoryInterface'                                                      => 'EventEspresso\core\services\commands\CommandFactoryInterface',
938
            'EventEspresso\core\services\commands\CommandFactoryInterface'                 => 'EventEspresso\core\services\commands\CommandFactory',
939
            'EventEspresso\core\domain\services\session\SessionIdentifierInterface'        => 'EE_Session',
940
            'EmailValidatorInterface'                                                      => 'EventEspresso\core\domain\services\validation\email\EmailValidatorInterface',
941
            'EventEspresso\core\domain\services\validation\email\EmailValidatorInterface'  => 'EventEspresso\core\domain\services\validation\email\EmailValidationService',
942
            'NoticeConverterInterface'                                                     => 'EventEspresso\core\services\notices\NoticeConverterInterface',
943
            'EventEspresso\core\services\notices\NoticeConverterInterface'                 => 'EventEspresso\core\services\notices\ConvertNoticesToEeErrors',
944
            'NoticesContainerInterface'                                                    => 'EventEspresso\core\services\notices\NoticesContainerInterface',
945
            'EventEspresso\core\services\notices\NoticesContainerInterface'                => 'EventEspresso\core\services\notices\NoticesContainer',
946
            'EventEspresso\core\services\request\RequestInterface'                         => 'EventEspresso\core\services\request\Request',
947
            'EventEspresso\core\services\request\ResponseInterface'                        => 'EventEspresso\core\services\request\Response',
948
            'EventEspresso\core\domain\DomainInterface'                                    => 'EventEspresso\core\domain\Domain',
949
        );
950
        foreach ($aliases as $alias => $fqn) {
951
            if (is_array($fqn)) {
952
                foreach ($fqn as $class => $for_class) {
953
                    $this->class_cache->addAlias($class, $alias, $for_class);
954
                }
955
                continue;
956
            }
957
            $this->class_cache->addAlias($fqn, $alias);
958
        }
959
        if (! (defined('DOING_AJAX') && DOING_AJAX) && is_admin()) {
960
            $this->class_cache->addAlias(
961
                'EventEspresso\core\services\notices\ConvertNoticesToAdminNotices',
962
                'EventEspresso\core\services\notices\NoticeConverterInterface'
963
            );
964
        }
965
    }
966
967
968
    /**
969
     * This is used to reset the internal map and class_loaders to their original default state at the beginning of the
970
     * request Primarily used by unit tests.
971
     */
972
    public function reset()
973
    {
974
        $this->_register_core_class_loaders();
975
        $this->_register_core_dependencies();
976
    }
977
978
979
    /**
980
     * PLZ NOTE: a better name for this method would be is_alias()
981
     * because it returns TRUE if the provided fully qualified name IS an alias
982
     * WHY?
983
     * Because if a class is type hinting for a concretion,
984
     * then why would we need to find another class to supply it?
985
     * ie: if a class asks for `Fully/Qualified/Namespace/SpecificClassName`,
986
     * then give it an instance of `Fully/Qualified/Namespace/SpecificClassName`.
987
     * Don't go looking for some substitute.
988
     * Whereas if a class is type hinting for an interface...
989
     * then we need to find an actual class to use.
990
     * So the interface IS the alias for some other FQN,
991
     * and we need to find out if `Fully/Qualified/Namespace/SomeInterface`
992
     * represents some other class.
993
     *
994
     * @deprecated 4.9.62.p
995
     * @param string $fqn
996
     * @param string $for_class
997
     * @return bool
998
     */
999
    public function has_alias($fqn = '', $for_class = '')
1000
    {
1001
        return $this->isAlias($fqn, $for_class);
1002
    }
1003
1004
1005
    /**
1006
     * PLZ NOTE: a better name for this method would be get_fqn_for_alias()
1007
     * because it returns a FQN for provided alias if one exists, otherwise returns the original $alias
1008
     * functions recursively, so that multiple aliases can be used to drill down to a FQN
1009
     *  for example:
1010
     *      if the following two entries were added to the _aliases array:
1011
     *          array(
1012
     *              'interface_alias'           => 'some\namespace\interface'
1013
     *              'some\namespace\interface'  => 'some\namespace\classname'
1014
     *          )
1015
     *      then one could use EE_Registry::instance()->create( 'interface_alias' )
1016
     *      to load an instance of 'some\namespace\classname'
1017
     *
1018
     * @deprecated 4.9.62.p
1019
     * @param string $alias
1020
     * @param string $for_class
1021
     * @return string
1022
     */
1023
    public function get_alias($alias = '', $for_class = '')
1024
    {
1025
        return $this->getFqnForAlias($alias, $for_class);
1026
    }
1027
}
1028