← All changes | back/Libraries/Pear/Error.php +301 -0 10.2.0 → 11.1.0 View file →

		@@ -1,0 +1,301 @@
	1	+<?php
	2	+
	3	+namespace AcyMailing\Libraries\Pear;
	4	+
	5	+/**
	6	+ * Standard PEAR error class for PHP 4
	7	+ *
	8	+ * This class is supserseded by {@link PEAR_Exception} in PHP 5
	9	+ *
	10	+ * @category pear
	11	+ * @package PEAR
	12	+ * @author Stig Bakken <[email protected]>
	13	+ * @author Tomas V.V. Cox <[email protected]>
	14	+ * @author Gregory Beaver <[email protected]>
	15	+ * @copyright 1997-2006 The PHP Group
	16	+ * @license http://opensource.org/licenses/bsd-license.php New BSD License
	17	+ * @version Release: 1.10.16
	18	+ * @link http://pear.php.net/manual/en/core.pear.pear-error.php
	19	+ * @see Pear::raiseError(), Pear::throwError()
	20	+ * @since Class available since PHP 4.0.2
	21	+ */
	22	+class Error
	23	+{
	24	+ var $error_message_prefix = '';
	25	+ var $mode = PEAR_ERROR_RETURN;
	26	+ var $level = E_USER_NOTICE;
	27	+ var $code = -1;
	28	+ var $message = '';
	29	+ var $userinfo = '';
	30	+ var $backtrace = null;
	31	+ var $callback = null;
	32	+
	33	+ /**
	34	+ * Error constructor
	35	+ *
	36	+ * @param string $message message
	37	+ *
	38	+ * @param int $code (optional) error code
	39	+ *
	40	+ * @param int $mode (optional) error mode, one of: PEAR_ERROR_RETURN,
	41	+ * PEAR_ERROR_PRINT, PEAR_ERROR_DIE, PEAR_ERROR_TRIGGER,
	42	+ * PEAR_ERROR_CALLBACK or PEAR_ERROR_EXCEPTION
	43	+ *
	44	+ * @param mixed $options (optional) error level, _OR_ in the case of
	45	+ * PEAR_ERROR_CALLBACK, the callback function or object/method
	46	+ * tuple.
	47	+ *
	48	+ * @param string $userinfo (optional) additional user/debug info
	49	+ *
	50	+ * @access public
	51	+ *
	52	+ */
	53	+ function __construct(
	54	+ $message = 'unknown error',
	55	+ $code = null,
	56	+ $mode = null,
	57	+ $options = null,
	58	+ $userinfo = null
	59	+ ) {
	60	+ if ($mode === null) {
	61	+ $mode = PEAR_ERROR_RETURN;
	62	+ }
	63	+ $this->message = $message;
	64	+ $this->code = $code;
	65	+ $this->mode = $mode;
	66	+ $this->userinfo = $userinfo;
	67	+
	68	+ $skiptrace = Pear::getStaticProperty('AcyMailing\Libraries\Pear\Error', 'skiptrace');
	69	+
	70	+ if (!$skiptrace) {
	71	+ $this->backtrace = debug_backtrace();
	72	+ if (isset($this->backtrace[0]) && isset($this->backtrace[0]['object'])) {
	73	+ unset($this->backtrace[0]['object']);
	74	+ }
	75	+ }
	76	+
	77	+ if ($mode & PEAR_ERROR_CALLBACK) {
	78	+ $this->level = E_USER_NOTICE;
	79	+ $this->callback = $options;
	80	+ } else {
	81	+ if ($options === null) {
	82	+ $options = E_USER_NOTICE;
	83	+ }
	84	+
	85	+ $this->level = $options;
	86	+ $this->callback = null;
	87	+ }
	88	+
	89	+ if ($this->mode & PEAR_ERROR_PRINT) {
	90	+ if (is_null($options) || is_int($options)) {
	91	+ $format = "%s";
	92	+ } else {
	93	+ $format = $options;
	94	+ }
	95	+
	96	+ printf($format, $this->getMessage());
	97	+ }
	98	+
	99	+ if ($this->mode & PEAR_ERROR_TRIGGER) {
	100	+ trigger_error($this->getMessage(), $this->level);
	101	+ }
	102	+
	103	+ if ($this->mode & PEAR_ERROR_DIE) {
	104	+ $msg = $this->getMessage();
	105	+ if (is_null($options) || is_int($options)) {
	106	+ $format = "%s";
	107	+ if (substr($msg, -1) != "\n") {
	108	+ $msg .= "\n";
	109	+ }
	110	+ } else {
	111	+ $format = $options;
	112	+ }
	113	+ printf($format, $msg);
	114	+ exit($code);
	115	+ }
	116	+
	117	+ if ($this->mode & PEAR_ERROR_CALLBACK && is_callable($this->callback)) {
	118	+ call_user_func($this->callback, $this);
	119	+ }
	120	+
	121	+ if ($this->mode & PEAR_ERROR_EXCEPTION) {
	122	+ trigger_error("PEAR_ERROR_EXCEPTION is obsolete, use class PEAR_Exception for exceptions", E_USER_WARNING);
	123	+ throw new \Exception($this->message, $this->code);
	124	+ }
	125	+ }
	126	+
	127	+ /**
	128	+ * Get the error mode from an error object.
	129	+ *
	130	+ * @return int error mode
	131	+ * @access public
	132	+ */
	133	+ function getMode()
	134	+ {
	135	+ return $this->mode;
	136	+ }
	137	+
	138	+ /**
	139	+ * Get the callback function/method from an error object.
	140	+ *
	141	+ * @return mixed callback function or object/method array
	142	+ * @access public
	143	+ */
	144	+ function getCallback()
	145	+ {
	146	+ return $this->callback;
	147	+ }
	148	+
	149	+ /**
	150	+ * Get the error message from an error object.
	151	+ *
	152	+ * @return string full error message
	153	+ * @access public
	154	+ */
	155	+ function getMessage()
	156	+ {
	157	+ return ($this->error_message_prefix.$this->message);
	158	+ }
	159	+
	160	+ /**
	161	+ * Get error code from an error object
	162	+ *
	163	+ * @return int error code
	164	+ * @access public
	165	+ */
	166	+ function getCode()
	167	+ {
	168	+ return $this->code;
	169	+ }
	170	+
	171	+ /**
	172	+ * Get the name of this error/exception.
	173	+ *
	174	+ * @return string error/exception name (type)
	175	+ * @access public
	176	+ */
	177	+ function getType()
	178	+ {
	179	+ return get_class($this);
	180	+ }
	181	+
	182	+ /**
	183	+ * Get additional user-supplied information.
	184	+ *
	185	+ * @return string user-supplied information
	186	+ * @access public
	187	+ */
	188	+ function getUserInfo()
	189	+ {
	190	+ return $this->userinfo;
	191	+ }
	192	+
	193	+ /**
	194	+ * Get additional debug information supplied by the application.
	195	+ *
	196	+ * @return string debug information
	197	+ * @access public
	198	+ */
	199	+ function getDebugInfo()
	200	+ {
	201	+ return $this->getUserInfo();
	202	+ }
	203	+
	204	+ /**
	205	+ * Get the call backtrace from where the error was generated.
	206	+ * Supported with PHP 4.3.0 or newer.
	207	+ *
	208	+ * @param int $frame (optional) what frame to fetch
	209	+ *
	210	+ * @return array Backtrace, or NULL if not available.
	211	+ * @access public
	212	+ */
	213	+ function getBacktrace($frame = null)
	214	+ {
	215	+ if (defined('PEAR_IGNORE_BACKTRACE')) {
	216	+ return null;
	217	+ }
	218	+ if ($frame === null) {
	219	+ return $this->backtrace;
	220	+ }
	221	+
	222	+ return $this->backtrace[$frame];
	223	+ }
	224	+
	225	+ function addUserInfo($info)
	226	+ {
	227	+ if (empty($this->userinfo)) {
	228	+ $this->userinfo = $info;
	229	+ } else {
	230	+ $this->userinfo .= " ** $info";
	231	+ }
	232	+ }
	233	+
	234	+ function __toString()
	235	+ {
	236	+ return $this->getMessage();
	237	+ }
	238	+
	239	+ /**
	240	+ * Make a string representation of this object.
	241	+ *
	242	+ * @return string a string with an object summary
	243	+ * @access public
	244	+ */
	245	+ function toString()
	246	+ {
	247	+ $modes = [];
	248	+ $levels = [
	249	+ E_USER_NOTICE => 'notice',
	250	+ E_USER_WARNING => 'warning',
	251	+ E_USER_ERROR => 'error',
	252	+ ];
	253	+ if ($this->mode & PEAR_ERROR_CALLBACK) {
	254	+ if (is_array($this->callback)) {
	255	+ $callback = (is_object($this->callback[0])
	256	+ ?
	257	+ strtolower(get_class($this->callback[0]))
	258	+ :
	259	+ $this->callback[0]).'::'.
	260	+ $this->callback[1];
	261	+ } else {
	262	+ $callback = $this->callback;
	263	+ }
	264	+
	265	+ return sprintf(
	266	+ '[%s: message="%s" code=%d mode=callback '.
	267	+ 'callback=%s prefix="%s" info="%s"]',
	268	+ strtolower(get_class($this)),
	269	+ $this->message,
	270	+ $this->code,
	271	+ $callback,
	272	+ $this->error_message_prefix,
	273	+ $this->userinfo
	274	+ );
	275	+ }
	276	+ if ($this->mode & PEAR_ERROR_PRINT) {
	277	+ $modes[] = 'print';
	278	+ }
	279	+ if ($this->mode & PEAR_ERROR_TRIGGER) {
	280	+ $modes[] = 'trigger';
	281	+ }
	282	+ if ($this->mode & PEAR_ERROR_DIE) {
	283	+ $modes[] = 'die';
	284	+ }
	285	+ if ($this->mode & PEAR_ERROR_RETURN) {
	286	+ $modes[] = 'return';
	287	+ }
	288	+
	289	+ return sprintf(
	290	+ '[%s: message="%s" code=%d mode=%s level=%s '.
	291	+ 'prefix="%s" info="%s"]',
	292	+ strtolower(get_class($this)),
	293	+ $this->message,
	294	+ $this->code,
	295	+ implode("|", $modes),
	296	+ $levels[$this->level],
	297	+ $this->error_message_prefix,
	298	+ $this->userinfo
	299	+ );
	300	+ }
	301	+}