class ValidGlobalSniff in Coder 8.3

Ensures that global variables start with an underscore.

@category PHP @package PHP_CodeSniffer @link http://pear.php.net/package/PHP_CodeSniffer

Hierarchy

• class \Drupal\Sniffs\NamingConventions\ValidGlobalSniff implements \PHP_CodeSniffer\Sniffs\Sniff

File

coder_sniffer/Drupal/Sniffs/NamingConventions/ValidGlobalSniff.php, line 23

Namespace

Drupal\Sniffs\NamingConventions

class ValidGlobalSniff implements Sniff {

  /**
   * List of allowed Drupal core global variable names.
   *
   * @var array<string>
   */
  public $coreGlobals = [
    '$argc',
    '$argv',
    '$base_insecure_url',
    '$base_path',
    '$base_root',
    '$base_secure_url',
    '$base_theme_info',
    '$base_url',
    '$channel',
    '$conf',
    '$config',
    '$config_directories',
    '$cookie_domain',
    '$databases',
    '$db_prefix',
    '$db_type',
    '$db_url',
    '$drupal_hash_salt',
    '$drupal_test_info',
    '$element',
    '$forum_topic_list_header',
    '$image',
    '$install_state',
    '$installed_profile',
    '$is_https',
    '$is_https_mock',
    '$item',
    '$items',
    '$language',
    '$language_content',
    '$language_url',
    '$locks',
    '$menu_admin',
    '$multibyte',
    '$pager_limits',
    '$pager_page_array',
    '$pager_total',
    '$pager_total_items',
    '$tag',
    '$theme',
    '$theme_engine',
    '$theme_info',
    '$theme_key',
    '$theme_path',
    '$timers',
    '$update_free_access',
    '$update_rewrite_settings',
    '$user',
  ];

  /**
   * Returns an array of tokens this test wants to listen for.
   *
   * @return array<int|string>
   */
  public function register() {
    return [
      T_GLOBAL,
    ];
  }

  //end register()

  /**
   * Processes this test, when one of its tokens is encountered.
   *
   * @param \PHP_CodeSniffer\Files\File $phpcsFile The current file being processed.
   * @param int                         $stackPtr  The position of the current token
   *                                               in the stack passed in $tokens.
   *
   * @return void
   */
  public function process(File $phpcsFile, $stackPtr) {
    $tokens = $phpcsFile
      ->getTokens();
    $varToken = $stackPtr;

    // Find variable names until we hit a semicolon.
    $ignore = Tokens::$emptyTokens;
    $ignore[] = T_SEMICOLON;
    while (($varToken = $phpcsFile
      ->findNext($ignore, $varToken + 1, null, true, null, true)) !== false) {
      if ($tokens[$varToken]['code'] === T_VARIABLE && in_array($tokens[$varToken]['content'], $this->coreGlobals) === false && $tokens[$varToken]['content'][1] !== '_') {
        $error = 'global variables should start with a single underscore followed by the module and another underscore';
        $phpcsFile
          ->addError($error, $varToken, 'GlobalUnderScore');
      }
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
ValidGlobalSniff::$coreGlobals	public	property	List of allowed Drupal core global variable names.
ValidGlobalSniff::process	public	function	Processes this test, when one of its tokens is encountered.
ValidGlobalSniff::register	public	function	Returns an array of tokens this test wants to listen for.