3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2015 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
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. |
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. |
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 +--------------------------------------------------------------------+
29 * Start of the Error framework. We should check out and inherit from
30 * PEAR_ErrorStack and use that framework
33 * @copyright CiviCRM LLC (c) 2004-2015
36 require_once 'PEAR/ErrorStack.php';
37 require_once 'PEAR/Exception.php';
38 require_once 'CRM/Core/Exception.php';
40 require_once 'Log.php';
45 class CRM_Exception
extends PEAR_Exception
{
47 * Redefine the exception so message isn't optional.
49 * Supported signatures:
50 * - PEAR_Exception(string $message);
51 * - PEAR_Exception(string $message, int $code);
52 * - PEAR_Exception(string $message, Exception $cause);
53 * - PEAR_Exception(string $message, Exception $cause, int $code);
54 * - PEAR_Exception(string $message, PEAR_Error $cause);
55 * - PEAR_Exception(string $message, PEAR_Error $cause, int $code);
56 * - PEAR_Exception(string $message, array $causes);
57 * - PEAR_Exception(string $message, array $causes, int $code);
59 * @param string $message exception message
61 * @param Exception $previous
63 public function __construct($message = NULL, $code = 0, Exception
$previous = NULL) {
64 parent
::__construct($message, $code, $previous);
70 * Class CRM_Core_Error
72 class CRM_Core_Error
extends PEAR_ErrorStack
{
75 * Status code of various types of errors.
77 const FATAL_ERROR
= 2;
78 const DUPLICATE_CONTACT
= 8001;
79 const DUPLICATE_CONTRIBUTION
= 8002;
80 const DUPLICATE_PARTICIPANT
= 8003;
83 * We only need one instance of this object. So we use the singleton
84 * pattern and cache the instance in this variable
87 private static $_singleton = NULL;
90 * The logger object for this application.
93 private static $_log = NULL;
96 * If modeException == true, errors are raised as exception instead of returning civicrm_errors
98 public static $modeException = NULL;
101 * Singleton function used to manage this object.
103 * @param null $package
104 * @param bool $msgCallback
105 * @param bool $contextCallback
106 * @param bool $throwPEAR_Error
107 * @param string $stackClass
111 public static function &singleton($package = NULL, $msgCallback = FALSE, $contextCallback = FALSE, $throwPEAR_Error = FALSE, $stackClass = 'PEAR_ErrorStack') {
112 if (self
::$_singleton === NULL) {
113 self
::$_singleton = new CRM_Core_Error('CiviCRM');
115 return self
::$_singleton;
121 public function __construct() {
122 parent
::__construct('CiviCRM');
124 $log = CRM_Core_Config
::getLog();
125 $this->setLogger($log);
127 // set up error handling for Pear Error Stack
128 $this->setDefaultCallback(array($this, 'handlePES'));
133 * @param string $separator
135 * @return array|null|string
137 static public function getMessages(&$error, $separator = '<br />') {
138 if (is_a($error, 'CRM_Core_Error')) {
139 $errors = $error->getErrors();
141 foreach ($errors as $e) {
142 $message[] = $e['code'] . ': ' . $e['message'];
144 $message = implode($separator, $message);
151 * Status display function specific to payment processor errors.
153 * @param string $separator
155 public static function displaySessionError(&$error, $separator = '<br />') {
156 $message = self
::getMessages($error, $separator);
158 $status = ts("Payment Processor Error message") . "{$separator} $message";
159 $session = CRM_Core_Session
::singleton();
160 $session->setStatus($status);
165 * Create the main callback method. this method centralizes error processing.
167 * the errors we expect are from the pear modules DB, DB_DataObject
168 * which currently use PEAR::raiseError to notify of error messages.
170 * @param object $pearError PEAR_Error
172 public static function handle($pearError) {
173 if (defined('CIVICRM_TEST')) {
174 return self
::simpleHandler($pearError);
177 // setup smarty with config, session and template location.
178 $template = CRM_Core_Smarty
::singleton();
179 $config = CRM_Core_Config
::singleton();
181 if ($config->backtrace
) {
185 // create the error array
187 $error['callback'] = $pearError->getCallback();
188 $error['code'] = $pearError->getCode();
189 $error['message'] = $pearError->getMessage();
190 $error['mode'] = $pearError->getMode();
191 $error['debug_info'] = $pearError->getDebugInfo();
192 $error['type'] = $pearError->getType();
193 $error['user_info'] = $pearError->getUserInfo();
194 $error['to_string'] = $pearError->toString();
196 // We access connection info via _DB_DATAOBJECT instead
197 // of, e.g., calling getDatabaseConnection(), so that we
198 // can avoid infinite loops.
199 global $_DB_DATAOBJECT;
201 if (!isset($_DB_DATAOBJECT['CONFIG']['database'])) {
202 // we haven't setup sql, so it's not our sql error...
204 elseif (preg_match('/^mysql:/', $_DB_DATAOBJECT['CONFIG']['database']) &&
207 $mysql_error = mysql_error() . ', ' . mysql_errno();
208 $template->assign_by_ref('mysql_code', $mysql_error);
210 // execute a dummy query to clear error stack
211 mysql_query('select 1');
213 elseif (preg_match('/^mysqli:/', $_DB_DATAOBJECT['CONFIG']['database'])) {
214 $dao = new CRM_Core_DAO();
216 if (isset($_DB_DATAOBJECT['CONNECTIONS'][$dao->_database_dsn_md5
])) {
217 $conn = $_DB_DATAOBJECT['CONNECTIONS'][$dao->_database_dsn_md5
];
218 $link = $conn->connection
;
220 if (mysqli_error($link)) {
221 $mysql_error = mysqli_error($link) . ', ' . mysqli_errno($link);
222 $template->assign_by_ref('mysql_code', $mysql_error);
224 // execute a dummy query to clear error stack
225 mysqli_query($link, 'select 1');
230 $template->assign_by_ref('error', $error);
231 $errorDetails = CRM_Core_Error
::debug('', $error, FALSE);
232 $template->assign_by_ref('errorDetails', $errorDetails);
234 CRM_Core_Error
::debug_var('Fatal Error Details', $error);
235 CRM_Core_Error
::backtrace('backTrace', TRUE);
237 if ($config->initialized
) {
238 $content = $template->fetch('CRM/common/fatal.tpl');
239 echo CRM_Utils_System
::theme($content);
242 echo "Sorry. A non-recoverable error has occurred. The error trace below might help to resolve the issue<p>";
243 CRM_Core_Error
::debug(NULL, $error);
245 static $runOnce = FALSE;
254 * this function is used to trap and print errors
255 * during system initialization time. Hence the error
256 * message is quite ugly
260 public static function simpleHandler($pearError) {
262 // create the error array
264 $error['callback'] = $pearError->getCallback();
265 $error['code'] = $pearError->getCode();
266 $error['message'] = $pearError->getMessage();
267 $error['mode'] = $pearError->getMode();
268 $error['debug_info'] = $pearError->getDebugInfo();
269 $error['type'] = $pearError->getType();
270 $error['user_info'] = $pearError->getUserInfo();
271 $error['to_string'] = $pearError->toString();
273 // ensure that debug does not check permissions since we are in bootstrap
274 // mode and need to print a decent message to help the user
275 CRM_Core_Error
::debug('Initialization Error', $error, TRUE, TRUE, FALSE);
277 // always log the backtrace to a file
278 self
::backtrace('backTrace', TRUE);
284 * Handle errors raised using the PEAR Error Stack.
286 * currently the handler just requests the PES framework
287 * to push the error to the stack (return value PEAR_ERRORSTACK_PUSH).
289 * Note: we can do our own error handling here and return PEAR_ERRORSTACK_IGNORE.
291 * Also, if we do not return any value the PEAR_ErrorStack::push() then does the
292 * action of PEAR_ERRORSTACK_PUSHANDLOG which displays the errors on the screen,
293 * since the logger set for this error stack is 'display' - see CRM_Core_Config::getLog();
295 * @param mixed $pearError
299 public static function handlePES($pearError) {
300 return PEAR_ERRORSTACK_PUSH
;
304 * Display an error page with an error message describing what happened.
306 * @param string $message
308 * @param string $code
309 * The error code if any.
310 * @param string $email
311 * The email address to notify of this situation.
315 public static function fatal($message = NULL, $code = NULL, $email = NULL) {
317 'message' => htmlspecialchars($message),
321 if (self
::$modeException) {
323 CRM_Core_Error
::debug_var('Fatal Error Details', $vars);
324 CRM_Core_Error
::backtrace('backTrace', TRUE);
326 $details = 'A fatal error was triggered';
328 $details .= ': ' . $message;
330 throw new Exception($details, $code);
334 $message = ts('We experienced an unexpected error. Please post a detailed description and the backtrace on the CiviCRM forums: %1', array(1 => 'http://forum.civicrm.org/'));
337 if (php_sapi_name() == "cli") {
338 print ("Sorry. A non-recoverable error has occurred.\n$message \n$code\n$email\n\n");
340 echo static::formatBacktrace(debug_backtrace());
342 // FIXME: Why doesn't this call abend()?
343 // Difference: abend() will cleanup transaction and (via civiExit) store session state
344 // self::abend(CRM_Core_Error::FATAL_ERROR);
347 $config = CRM_Core_Config
::singleton();
349 if ($config->fatalErrorHandler
&&
350 function_exists($config->fatalErrorHandler
)
352 $name = $config->fatalErrorHandler
;
355 // the call has been successfully handled
357 self
::abend(CRM_Core_Error
::FATAL_ERROR
);
361 if ($config->backtrace
) {
365 CRM_Core_Error
::debug_var('Fatal Error Details', $vars);
366 CRM_Core_Error
::backtrace('backTrace', TRUE);
368 // If we are in an ajax callback, format output appropriately
369 if (CRM_Utils_Array
::value('snippet', $_REQUEST) === CRM_Core_Smarty
::PRINT_JSON
) {
372 'content' => '<div class="messages status no-popup"><div class="icon inform-icon"></div>' . ts('Sorry but we are not able to provide this at the moment.') . '</div>',
374 if ($config->backtrace
&& CRM_Core_Permission
::check('view debug output')) {
375 $out['backtrace'] = self
::parseBacktrace(debug_backtrace());
376 $message .= '<p><em>See console for backtrace</em></p>';
378 CRM_Core_Session
::setStatus($message, ts('Sorry an error occurred'), 'error');
379 CRM_Core_Transaction
::forceRollbackIfEnabled();
380 CRM_Core_Page_AJAX
::returnJsonResponse($out);
383 $template = CRM_Core_Smarty
::singleton();
384 $template->assign($vars);
385 $config->userSystem
->outputError($template->fetch('CRM/common/fatal.tpl'));
387 self
::abend(CRM_Core_Error
::FATAL_ERROR
);
391 * Display an error page with an error message describing what happened.
393 * This function is evil -- it largely replicates fatal(). Hopefully the
394 * entire CRM_Core_Error system can be hollowed out and replaced with
395 * something that follows a cleaner separation of concerns.
397 * @param Exception $exception
399 public static function handleUnhandledException($exception) {
401 CRM_Utils_Hook
::unhandledException($exception);
403 catch (Exception
$other) {
404 // if the exception-handler generates an exception, then that sucks! oh, well. carry on.
405 CRM_Core_Error
::debug_var('handleUnhandledException_nestedException', self
::formatTextException($other));
407 $config = CRM_Core_Config
::singleton();
409 'message' => $exception->getMessage(),
411 'exception' => $exception,
413 if (!$vars['message']) {
414 $vars['message'] = ts('We experienced an unexpected error. Please post a detailed description and the backtrace on the CiviCRM forums: %1', array(1 => 'http://forum.civicrm.org/'));
418 if (php_sapi_name() == "cli") {
419 printf("Sorry. A non-recoverable error has occurred.\n%s\n", $vars['message']);
420 print self
::formatTextException($exception);
422 // FIXME: Why doesn't this call abend()?
423 // Difference: abend() will cleanup transaction and (via civiExit) store session state
424 // self::abend(CRM_Core_Error::FATAL_ERROR);
427 // Case B: Custom error handler
428 if ($config->fatalErrorHandler
&&
429 function_exists($config->fatalErrorHandler
)
431 $name = $config->fatalErrorHandler
;
434 // the call has been successfully handled
436 self
::abend(CRM_Core_Error
::FATAL_ERROR
);
440 // Case C: Default error handler
443 CRM_Core_Error
::debug_var('Fatal Error Details', $vars);
444 CRM_Core_Error
::backtrace('backTrace', TRUE);
447 $template = CRM_Core_Smarty
::singleton();
448 $template->assign($vars);
449 $content = $template->fetch('CRM/common/fatal.tpl');
450 if ($config->backtrace
) {
451 $content = self
::formatHtmlException($exception) . $content;
453 if ($config->userFramework
== 'Joomla' &&
454 class_exists('JError')
456 JError
::raiseError('CiviCRM-001', $content);
459 echo CRM_Utils_System
::theme($content);
463 self
::abend(CRM_Core_Error
::FATAL_ERROR
);
467 * Outputs pre-formatted debug information. Flushes the buffers
468 * so we can interrupt a potential POST/redirect
470 * @param string $name name of debug section
471 * @param $variable mixed reference to variables that we need a trace of
472 * @param bool $log should we log or return the output
473 * @param bool $html whether to generate a HTML-escaped output
474 * @param bool $checkPermission should we check permissions before displaying output
475 * useful when we die during initialization and permissioning
476 * subsystem is not initialized - CRM-13765
479 * the generated output
481 public static function debug($name, $variable = NULL, $log = TRUE, $html = TRUE, $checkPermission = TRUE) {
482 $error = self
::singleton();
484 if ($variable === NULL) {
489 $out = print_r($variable, TRUE);
492 $out = htmlspecialchars($out);
494 $prefix = "<p>$name</p>";
496 $out = "{$prefix}<p><pre>$out</pre></p><p></p>";
500 $prefix = "$name:\n";
502 $out = "{$prefix}$out\n";
506 (!$checkPermission || CRM_Core_Permission
::check('view debug output'))
515 * Similar to the function debug. Only difference is
516 * in the formatting of the output.
518 * @param string $variable_name
519 * @param mixed $variable
521 * Should we use print_r ? (else we use var_dump).
523 * Should we log or return the output.
524 * @param string $comp
528 * the generated output
532 * @see CRM_Core_Error::debug()
533 * @see CRM_Core_Error::debug_log_message()
535 public static function debug_var(
542 // check if variable is set
543 if (!isset($variable)) {
544 $out = "\$$variable_name is not set";
548 $out = print_r($variable, TRUE);
549 $out = "\$$variable_name = $out";
555 $dump = ob_get_contents();
557 $out = "\n\$$variable_name = $dump";
559 // reset if it is an array
560 if (is_array($variable)) {
564 return self
::debug_log_message($out, FALSE, $comp);
568 * Display the error message on terminal.
570 * @param string $message
572 * Should we log or return the output.
574 * @param string $comp
575 * Message to be output.
576 * @param string $priority
579 * Format of the backtrace
581 public static function debug_log_message($message, $out = FALSE, $comp = '', $priority = NULL) {
582 $config = CRM_Core_Config
::singleton();
584 $file_log = self
::createDebugLogger($comp);
585 $file_log->log("$message\n", $priority);
587 $str = '<p/><code>' . htmlspecialchars($message) . '</code>';
588 if ($out && CRM_Core_Permission
::check('view debug output')) {
593 if (!empty($config->userFrameworkLogging
)) {
594 // should call $config->userSystem->logger($message) here - but I got a situation where userSystem was not an object - not sure why
595 if ($config->userSystem
->is_drupal
and function_exists('watchdog')) {
596 watchdog('civicrm', '%message', array('%message' => $message), WATCHDOG_DEBUG
);
604 * Append to the query log (if enabled)
606 * @param string $string
608 public static function debug_query($string) {
609 if (defined('CIVICRM_DEBUG_LOG_QUERY')) {
610 if (CIVICRM_DEBUG_LOG_QUERY
== 'backtrace') {
611 CRM_Core_Error
::backtrace($string, TRUE);
613 elseif (CIVICRM_DEBUG_LOG_QUERY
) {
614 CRM_Core_Error
::debug_var('Query', $string, FALSE, TRUE);
620 * Execute a query and log the results.
622 * @param string $query
624 public static function debug_query_result($query) {
625 $results = CRM_Core_DAO
::executeQuery($query)->fetchAll();
626 CRM_Core_Error
::debug_var('dao result', array('query' => $query, 'results' => $results));
630 * Obtain a reference to the error log.
632 * @param string $comp
636 public static function createDebugLogger($comp = '') {
637 $config = CRM_Core_Config
::singleton();
643 $fileName = "{$config->configAndLogDir}CiviCRM." . $comp . md5($config->dsn
) . '.log';
645 // Roll log file monthly or if greater than 256M
646 // note that PHP file functions have a limit of 2G and hence
647 // the alternative was introduce
648 if (file_exists($fileName)) {
649 $fileTime = date("Ym", filemtime($fileName));
650 $fileSize = filesize($fileName);
651 if (($fileTime < date('Ym')) ||
652 ($fileSize > 256 * 1024 * 1024) ||
656 $fileName . '.' . date('YmdHi')
661 return Log
::singleton('file', $fileName);
668 public static function backtrace($msg = 'backTrace', $log = FALSE) {
669 $backTrace = debug_backtrace();
670 $message = self
::formatBacktrace($backTrace);
672 CRM_Core_Error
::debug($msg, $message);
675 CRM_Core_Error
::debug_var($msg, $message);
680 * Render a backtrace array as a string.
682 * @param array $backTrace
683 * Array of stack frames.
684 * @param bool $showArgs
685 * TRUE if we should try to display content of function arguments (which could be sensitive); FALSE to display only the type of each function argument.
686 * @param int $maxArgLen
687 * Maximum number of characters to show from each argument string.
689 * printable plain-text
691 public static function formatBacktrace($backTrace, $showArgs = TRUE, $maxArgLen = 80) {
693 foreach (self
::parseBacktrace($backTrace, $showArgs, $maxArgLen) as $idx => $trace) {
694 $message .= sprintf("#%s %s\n", $idx, $trace);
696 $message .= sprintf("#%s {main}\n", 1 +
$idx);
701 * Render a backtrace array as an array.
703 * @param array $backTrace
704 * Array of stack frames.
705 * @param bool $showArgs
706 * TRUE if we should try to display content of function arguments (which could be sensitive); FALSE to display only the type of each function argument.
707 * @param int $maxArgLen
708 * Maximum number of characters to show from each argument string.
710 * @see debug_backtrace
711 * @see Exception::getTrace()
713 public static function parseBacktrace($backTrace, $showArgs = TRUE, $maxArgLen = 80) {
715 foreach ($backTrace as $trace) {
717 $fnName = CRM_Utils_Array
::value('function', $trace);
718 $className = isset($trace['class']) ?
($trace['class'] . $trace['type']) : '';
720 // Do not show args for a few password related functions
721 $skipArgs = ($className == 'DB::' && $fnName == 'connect') ?
TRUE : FALSE;
723 if (!empty($trace['args'])) {
724 foreach ($trace['args'] as $arg) {
725 if (!$showArgs ||
$skipArgs) {
726 $args[] = '(' . gettype($arg) . ')';
729 switch ($type = gettype($arg)) {
731 $args[] = $arg ?
'TRUE' : 'FALSE';
740 $args[] = '"' . CRM_Utils_String
::ellipsify(addcslashes((string) $arg, "\r\n\t\""), $maxArgLen) . '"';
744 $args[] = '(Array:' . count($arg) . ')';
748 $args[] = 'Object(' . get_class($arg) . ')';
752 $args[] = 'Resource';
768 CRM_Utils_Array
::value('file', $trace, '[internal function]'),
769 CRM_Utils_Array
::value('line', $trace, ''),
779 * Render an exception as HTML string.
781 * @param Exception $e
783 * printable HTML text
785 public static function formatHtmlException(Exception
$e) {
788 // Exception metadata
790 // Exception backtrace
791 if ($e instanceof PEAR_Exception
) {
793 while (is_callable(array($ei, 'getCause'))) {
794 if ($ei->getCause() instanceof PEAR_Error
) {
795 $msg .= '<table class="crm-db-error">';
796 $msg .= sprintf('<thead><tr><th>%s</th><th>%s</th></tr></thead>', ts('Error Field'), ts('Error Value'));
798 foreach (array('Type', 'Code', 'Message', 'Mode', 'UserInfo', 'DebugInfo') as $f) {
799 $msg .= sprintf('<tr><td>%s</td><td>%s</td></tr>', $f, call_user_func(array($ei->getCause(), "get$f")));
801 $msg .= '</tbody></table>';
803 $ei = $ei->getCause();
805 $msg .= $e->toHtml();
808 $msg .= '<p><b>' . get_class($e) . ': "' . htmlentities($e->getMessage()) . '"</b></p>';
809 $msg .= '<pre>' . htmlentities(self
::formatBacktrace($e->getTrace())) . '</pre>';
815 * Write details of an exception to the log.
817 * @param Exception $e
819 * printable plain text
821 public static function formatTextException(Exception
$e) {
822 $msg = get_class($e) . ": \"" . $e->getMessage() . "\"\n";
825 while (is_callable(array($ei, 'getCause'))) {
826 if ($ei->getCause() instanceof PEAR_Error
) {
827 foreach (array('Type', 'Code', 'Message', 'Mode', 'UserInfo', 'DebugInfo') as $f) {
828 $msg .= sprintf(" * ERROR %s: %s\n", strtoupper($f), call_user_func(array($ei->getCause(), "get$f")));
831 $ei = $ei->getCause();
833 $msg .= self
::formatBacktrace($e->getTrace());
840 * @param string $level
841 * @param array $params
845 public static function createError($message, $code = 8000, $level = 'Fatal', $params = NULL) {
846 $error = CRM_Core_Error
::singleton();
847 $error->push($code, $level, array($params), $message);
852 * Set a status message in the session, then bounce back to the referrer.
854 * @param string $status
855 * The status message to set.
857 * @param null $redirect
858 * @param string $title
860 public static function statusBounce($status, $redirect = NULL, $title = NULL) {
861 $session = CRM_Core_Session
::singleton();
863 $redirect = $session->readUserContext();
865 if ($title === NULL) {
866 $title = ts('Error');
868 $session->setStatus($status, $title, 'alert', array('expires' => 0));
869 if (CRM_Utils_Array
::value('snippet', $_REQUEST) === CRM_Core_Smarty
::PRINT_JSON
) {
870 CRM_Core_Page_AJAX
::returnJsonResponse(array('status' => 'error'));
872 CRM_Utils_System
::redirect($redirect);
876 * Reset the error stack.
879 public static function reset() {
880 $error = self
::singleton();
881 $error->_errors
= array();
882 $error->_errorsByLevel
= array();
886 * PEAR error-handler which converts errors to exceptions
889 * @throws PEAR_Exception
891 public static function exceptionHandler($pearError) {
892 CRM_Core_Error
::backtrace('backTrace', TRUE);
893 throw new PEAR_Exception($pearError->getMessage(), $pearError);
897 * PEAR error-handler to quietly catch otherwise fatal errors. Intended for use with smtp transport.
900 * The PEAR_ERROR object.
904 public static function nullHandler($obj) {
905 CRM_Core_Error
::debug_log_message("Ignoring exception thrown by nullHandler: {$obj->code}, {$obj->message}");
906 CRM_Core_Error
::backtrace('backTrace', TRUE);
912 * This function is no longer used by v3 api.
913 * @fixme Some core files call it but it should be re-thought & renamed or removed
921 public static function &createAPIError($msg, $data = NULL) {
922 if (self
::$modeException) {
923 throw new Exception($msg, $data);
928 $values['is_error'] = 1;
929 $values['error_message'] = $msg;
931 $values = array_merge($values, $data);
939 public static function movedSiteError($file) {
940 $url = CRM_Utils_System
::url('civicrm/admin/setting/updateConfigBackend',
944 echo "We could not write $file. Have you moved your site directory or server?<p>";
945 echo "Please fix the setting by running the <a href=\"$url\">update config script</a>";
950 * Terminate execution abnormally.
952 * @param string $code
954 protected static function abend($code) {
955 // do a hard rollback of any pending transactions
956 // if we've come here, its because of some unexpected PEAR errors
957 CRM_Core_Transaction
::forceRollbackIfEnabled();
958 CRM_Utils_System
::civiExit($code);
962 * @param array $error
967 public static function isAPIError($error, $type = CRM_Core_Error
::FATAL_ERROR
) {
968 if (is_array($error) && !empty($error['is_error'])) {
969 $code = $error['error_message']['code'];
970 if ($code == $type) {
979 $e = new PEAR_ErrorStack('CRM');
980 $e->singleton('CRM', FALSE, NULL, 'CRM_Core_Error');