Viewing file:  CSS.php (17.96 KB) -rw-rw-rw-
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
<?php
/**
* Tokenizes CSS code.
*
* PHP version 5
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood <gsherwood@squiz.net>
* @copyright 2006-2011 Squiz Pty Ltd (ABN 77 084 670 600)
* @license http://matrix.squiz.net/developer/tools/php_cs/licence BSD Licence
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
if (class_exists('PHP_CodeSniffer_Tokenizers_PHP', true) === false) {
throw new Exception('Class PHP_CodeSniffer_Tokenizers_PHP not found');
}
/**
* Tokenizes CSS code.
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood <gsherwood@squiz.net>
* @copyright 2006-2011 Squiz Pty Ltd (ABN 77 084 670 600)
* @license http://matrix.squiz.net/developer/tools/php_cs/licence BSD Licence
* @version Release: 1.3.3
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
class PHP_CodeSniffer_Tokenizers_CSS extends PHP_CodeSniffer_Tokenizers_PHP
{
/**
* Creates an array of tokens when given some CSS code.
*
* Uses the PHP tokenizer to do all the tricky work
*
* @param string $string The string to tokenize.
* @param string $eolChar The EOL character to use for splitting strings.
*
* @return array
*/
public function tokenizeString($string, $eolChar='\n')
{
$tokens = parent::tokenizeString('<?php '.$string.' ?>', $eolChar);
$finalTokens = array();
$newStackPtr = 0;
$numTokens = count($tokens);
$multiLineComment = false;
for ($stackPtr = 0; $stackPtr < $numTokens; $stackPtr++) {
$token = $tokens[$stackPtr];
if ($token['code'] === T_FUNCTION) {
// There are no functions in CSS, so convert this to a string.
$finalTokens[$newStackPtr] = array(
'type' => 'T_STRING',
'code' => T_STRING,
'content' => $token['content'],
);
$newStackPtr++;
continue;
}
if ($token['code'] === T_COMMENT
&& substr($token['content'], 0, 2) === '/*'
) {
// Multi-line comment. Record it so we can ignore other
// comment tags until we get out of this one.
$multiLineComment = true;
}
if ($token['code'] === T_COMMENT
&& $multiLineComment === false
&& (substr($token['content'], 0, 2) === '//'
|| $token['content']{0} === '#')
) {
$content = ltrim($token['content'], '#/');
$commentTokens
= parent::tokenizeString('<?php '.$content.'?>', $eolChar);
// The first and last tokens are the open/close tags.
array_shift($commentTokens);
array_pop($commentTokens);
if ($token['content']{0} === '#') {
// The # character is not a comment in CSS files, so
// determine what it means in this context.
$firstContent = $commentTokens[0]['content'];
// If the first content is just a number, it is probably a
// colour like 8FB7DB, which PHP splits into 8 and FB7DB.
if (($commentTokens[0]['code'] === T_LNUMBER
|| $commentTokens[0]['code'] === T_DNUMBER)
&& $commentTokens[1]['code'] === T_STRING
) {
$firstContent .= $commentTokens[1]['content'];
array_shift($commentTokens);
}
// If the first content looks like a colour and not a class
// definition, join the tokens together.
if (preg_match('/^[ABCDEF0-9]+$/i', $firstContent) === 1) {
array_shift($commentTokens);
// Work out what we trimmed off above and remember to re-add it.
$trimmed = substr($token['content'], 0, (strlen($token['content']) - strlen($content)));
$finalTokens[$newStackPtr] = array(
'type' => 'T_COLOUR',
'code' => T_COLOUR,
'content' => $trimmed.$firstContent,
);
} else {
$finalTokens[$newStackPtr] = array(
'type' => 'T_HASH',
'code' => T_HASH,
'content' => '#',
);
}
} else {
$finalTokens[$newStackPtr] = array(
'type' => 'T_STRING',
'code' => T_STRING,
'content' => '//',
);
}//end if
$newStackPtr++;
foreach ($commentTokens as $tokenData) {
if ($tokenData['code'] === T_COMMENT
&& (substr($tokenData['content'], 0, 2) === '//'
|| $tokenData['content']{0} === '#')
) {
// This is a comment in a comment, so it needs
// to go through the whole process again.
$tokens[$stackPtr]['content'] = $tokenData['content'];
$stackPtr--;
break;
}
$finalTokens[$newStackPtr] = $tokenData;
$newStackPtr++;
}
continue;
}//end if
if ($token['code'] === T_COMMENT
&& substr($token['content'], -2) === '*/'
) {
// Multi-line comment is done.
$multiLineComment = false;
}
$finalTokens[$newStackPtr] = $token;
$newStackPtr++;
}//end for
// A flag to indicate if we are inside a style definition,
// which is defined using curly braces. I'm assuming you can't
// have nested curly brackets.
$inStyleDef = false;
$numTokens = count($finalTokens);
for ($stackPtr = 0; $stackPtr < $numTokens; $stackPtr++) {
$token = $finalTokens[$stackPtr];
switch ($token['code']) {
case T_OPEN_CURLY_BRACKET:
$inStyleDef = true;
break;
case T_CLOSE_CURLY_BRACKET:
$inStyleDef = false;
break;
case T_MINUS:
// Minus signs are often used instead of spaces inside
// class names, IDs and styles.
if ($finalTokens[($stackPtr + 1)]['code'] === T_STRING) {
if ($finalTokens[($stackPtr - 1)]['code'] === T_STRING) {
$newContent = $finalTokens[($stackPtr - 1)]['content'].'-'.$finalTokens[($stackPtr + 1)]['content'];
$finalTokens[($stackPtr - 1)]['content'] = $newContent;
unset($finalTokens[$stackPtr]);
unset($finalTokens[($stackPtr + 1)]);
$stackPtr -= 2;
} else {
$newContent = '-'.$finalTokens[($stackPtr + 1)]['content'];
$finalTokens[($stackPtr + 1)]['content'] = $newContent;
unset($finalTokens[$stackPtr]);
$stackPtr--;
}
$finalTokens = array_values($finalTokens);
$numTokens = count($finalTokens);
} else if ($finalTokens[($stackPtr + 1)]['code'] === T_LNUMBER) {
// They can also be used to provide negative numbers.
$finalTokens[($stackPtr + 1)]['content']
= '-'.$finalTokens[($stackPtr + 1)]['content'];
unset($finalTokens[$stackPtr]);
$finalTokens = array_values($finalTokens);
$numTokens = count($finalTokens);
}
break;
case T_COLON:
// Only interested in colons that are defining styles.
if ($inStyleDef === false) {
break;
}
for ($x = ($stackPtr - 1); $x >= 0; $x--) {
if (in_array($finalTokens[$x]['code'], PHP_CodeSniffer_Tokens::$emptyTokens) === false) {
break;
}
}
$finalTokens[$x]['type'] = 'T_STYLE';
$finalTokens[$x]['code'] = T_STYLE;
break;
case T_STRING:
if (strtolower($token['content']) === 'url') {
// Find the next content.
for ($x = ($stackPtr + 1); $x < $numTokens; $x++) {
if (in_array($finalTokens[$x]['code'], PHP_CodeSniffer_Tokens::$emptyTokens) === false) {
break;
}
}
// Needs to be in the format "url(" for it to be a URL.
if ($finalTokens[$x]['code'] !== T_OPEN_PARENTHESIS) {
continue;
}
// Make sure the content isn't empty.
for ($y = ($x + 1); $y < $numTokens; $y++) {
if (in_array($finalTokens[$y]['code'], PHP_CodeSniffer_Tokens::$emptyTokens) === false) {
break;
}
}
if ($finalTokens[$y]['code'] === T_CLOSE_PARENTHESIS) {
continue;
}
// Join all the content together inside the url() statement.
$newContent = '';
for ($i = ($x + 2); $i < $numTokens; $i++) {
if ($finalTokens[$i]['code'] === T_CLOSE_PARENTHESIS) {
break;
}
$newContent .= $finalTokens[$i]['content'];
unset($finalTokens[$i]);
}
// If the content inside the "url()" is in double quotes
// there will only be one token and so we don't have to do
// anything except change its type. If it is not empty,
// we need to do some token merging.
$finalTokens[($x + 1)]['type'] = 'T_URL';
$finalTokens[($x + 1)]['code'] = T_URL;
if ($newContent !== '') {
$finalTokens[($x + 1)]['content'] .= $newContent;
$finalTokens = array_values($finalTokens);
$numTokens = count($finalTokens);
}
}//end if
break;
default:
// Nothing special to be done with this token.
break;
}//end switch
}//end for
return $finalTokens;
}//end tokenizeString()
/**
* Performs additional processing after main tokenizing.
*
* This additional processsing converts T_LIST tokens to T_STRING
* because there are no list constructs in CSS and list-* styles
* look like lists to the PHP tokenizer.
*
* @param array &$tokens The array of tokens to process.
* @param string $eolChar The EOL character to use for splitting strings.
*
* @return void
*/
public function processAdditional(&$tokens, $eolChar)
{
if (PHP_CODESNIFFER_VERBOSITY > 1) {
echo "\t*** START ADDITIONAL JS PROCESSING ***".PHP_EOL;
}
$numTokens = (count($tokens) - 1);
$changeMade = false;
for ($i = 0; $i < $numTokens; $i++) {
if ($tokens[($i + 1)]['code'] !== T_STYLE) {
continue;
}
$style = ($i + 1);
if ($tokens[$i]['code'] === T_LIST) {
$tokens[$style]['content'] = $tokens[$i]['content'].$tokens[$style]['content'];
$tokens[$style]['column'] = $tokens[$i]['column'];
if (PHP_CODESNIFFER_VERBOSITY > 1) {
$line = $tokens[$i]['line'];
echo "\t* T_LIST token $i on line $line merged into T_STYLE token $style *".PHP_EOL;
}
// Now fix the brackets that surround this token as they will
// be pointing too far ahead now that we have removed a token.
for ($t = $i; $t >= 0; $t--) {
if (isset($tokens[$t]['bracket_closer']) === true) {
$old = $tokens[$t]['bracket_closer'];
$tokens[$t]['bracket_closer']--;
if (PHP_CODESNIFFER_VERBOSITY > 1) {
$new = $tokens[$t]['bracket_closer'];
$type = $tokens[$t]['type'];
$line = $tokens[$t]['line'];
echo "\t\t* $type token $t on line $line closer changed from $old to $new *".PHP_EOL;
}
// Only need to fix one set of brackets.
break;
}
}
// Now fix all future brackets as they are no longer pointing
// to the correct tokens either.
for ($t = $i; $t <= $numTokens; $t++) {
if (isset($tokens[$t]) === false) {
break;
}
if ($tokens[$t]['code'] === T_OPEN_CURLY_BRACKET) {
$old = $tokens[$t]['bracket_closer'];
$tokens[$t]['bracket_closer']--;
if (PHP_CODESNIFFER_VERBOSITY > 1) {
$new = $tokens[$t]['bracket_closer'];
$type = $tokens[$t]['type'];
$line = $tokens[$t]['line'];
echo "\t\t* $type token $t on line $line closer changed from $old to $new *".PHP_EOL;
}
$t = $old;
}
}
unset($tokens[$i]);
$changeMade = true;
$i++;
} else if ($tokens[$i]['code'] === T_BREAK) {
// Break is sometimes used in style definitions, like page-break-inside
// so we need merge the elements around it into the next T_STYLE.
$newStyle = 'break'.$tokens[$style]['content'];
for ($x = ($i - 1); $x >= 0; $x--) {
if ($tokens[$x]['code'] !== T_STRING && $tokens[$x]['code'] !== T_MINUS) {
break;
}
$newStyle = $tokens[$x]['content'].$newStyle;
}
$x++;
$tokens[$style]['content'] = $newStyle;
$tokens[$style]['column'] = $tokens[$x]['column'];
if (PHP_CODESNIFFER_VERBOSITY > 1) {
$line = $tokens[$i]['line'];
echo "\t* tokens $x - $i on line $line merged into T_STYLE token $style due to T_BREAK at token $i *".PHP_EOL;
}
// Now fix the brackets that surround this token as they will
// be pointing too far ahead now that we have removed tokens.
$diff = ($style - $x);
for ($t = $style; $t >= 0; $t--) {
if (isset($tokens[$t]['bracket_closer']) === true) {
$old = $tokens[$t]['bracket_closer'];
$tokens[$t]['bracket_closer'] -= $diff;
if (PHP_CODESNIFFER_VERBOSITY > 1) {
$new = $tokens[$t]['bracket_closer'];
$type = $tokens[$t]['type'];
$line = $tokens[$t]['line'];
echo "\t\t* $type token $t on line $line closer changed from $old to $new *".PHP_EOL;
}
// Only need to fix one set of brackets.
break;
}
}
// Now fix all future brackets as they are no longer pointing
// to the correct tokens either.
for ($t = $style; $t <= $numTokens; $t++) {
if (isset($tokens[$t]) === false) {
break;
}
if ($tokens[$t]['code'] === T_OPEN_CURLY_BRACKET) {
$old = $tokens[$t]['bracket_closer'];
$tokens[$t]['bracket_closer'] -= $diff;
if (PHP_CODESNIFFER_VERBOSITY > 1) {
$new = $tokens[$t]['bracket_closer'];
$type = $tokens[$t]['type'];
$line = $tokens[$t]['line'];
echo "\t\t* $type token $t on line $line closer changed from $old to $new *".PHP_EOL;
}
$t = $old;
}
}
for ($x; $x <= $i; $x++) {
unset($tokens[$x]);
}
$changeMade = true;
$i++;
}//end if
}//end for
if ($changeMade === true) {
$tokens = array_values($tokens);
}
if (PHP_CODESNIFFER_VERBOSITY > 1) {
echo "\t*** END ADDITIONAL JS PROCESSING ***".PHP_EOL;
}
}//end processAdditional()
}//end class
?>
|