Commit | Line | Data |
---|---|---|
6a488035 TO |
1 | <?php |
2 | /* | |
3 | +--------------------------------------------------------------------+ | |
7e9e8871 | 4 | | CiviCRM version 4.7 | |
6a488035 | 5 | +--------------------------------------------------------------------+ |
e7112fa7 | 6 | | Copyright CiviCRM LLC (c) 2004-2015 | |
6a488035 TO |
7 | +--------------------------------------------------------------------+ |
8 | | This file is a part of CiviCRM. | | |
9 | | | | |
10 | | CiviCRM is free software; you can copy, modify, and distribute it | | |
11 | | under the terms of the GNU Affero General Public License | | |
12 | | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. | | |
13 | | | | |
14 | | CiviCRM is distributed in the hope that it will be useful, but | | |
15 | | WITHOUT ANY WARRANTY; without even the implied warranty of | | |
16 | | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | | |
17 | | See the GNU Affero General Public License for more details. | | |
18 | | | | |
19 | | You should have received a copy of the GNU Affero General Public | | |
20 | | License and the CiviCRM Licensing Exception along | | |
21 | | with this program; if not, contact CiviCRM LLC | | |
22 | | at info[AT]civicrm[DOT]org. If you have questions about the | | |
23 | | GNU Affero General Public License or the licensing of CiviCRM, | | |
24 | | see the CiviCRM license FAQ at http://civicrm.org/licensing | | |
25 | +--------------------------------------------------------------------+ | |
d25dd0ee | 26 | */ |
6a488035 TO |
27 | |
28 | /** | |
29 | * Config handles all the run time configuration changes that the system needs to deal with. | |
8eedd10a | 30 | * |
6a488035 TO |
31 | * Typically we'll have different values for a user's sandbox, a qa sandbox and a production area. |
32 | * The default values in general, should reflect production values (minimizes chances of screwing up) | |
33 | * | |
34 | * @package CRM | |
e7112fa7 | 35 | * @copyright CiviCRM LLC (c) 2004-2015 |
6a488035 TO |
36 | */ |
37 | ||
38 | require_once 'Log.php'; | |
39 | require_once 'Mail.php'; | |
40 | ||
41 | require_once 'api/api.php'; | |
72536736 | 42 | |
28518c90 EM |
43 | /** |
44 | * Class CRM_Core_Config | |
45 | */ | |
c0a1f187 | 46 | class CRM_Core_Config extends CRM_Core_Config_MagicMerge { |
4d66768d | 47 | |
6a488035 TO |
48 | /** |
49 | * The handle to the log that we are using | |
50 | * @var object | |
51 | */ | |
52 | private static $_log = NULL; | |
53 | ||
6a488035 TO |
54 | /** |
55 | * We only need one instance of this object. So we use the singleton | |
56 | * pattern and cache the instance in this variable | |
72536736 AH |
57 | * |
58 | * @var CRM_Core_Config | |
6a488035 TO |
59 | */ |
60 | private static $_singleton = NULL; | |
61 | ||
6a488035 TO |
62 | /** |
63 | * The constructor. Sets domain id if defined, otherwise assumes | |
64 | * single instance installation. | |
6a488035 | 65 | */ |
0acb7f15 | 66 | public function __construct() { |
c0a1f187 | 67 | parent::__construct(); |
6a488035 TO |
68 | } |
69 | ||
70 | /** | |
71 | * Singleton function used to manage this object. | |
72 | * | |
5a4f6742 CW |
73 | * @param bool $loadFromDB |
74 | * whether to load from the database. | |
75 | * @param bool $force | |
76 | * whether to force a reconstruction. | |
6a488035 | 77 | * |
5af8c999 | 78 | * @return CRM_Core_Config |
6a488035 | 79 | */ |
00be9182 | 80 | public static function &singleton($loadFromDB = TRUE, $force = FALSE) { |
6a488035 | 81 | if (self::$_singleton === NULL || $force) { |
ca32aecc TO |
82 | $GLOBALS['civicrm_default_error_scope'] = CRM_Core_TemporaryErrorScope::create(array('CRM_Core_Error', 'handle')); |
83 | $errorScope = CRM_Core_TemporaryErrorScope::create(array('CRM_Core_Error', 'simpleHandler')); | |
6a488035 | 84 | |
6a488035 TO |
85 | if (defined('E_DEPRECATED')) { |
86 | error_reporting(error_reporting() & ~E_DEPRECATED); | |
87 | } | |
88 | ||
fc50f470 | 89 | self::$_singleton = new CRM_Core_Config(); |
7f835399 TO |
90 | \Civi\Core\Container::boot($loadFromDB); |
91 | if ($loadFromDB && self::$_singleton->dsn) { | |
c0a1f187 TO |
92 | $domain = \CRM_Core_BAO_Domain::getDomain(); |
93 | \CRM_Core_BAO_ConfigSetting::applyLocale(\Civi::settings($domain->id), $domain->locales); | |
6a488035 | 94 | |
fc50f470 | 95 | unset($errorScope); |
6a488035 | 96 | |
fc50f470 TO |
97 | CRM_Utils_Hook::config(self::$_singleton); |
98 | self::$_singleton->authenticate(); | |
23bb9c85 | 99 | |
fc50f470 TO |
100 | // Extreme backward compat: $config binds to active domain at moment of setup. |
101 | self::$_singleton->getSettings(); | |
23bb9c85 | 102 | |
fc50f470 TO |
103 | Civi::service('settings_manager')->useDefaults(); |
104 | } | |
6a488035 TO |
105 | } |
106 | return self::$_singleton; | |
107 | } | |
108 | ||
6a488035 | 109 | /** |
d09edf64 | 110 | * Returns the singleton logger for the application. |
6a488035 | 111 | * |
c0a1f187 | 112 | * @deprecated |
6a488035 | 113 | * @return object |
c0a1f187 | 114 | * @see Civi::log() |
6a488035 TO |
115 | */ |
116 | static public function &getLog() { | |
117 | if (!isset(self::$_log)) { | |
118 | self::$_log = Log::singleton('display'); | |
119 | } | |
120 | ||
121 | return self::$_log; | |
122 | } | |
123 | ||
6a488035 | 124 | /** |
d09edf64 | 125 | * Retrieve a mailer to send any mail from the application. |
6a488035 | 126 | * |
247eb841 TO |
127 | * @return Mail |
128 | * @deprecated | |
c0a1f187 | 129 | * @see Civi::service() |
6a488035 | 130 | */ |
247eb841 | 131 | public static function getMailer() { |
048222df | 132 | return Civi::service('pear_mail'); |
72ad6c1b TO |
133 | } |
134 | ||
6a488035 | 135 | /** |
d09edf64 | 136 | * Deletes the web server writable directories. |
6a488035 | 137 | * |
72536736 AH |
138 | * @param int $value |
139 | * 1: clean templates_c, 2: clean upload, 3: clean both | |
140 | * @param bool $rmdir | |
6a488035 TO |
141 | */ |
142 | public function cleanup($value, $rmdir = TRUE) { | |
143 | $value = (int ) $value; | |
144 | ||
145 | if ($value & 1) { | |
146 | // clean templates_c | |
147 | CRM_Utils_File::cleanDir($this->templateCompileDir, $rmdir); | |
148 | CRM_Utils_File::createDir($this->templateCompileDir); | |
149 | } | |
150 | if ($value & 2) { | |
151 | // clean upload dir | |
152 | CRM_Utils_File::cleanDir($this->uploadDir); | |
153 | CRM_Utils_File::createDir($this->uploadDir); | |
fea6131e TO |
154 | } |
155 | ||
156 | // Whether we delete/create or simply preserve directories, we should | |
157 | // certainly make sure the restrictions are enforced. | |
353ffa53 TO |
158 | foreach (array( |
159 | $this->templateCompileDir, | |
160 | $this->uploadDir, | |
161 | $this->configAndLogDir, | |
8d7a9d07 | 162 | $this->customFileUploadDir, |
353ffa53 | 163 | ) as $dir) { |
fea6131e TO |
164 | if ($dir && is_dir($dir)) { |
165 | CRM_Utils_File::restrictAccess($dir); | |
166 | } | |
6a488035 TO |
167 | } |
168 | } | |
169 | ||
170 | /** | |
0880a9d0 | 171 | * Verify that the needed parameters are not null in the config. |
6a488035 | 172 | * |
8d7a9d07 CB |
173 | * @param CRM_Core_Config $config (reference) the system config object |
174 | * @param array $required (reference) the parameters that need a value | |
6a488035 | 175 | * |
8d7a9d07 | 176 | * @return bool |
6a488035 | 177 | */ |
00be9182 | 178 | public static function check(&$config, &$required) { |
6a488035 TO |
179 | foreach ($required as $name) { |
180 | if (CRM_Utils_System::isNull($config->$name)) { | |
181 | return FALSE; | |
182 | } | |
183 | } | |
184 | return TRUE; | |
185 | } | |
186 | ||
187 | /** | |
0880a9d0 | 188 | * Reset the serialized array and recompute. |
6a488035 TO |
189 | * use with care |
190 | */ | |
00be9182 | 191 | public function reset() { |
6a488035 TO |
192 | $query = "UPDATE civicrm_domain SET config_backend = null"; |
193 | CRM_Core_DAO::executeQuery($query); | |
194 | } | |
195 | ||
546b78fa | 196 | /** |
0880a9d0 | 197 | * This method should initialize auth sources. |
546b78fa | 198 | */ |
635f0b86 TO |
199 | public function authenticate() { |
200 | // make sure session is always initialised | |
e8f14831 | 201 | $session = CRM_Core_Session::singleton(); |
635f0b86 TO |
202 | |
203 | // for logging purposes, pass the userID to the db | |
204 | $userID = $session->get('userID'); | |
205 | if ($userID) { | |
206 | CRM_Core_DAO::executeQuery('SET @civicrm_user_id = %1', | |
207 | array(1 => array($userID, 'Integer')) | |
208 | ); | |
209 | } | |
210 | ||
e8f14831 DS |
211 | if ($session->get('userID') && !$session->get('authSrc')) { |
212 | $session->set('authSrc', CRM_Core_Permission::AUTH_SRC_LOGIN); | |
213 | } | |
214 | ||
215 | // checksum source | |
216 | CRM_Contact_BAO_Contact_Permission::initChecksumAuthSrc(); | |
217 | } | |
218 | ||
6a488035 | 219 | /** |
0880a9d0 | 220 | * One function to get domain ID. |
6a488035 | 221 | */ |
00be9182 | 222 | public static function domainID($domainID = NULL, $reset = FALSE) { |
6a488035 TO |
223 | static $domain; |
224 | if ($domainID) { | |
225 | $domain = $domainID; | |
226 | } | |
227 | if ($reset || empty($domain)) { | |
228 | $domain = defined('CIVICRM_DOMAIN_ID') ? CIVICRM_DOMAIN_ID : 1; | |
229 | } | |
230 | ||
231 | return $domain; | |
232 | } | |
233 | ||
234 | /** | |
100fef9d | 235 | * Do general cleanup of caches, temp directories and temp tables |
6a488035 TO |
236 | * CRM-8739 |
237 | */ | |
00be9182 | 238 | public function cleanupCaches($sessionReset = TRUE) { |
6a488035 TO |
239 | // cleanup templates_c directory |
240 | $this->cleanup(1, FALSE); | |
241 | ||
1b50807d | 242 | // clear all caches |
6a488035 | 243 | self::clearDBCache(); |
1b50807d | 244 | CRM_Utils_System::flushCache(); |
6a488035 TO |
245 | |
246 | if ($sessionReset) { | |
247 | $session = CRM_Core_Session::singleton(); | |
248 | $session->reset(2); | |
249 | } | |
250 | } | |
251 | ||
252 | /** | |
253 | * Do general cleanup of module permissions. | |
254 | */ | |
00be9182 | 255 | public function cleanupPermissions() { |
6a488035 | 256 | $module_files = CRM_Extension_System::singleton()->getMapper()->getActiveModuleFiles(); |
7fccad46 TO |
257 | if ($this->userPermissionClass->isModulePermissionSupported()) { |
258 | // Can store permissions -- so do it! | |
0d8fc497 TO |
259 | $this->userPermissionClass->upgradePermissions( |
260 | CRM_Core_Permission::basicPermissions() | |
261 | ); | |
0db6c3e1 TO |
262 | } |
263 | else { | |
7fccad46 TO |
264 | // Cannot store permissions -- warn if any modules require them |
265 | $modules_with_perms = array(); | |
266 | foreach ($module_files as $module_file) { | |
267 | $perms = $this->userPermissionClass->getModulePermissions($module_file['prefix']); | |
268 | if (!empty($perms)) { | |
269 | $modules_with_perms[] = $module_file['prefix']; | |
270 | } | |
271 | } | |
272 | if (!empty($modules_with_perms)) { | |
273 | CRM_Core_Session::setStatus( | |
10a5be27 | 274 | ts('Some modules define permissions, but the CMS cannot store them: %1', array(1 => implode(', ', $modules_with_perms))), |
7fccad46 TO |
275 | ts('Permission Error'), |
276 | 'error' | |
277 | ); | |
278 | } | |
6a488035 TO |
279 | } |
280 | } | |
281 | ||
282 | /** | |
0880a9d0 | 283 | * Flush information about loaded modules. |
6a488035 | 284 | */ |
00be9182 | 285 | public function clearModuleList() { |
6a488035 TO |
286 | CRM_Extension_System::singleton()->getCache()->flush(); |
287 | CRM_Utils_Hook::singleton(TRUE); | |
288 | CRM_Core_PseudoConstant::getModuleExtensions(TRUE); | |
289 | CRM_Core_Module::getAll(TRUE); | |
290 | } | |
291 | ||
292 | /** | |
0880a9d0 | 293 | * Clear db cache. |
6a488035 TO |
294 | */ |
295 | public static function clearDBCache() { | |
296 | $queries = array( | |
297 | 'TRUNCATE TABLE civicrm_acl_cache', | |
298 | 'TRUNCATE TABLE civicrm_acl_contact_cache', | |
299 | 'TRUNCATE TABLE civicrm_cache', | |
300 | 'TRUNCATE TABLE civicrm_prevnext_cache', | |
301 | 'UPDATE civicrm_group SET cache_date = NULL', | |
302 | 'TRUNCATE TABLE civicrm_group_contact_cache', | |
303 | 'TRUNCATE TABLE civicrm_menu', | |
304 | 'UPDATE civicrm_setting SET value = NULL WHERE name="navigation" AND contact_id IS NOT NULL', | |
305 | 'DELETE FROM civicrm_setting WHERE name="modulePaths"', // CRM-10543 | |
306 | ); | |
307 | ||
308 | foreach ($queries as $query) { | |
309 | CRM_Core_DAO::executeQuery($query); | |
310 | } | |
311 | ||
312 | // also delete all the import and export temp tables | |
313 | self::clearTempTables(); | |
314 | } | |
315 | ||
316 | /** | |
0880a9d0 | 317 | * Clear leftover temporary tables. |
0383ef73 EM |
318 | * |
319 | * This is called on upgrade, during tests and site move, from the cron and via clear caches in the UI. | |
320 | * | |
321 | * Currently the UI clear caches does not pass a time interval - which may need review as it does risk | |
322 | * ripping the tables out from underneath a current action. This was considered but | |
323 | * out-of-scope for CRM-16167 | |
324 | * | |
325 | * @param string|bool $timeInterval | |
326 | * Optional time interval for mysql date function.g '2 day'. This can be used to prevent | |
327 | * tables created recently from being deleted. | |
6a488035 | 328 | */ |
0383ef73 EM |
329 | public static function clearTempTables($timeInterval = FALSE) { |
330 | ||
331 | $dao = new CRM_Core_DAO(); | |
6a488035 | 332 | $query = " |
0383ef73 EM |
333 | SELECT TABLE_NAME as tableName |
334 | FROM INFORMATION_SCHEMA.TABLES | |
335 | WHERE TABLE_SCHEMA = %1 | |
336 | AND ( | |
337 | TABLE_NAME LIKE 'civicrm_import_job_%' | |
338 | OR TABLE_NAME LIKE 'civicrm_export_temp%' | |
339 | OR TABLE_NAME LIKE 'civicrm_task_action_temp%' | |
340 | OR TABLE_NAME LIKE 'civicrm_report_temp%' | |
341 | ) | |
342 | "; | |
343 | if ($timeInterval) { | |
344 | $query .= " AND CREATE_TIME < DATE_SUB(NOW(), INTERVAL {$timeInterval})"; | |
345 | } | |
346 | ||
347 | $tableDAO = CRM_Core_DAO::executeQuery($query, array(1 => array($dao->database(), 'String'))); | |
6a488035 TO |
348 | $tables = array(); |
349 | while ($tableDAO->fetch()) { | |
350 | $tables[] = $tableDAO->tableName; | |
351 | } | |
352 | if (!empty($tables)) { | |
353 | $table = implode(',', $tables); | |
354 | // drop leftover temporary tables | |
355 | CRM_Core_DAO::executeQuery("DROP TABLE $table"); | |
356 | } | |
357 | } | |
358 | ||
359 | /** | |
0880a9d0 | 360 | * Check if running in upgrade mode. |
6a488035 | 361 | */ |
00be9182 | 362 | public static function isUpgradeMode($path = NULL) { |
6a488035 TO |
363 | if (defined('CIVICRM_UPGRADE_ACTIVE')) { |
364 | return TRUE; | |
365 | } | |
366 | ||
367 | if (!$path) { | |
368 | // note: do not re-initialize config here, since this function is part of | |
369 | // config initialization itself | |
370 | $urlVar = 'q'; | |
371 | if (defined('CIVICRM_UF') && CIVICRM_UF == 'Joomla') { | |
372 | $urlVar = 'task'; | |
373 | } | |
374 | ||
375 | $path = CRM_Utils_Array::value($urlVar, $_GET); | |
376 | } | |
377 | ||
378 | if ($path && preg_match('/^civicrm\/upgrade(\/.*)?$/', $path)) { | |
379 | return TRUE; | |
380 | } | |
381 | ||
382 | return FALSE; | |
383 | } | |
384 | ||
9be1374d EM |
385 | /** |
386 | * Is back office credit card processing enabled for this site - ie are there any installed processors that support | |
fbcb6fba | 387 | * it? |
52767de0 EM |
388 | * This function is used for determining whether to show the submit credit card link, not for determining which processors to show, hence |
389 | * it is a config var | |
9be1374d EM |
390 | * @return bool |
391 | */ | |
00be9182 | 392 | public static function isEnabledBackOfficeCreditCardPayments() { |
44b6505d | 393 | return CRM_Financial_BAO_PaymentProcessor::hasPaymentProcessorSupporting(array('BackOffice')); |
9be1374d | 394 | } |
96025800 | 395 | |
0acb7f15 TO |
396 | /** |
397 | * @deprecated | |
398 | */ | |
399 | public function addressSequence() { | |
400 | return CRM_Utils_Address::sequence(Civi::settings()->get('address_format')); | |
401 | } | |
402 | ||
403 | /** | |
404 | * @deprecated | |
405 | */ | |
406 | public function defaultContactCountry() { | |
407 | return CRM_Core_BAO_Country::defaultContactCountry(); | |
408 | } | |
409 | ||
410 | /** | |
411 | * @deprecated | |
412 | */ | |
413 | public function defaultContactCountryName() { | |
414 | return CRM_Core_BAO_Country::defaultContactCountryName(); | |
415 | } | |
416 | ||
417 | /** | |
418 | * @deprecated | |
419 | */ | |
420 | public function defaultCurrencySymbol($defaultCurrency = NULL) { | |
421 | return CRM_Core_BAO_Country::defaultCurrencySymbol($defaultCurrency); | |
422 | } | |
423 | ||
97b8e6b2 | 424 | /** |
425 | * Resets the singleton, so that the next call to CRM_Core_Config::singleton() | |
426 | * reloads completely. | |
427 | * | |
428 | * While normally we could call the singleton function with $force = TRUE, | |
429 | * this function addresses a very specific use-case in the CiviCRM installer, | |
430 | * where we cannot yet force a reload, but we want to make sure that the next | |
431 | * call to this object gets a fresh start (ex: to initialize the DAO). | |
432 | */ | |
433 | public function free() { | |
434 | self::$_singleton = NULL; | |
435 | } | |
c8ab0a65 | 436 | |
6a488035 | 437 | } |