/**
* log to console directly with this method passing only the first required parameter and to change
* the log type the third parameter according to allowed log types. pass a lable for second parameter
* to describe the message send to console.
*
* @error 10908
* @param null|mixed $mixed expects the message of any type to send to console
* @param null|string $label expects the optional label to describe the first parameter
* @param string $type expects the log type - see log type array
* @param array $options expects optional parameters
* @return void
* @throws Xapp_Error
*/
public function log($mixed = null, $label = null, $type = 'info', array $options = array())
{
$type = strtolower((string) $type);
if (array_key_exists($type, self::$_typeMap)) {
if ($type === 'ini') {
$this->ini($mixed, $label, $options);
}
if ($label !== null) {
$label = trim(trim($label), ':') . ':';
}
switch ($this->_driver) {
case 'chromephp':
switch ($type) {
case $type === 'ungroup' || $mixed === null:
$this->console->groupEnd();
break;
case 'group':
$this->console->group($mixed);
break;
case 'trace':
$this->console->log((string) $label, $mixed, 'info');
break;
default:
$this->console->log((string) $label, $mixed, self::$_typeMap[$type]);
}
break;
case 'firephp':
switch ($type) {
case $type === 'ungroup' || $mixed === null:
$this->console->groupEnd();
break;
case 'group':
$this->console->group($mixed, $options);
break;
case 'trace':
$this->console->trace($label);
break;
default:
$this->console->{$type}($mixed, (string) $label, $options);
}
break;
}
} else {
throw new Xapp_Error(xapp_sprintf(_("xapp console log type: %s not supported"), $type), 1090801);
}
}
/**
* Flag a function as deprecated by placing this method inside it.
*
* @param string $alternative an alternative function that should be used instead.
* @param boolean $continue true to die
*
* @return void
*/
public static function deprecate($alternative = '', $continue = true)
{
if (!self::$_enabled) {
return;
}
if (self::$ensureByGet && !isset($_GET['debug'])) {
return;
}
$debug = new THEDEBUG\ADEBUG();
/* Get the deprecated method/function name */
$scope = $debug->getScope();
/* You can not deprecate the global namespace */
if ($scope->type === 'global') {
return;
}
/* Write a nice message */
$message = sprintf('Deprecated usage of %s "%s".', $scope->type, $scope->name);
/* Add alternative hint if given */
if (!empty($alternative)) {
$message .= sprintf(' Please consider using "%s" instead.', $alternative);
}
/* Manipulate the offset so the debug will point to the deprecated method call */
$debug->backTraceOffset++;
$debug->setLineAndFile();
/* Set the message, type and put */
$debug->variable = $message;
$debug->type = 'warning';
$debug->variableType = 'string';
$debug->put();
if ($debug->modus === 'FirePHP') {
self::$_FirePHP->trace('');
}
/* Die if continue is false */
if (!$continue) {
die;
}
}
public function trace($Label)
{
parent::trace($Label);
return $this;
}
