3 +--------------------------------------------------------------------+
4 | Copyright CiviCRM LLC. All rights reserved. |
6 | This work is published under the GNU AGPLv3 license with some |
7 | permitted exceptions and without any warranty. For full license |
8 | and copyright information, see https://civicrm.org/licensing |
9 +--------------------------------------------------------------------+
16 * @copyright CiviCRM LLC https://civicrm.org/licensing
18 class CRM_Core_ClassLoader
{
21 * We only need one instance of this object. So we use the singleton
22 * pattern and cache the instance in this variable
25 private static $_singleton = NULL;
28 * The classes in CiviTest have ucky, non-standard naming.
31 * Array(string $className => string $filePath).
33 private $civiTestClasses;
40 public static function &singleton($force = FALSE) {
41 if ($force || self
::$_singleton === NULL) {
42 self
::$_singleton = new CRM_Core_ClassLoader();
44 return self
::$_singleton;
48 * Has this been registered already.
52 protected $_registered;
57 protected function __construct() {
58 $this->_registered
= FALSE;
59 $this->civiTestClasses
= [
64 'CiviSeleniumTestCase',
67 'CiviEndToEndTestCase',
79 * Requires the autoload.php generated by composer
83 protected function requireComposerAutoload() {
84 // We are trying to locate 'vendor/autoload.php'. When installing CiviCRM
85 // manually from the built tarball, that will be two directories up in the
86 // civicrm-core directory. However, if civicrm-core was installed via
87 // composer as a library, that'll be 5 directories up where composer was
88 // run (ex. the Drupal root on a Drupal 8 site).
89 $civicrm_base_path = dirname(dirname(__DIR__
));
90 $top_path = dirname(dirname(dirname(dirname(dirname(__DIR__
)))));
92 if (file_exists($civicrm_base_path . '/vendor/autoload.php')) {
93 require_once $civicrm_base_path . '/vendor/autoload.php';
95 elseif (file_exists($top_path . '/vendor/autoload.php')) {
96 require_once $top_path . '/vendor/autoload.php';
101 * Registers this instance as an autoloader.
103 * @param bool $prepend
104 * Whether to prepend the autoloader or not.
108 public function register($prepend = FALSE) {
109 if ($this->_registered
) {
112 $civicrm_base_path = dirname(dirname(__DIR__
));
114 $this->requireComposerAutoload();
116 // we do this to prevent a autoloader errors with joomla / 3rd party packages
117 // use absolute path since we dont know the content of include_path as yet
119 // TODO Remove this autoloader. For civicrm-core and civicrm-packages, the composer autoloader works fine.
120 // Extensions rely on include_path-based autoloading
121 spl_autoload_register([$this, 'loadClass'], TRUE, $prepend);
123 $this->_registered
= TRUE;
124 // The ClassLoader runs before the classes are available. Approximate Civi::paths()->get('[civicrm.packages]').
125 if (isset($GLOBALS['civicrm_paths']['civicrm.packages']['path'])) {
126 $packages_path = rtrim($GLOBALS['civicrm_paths']['civicrm.packages']['path'], DIRECTORY_SEPARATOR
);
129 $packages_path = implode(DIRECTORY_SEPARATOR
, [$civicrm_base_path, 'packages']);
136 $include_paths = implode(PATH_SEPARATOR
, $include_paths);
137 set_include_path($include_paths . PATH_SEPARATOR
. get_include_path());
138 // @todo Why do we need to load this again?
139 $this->requireComposerAutoload();
145 public function loadClass($class) {
146 if ($class === 'CiviCRM_API3_Exception' ||
$class === 'API_Exception') {
147 //call internal error class api/Exception first
148 // allow api/Exception class call external error class
149 // CiviCRM_API3_Exception
150 require_once 'api/Exception.php';
153 // Only load classes that clearly belong to CiviCRM.
154 // Note: api/v3 does not use classes, but api_v3's test-suite does
155 (0 === strncmp($class, 'CRM_', 4) ||
0 === strncmp($class, 'CRMTraits', 9) ||
0 === strncmp($class, 'api_v3_', 7) ||
0 === strncmp($class, 'WebTest_', 8) ||
0 === strncmp($class, 'E2E_', 4)) &&
156 // Do not load PHP 5.3 namespaced classes.
157 // (in a future version, maybe)
158 FALSE === strpos($class, '\\')
160 $file = strtr($class, '_', '/') . '.php';
161 // There is some question about the best way to do this.
162 // "require_once" is nice because it's simple and throws
163 // intelligible errors.
164 if (FALSE != stream_resolve_include_path($file)) {
168 elseif (in_array($class, $this->civiTestClasses
)) {
169 $file = "tests/phpunit/CiviTest/{$class}.php";
170 if (FALSE != stream_resolve_include_path($file)) {
174 elseif ($class === 'CiviSeleniumSettings') {
175 if (!empty($GLOBALS['_CV'])) {
176 require_once 'tests/phpunit/CiviTest/CiviSeleniumSettings.auto.php';
178 elseif (CRM_Utils_File
::isIncludable('tests/phpunit/CiviTest/CiviSeleniumSettings.php')) {
179 require_once 'tests/phpunit/CiviTest/CiviSeleniumSettings.php';