class FrontMatterParseException

Same name in other branches
  1. 9 core/lib/Drupal/Component/FrontMatter/Exception/FrontMatterParseException.php \Drupal\Component\FrontMatter\Exception\FrontMatterParseException
  2. 10 core/lib/Drupal/Component/FrontMatter/Exception/FrontMatterParseException.php \Drupal\Component\FrontMatter\Exception\FrontMatterParseException

Defines a class for front matter parsing exceptions.

Hierarchy

  • class \Drupal\Component\Serialization\Exception\InvalidDataTypeException extends \Drupal\Component\Serialization\Exception\InvalidArgumentException
    • class \Drupal\Component\FrontMatter\Exception\FrontMatterParseException extends \Drupal\Component\Serialization\Exception\InvalidDataTypeException

Expanded class hierarchy of FrontMatterParseException

3 files declare their use of FrontMatterParseException
FrontMatter.php in core/lib/Drupal/Component/FrontMatter/FrontMatter.php
FrontMatterTest.php in core/tests/Drupal/Tests/Component/FrontMatter/FrontMatterTest.php
TwigEnvironment.php in core/lib/Drupal/Core/Template/TwigEnvironment.php

File

core/lib/Drupal/Component/FrontMatter/Exception/FrontMatterParseException.php, line 10

Namespace

Drupal\Component\FrontMatter\Exception
View source
class FrontMatterParseException extends InvalidDataTypeException {
    
    /**
     * The line number of where the parse error occurred.
     *
     * This line number is in relation to where the parse error occurred in the
     * source front matter content. It is different from \Exception::getLine()
     * which is populated with the line number of where this exception was
     * thrown in PHP.
     *
     * @var int
     */
    protected $sourceLine;
    
    /**
     * Constructs a new FrontMatterParseException instance.
     *
     * @param \Drupal\Component\Serialization\Exception\InvalidDataTypeException $exception
     *   The exception thrown when attempting to parse front matter data.
     */
    public function __construct(InvalidDataTypeException $exception) {
        $this->sourceLine = 1;
        // Attempt to extract the line number from the serializer error. This isn't
        // a very stable way to do this, however it is the only way given that
        // \Drupal\Component\Serialization\SerializationInterface does not have
        // methods for accessing this kind of information reliably.
        $message = 'An error occurred when attempting to parse front matter data';
        if ($exception) {
            preg_match('/line:?\\s?(\\d+)/i', $exception->getMessage(), $matches);
            if (!empty($matches[1])) {
                $message .= ' on line %d';
                // Add any matching line count to the existing source line so it
                // increases it by 1 to account for the front matter separator (---).
                $this->sourceLine += (int) $matches[1];
            }
        }
        parent::__construct(sprintf($message, $this->sourceLine), 0, $exception);
    }
    
    /**
     * Retrieves the line number where the parse error occurred.
     *
     * This line number is in relation to where the parse error occurred in the
     * source front matter content. It is different from \Exception::getLine()
     * which is populated with the line number of where this exception was
     * thrown in PHP.
     *
     * @return int
     *   The source line number.
     */
    public function getSourceLine() : int {
        return $this->sourceLine;
    }

}

Members

Title Sort descending Modifiers Object type Summary
FrontMatterParseException::$sourceLine protected property The line number of where the parse error occurred.
FrontMatterParseException::getSourceLine public function Retrieves the line number where the parse error occurred.
FrontMatterParseException::__construct public function Constructs a new FrontMatterParseException instance.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.