You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
67 lines
2.1 KiB
67 lines
2.1 KiB
<?php declare(strict_types=1);
|
|
/*
|
|
* This file is part of PHPUnit.
|
|
*
|
|
* (c) Sebastian Bergmann <sebastian@phpunit.de>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
namespace PHPUnit\Framework;
|
|
|
|
use function array_keys;
|
|
use function get_object_vars;
|
|
use RuntimeException;
|
|
use Throwable;
|
|
|
|
/**
|
|
* Base class for all PHPUnit Framework exceptions.
|
|
*
|
|
* Ensures that exceptions thrown during a test run do not leave stray
|
|
* references behind.
|
|
*
|
|
* Every Exception contains a stack trace. Each stack frame contains the 'args'
|
|
* of the called function. The function arguments can contain references to
|
|
* instantiated objects. The references prevent the objects from being
|
|
* destructed (until test results are eventually printed), so memory cannot be
|
|
* freed up.
|
|
*
|
|
* With enabled process isolation, test results are serialized in the child
|
|
* process and unserialized in the parent process. The stack trace of Exceptions
|
|
* may contain objects that cannot be serialized or unserialized (e.g., PDO
|
|
* connections). Unserializing user-space objects from the child process into
|
|
* the parent would break the intended encapsulation of process isolation.
|
|
*
|
|
* @see http://fabien.potencier.org/article/9/php-serialization-stack-traces-and-exceptions
|
|
*
|
|
* @internal This class is not covered by the backward compatibility promise for PHPUnit
|
|
*/
|
|
class Exception extends RuntimeException implements \PHPUnit\Exception
|
|
{
|
|
protected array $serializableTrace;
|
|
|
|
public function __construct(string $message = '', int $code = 0, Throwable $previous = null)
|
|
{
|
|
parent::__construct($message, $code, $previous);
|
|
|
|
$this->serializableTrace = $this->getTrace();
|
|
|
|
foreach (array_keys($this->serializableTrace) as $key) {
|
|
unset($this->serializableTrace[$key]['args']);
|
|
}
|
|
}
|
|
|
|
public function __sleep(): array
|
|
{
|
|
return array_keys(get_object_vars($this));
|
|
}
|
|
|
|
/**
|
|
* Returns the serializable trace (without 'args').
|
|
*/
|
|
public function getSerializableTrace(): array
|
|
{
|
|
return $this->serializableTrace;
|
|
}
|
|
}
|