TokenParser.php in Service Container 7

Namespace

Doctrine\Common\Annotations

File

modules/providers/service_container_annotation_discovery/lib/Doctrine/annotations/lib/Doctrine/Common/Annotations/TokenParser.php

<?php

/*
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * This software consists of voluntary contributions made by many individuals
 * and is licensed under the MIT license. For more information, see
 * <http://www.doctrine-project.org>.
 */
namespace Doctrine\Common\Annotations;


/**
 * Parses a file for namespaces/use/class declarations.
 *
 * @author Fabien Potencier <[e-mail]>
 * @author Christian Kaps <[e-mail]>
 */
class TokenParser {

  /**
   * The token list.
   *
   * @var array
   */
  private $tokens;

  /**
   * The number of tokens.
   *
   * @var int
   */
  private $numTokens;

  /**
   * The current array pointer.
   *
   * @var int
   */
  private $pointer = 0;

  /**
   * @param string $contents
   */
  public function __construct($contents) {
    $this->tokens = token_get_all($contents);

    // The PHP parser sets internal compiler globals for certain things. Annoyingly, the last docblock comment it
    // saw gets stored in doc_comment. When it comes to compile the next thing to be include()d this stored
    // doc_comment becomes owned by the first thing the compiler sees in the file that it considers might have a
    // docblock. If the first thing in the file is a class without a doc block this would cause calls to
    // getDocBlock() on said class to return our long lost doc_comment. Argh.
    // To workaround, cause the parser to parse an empty docblock. Sure getDocBlock() will return this, but at least
    // it's harmless to us.
    token_get_all("<?php\n/**\n *\n */");
    $this->numTokens = count($this->tokens);
  }

  /**
   * Gets the next non whitespace and non comment token.
   *
   * @param boolean $docCommentIsComment If TRUE then a doc comment is considered a comment and skipped.
   *                                     If FALSE then only whitespace and normal comments are skipped.
   *
   * @return array|null The token if exists, null otherwise.
   */
  public function next($docCommentIsComment = TRUE) {
    for ($i = $this->pointer; $i < $this->numTokens; $i++) {
      $this->pointer++;
      if ($this->tokens[$i][0] === T_WHITESPACE || $this->tokens[$i][0] === T_COMMENT || $docCommentIsComment && $this->tokens[$i][0] === T_DOC_COMMENT) {
        continue;
      }
      return $this->tokens[$i];
    }
    return null;
  }

  /**
   * Parses a single use statement.
   *
   * @return array A list with all found class names for a use statement.
   */
  public function parseUseStatement() {
    $class = '';
    $alias = '';
    $statements = array();
    $explicitAlias = false;
    while ($token = $this
      ->next()) {
      $isNameToken = $token[0] === T_STRING || $token[0] === T_NS_SEPARATOR;
      if (!$explicitAlias && $isNameToken) {
        $class .= $token[1];
        $alias = $token[1];
      }
      else {
        if ($explicitAlias && $isNameToken) {
          $alias .= $token[1];
        }
        else {
          if ($token[0] === T_AS) {
            $explicitAlias = true;
            $alias = '';
          }
          else {
            if ($token === ',') {
              $statements[strtolower($alias)] = $class;
              $class = '';
              $alias = '';
              $explicitAlias = false;
            }
            else {
              if ($token === ';') {
                $statements[strtolower($alias)] = $class;
                break;
              }
              else {
                break;
              }
            }
          }
        }
      }
    }
    return $statements;
  }

  /**
   * Gets all use statements.
   *
   * @param string $namespaceName The namespace name of the reflected class.
   *
   * @return array A list with all found use statements.
   */
  public function parseUseStatements($namespaceName) {
    $statements = array();
    while ($token = $this
      ->next()) {
      if ($token[0] === T_USE) {
        $statements = array_merge($statements, $this
          ->parseUseStatement());
        continue;
      }
      if ($token[0] !== T_NAMESPACE || $this
        ->parseNamespace() != $namespaceName) {
        continue;
      }

      // Get fresh array for new namespace. This is to prevent the parser to collect the use statements
      // for a previous namespace with the same name. This is the case if a namespace is defined twice
      // or if a namespace with the same name is commented out.
      $statements = array();
    }
    return $statements;
  }

  /**
   * Gets the namespace.
   *
   * @return string The found namespace.
   */
  public function parseNamespace() {
    $name = '';
    while (($token = $this
      ->next()) && ($token[0] === T_STRING || $token[0] === T_NS_SEPARATOR)) {
      $name .= $token[1];
    }
    return $name;
  }

  /**
   * Gets the class name.
   *
   * @return string The found class name.
   */
  public function parseClass() {

    // Namespaces and class names are tokenized the same: T_STRINGs
    // separated by T_NS_SEPARATOR so we can use one function to provide
    // both.
    return $this
      ->parseNamespace();
  }

}

Classes

Name	Description
TokenParser	Parses a file for namespaces/use/class declarations.