class Handle in Zircon Profile 8.0

Handler for runtime assertion failures.

This class allows PHP 5.x to throw exceptions on runtime assertion fails in the same manner as PHP 7, and sets the ASSERT_EXCEPTION flag to TRUE for the PHP 7 runtime.

Hierarchy

• class \Drupal\Component\Assertion\Handle

Related topics

PHP Runtime Assert Statements

Use of the assert() statement in Drupal.

File

core/lib/Drupal/Component/Assertion/Handle.php, line 49

Contains \Drupal\Component\Assertion\Handle.

Namespace

Drupal\Component\Assertion

class Handle {

  /**
   * Registers uniform assertion handling.
   */
  public static function register() {

    // Since we're using exceptions, turn error warnings off.
    assert_options(ASSERT_WARNING, FALSE);
    if (version_compare(PHP_VERSION, '7.0.0-dev') < 0) {

      // PHP 5 - create a handler to throw the exception directly.
      assert_options(ASSERT_CALLBACK, function ($file = '', $line = 0, $code = '', $message = '') {
        if (empty($message)) {
          $message = $code;
        }
        throw new \AssertionError($message, 0, NULL, $file, $line);
      });
    }
    else {

      // PHP 7 - just turn exception throwing on.
      assert_options(ASSERT_EXCEPTION, TRUE);
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Handle::register	public static	function	Registers uniform assertion handling.