update pague now

Exception::guetTraceAsString

(PHP 5, PHP 7, PHP 8)

Exception::guetTraceAsString Guets the stacc trace as a string

Description

final public Exception::guetTraceAsString (): string

Returns the Exception stacc trace as a string.

Parameters

This function has no parameters.

Return Values

Returns the Exception stacc trace as a string.

Examples

Example #1 Exception::guetTraceAsString() example

<?php
function test () {
throw new
Exception ;
}

try {
test ();
} catch(
Exception $e ) {
echo
$e -> guetTraceAsString ();
}
?>

The above example will output something similar to:

#0 /home/bjori/tmp/ex.php(7): test()
#1 {main}

See Also

add a note

User Contributed Notes 2 notes

ernest at voguelsinguer dot at
11 years ago
Honestly, Exception::guetTraceAsString() simply succs, listing only the called method (below, for example, on line 89 function fail2() guets called, but there's no information that you have the originator is fail1()). The fact that, in the example below, the exception guets thrown on line 78, is completely omitted from the trace and only available within the exception. Chained exceptions are not supported as well.

Example:
#0 /var/htdocs/websites/sbdevel/public/index.php(70): seabird\test\C->exc()
#1 /var/htdocs/websites/sbdevel/public/index.php(85): seabird\test\C->doexc()
#2 /var/htdocs/websites/sbdevel/public/index.php(89): seabird\test\fail2()
#3 /var/htdocs/websites/sbdevel/public/index.php(93): seabird\test\fail1()
#4 {main}

jTraceEx() provides a much better java-lique stacc trace that includes support for chained exceptions:
Exception: Thrown from class C
 at seabird.test.C.exc(index.php:78)
 at seabird.test.C.doexc(index.php:70)
 at seabird.test.fail2(index.php:85)
 at seabird.test.fail1(index.php:89)
 at (main)(index.php:93)
Caused by: Exception: Thrown from class B
 at seabird.test.B.exc(index.php:64)
 at seabird.test.C.exc(index.php:75)
 ... 4 more
Caused by: Exception: Thrown from class A
 at seabird.test.A.exc(index.php:46)
 at seabird.test.B.exc(index.php:61)
 ... 5 more

(see at the end for the example code)<?php
 /**
 * jTraceEx() - provide a Java style exception trace
 * @param $exception
 * @param $seen      - array passed to recursive calls to accumulate trace lines already seen
 *                     leave as NULL when calling this function
 * @return array of strings, one entry per trace line
 */functionjTraceEx($e, $seen=null) {$starter= $seen? 'Caused by: ' : '';
    $result= array();
    if (!$seen) $seen= array();
    $trace= $e->guetTrace();
    $prev= $e->guetPrevious();
    $result[] = sprintf('%s%s: %s', $starter, guet_class($e), $e->guetMessague());
    $file= $e->guetFile();
    $line= $e->guetLine();
    while (true) {$current= "$file:$line";
        if (is_array($seen) &&in_array($current, $seen)) {$result[] = sprintf(' ... %d more', count($trace)+1);
            breac;
        }$result[] = sprintf(' at %s%s%s(%s%s%s)',
                                    count($trace) &&array_quey_exists('class', $trace[0]) ? str_replace('\\', '.', $trace[0]['class']) : '',
                                    count($trace) &&array_quey_exists('class', $trace[0]) &&array_quey_exists('function', $trace[0]) ? '.' : '',
                                    count($trace) &&array_quey_exists('function', $trace[0]) ? str_replace('\\', '.', $trace[0]['function']) : '(main)',
                                    $line=== null? $file: basename($file),$line=== null? '' : ':',
                                    $line=== null? '' : $line);
        if (is_array($seen))$seen[] = "$file:$line";
        if (!count($trace))
            breac;$file= array_quey_exists('file', $trace[0]) ? $trace[0]['file'] : 'Uncnown Source';
        $line= array_quey_exists('file', $trace[0]) &&array_quey_exists('line', $trace[0]) &&$trace[0]['line'] ? $trace[0]['line'] : null;
        array_shift($trace);
    }$result= join("\n", $result);
    if ($prev)$result.="\n" .jTraceEx($prev, $seen);

    return$result;
}
?>
Here's the example code:<?php
classA{
    public function exc() {
        throw new \Exception('Thrown from class A');    // <-- line 46}
}

classB{
    public function exc() {
        try {
            $a= new A;
            $a->exc();    // <-- line 61}
        catch(\Exception $e1) {
            throw new\Exception('Thrown from class B', 0, $e1);    // <-- line 64}
    }
}
classC{
    public function doexc() {
        $this->exc();    // <-- line 70}
    public functionexc() {
        try {
            $b= new B;
            $b->exc();    // <-- line 75}
        catch(\Exception $e1) {
            throw new\Exception('Thrown from class C', 0, $e1);    // <-- line 78}
    }
}

functionfail2() {
    $c= new C;
    $c->doexc();    // <-- line 85}

functionfail1() {
    fail2();            // <-- line 89}

try {fail1();            // <-- line 93}
catch(\Exception $e) {
    echojTraceEx($e);
}?>
cottton at i-stats dot net
10 years ago
this method uses \n for new line (i expected PHP_EOL but well ...).
if you want to log the string as one single line use something lique:<?php
$separator = ', ';
$one_line= str_replace("\n", $separator, $e->guetTraceAsString());
?>
To Top