From 86d649e9e8d199d85f812c1e1cef22089106bd70 Mon Sep 17 00:00:00 2001 From: Timothy J Warren Date: Wed, 31 Aug 2016 12:18:46 -0400 Subject: [PATCH] First commit --- .editorconfig | 20 + .gitignore | 29 + README.md | 3 + RoboFile.php | 330 ++++++++++ .../ClosingFileAndLocationCommentStandard.xml | 28 + .../Utf8EncodingAndByteOrderMarkStandard.xml | 7 + .../ConstructorNameStandard.xml | 31 + .../ValidClassNameStandard.xml | 21 + .../ValidFileNameStandard.xml | 21 + .../ValidMethodNameStandard.xml | 27 + .../ValidVariableNameStandard.xml | 31 + .../StrictComparisonOperatorStandard.xml | 40 ++ .../Docs/Strings/DoubleQuoteUsageStandard.xml | 28 + .../Sniffs/Commenting/InlineCommentSniff.php | 187 ++++++ .../Sniffs/Files/ByteOrderMarkSniff.php | 98 +++ .../Sniffs/Files/Utf8EncodingSniff.php | 222 +++++++ .../Operators/LogicalOperatorAndSniff.php | 81 +++ .../StrictComparisonOperatorSniff.php | 81 +++ .../UppercaseLogicalOperatorOrSniff.php | 84 +++ .../Sniffs/Strings/DoubleQuoteUsageSniff.php | 464 +++++++++++++++ .../WhiteSpace/DisallowSpaceIndentSniff.php | 87 +++ .../DisallowWitheSpaceAroundPhpTagsSniff.php | 95 +++ .../Sniffs/WhiteSpace/ElseOnNewLineSniff.php | 82 +++ .../WhiteSpace/LogicalNotSpacingSniff.php | 75 +++ .../Files/AbstractClosingCommentSniff.php | 104 ++++ .../Files/ClosingFileCommentSniff.php | 109 ++++ .../Files/ClosingLocationCommentSniff.php | 182 ++++++ .../ConstructorNameSniff.php | 142 +++++ .../NamingConventions/ValidClassNameSniff.php | 84 +++ .../NamingConventions/ValidFileNameSniff.php | 84 +++ .../ValidMethodNameSniff.php | 161 +++++ .../ValidVariableNameSniff.php | 562 ++++++++++++++++++ build/CodeIgniter/ruleset.xml | 47 ++ build/header_comment.txt | 13 + build/phpcs.xml | 84 +++ build/phpdox.xml | 128 ++++ build/phpunit.xml | 26 + build/update_header_comments.php | 70 +++ composer.json | 37 ++ phpdoc.dist.xml | 15 + phpunit.xml | 18 + src/CachePool.php | 208 +++++++ src/Driver/Driver.php | 23 + src/Driver/DriverCacheItem.php | 121 ++++ src/Driver/DriverInterface.php | 42 ++ src/Driver/RedisDriver.php | 23 + src/Driver/SQLDriver.php | 23 + src/Exception/CacheException.php | 25 + src/Exception/InvalidArgumentException.php | 28 + src/ItemCollection.php | 56 ++ tests/bootstrap.php | 4 + 51 files changed, 4591 insertions(+) create mode 100644 .editorconfig create mode 100644 .gitignore create mode 100644 README.md create mode 100644 RoboFile.php create mode 100644 build/CodeIgniter/Docs/Files/ClosingFileAndLocationCommentStandard.xml create mode 100644 build/CodeIgniter/Docs/Files/Utf8EncodingAndByteOrderMarkStandard.xml create mode 100644 build/CodeIgniter/Docs/NamingConventions/ConstructorNameStandard.xml create mode 100644 build/CodeIgniter/Docs/NamingConventions/ValidClassNameStandard.xml create mode 100644 build/CodeIgniter/Docs/NamingConventions/ValidFileNameStandard.xml create mode 100644 build/CodeIgniter/Docs/NamingConventions/ValidMethodNameStandard.xml create mode 100644 build/CodeIgniter/Docs/NamingConventions/ValidVariableNameStandard.xml create mode 100644 build/CodeIgniter/Docs/Operators/StrictComparisonOperatorStandard.xml create mode 100755 build/CodeIgniter/Docs/Strings/DoubleQuoteUsageStandard.xml create mode 100644 build/CodeIgniter/Sniffs/Commenting/InlineCommentSniff.php create mode 100755 build/CodeIgniter/Sniffs/Files/ByteOrderMarkSniff.php create mode 100755 build/CodeIgniter/Sniffs/Files/Utf8EncodingSniff.php create mode 100644 build/CodeIgniter/Sniffs/Operators/LogicalOperatorAndSniff.php create mode 100755 build/CodeIgniter/Sniffs/Operators/StrictComparisonOperatorSniff.php create mode 100644 build/CodeIgniter/Sniffs/Operators/UppercaseLogicalOperatorOrSniff.php create mode 100755 build/CodeIgniter/Sniffs/Strings/DoubleQuoteUsageSniff.php create mode 100755 build/CodeIgniter/Sniffs/WhiteSpace/DisallowSpaceIndentSniff.php create mode 100755 build/CodeIgniter/Sniffs/WhiteSpace/DisallowWitheSpaceAroundPhpTagsSniff.php create mode 100644 build/CodeIgniter/Sniffs/WhiteSpace/ElseOnNewLineSniff.php create mode 100755 build/CodeIgniter/Sniffs/WhiteSpace/LogicalNotSpacingSniff.php create mode 100644 build/CodeIgniter/UnusedSniffs/Files/AbstractClosingCommentSniff.php create mode 100755 build/CodeIgniter/UnusedSniffs/Files/ClosingFileCommentSniff.php create mode 100755 build/CodeIgniter/UnusedSniffs/Files/ClosingLocationCommentSniff.php create mode 100755 build/CodeIgniter/UnusedSniffs/NamingConventions/ConstructorNameSniff.php create mode 100755 build/CodeIgniter/UnusedSniffs/NamingConventions/ValidClassNameSniff.php create mode 100644 build/CodeIgniter/UnusedSniffs/NamingConventions/ValidFileNameSniff.php create mode 100755 build/CodeIgniter/UnusedSniffs/NamingConventions/ValidMethodNameSniff.php create mode 100755 build/CodeIgniter/UnusedSniffs/NamingConventions/ValidVariableNameSniff.php create mode 100644 build/CodeIgniter/ruleset.xml create mode 100644 build/header_comment.txt create mode 100644 build/phpcs.xml create mode 100644 build/phpdox.xml create mode 100644 build/phpunit.xml create mode 100644 build/update_header_comments.php create mode 100644 composer.json create mode 100644 phpdoc.dist.xml create mode 100644 phpunit.xml create mode 100644 src/CachePool.php create mode 100644 src/Driver/Driver.php create mode 100644 src/Driver/DriverCacheItem.php create mode 100644 src/Driver/DriverInterface.php create mode 100644 src/Driver/RedisDriver.php create mode 100644 src/Driver/SQLDriver.php create mode 100644 src/Exception/CacheException.php create mode 100644 src/Exception/InvalidArgumentException.php create mode 100644 src/ItemCollection.php create mode 100644 tests/bootstrap.php diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..b909682 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,20 @@ +# EditorConfig is awesome: http://EditorConfig.org + +# top-most EditorConfig file +root = true + +# Unix-style newlines with a newline ending every file +[*] +end_of_line = lf +insert_final_newline = false +charset = utf-8 +indent_style = tab +trim_trailing_whitespace = true + +[*.{cpp,c,h,hpp,cxx}] +insert_final_newline = true + +# Yaml files +[*.{yml,yaml}] +indent_style = space +indent_size = 4 \ No newline at end of file diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..78031d8 --- /dev/null +++ b/.gitignore @@ -0,0 +1,29 @@ +.codelite +.phing_targets +.sonar/ +*.phprj +*.workspace +vendor +**/cache/** +**/logs/** +**/coverage/** +**/docs/** +**/node_modules/** +public/images/* +composer.lock +*.sqlite +*.db +*.sqlite3 +docs/* +tests/test_data/sessions/* +cache.properties +build/** +!build/*.txt +!build/*.xml +!build/*.php +app/config/*.toml +!app/config/*.toml.example +phinx.yml +.idea/ +Caddyfile +build/humbuglog.txt \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..0db316c --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# Banker + +A Caching library implementing the PSR-6 interface for several common cache backends \ No newline at end of file diff --git a/RoboFile.php b/RoboFile.php new file mode 100644 index 0000000..d54b3ea --- /dev/null +++ b/RoboFile.php @@ -0,0 +1,330 @@ +prepare(); + $this->lint(); + $this->phploc(TRUE); + $this->phpcs(TRUE); + $this->dependencyReport(); + $this->phpcpdReport(); + } + + /** + * Run all tests, generate coverage, generate docs, generate code statistics + */ + public function build() + { + $this->analyze(); + $this->coverage(); + $this->docs(); + } + + /** + * Cleanup temporary files + */ + public function clean() + { + $cleanFiles = [ + 'build/humbug.json', + 'build/humbug-log.txt', + ]; + array_map(function ($file) { + @unlink($file); + }, $cleanFiles); + + // So the task doesn't complain, + // make any 'missing' dirs to cleanup + array_map(function ($dir) { + if ( ! is_dir($dir)) + { + `mkdir -p {$dir}`; + } + }, $this->cleanDirs); + + $this->_cleanDir($this->cleanDirs); + $this->_deleteDir($this->cleanDirs); + } + + /** + * Run unit tests and generate coverage reports + */ + public function coverage() + { + $this->taskPhpUnit() + ->configFile('build/phpunit.xml') + ->printed(true) + ->run(); + } + + /** + * Generate documentation with phpdox + */ + public function docs() + { + $cmd_parts = [ + 'cd build', + '../vendor/bin/phpdox', + 'cd ..' + ]; + $this->_run($cmd_parts, ' && '); + } + + /** + * Verify that source files are valid + */ + public function lint() + { + $files = $this->getAllSourceFiles(); + + $chunks = array_chunk($files, 6); + + foreach($chunks as $chunk) + { + $this->parallelLint($chunk); + } + } + + + /** + * Run mutation tests with humbug + * + * @param bool $stats - if true, generates stats rather than running mutation tests + */ + public function mutate($stats = FALSE) + { + $test_parts = [ + 'vendor/bin/humbug' + ]; + + $stat_parts = [ + 'vendor/bin/humbug', + '--skip-killed=yes', + '-v', + './build/humbug.json' + ]; + + $cmd_parts = ($stats) ? $stat_parts : $test_parts; + $this->_run($cmd_parts); + } + + /** + * Run the phpcs tool + * + * @param bool $report - if true, generates reports instead of direct output + */ + public function phpcs($report = FALSE) + { + $report_cmd_parts = [ + 'vendor/bin/phpcs', + '--standard=./build/phpcs.xml', + '--report-checkstyle=./build/logs/phpcs.xml', + ]; + + $normal_cmd_parts = [ + 'vendor/bin/phpcs', + '--standard=./build/phpcs.xml', + ]; + + $cmd_parts = ($report) ? $report_cmd_parts : $normal_cmd_parts; + + $this->_run($cmd_parts); + } + + /** + * Run the phploc tool + * + * @param bool $report - if true, generates reports instead of direct output + */ + public function phploc($report = FALSE) + { + // Command for generating reports + $report_cmd_parts = [ + 'vendor/bin/phploc', + '--count-tests', + '--log-csv=build/logs/phploc.csv', + '--log-xml=build/logs/phploc.xml', + 'src', + 'tests' + ]; + + // Command for generating direct output + $normal_cmd_parts = [ + 'vendor/bin/phploc', + '--count-tests', + 'src', + 'tests' + ]; + + $cmd_parts = ($report) ? $report_cmd_parts : $normal_cmd_parts; + + $this->_run($cmd_parts); + } + + /** + * Create temporary directories + */ + public function prepare() + { + array_map([$this, '_mkdir'], $this->taskDirs); + } + + /** + * Lint php files and run unit tests + */ + public function test() + { + $this->lint(); + $this->taskPHPUnit() + ->configFile('phpunit.xml') + ->printed(true) + ->run(); + } + + /** + * Watches for file updates, and automatically runs appropriate actions + */ + public function watch() + { + $this->taskWatch() + ->monitor('composer.json', function() { + $this->taskComposerUpdate()->run(); + }) + ->monitor('src', function () { + $this->taskExec('test')->run(); + }) + ->monitor('tests', function () { + $this->taskExec('test')->run(); + }) + ->run(); + } + + /** + * Create pdepend reports + */ + protected function dependencyReport() + { + $cmd_parts = [ + 'vendor/bin/pdepend', + '--jdepend-xml=build/logs/jdepend.xml', + '--jdepend-chart=build/pdepend/dependencies.svg', + '--overview-pyramid=build/pdepend/overview-pyramid.svg', + 'src' + ]; + $this->_run($cmd_parts); + } + + /** + * Get the total list of source files, including tests + * + * @return array + */ + protected function getAllSourceFiles() + { + $files = array_merge( + glob_recursive('build/*.php'), + glob_recursive('src/*.php'), + glob_recursive('tests/*.php'), + glob('*.php') + ); + + sort($files); + + return $files; + } + + /** + * Run php's linter in one parallel task for the passed chunk + * + * @param array $chunk + */ + protected function parallelLint(array $chunk) + { + $task = $this->taskParallelExec() + ->timeout(5) + ->printed(FALSE); + + foreach($chunk as $file) + { + $task = $task->process("php -l {$file}"); + } + + $task->run(); + } + + /** + * Generate copy paste detector report + */ + protected function phpcpdReport() + { + $cmd_parts = [ + 'vendor/bin/phpcpd', + '--log-pmd build/logs/pmd-cpd.xml', + 'src' + ]; + $this->_run($cmd_parts); + } + + /** + * Shortcut for joining an array of command arguments + * and then running it + * + * @param array $cmd_parts - command arguments + * @param string $join_on - what to join the command arguments with + */ + protected function _run(array $cmd_parts, $join_on = ' ') + { + $this->taskExec(implode($join_on, $cmd_parts))->run(); + } +} \ No newline at end of file diff --git a/build/CodeIgniter/Docs/Files/ClosingFileAndLocationCommentStandard.xml b/build/CodeIgniter/Docs/Files/ClosingFileAndLocationCommentStandard.xml new file mode 100644 index 0000000..5dd3d3c --- /dev/null +++ b/build/CodeIgniter/Docs/Files/ClosingFileAndLocationCommentStandard.xml @@ -0,0 +1,28 @@ + + + is optional to the PHP parser. However, if used, any whitespace following the closing tag, whether introduced by the developer, user, or an FTP application, can cause unwanted output, PHP errors, or if the latter are suppressed, blank pages. For this reason, all PHP files should OMIT the closing PHP tag, and instead use a comment block to mark the end of file and it's location relative to the application root. This allows you to still identify a file as being complete and not truncated. + ]]> + + + + + + + + ]]> + + + diff --git a/build/CodeIgniter/Docs/Files/Utf8EncodingAndByteOrderMarkStandard.xml b/build/CodeIgniter/Docs/Files/Utf8EncodingAndByteOrderMarkStandard.xml new file mode 100644 index 0000000..d3a0d9b --- /dev/null +++ b/build/CodeIgniter/Docs/Files/Utf8EncodingAndByteOrderMarkStandard.xml @@ -0,0 +1,7 @@ + + + + + diff --git a/build/CodeIgniter/Docs/NamingConventions/ConstructorNameStandard.xml b/build/CodeIgniter/Docs/NamingConventions/ConstructorNameStandard.xml new file mode 100644 index 0000000..46b3e69 --- /dev/null +++ b/build/CodeIgniter/Docs/NamingConventions/ConstructorNameStandard.xml @@ -0,0 +1,31 @@ + + + + + + + + + + + + + diff --git a/build/CodeIgniter/Docs/NamingConventions/ValidClassNameStandard.xml b/build/CodeIgniter/Docs/NamingConventions/ValidClassNameStandard.xml new file mode 100644 index 0000000..3721b67 --- /dev/null +++ b/build/CodeIgniter/Docs/NamingConventions/ValidClassNameStandard.xml @@ -0,0 +1,21 @@ + + + + + + + + + + + + + diff --git a/build/CodeIgniter/Docs/NamingConventions/ValidFileNameStandard.xml b/build/CodeIgniter/Docs/NamingConventions/ValidFileNameStandard.xml new file mode 100644 index 0000000..331fa44 --- /dev/null +++ b/build/CodeIgniter/Docs/NamingConventions/ValidFileNameStandard.xml @@ -0,0 +1,21 @@ + + + + + + + + + + + + + diff --git a/build/CodeIgniter/Docs/NamingConventions/ValidMethodNameStandard.xml b/build/CodeIgniter/Docs/NamingConventions/ValidMethodNameStandard.xml new file mode 100644 index 0000000..a669c44 --- /dev/null +++ b/build/CodeIgniter/Docs/NamingConventions/ValidMethodNameStandard.xml @@ -0,0 +1,27 @@ + + + + + + + + + + + + + diff --git a/build/CodeIgniter/Docs/NamingConventions/ValidVariableNameStandard.xml b/build/CodeIgniter/Docs/NamingConventions/ValidVariableNameStandard.xml new file mode 100644 index 0000000..14362b7 --- /dev/null +++ b/build/CodeIgniter/Docs/NamingConventions/ValidVariableNameStandard.xml @@ -0,0 +1,31 @@ + + + + + + + + + + + + + diff --git a/build/CodeIgniter/Docs/Operators/StrictComparisonOperatorStandard.xml b/build/CodeIgniter/Docs/Operators/StrictComparisonOperatorStandard.xml new file mode 100644 index 0000000..92fc74f --- /dev/null +++ b/build/CodeIgniter/Docs/Operators/StrictComparisonOperatorStandard.xml @@ -0,0 +1,40 @@ + + + + + + + + + + + + + diff --git a/build/CodeIgniter/Docs/Strings/DoubleQuoteUsageStandard.xml b/build/CodeIgniter/Docs/Strings/DoubleQuoteUsageStandard.xml new file mode 100755 index 0000000..137130c --- /dev/null +++ b/build/CodeIgniter/Docs/Strings/DoubleQuoteUsageStandard.xml @@ -0,0 +1,28 @@ + + + + + + + + + + bar}" // variables in strings may be an object attribute +"SELECT foo FROM bar WHERE baz = 'bag'" +"\n" // not specified in Code Igniter coding standard, but it should be allowed + ]]> + + + diff --git a/build/CodeIgniter/Sniffs/Commenting/InlineCommentSniff.php b/build/CodeIgniter/Sniffs/Commenting/InlineCommentSniff.php new file mode 100644 index 0000000..d8e51eb --- /dev/null +++ b/build/CodeIgniter/Sniffs/Commenting/InlineCommentSniff.php @@ -0,0 +1,187 @@ + + * @copyright 2011 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Commenting_InlineCommentSniff. + * + * Ensure the use of single line comments within code (i.e //) + * and blank lines between large comment blocks and code. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2011 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ +namespace CodeIgniter\Sniffs\Commenting; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class InlineCommentSniff implements Sniff +{ + /** + * @var int Limit defining long comments. + * Long comments count $longCommentLimit or more lines. + */ + public $longCommentLimit = 5; + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_COMMENT + ); + }//end register() + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @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(); + + // keep testing only if it's about the first comment of the block + $previousCommentPtr = $phpcsFile->findPrevious($tokens[$stackPtr]['code'], $stackPtr - 1); + if ($tokens[$previousCommentPtr]['line'] !== $tokens[$stackPtr]['line'] - 1) { + if (TRUE !== $this->_checkCommentStyle($phpcsFile, $stackPtr)) { + return; + } + + $commentLines = $this->_getCommentBlock($phpcsFile, $stackPtr); + + if (count($commentLines) >= $this->longCommentLimit) { + $this->_checkBlankLinesAroundLongComment($phpcsFile, $commentLines); + } + } + }//end process() + + + /** + * Add error to $phpcsFile, if comment pointed by $stackPtr doesn't start + * with '//'. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * that has to be a comment. + * + * @return bool TRUE if the content of the token pointed by $stackPtr starts + * with //, FALSE if an error was added to $phpcsFile. + */ + private function _checkCommentStyle(File $phpcsFile, $stackPtr) + { + $tokens = $phpcsFile->getTokens(); + if ($tokens[$stackPtr]['content']{0} === '#') { + $error = 'Perl-style comments are not allowed; use "// Comment" or DocBlock comments instead'; + $phpcsFile->addError($error, $stackPtr, 'WrongStyle'); + return FALSE; + } else if (substr($tokens[$stackPtr]['content'], 0, 2) === '/*' + || $tokens[$stackPtr]['content']{0} === '*' + ) { + $error = 'Multi lines comments are not allowed; use "// Comment" DocBlock comments instead'; + $phpcsFile->addError($error, $stackPtr, 'WrongStyle'); + return FALSE; + } else if (substr($tokens[$stackPtr]['content'], 0, 2) !== '//') { + $error = 'Use single line or DocBlock comments within code'; + $phpcsFile->addError($error, $stackPtr, 'WrongStyle'); + return FALSE; + } + return TRUE; + }//_checkCommentStyle() + + + /** + * Gather into an array all comment lines to which $stackPtr belongs. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr Pointer to the first comment line. + * + * @return type array Pointers to tokens making up the comment block. + */ + private function _getCommentBlock(File $phpcsFile, $stackPtr) + { + $tokens = $phpcsFile->getTokens(); + $commentLines = array($stackPtr); + $nextComment = $stackPtr; + $lastLine = $tokens[$stackPtr]['line']; + + while (($nextComment = $phpcsFile->findNext($tokens[$stackPtr]['code'], ($nextComment + 1), null, false)) !== false) { + if (($tokens[$nextComment]['line'] - 1) !== $lastLine) { + // Not part of the block. + break; + } + + $lastLine = $tokens[$nextComment]['line']; + $commentLines[] = $nextComment; + } + + return $commentLines; + }//_getCommentBlock() + + + /** + * Add errors to $phpcsFile, if $commentLines isn't enclosed with blank lines. + * + * @param File $phpcsFile The current file being scanned. + * @param array $commentLines Lines of the comment block being checked. + * + * @return bool TRUE if $commentLines is enclosed with at least a blank line + * before and after, FALSE otherwise. + */ + private function _checkBlankLinesAroundLongComment(File $phpcsFile, array $commentLines) + { + $hasBlankLinesAround = TRUE; + $tokens = $phpcsFile->getTokens(); + + // check blank line before the long comment + $firstCommentPtr = reset($commentLines); + $firstPreviousSpacePtr = $firstCommentPtr - 1; + while (T_WHITESPACE === $tokens[$firstPreviousSpacePtr]['code'] && $firstPreviousSpacePtr > 0) { + $firstPreviousSpacePtr--; + } + if ($tokens[$firstPreviousSpacePtr]['line'] >= $tokens[$firstCommentPtr]['line'] - 1) { + $error = "Please add a blank line before comments counting more than {$this->longCommentLimit} lines."; + $phpcsFile->addError($error, $firstCommentPtr, 'LongCommentWithoutSpacing'); + $hasBlankLinesAround = FALSE; + } + + // check blank line after the long comment + $lastCommentPtr = end($commentLines); + $lastNextSpacePtr = $lastCommentPtr + 1; + while (T_WHITESPACE === $tokens[$lastNextSpacePtr]['code'] && $lastNextSpacePtr < count($tokens)) { + $lastNextSpacePtr++; + } + if ($tokens[$lastNextSpacePtr]['line'] <= $tokens[$lastCommentPtr]['line'] + 1) { + $error = "Please add a blank line after comments counting more than {$this->longCommentLimit} lines."; + $phpcsFile->addError($error, $lastCommentPtr, 'LongCommentWithoutSpacing'); + $hasBlankLinesAround = FALSE; + } + + return $hasBlankLinesAround; + }//end _checkBlanksAroundLongComment() + +}//end class + +?> \ No newline at end of file diff --git a/build/CodeIgniter/Sniffs/Files/ByteOrderMarkSniff.php b/build/CodeIgniter/Sniffs/Files/ByteOrderMarkSniff.php new file mode 100755 index 0000000..edd534e --- /dev/null +++ b/build/CodeIgniter/Sniffs/Files/ByteOrderMarkSniff.php @@ -0,0 +1,98 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Files_ByteOrderMarkSniff. + * + * Ensures that no BOM appears at the beginning of file. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Files; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class ByteOrderMarkSniff implements Sniff +{ + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( T_OPEN_TAG ); + }//end register() + + /** + * List of supported BOM definitions. + * + * Use encoding names as keys and hex BOM representations as values. + * + * @return array + */ + protected function getBomDefinitions() + { + return array( + 'UTF-8' => 'efbbbf', + 'UTF-16 (BE)' => 'feff', + 'UTF-16 (LE)' => 'fffe', + 'UTF-32 (BE)' => '0000feff', + 'UTF-32 (LE)' => 'fffe0000' + ); + }//end getBomDefinitions() + + /** + * Process tokens. + * + * Actually, only proceed when we're at index 0, this should be the only case + * that will contain BOM. Then check if BOM definition matches what + * we've found as file's inline HTML. Inline HTML could be longer than just BOM + * so make sure you test as much as needed. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * + * @return void + */ + public function process(File $phpcsFile, $stackPtr ) + { + // We are only interested if this is the first open tag. + if ($stackPtr !== 0) { + if ($phpcsFile->findPrevious(T_OPEN_TAG, ($stackPtr - 1)) !== false) { + return; + } + } + + $tokens = $phpcsFile->getTokens(); + $fileStartString = $tokens[0]['content']; + foreach ($this->getBomDefinitions() as $bomName => $expectedBomHex) { + $bomByteLength = strlen($expectedBomHex) / 2; + $fileStartHex = bin2hex(substr($fileStartString, 0, $bomByteLength)); + if ($fileStartHex === $expectedBomHex) { + $error = "File contains a $bomName byte order mark (BOM)."; + $phpcsFile->addError($error, $stackPtr); + break; + } + } + }//end process() +} diff --git a/build/CodeIgniter/Sniffs/Files/Utf8EncodingSniff.php b/build/CodeIgniter/Sniffs/Files/Utf8EncodingSniff.php new file mode 100755 index 0000000..9c13bbc --- /dev/null +++ b/build/CodeIgniter/Sniffs/Files/Utf8EncodingSniff.php @@ -0,0 +1,222 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Files_Utf8EncodingSniff. + * + * Ensures that PHP files are encoded with Unicode (UTF-8) encoding. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Files; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class Utf8EncodingSniff implements Sniff +{ + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_OPEN_TAG + ); + + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * + * @return void + */ + public function process(File $phpcsFile, $stackPtr) + { + // We are only interested if this is the first open tag. + if ($stackPtr !== 0) { + if ($phpcsFile->findPrevious(T_OPEN_TAG, ($stackPtr - 1)) !== false) { + return; + } + } + + $file_path = $phpcsFile->getFilename(); + $file_name = basename($file_path); + $file_content = file_get_contents($file_path); + if (false === mb_check_encoding($file_content, 'UTF-8')) { + $error = 'File "' . $file_name . '" should be saved with Unicode (UTF-8) encoding.'; + $phpcsFile->addError($error, 0); + } + if ( ! self::_checkUtf8W3c($file_content)) { + $error = 'File "' . $file_name . '" should be saved with Unicode (UTF-8) encoding, but it did not successfully pass the W3C test.'; + $phpcsFile->addError($error, 0); + } + if ( ! self::_checkUtf8Rfc3629($file_content)) { + $error = 'File "' . $file_name . '" should be saved with Unicode (UTF-8) encoding, but it did not meet RFC3629 requirements.'; + $phpcsFile->addError($error, 0); + } + }//end process() + + + /** + * Checks that the string $content contains only valid UTF-8 chars + * using W3C's method. + * Returns true if $content contains only UTF-8 chars, false otherwise. + * + * @param string $content String to check. + * + * @return bool true if $content contains only UTF-8 chars, false otherwise. + * + * @see http://w3.org/International/questions/qa-forms-utf-8.html + */ + private static function _checkUtf8W3c($content) + { + $content_chunks=self::mb_chunk_split($content, 4096, ''); + foreach($content_chunks as $content_chunk) + { + $preg_result= preg_match( + '%^(?: + [\x09\x0A\x0D\x20-\x7E] # ASCII + | [\xC2-\xDF][\x80-\xBF] # non-overlong 2-byte + | \xE0[\xA0-\xBF][\x80-\xBF] # excluding overlongs + | [\xE1-\xEC\xEE\xEF][\x80-\xBF]{2} # straight 3-byte + | \xED[\x80-\x9F][\x80-\xBF] # excluding surrogates + | \xF0[\x90-\xBF][\x80-\xBF]{2} # planes 1-3 + | [\xF1-\xF3][\x80-\xBF]{3} # planes 4-15 + | \xF4[\x80-\x8F][\x80-\xBF]{2} # plane 16 + )*$%xs', + $content_chunk + ); + if($preg_result!==1) + { + return false; + } + + } + return true; + }//end _checkUtf8W3c() + + /** + * Checks that the string $content contains only valid UTF-8 chars + * using the method described in RFC 3629. + * Returns true if $content contains only UTF-8 chars, false otherwise. + * + * @param string $content String to check. + * + * @return bool true if $content contains only UTF-8 chars, false otherwise. + * + * @see http://www.php.net/manual/en/function.mb-detect-encoding.php#85294 + */ + private static function _checkUtf8Rfc3629($content) + { + $len = strlen($content); + for ($i = 0; $i < $len; $i++) { + $c = ord($content[$i]); + if ($c > 128) { + if (($c >= 254)) { + return false; + } elseif ($c >= 252) { + $bits=6; + } elseif ($c >= 248) { + $bits=5; + } elseif ($c >= 240) { + $bytes = 4; + } elseif ($c >= 224) { + $bytes = 3; + } elseif ($c >= 192) { + $bytes = 2; + } else { + return false; + } if (($i + $bytes) > $len) { + return false; + } while ($bytes > 1) { + $i++; + $b = ord($content[$i]); + if ($b < 128 || $b > 191) { + return false; + } + $bytes--; + } + } + } + return true; + }//_checkUtf8Rfc3629() + + /** + * Splits a string to chunks of given size + * This helps to avoid segmentation fault errors when large text is given + * Returns array of strings after splitting + * + * @param string $str String to split. + * @param int $len number of characters per chunk + * + * @return array string array after splitting + * + * @see http://php.net/manual/en/function.chunk-split.php + */ + private static function mb_chunk_split($str, $len, $glue) + { + if (empty($str)) return false; + $array = self::mbStringToArray ($str); + $n = -1; + $new = Array(); + foreach ($array as $char) { + $n++; + if ($n < $len) $new []= $char; + elseif ($n == $len) { + $new []= $glue . $char; + $n = 0; + } + } + return $new; + }//mb_chunk_split + /** + * Supporting function for mb_chunk_split + * + * @param string $str + * + * @return array + * + * @see http://php.net/manual/en/function.chunk-split.php + */ + private static function mbStringToArray ($str) + { + if (empty($str)) return false; + $len = mb_strlen($str); + $array = array(); + for ($i = 0; $i < $len; $i++) { + $array[] = mb_substr($str, $i, 1); + } + return $array; + } + + + +}//end class + +?> diff --git a/build/CodeIgniter/Sniffs/Operators/LogicalOperatorAndSniff.php b/build/CodeIgniter/Sniffs/Operators/LogicalOperatorAndSniff.php new file mode 100644 index 0000000..d7af22a --- /dev/null +++ b/build/CodeIgniter/Sniffs/Operators/LogicalOperatorAndSniff.php @@ -0,0 +1,81 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Operators_LogicalOperatorAndSniff. + * + * Ensures that the logical operator 'AND' is in upper case and suggest the use of its symbolic equivalent. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Operators; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class LogicalOperatorAndSniff implements Sniff +{ + /** + * Returns an array of tokens this test wants to listen for: symbolic and literal operators and. + * + * @return array + */ + public function register() + { + return array( + T_LOGICAL_AND, + ); + + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @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(); + + $operator_token = $tokens[$stackPtr]; + $operator_string = $operator_token['content']; + $operator_code = $operator_token['code']; + + if ($operator_string !== strtoupper($operator_string)) { + $error_message = 'Logical operator should be in upper case;' + . ' use "' . strtoupper($operator_string) + . '" instead of "' . $operator_string . '"'; + $phpcsFile->addError($error_message, $stackPtr, 'LowercaseLogicalOperator'); + } + + $warning_message = 'The symbolic form "&&" is preferred over the literal form "AND"'; + $phpcsFile->addWarning($warning_message, $stackPtr, 'UseOfLiteralAndOperator'); + + }//end process() + + +}//end class + +?> \ No newline at end of file diff --git a/build/CodeIgniter/Sniffs/Operators/StrictComparisonOperatorSniff.php b/build/CodeIgniter/Sniffs/Operators/StrictComparisonOperatorSniff.php new file mode 100755 index 0000000..e30a1a0 --- /dev/null +++ b/build/CodeIgniter/Sniffs/Operators/StrictComparisonOperatorSniff.php @@ -0,0 +1,81 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Operators_StrictComparisonOperatorSniff. + * + * Ensures that only strict comparison operators are used instead of + * equal and not equal operators. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Operators; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class StrictComparisonOperatorSniff implements Sniff +{ + private static $_replacements = array( + T_IS_EQUAL => '===', + T_IS_NOT_EQUAL => '!==', + ); + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_IS_EQUAL, + T_IS_NOT_EQUAL, + ); + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @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(); + + $operator_token = $tokens[$stackPtr]; + $operator_string = $operator_token['content']; + $operator_code = $operator_token['code']; + + $error_message = '"==" and "!=" are prohibited; use "' + . self::$_replacements[$operator_code] . '" instead of "' + . $operator_string . '".'; + $phpcsFile->addError($error_message, $stackPtr, 'NonStrictComparisonUsed'); + }//end process() + + +}//end class + +?> \ No newline at end of file diff --git a/build/CodeIgniter/Sniffs/Operators/UppercaseLogicalOperatorOrSniff.php b/build/CodeIgniter/Sniffs/Operators/UppercaseLogicalOperatorOrSniff.php new file mode 100644 index 0000000..cda26c0 --- /dev/null +++ b/build/CodeIgniter/Sniffs/Operators/UppercaseLogicalOperatorOrSniff.php @@ -0,0 +1,84 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Operators_UppercaseLogicalOperatorOrSniff. + * + * Ensures that the logical operator 'OR' is in upper cases and its symbolic equivalent. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Operators; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class UppercaseLogicalOperatorOrSniff implements Sniff +{ + /** + * Returns an array of tokens this test wants to listen for: literal and symbolic operators or. + * + * @return array + */ + public function register() + { + return array( + T_BOOLEAN_OR, + T_LOGICAL_OR, + ); + + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @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(); + + $operator_token = $tokens[$stackPtr]; + $operator_string = $operator_token['content']; + $operator_code = $operator_token['code']; + + if ($operator_code == T_BOOLEAN_OR) { + $error_message = 'Logical operator "' . $operator_string + . '" is prohibited; use "OR" instead'; + $phpcsFile->addError($error_message, $stackPtr, 'UseOf||InsteadOfOR'); + } + // it is literal, if it is not symbolic + else if ($operator_string !== strtoupper($operator_string)) { + $error_message = 'Logical operator should be in upper case;' + . ' use "' . strtoupper($operator_string) + . '" instead of "' . $operator_string . '"'; + $phpcsFile->addError($error_message, $stackPtr, 'UseOfLowercaseOr'); + } + }//end process() + + +}//end class + +?> \ No newline at end of file diff --git a/build/CodeIgniter/Sniffs/Strings/DoubleQuoteUsageSniff.php b/build/CodeIgniter/Sniffs/Strings/DoubleQuoteUsageSniff.php new file mode 100755 index 0000000..2c54d71 --- /dev/null +++ b/build/CodeIgniter/Sniffs/Strings/DoubleQuoteUsageSniff.php @@ -0,0 +1,464 @@ + + * @copyright 2011 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Strings; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +/** + * CodeIgniter_Sniffs_Strings_DoubleQuoteUsageSniff. + * + * Ensures that double-quoted strings are used only to parse variables, + * to avoid escape characters before single quotes or for chars that need + * to be interpreted like \r, \n or \t. + * If a double-quoted string contain both single and double quotes + * but no variable, then a warning is raised to encourage the use of + * single-quoted strings. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2011 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ +class VariableUsageSniff implements Sniff +{ + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + /* + return array( + T_DOUBLE_QUOTED_STRING, + T_CONSTANT_ENCAPSED_STRING, + ); + */ + return array(); + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @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(); + $string = $tokens[$stackPtr]['content']; + // makes sure that it is about a double quote string, + // since variables are not parsed out of double quoted string + $openDblQtStr = substr($string, 0, 1); + if (0 === strcmp($openDblQtStr, '"')) { + $this->processDoubleQuotedString($phpcsFile, $stackPtr, $string); + } else if (0 === strcmp($openDblQtStr, "'")) { + $this->processSingleQuotedString($phpcsFile, $stackPtr, $string); + } + }//end process() + + + /** + * Processes this test, when the token encountered is a double-quoted string. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param string $dblQtString The double-quoted string content, + * i.e. without quotes. + * + * @return void + */ + protected function processDoubleQuotedString (File $phpcsFile, $stackPtr, $dblQtString) + { + $variableFound = FALSE; + $strTokens = token_get_all('_parseVariable($strTokens, $strPtr); + } catch (Exception $err) { + $error = 'There is no variable, object nor array between curly braces. Please use the escape char for $ or {.'; + $phpcsFile->addError($error, $stackPtr); + } + $variableFound = TRUE; + if ('}' !== $strTokens[$strPtr]) { + $error = 'There is no matching closing curly brace.'; + $phpcsFile->addError($error, $stackPtr); + } + // don't move forward, since it will be done in the main loop + // $strPtr++; + } else if (T_VARIABLE === $strToken[0]) { + $variableFound = TRUE; + $error = "Variable {$strToken[1]} in double-quoted strings should be enclosed with curly braces. Please consider {{$strToken[1]}}"; + $phpcsFile->addError($error, $stackPtr); + } + } + $strPtr++; + } + return $variableFound; + }//end processDoubleQuotedString() + + + /** + * Processes this test, when the token encountered is a single-quoted string. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param string $sglQtString The single-quoted string content, + * i.e. without quotes. + * + * @return void + */ + protected function processSingleQuotedString (File $phpcsFile, $stackPtr, $sglQtString) + { + $variableFound = FALSE; + $strTokens = token_get_all('addError($error, $stackPtr); + } + } + $strPtr++; + } + return $variableFound; + }//end processSingleQuotedString() + + /** + * Grammar rule to parse the use of a variable. Please notice that it + * doesn't manage the leading $. + * + * _parseVariable ::= + * | _parseObjectAttribute() + * | _parseArrayIndexes() + * + * @exception Exception raised if $strTokens starting from $strPtr + * doesn't matched the rule. + * + * @param array $strTokens Tokens to parse. + * @param int $strPtr Pointer to the token where parsing starts. + * + * @return array The attribute name associated to index 'var', an array with + * indexes 'obj' and 'attr' or an array with indexes 'arr' and 'idx'. + */ + private function _parseVariable ($strTokens, &$strPtr) + { + if ( ! in_array($strTokens[$strPtr][0], array(T_VARIABLE, T_STRING_VARNAME))) { + throw new Exception ('Expected variable name.'); + } + $var = $strTokens[$strPtr][1]; + $strPtr++; + $startStrPtr = $strPtr; + try { + $attr = $this->_parseObjectAttribute($strTokens, $strPtr); + return array ('obj' => $var, 'attr' => $attr); + } catch (Exception $err) { + if ($strPtr !== $startStrPtr) { + throw $err; + } + } + try { + $idx = $this->_parseArrayIndexes($strTokens, $strPtr); + return array ('arr' => $var, 'idx' => $idx); + } catch (Exception $err) { + if ($strPtr !== $startStrPtr) { + throw $err; + } + } + return array ('var' => $var); + }//end _parseVariable() + + + /** + * Grammar rule to parse the use of an object attribute. + * + * _parseObjectAttribute ::= -> + * | ->_parseObjectAttribute() + * | ->_parseArrayIndexes() + * + * @exception Exception raised if $strTokens starting from $strPtr + * doesn't matched the rule. + * + * @param array $strTokens Tokens to parse. + * @param int $strPtr Pointer to the token where parsing starts. + * + * @return mixed The attribute name as a string, an array with indexes + * 'obj' and 'attr' or an array with indexes 'arr' and 'idx'. + */ + private function _parseObjectAttribute ($strTokens, &$strPtr) + { + if (T_OBJECT_OPERATOR !== $strTokens[$strPtr][0]) { + throw new Exception ('Expected ->.'); + } + $strPtr++; + if (T_STRING !== $strTokens[$strPtr][0]) { + throw new Exception ('Expected an object attribute.'); + } + $attr = $strTokens[$strPtr][1]; + $strPtr++; + $startStrPtr = $strPtr; + try { + $sub_attr = $this->_parseObjectAttribute($strTokens, $strPtr); + return array ('obj' => $attr, 'attr' => $sub_attr); + } catch (Exception $err) { + if ($strPtr !== $startStrPtr) { + throw $err; + } + } + try { + $idx = $this->_parseArrayIndexes($strTokens, $strPtr); + return array ('arr' => $attr, 'idx' => $idx); + } catch (Exception $err) { + if ($strPtr !== $startStrPtr) { + throw $err; + } + } + return $attr; + }//end _parseObjectAttribute() + + + /** + * Grammar rule to parse the use of one or more array indexes. + * + * _parseArrayIndexes ::= _parseArrayIndex()+ + * + * @exception Exception raised if $strTokens starting from $strPtr + * doesn't matched the rule. + * + * @param array $strTokens Tokens to parse. + * @param int $strPtr Pointer to the token where parsing starts. + * + * @return array Indexes in the same order as in the string. + */ + private function _parseArrayIndexes ($strTokens, &$strPtr) + { + $indexes = array($this->_parseArrayIndex($strTokens, $strPtr)); + try { + while (1) { + $startStrPtr = $strPtr; + $indexes [] = $this->_parseArrayIndex($strTokens, $strPtr); + } + } catch (Exception $err) { + if (0 !== ($strPtr - $startStrPtr)) { + throw $err; + } + return $indexes; + } + }//end _parseArrayIndexes() + + + /** + * Grammar rule to parse the use of array index. + * + * _parseArrayIndex ::= [] + * + * @exception Exception raised if $strTokens starting from $strPtr + * doesn't matched the rule. + * + * @param array $strTokens Tokens to parse. + * @param int $strPtr Pointer to the token where parsing starts. + * + * @return string Index between the 2 square brackets + */ + private function _parseArrayIndex ($strTokens, &$strPtr) + { + if ('[' !== $strTokens[$strPtr]) { + throw new Exception ('Expected [.'); + } + $strPtr++; + if (! in_array($strTokens[$strPtr][0], array(T_CONSTANT_ENCAPSED_STRING, T_LNUMBER))) { + throw new Exception ('Expected an array index.'); + } + $index = $strTokens[$strPtr][1]; + $strPtr++; + if (']' !== $strTokens[$strPtr]) { + throw new Exception ('Expected ].'); + } + $strPtr++; + return $index; + }//end _parseArrayIndex() + +}//end class + +/** + * CodeIgniter_Sniffs_Strings_VariableUsageSniff. + * + * Ensures that variables parsed in double-quoted strings are enclosed with + * braces to prevent greedy token parsing. + * Single-quoted strings don't parse variables, so there is no risk of greedy + * token parsing. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2011 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ +class DoubleQuoteUsageSniff extends VariableUsageSniff +{ + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_DOUBLE_QUOTED_STRING, + T_CONSTANT_ENCAPSED_STRING, + ); + }//end register() + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * + * @return void + */ + public function process(File $phpcsFile, $stackPtr) + { + // no variable are in the string from here + $tokens = $phpcsFile->getTokens(); + $qtString = $tokens[$stackPtr]['content']; + // makes sure that it is about a double quote string, + // since variables are not parsed out of double quoted string + $open_qt_str = substr($qtString, 0, 1); + + // clean the enclosing quotes + $qtString = substr($qtString, 1, strlen($qtString) - 1 - 1); + + if (0 === strcmp($open_qt_str, '"')) { + $this->processDoubleQuotedString($phpcsFile, $stackPtr, $qtString); + } else if (0 === strcmp($open_qt_str, "'")) { + $this->processSingleQuotedString($phpcsFile, $stackPtr, $qtString); + } + }//end process() + + + /** + * Processes this test, when the token encountered is a double-quoted string. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param string $qtString The double-quoted string content, + * i.e. without quotes. + * + * @return void + */ + protected function processDoubleQuotedString (File $phpcsFile, $stackPtr, $qtString) + { + // so there should be at least a single quote or a special char + // if there are the 2 kinds of quote and no special char, then add a warning + $has_variable = parent::processDoubleQuotedString($phpcsFile, $stackPtr, '"'.$qtString.'"'); + $has_specific_sequence = $this->_hasSpecificSequence($qtString); + $dbl_qt_at = strpos($qtString, '"'); + $smpl_qt_at = strpos($qtString, "'"); + if (false === $has_variable && false === $has_specific_sequence + && false === $smpl_qt_at + ) { + $error = 'Single-quoted strings should be used unless it contains variables, special chars like \n or single quotes.'; + $phpcsFile->addError($error, $stackPtr); + } else if (false !== $smpl_qt_at && false !== $dbl_qt_at + && false === $has_variable && false === $has_specific_sequence + ) { + $warning = 'It is encouraged to use a single-quoted string, since it doesn\'t contain any variable nor special char though it mixes single and double quotes.'; + $phpcsFile->addWarning($warning, $stackPtr); + } + }//end processDoubleQuotedString() + + + /** + * Processes this test, when the token encountered is a single-quoted string. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param string $qtString The single-quoted string content, + * i.e. without quotes. + * + * @return void + */ + protected function processSingleQuotedString (File $phpcsFile, $stackPtr, $qtString) + { + // if there is single quotes without additional double quotes, + // then user is allowed to use double quote to avoid having to + // escape single quotes. Don't add the warning, if an error was + // already added, because a variable was found in a single-quoted + // string. + $has_variable = parent::processSingleQuotedString($phpcsFile, $stackPtr, "'".$qtString."'"); + $dbl_qt_at = strpos($qtString, '"'); + $smpl_qt_at = strpos($qtString, "'"); + if (false === $has_variable && false !== $smpl_qt_at && false === $dbl_qt_at) { + $warning = 'You may also use double-quoted strings if the string contains single quotes, so you do not have to use escape characters.'; + $phpcsFile->addWarning($warning, $stackPtr); + } + }//end processSingleQuotedString() + + /** + * Return TRUE, if a sequence of chars that is parsed in a specific way + * in double-quoted strings is found, FALSE otherwise. + * + * @param string $string String in which sequence of special chars will + * be researched. + * + * @return TRUE, if a sequence of chars that is parsed in a specific way + * in double-quoted strings is found, FALSE otherwise. + * + * @link http://www.php.net/manual/en/language.types.string.php#language.types.string.syntax.double + */ + private function _hasSpecificSequence($string) + { + $hasSpecificSequence = FALSE; + $specialMeaningStrs = array('\n', '\r', '\t', '\v', '\f'); + foreach ($specialMeaningStrs as $splStr) { + if (FALSE !== strpos($string, $splStr)) { + $hasSpecificSequence = TRUE; + } + } + $specialMeaningPtrns = array('\[0-7]{1,3}', '\x[0-9A-Fa-f]{1,2}'); + foreach ($specialMeaningPtrns as $splPtrn) { + if (1 === preg_match("/{$splPtrn}/", $string)) { + $hasSpecificSequence = TRUE; + } + } + return $hasSpecificSequence; + }//end _hasSpecificSequence() + +}//end class + +?> diff --git a/build/CodeIgniter/Sniffs/WhiteSpace/DisallowSpaceIndentSniff.php b/build/CodeIgniter/Sniffs/WhiteSpace/DisallowSpaceIndentSniff.php new file mode 100755 index 0000000..933dcca --- /dev/null +++ b/build/CodeIgniter/Sniffs/WhiteSpace/DisallowSpaceIndentSniff.php @@ -0,0 +1,87 @@ + + * @copyright 2011 Thomas ERNEST + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_WhiteSpace_DisallowSpaceIndentSniff. + * + * Ensures the use of tabs for indentation. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2011 Thomas ERNEST + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\WhiteSpace; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class DisallowSpaceIndentSniff implements Sniff +{ + + /** + * A list of tokenizers this sniff supports. + * + * @var array + */ + public $supportedTokenizers = array( + 'PHP', + 'JS', + 'CSS', + ); + + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array(T_WHITESPACE); + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile All the tokens found in the document. + * @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(); + + // Make sure this is whitespace used for indentation. + $line = $tokens[$stackPtr]['line']; + if ($stackPtr > 0 && $tokens[($stackPtr - 1)]['line'] === $line) { + return; + } + + if (strpos($tokens[$stackPtr]['content'], " ") !== false) { + $error = 'Tabs must be used to indent lines; spaces are not allowed for code indentation'; + $phpcsFile->addError($error, $stackPtr, 'SpacesUsedForIndentation'); + } + }//end process() + + +}//end class + +?> diff --git a/build/CodeIgniter/Sniffs/WhiteSpace/DisallowWitheSpaceAroundPhpTagsSniff.php b/build/CodeIgniter/Sniffs/WhiteSpace/DisallowWitheSpaceAroundPhpTagsSniff.php new file mode 100755 index 0000000..615271e --- /dev/null +++ b/build/CodeIgniter/Sniffs/WhiteSpace/DisallowWitheSpaceAroundPhpTagsSniff.php @@ -0,0 +1,95 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_WhiteSpace_DisallowWitheSpaceAroundPhpTagsSniff. + * + * Ensures that no whitespace precedes the opening PHP tag + * or follows the closing PHP tag. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\WhiteSpace; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class DisallowWitheSpaceAroundPhpTagsSniff implements Sniff +{ + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_OPEN_TAG, + T_CLOSE_TAG + ); + + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @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(); + + $php_tag_token = $tokens[$stackPtr]; + $php_tag_code = $php_tag_token['code']; + + if (T_OPEN_TAG === $php_tag_code) { + // opening php tag should be the first token. + // any whitespace beofre an opening php tag is tokenized + // as T_INLINE_HTML, so no need to check the content of the token. + $isFirst = 0 === $stackPtr; + if ( ! $isFirst) { + $error = 'Any char before the opening PHP tag is prohibited. Please remove newline or indentation before the opening PHP tag.'; + $phpcsFile->addError($error, $stackPtr); + } + } else { + // if (T_CLOSE_TAG === $php_tag_code) + // closing php tag should be the last token + // and it must not contain any whitespace. + $php_tag_string = $php_tag_token['content']; + $isLast = count($tokens) - 1 === $stackPtr; + // both of the two closing php tags contains 2 chars exactly. + $containsEndTagOnly = strlen($php_tag_string) > 2; + if ( ! $isLast || ! $containsEndTagOnly ) { + $error = 'Any char after the closing PHP tag is prohibited. Please removes newline or spaces after the closing PHP tag.'; + $phpcsFile->addError($error, $stackPtr); + } + } + }//end process() + + +}//end class + +?> \ No newline at end of file diff --git a/build/CodeIgniter/Sniffs/WhiteSpace/ElseOnNewLineSniff.php b/build/CodeIgniter/Sniffs/WhiteSpace/ElseOnNewLineSniff.php new file mode 100644 index 0000000..03687d7 --- /dev/null +++ b/build/CodeIgniter/Sniffs/WhiteSpace/ElseOnNewLineSniff.php @@ -0,0 +1,82 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_WhiteSpace_ElseOnNewLineSniff. + * + * Ensures that control structures else and elseif stand on new lines. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\WhiteSpace; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class ElseOnNewLineSniff implements Sniff +{ + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_ELSE, + T_ELSEIF, + ); + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @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(); + + $else_token = $tokens[$stackPtr]; + $previous_non_blank_token_ptr = $phpcsFile->findPrevious(array(T_WHITESPACE), $stackPtr - 1, null, true); + + if (false === $previous_non_blank_token_ptr) { + // else is no preceded with any symbol, but it is not the responsibility of this sniff. + return; + } + + $previous_non_blank_token = $tokens[$previous_non_blank_token_ptr]; + if ($previous_non_blank_token['line'] === $else_token['line']) { + $error = '"' . $else_token['content'] . '" should be on a new line.'; + $phpcsFile->addError($error, $stackPtr); + } + + }//end process() + + +}//end class + +?> \ No newline at end of file diff --git a/build/CodeIgniter/Sniffs/WhiteSpace/LogicalNotSpacingSniff.php b/build/CodeIgniter/Sniffs/WhiteSpace/LogicalNotSpacingSniff.php new file mode 100755 index 0000000..2e242e4 --- /dev/null +++ b/build/CodeIgniter/Sniffs/WhiteSpace/LogicalNotSpacingSniff.php @@ -0,0 +1,75 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_WhiteSpace_LogicalNotSpacingSniff. + * + * Ensures that at exactly a space precedes and follows the logical operator !. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\WhiteSpace; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class LogicalNotSpacingSniff implements Sniff +{ + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_BOOLEAN_NOT, + ); + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @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(); + + $operator_token = $tokens[$stackPtr]; + + $previous_token = $tokens[$stackPtr - 1]; + $next_token = $tokens[$stackPtr + 1]; + if (T_WHITESPACE !== $previous_token['code'] || T_WHITESPACE !== $next_token['code']) { + $error = 'Logical operator ! should always be preceded and followed with a whitespace.'; + $phpcsFile->addError($error, $stackPtr); + } + }//end process() + + +}//end class + +?> \ No newline at end of file diff --git a/build/CodeIgniter/UnusedSniffs/Files/AbstractClosingCommentSniff.php b/build/CodeIgniter/UnusedSniffs/Files/AbstractClosingCommentSniff.php new file mode 100644 index 0000000..dfdde6f --- /dev/null +++ b/build/CodeIgniter/UnusedSniffs/Files/AbstractClosingCommentSniff.php @@ -0,0 +1,104 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Files_AbstractClosingCommentSniff. + * + * Defines some methods used by + * CodeIgniter_Sniffs_Files_ClosingFileCommentSniff + * and CodeIgniter_Sniffs_Files_ClosingLocationCommentSniff. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Files; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class AbstractClosingCommentSniff implements Sniff +{ + /** + * As an abstract class, this sniff is not associated to any token. + */ + public function register() + { + return array(); + } + + /** + * As an abstract class, this sniff is not dedicated to process a token. + */ + public function process(File $phpcsFile, $stackPtr) + { + $error = __CLASS__.'::'.__METHOD__.' is abstract. Please develop this method in a child class.'; + throw new PHP_CodeSniffer_Exception($error); + } + + /** + * Returns the comment without its delimiter(s) as well as leading + * and traling whitespaces. + * + * It removes the first #, the two first / (i.e. //) or the first /* + * and last \*\/. If a comment starts with /**, then the last * will remain + * as well as whitespaces between this star and the comment content. + * + * @param string $comment Comment containing either comment delimiter(s) and + * trailing or leading whitspaces to clean. + * + * @return string Comment without comment delimiter(s) and whitespaces. + */ + protected static function _getCommentContent ($comment) + { + if (self::_stringStartsWith($comment, '#')) { + $comment = substr($comment, 1); + } else if (self::_stringStartsWith($comment, '//')) { + $comment = substr($comment, 2); + } else if (self::_stringStartsWith($comment, '/*')) { + $comment = substr($comment, 2, strlen($comment) - 2 - 2); + } + $comment = trim($comment); + return $comment; + }//_getCommentContent() + + + /** + * Binary safe string comparison between $needle and + * the beginning of $haystack. Returns true if $haystack starts with + * $needle, false otherwise. + * + * @param string $haystack The string to search in. + * @param string $needle The string to search for. + * + * @return bool true if $haystack starts with $needle, false otherwise. + */ + protected static function _stringStartsWith ($haystack, $needle) + { + $startsWith = false; + if (strlen($needle) <= strlen($haystack)) { + $haystackBeginning = substr($haystack, 0, strlen($needle)); + if (0 === strcmp($haystackBeginning, $needle)) { + $startsWith = true; + } + } + return $startsWith; + }//_stringStartsWith() +}//end class + +?> diff --git a/build/CodeIgniter/UnusedSniffs/Files/ClosingFileCommentSniff.php b/build/CodeIgniter/UnusedSniffs/Files/ClosingFileCommentSniff.php new file mode 100755 index 0000000..d060e08 --- /dev/null +++ b/build/CodeIgniter/UnusedSniffs/Files/ClosingFileCommentSniff.php @@ -0,0 +1,109 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Files_ClosingFileCommentSniff. + * + * Ensures that a comment containing the file name is available at the end of file. + * Only other comments and whitespaces are allowed to follow this specific comment. + * + * It may be all kind of comment like multi-line and inline C-style comments as + * well as PERL-style comments. Any number of white may separate comment delimiters + * from comment content. However, content has to be equal to template + * "End of file ". Comparison between content and template is + * case-sensitive. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Files; + +use PHP_CodeSniffer\Files\File; + +class ClosingFileCommentSniff extends AbstractClosingCommentSniff +{ + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_OPEN_TAG, + ); + + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * + * @return void + */ + public function process(File $phpcsFile, $stackPtr) + { + // We are only interested if this is the first open tag. + if ($stackPtr !== 0) { + if ($phpcsFile->findPrevious(T_OPEN_TAG, ($stackPtr - 1)) !== false) { + return; + } + } + + $fullFilename = $phpcsFile->getFilename(); + $filename = basename($fullFilename); + $commentTemplate = "End of file $filename"; + + $tokens = $phpcsFile->getTokens(); + $currentToken = count($tokens) - 1; + $hasClosingFileComment = false; + $isNotAWhitespaceOrAComment = false; + while ($currentToken >= 0 + && ! $isNotAWhitespaceOrAComment + && ! $hasClosingFileComment + ) { + $token = $tokens[$currentToken]; + $tokenCode = $token['code']; + if (T_COMMENT === $tokenCode) { + $commentString = self::_getCommentContent($token['content']); + if (0 === strcmp($commentString, $commentTemplate)) { + $hasClosingFileComment = true; + } + } else if (T_WHITESPACE === $tokenCode) { + // Whitespaces are allowed between the closing file comment, + // other comments and end of file + } else { + $isNotAWhitespaceOrAComment = true; + } + $currentToken--; + } + + if ( ! $hasClosingFileComment) { + $error = 'No comment block marks the end of file instead of the closing PHP tag. Please add a comment block containing only "' . $commentTemplate . '".'; + $phpcsFile->addError($error, $currentToken); + } + }//end process() +}//end class + +?> diff --git a/build/CodeIgniter/UnusedSniffs/Files/ClosingLocationCommentSniff.php b/build/CodeIgniter/UnusedSniffs/Files/ClosingLocationCommentSniff.php new file mode 100755 index 0000000..ed84211 --- /dev/null +++ b/build/CodeIgniter/UnusedSniffs/Files/ClosingLocationCommentSniff.php @@ -0,0 +1,182 @@ + + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_Files_ClosingLocationCommentSniff. + * + * Ensures that a comment containing the file location exists at the end of file. + * Only other comments and whitespaces are allowed between this comment and + * the end of file. + * + * It may be all kind of comment like multi-line and inline C-style comments as + * well as PERL-style comments. Any number of white may separate comment delimiters + * from comment content. However, content has to be equal to template + * "Location: ". + * Comparison between content and template is case-sensitive. + * + * There are several ways to configure the application root. In order of priority : + * - Configuration variable ci_application_root. + * - Rule property applicationRoot. + * - Default value '/application/' + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2006 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\Files; + +use PHP_CodeSniffer\Files\File; +use PHP_CodeSniffer\Util\Common; + +class ClosingLocationCommentSniff extends AbstractClosingCommentSniff +{ + public $applicationRoot = '/application/'; + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_OPEN_TAG + ); + + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * + * @return void + */ + public function process(File $phpcsFile, $stackPtr) + { + // We are only interested if this is the first open tag. + if ($stackPtr !== 0) { + if ($phpcsFile->findPrevious(T_OPEN_TAG, ($stackPtr - 1)) !== false) { + return; + } + } + + $filePath = $phpcsFile->getFilename(); + $tokens = $phpcsFile->getTokens(); + // removes the application root from the beginning of the file path + $locationPath = self::_getLocationPath($filePath, $this->_getAppRoot()); + // add an error, if application root doesn't exist in current file path + if (false === $locationPath) { + $error = 'Unable to find "' . $this->_getAppRoot() . '" in file path "' . $filePath . '". Please set your project\'s application root.'; + $phpcsFile->addError($error, count($tokens) - 1); + return; + } + // generates the expected comment + $commentTemplate = "Location: $locationPath"; + + $currentToken = count($tokens) - 1; + $hasClosingLocationComment = false; + $isNotAWhitespaceOrAComment = false; + while ($currentToken >= 0 + && ! $isNotAWhitespaceOrAComment + && ! $hasClosingLocationComment + ) { + $token = $tokens[$currentToken]; + $tokenCode = $token['code']; + if (T_COMMENT === $tokenCode) { + $commentString = self::_getCommentContent($token['content']); + if (0 === strcmp($commentString, $commentTemplate)) { + $hasClosingLocationComment = true; + } + } else if (T_WHITESPACE === $tokenCode) { + // Whitespaces are allowed between the closing file comment, + //other comments and end of file + } else { + $isNotAWhitespaceOrAComment = true; + } + $currentToken--; + } + + if ( ! $hasClosingLocationComment) { + $error = 'No comment block marks the end of file instead of the closing PHP tag. Please add a comment block containing only "' . $commentTemplate . '".'; + $phpcsFile->addError($error, $currentToken); + } + }//end process() + + + /** + * Returns the relative path from $appRoot to $filePath, or false if + * $appRoot cannot be found in $filePath, because $appRoot is not a parent + * of $filePath. + * + * @param string $filePath Full path to the file being proceed. + * @param string $appRoot Partial or full path to the CodeIgniter + * application root of the file being proceed. It must not contain the + * full path to the application root, but at least the name of the + * application root. Parent directory of the application root are allowed + * but not mandatory. + * + * @return string|bool The relative path from $appRoot to $filePath, or + * false if $appRoot cannot be found in $filePath. + */ + private static function _getLocationPath ($filePath, $appRoot) + { + // removes the path to application root + // from the beginning of the file path + $appRootAt = strpos($filePath, $appRoot); + if (false === $appRootAt) { + return false; + } + $localPath = substr($filePath, $appRootAt + strlen($appRoot)); + // ensures the location path to be a relative path starting with "./". + if ( ! self::_stringStartsWith($localPath, './')) { + $localPath = './' . $localPath; + } else if ( ! self::_stringStartsWith($localPath, '.') + && self::_stringStartsWith($localPath, '/') + ) { + $localPath = '.' . $localPath; + } + return $localPath; + }//end _getLocationPath() + + + /** + * Returns the application root that should be used first. + * + * There are several ways to configure the application root. + * In order of priority : + * - Configuration variable ci_application_root. + * - Rule property applicationRoot. + * - Default value '/application/' + * + * @return string Path to your project application root. + */ + private function _getAppRoot() + { + $appRoot = Common::getConfigData('ci_application_root'); + if (null === $appRoot) { + $appRoot = $this->applicationRoot; + } + return $appRoot; + }//end _getAppRoot() +}//end class + +?> diff --git a/build/CodeIgniter/UnusedSniffs/NamingConventions/ConstructorNameSniff.php b/build/CodeIgniter/UnusedSniffs/NamingConventions/ConstructorNameSniff.php new file mode 100755 index 0000000..983bb28 --- /dev/null +++ b/build/CodeIgniter/UnusedSniffs/NamingConventions/ConstructorNameSniff.php @@ -0,0 +1,142 @@ + + * @copyright 2011 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\NamingConventions; + +use PHP_CodeSniffer\Sniffs\AbstractScopeSniff; +use PHP_CodeSniffer\Files\File; + +/** + * CodeIgniter_Sniffs_NamingConventions_ConstructorNameSniff. + * + * Favor PHP 4 constructor syntax, which uses "function ClassName()". + * Avoid PHP 5 constructor syntax, which uses "function __construct()". + * + * @todo Try to avoid overly long and verbose names. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2010 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ +class ConstructorNameSniff extends AbstractScopeSniff +{ + + + public $php5Constructors = '1'; + + + /** + * Constructs the test with the tokens it wishes to listen for. + * + * @return void + */ + public function __construct() + { + parent::__construct(array(T_CLASS, T_INTERFACE), array(T_FUNCTION), true); + + }//end __construct() + + + /** + * Processes this test when one of its tokens is encountered. + * + * @param File $phpcsFile The current file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param int $currScope A pointer to the start of the scope. + * + * @return void + */ + protected function processTokenWithinScope( + File $phpcsFile, + $stackPtr, + $currScope + ) { + $methodName = $phpcsFile->getDeclarationName($stackPtr); + $className = $phpcsFile->getDeclarationName($currScope); + + $isPhp4Constructor = strcasecmp($methodName, $className) === 0; + $isPhp5Constructor = strcasecmp($methodName, '__construct') === 0; + if ($this->php5Constructors != '0') { + if ($isPhp4Constructor) { + $error = "PHP4 style constructors are not allowed; use \"__construct\" instead"; + $phpcsFile->addError($error, $stackPtr); + } + } else { + if ($isPhp5Constructor) { + $error = "PHP5 style constructors are not allowed; use \"$className\" instead"; + $phpcsFile->addError($error, $stackPtr); + } + } + if ( ! $isPhp4Constructor && ! $isPhp5Constructor ) { + return; + } + + $tokens = $phpcsFile->getTokens(); + + $parentClassName = $phpcsFile->findExtendedClassName($currScope); + $wrongConstructor = ''; + // prepares the error message and wrong constructor + if ($this->php5Constructors != '0') { + $error = 'PHP4 style calls to parent constructors are not allowed.'; + $error = "$error Please use \"parent::__construct\" instead."; + if (false !== $parentClassName) { + $wrongConstructor = $parentClassName; + } + // Else $wrongConstructor will be empty + // and the test expression will always be false. + // It doesn't check that no parent method should be called + // when no parent class is defined. + } else { + $error = 'PHP5 style calls to parent constructors are not allowed.'; + if (false !== $parentClassName) { + $error = "$error Please use \"parent::$parentClassName\" instead."; + } + $wrongConstructor = '__construct'; + } + + // looks for the use of a wrong constructor. + $endFunctionIndex = $tokens[$stackPtr]['scope_closer']; + $doubleColonIndex = $phpcsFile->findNext( + array(T_DOUBLE_COLON), + $stackPtr, + $endFunctionIndex + ); + while ($doubleColonIndex) { + if ($tokens[($doubleColonIndex + 1)]['code'] === T_STRING + && $tokens[($doubleColonIndex + 1)]['content'] === $wrongConstructor + ) { + $phpcsFile->addError($error, ($doubleColonIndex + 1)); + } + + $doubleColonIndex = $phpcsFile->findNext( + array(T_DOUBLE_COLON), + $doubleColonIndex + 1, + $endFunctionIndex + ); + } + + }//end processTokenWithinScope() + + protected function processTokenOutsideScope(File $phpcsFile, $stackPtr) + { + // TODO: Implement processTokenOutsideScope() method. + } + +}//end class + +?> diff --git a/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidClassNameSniff.php b/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidClassNameSniff.php new file mode 100755 index 0000000..2b24327 --- /dev/null +++ b/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidClassNameSniff.php @@ -0,0 +1,84 @@ + + * @copyright 2010 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_NamingConventions_ValidClassNameSniff. + * + * Ensures that class and interface names have their first letter uppercase + * and that words are separated with an underscore, and not CamelCased. + * + * @todo Try to avoid overly long and verbose names in using property rule and + * configuration variable to set limits. Have a look at + * CodeIgniter_Sniffs_NamingConventions_ValidMethodNameSniff. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2010 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\NamingConventions; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class ValidClassNameSniff implements Sniff +{ + + + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_CLASS, + T_INTERFACE, + ); + + }//end register() + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param 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) + { + // get the class name + $className = trim($phpcsFile->getDeclarationName($stackPtr)); + // compute the expected class name + // [^_] means "something different from _", but not "nothing or something different from _" + $lcClassNameChunk = preg_replace('/([^_])([A-Z])/', '${1}_${2}', $className); + $expectedClassName + = strtoupper($className[0]) . strtolower(substr($lcClassNameChunk,1)); + // ensures that the current class name + // and the expected class name are identical + if (0 !== strcmp($className, $expectedClassName)) { + $error = 'Class names should always have their first letter uppercase. Multiple words should be separated with an underscore, and not CamelCased. Please consider ' . $expectedClassName . ' instead of ' . $className . '.'; + $phpcsFile->addError($error, $stackPtr); + } + }//end process() + +}//end class + +?> diff --git a/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidFileNameSniff.php b/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidFileNameSniff.php new file mode 100644 index 0000000..7f10fa4 --- /dev/null +++ b/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidFileNameSniff.php @@ -0,0 +1,84 @@ + + * @copyright 2011 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +/** + * CodeIgniter_Sniffs_NamingConventions_ValidFileNameSniff. + * + * Tests that the file name matchs the name of the class that it contains in lower case. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2011 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\NamingConventions; + +use PHP_CodeSniffer\Sniffs\Sniff; +use PHP_CodeSniffer\Files\File; + +class ValidFileNameSniff implements Sniff +{ + /** + * Returns an array of tokens this test wants to listen for. + * + * @return array + */ + public function register() + { + return array( + T_CLASS, + T_INTERFACE, + ); + }//end register() + + + /** + * Processes this test, when one of its tokens is encountered. + * + * @param File $phpcsFile The file being scanned. + * @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(); + // computes the expected filename based on the name of the class or interface that it contains. + $decNamePtr = $phpcsFile->findNext(T_STRING, $stackPtr); + $decName = $tokens[$decNamePtr]['content']; + $expectedFileName = strtolower($decName); + // extracts filename without extension from its path. + $fullPath = $phpcsFile->getFilename(); + $fileNameAndExt = basename($fullPath); + $fileName = substr($fileNameAndExt, 0, strrpos($fileNameAndExt, '.')); + + if ($expectedFileName !== $fileName) { + $errorTemplate = 'Filename "%s" doesn\'t match the name of the %s that it contains "%s" in lower case. "%s" was expected.'; + $errorMessage = sprintf( + $errorTemplate, + $fileName, + strtolower($tokens[$stackPtr]['content']), // class or interface + $decName, + $expectedFileName + ); + $phpcsFile->addError($errorMessage, 0); + } + }//end process() +}//end class + +?> diff --git a/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidMethodNameSniff.php b/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidMethodNameSniff.php new file mode 100755 index 0000000..34e973c --- /dev/null +++ b/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidMethodNameSniff.php @@ -0,0 +1,161 @@ + + * @copyright 2010 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ +/** + * CodeIgniter_Sniffs_NamingConventions_ValidMethodNameSniff. + * + * Ensures that class methods and functions areentirely lowercased and that + * words are separated with an underscore, and not CamelCased. + * Ensures that private class methods are prefixed with an underscore and that + * all other methods are not prefixed with an underscored. + * Ensures that names longer than 50 chars are prohibited. Likewise names longer + * than 35 chars raise a warning. + * + * @todo Use a rule property or a configuration variable to allow users to set + * their own maximum lengths for function and method names. Have a look at + * CodeIgniter_Sniffs_Files_ClosingLocationCommentSniff and application root. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2010 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ + +namespace CodeIgniter\Sniffs\NamingConventions; + +use PHP_CodeSniffer\Sniffs\AbstactScopeSniff; +use PHP_CodeSniffer\Files\File; + +class ValidMethodNameSniff extends AbstractScopeSniff +{ + /** + * A list of all PHP magic methods. + * + * @var array + */ + protected static $magicMethods = array( + 'construct', + 'destruct', + 'call', + 'callStatic', + 'get', + 'set', + 'isset', + 'unset', + 'sleep', + 'wakeup', + 'toString', + 'set_state', + 'clone', + ); + + /** + * Defines which token(s) in which scope(s) will be proceed. + */ + public function __construct() + { + parent::__construct(array(T_CLASS, T_INTERFACE), array(T_FUNCTION), true); + + }//end __construct() + + + /** + * Processes the tokens within the scope. + * + * @param File $phpcsFile The file being processed. + * @param int $stackPtr The position where this token was + * found. + * @param int $currScope The position of the current scope. + * + * @return void + */ + protected function processTokenWithinScope(File $phpcsFile, $stackPtr, $currScope) + { + $methodName = $phpcsFile->getDeclarationName($stackPtr); + if ($methodName === null) { + // Ignore closures. + return; + } + + $className = $phpcsFile->getDeclarationName($currScope); + + // Is this a magic method i.e. is prefixed with "__". + if (0 === strcmp(substr($methodName, 0, 2), '__')) { + $magicPart = substr($methodName, 2); + if (in_array($magicPart, self::$magicMethods) === false) { + $error = "Method name \"$className::$methodName\" is invalid; only PHP magic methods should be prefixed with a double underscore"; + $phpcsFile->addError($error, $stackPtr); + } + + return; + } + + // PHP4 constructors are allowed to break our rules. + if ($methodName === $className) { + return; + } + + // PHP4 destructors are allowed to break our rules. + if ($methodName === '_'.$className) { + return; + } + + if (0 !== strcmp($methodName, strtolower($methodName))) { + $uscrdMethodName = preg_replace('/([A-Z])/', '_${1}', $methodName); + $expectedMethodName = strtolower($uscrdMethodName); + $error = "Class methods should be entirely lowercased. Please consider \"$expectedMethodName\" instead of \"$methodName\"."; + $phpcsFile->addError($error, $stackPtr); + return; + } + + $methodProps = $phpcsFile->getMethodProperties($stackPtr); + $scope = $methodProps['scope']; + $scopeSpecified = $methodProps['scope_specified']; + + // If it's a private method, it must have an underscore on the front. + if ($scope === 'private' && $methodName{0} !== '_') { + $error = "Private method name \"$className::$methodName\" must be prefixed with an underscore"; + $phpcsFile->addError($error, $stackPtr); + return; + } + + // If it's not a private method, it must not have an underscore on the front. + if ($scope !== 'private' && $methodName{0} === '_') { + if (true === $scopeSpecified) { + $error = "Public method name \"$className::$methodName\" must not be prefixed with an underscore"; + } else { + $error = ucfirst($scope)." method name \"$className::$methodName\" must not be prefixed with an underscore"; + } + $phpcsFile->addError($error, $stackPtr); + return; + } + + // If name is too verbose, + // then either an error or a warning is displayed. + $error_limit = 50; + $warning_limit = 35; + if (strlen($methodName) > $error_limit) { + $error = "Overly long and verbose names are prohibited. Please find a name shorter than $error_limit chars."; + $phpcsFile->addError($error, $stackPtr); + return; + } else if (strlen($methodName) > $warning_limit) { + $warning = "Try to avoid overly long and verbose names in finding a name shorter than $warning_limit chars."; + $phpcsFile->addWarning($warning, $stackPtr); + } + }//end processTokenWithinScope() + +}//end class + +?> diff --git a/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidVariableNameSniff.php b/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidVariableNameSniff.php new file mode 100755 index 0000000..c4d8798 --- /dev/null +++ b/build/CodeIgniter/UnusedSniffs/NamingConventions/ValidVariableNameSniff.php @@ -0,0 +1,562 @@ + + * @copyright 2010 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ +/** + * CodeIgniter_Sniffs_NamingConventions_ValidVariableNameSniff. + * + * Ensures that variable names contain only lowercase letters, + * use underscore separators. + * Ensures that class attribute names are prefixed with an underscore, + * only when they are private. + * Ensure that variable names are longer than 3 chars except those declared + * in for loops. + * + * @todo Try to avoid overly long and verbose names in using property rule and + * configuration variable to set limits. Have a look at + * CodeIgniter_Sniffs_NamingConventions_ValidMethodNameSniff. + * @todo Use a property rule or a configuration variable to allow users to set + * minimum variable name length. Have a look at + * CodeIgniter_Sniffs_Files_ClosingLocationCommentSniff and application root. + * + * @category PHP + * @package PHP_CodeSniffer + * @author Thomas Ernest + * @copyright 2010 Thomas Ernest + * @license http://thomas.ernest.fr/developement/php_cs/licence GNU General Public License + * @link http://pear.php.net/package/PHP_CodeSniffer + */ +namespace CodeIgniter\Sniffs\NamingConventions; + +use PHP_CodeSniffer\Sniffs\AbstractVariableSniff; +use PHP_CodeSniffer\Files\File; + +class ValidVariableNameSniff extends AbstractVariableSniff +{ + + + /** + * Processes class member variables. + * + * @param File $phpcsFile The file being scanned. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * + * @return void + */ + protected function processMemberVar(File $phpcsFile, $stackPtr) + { + // get variable name and properties + $tokens = $phpcsFile->getTokens(); + $varTk = $tokens[$stackPtr]; + $varName = substr($varTk['content'], 1); + $varProps = $phpcsFile->getMemberProperties($stackPtr); + // check(s) + if ( ! $this->checkLowerCase($phpcsFile, $stackPtr, $varName) ) { + return; + } + if ( ! $this->checkVisibilityPrefix($phpcsFile, $stackPtr, $varName, $varProps)) { + return; + } + if ( ! $this->checkLength($phpcsFile, $stackPtr, $varName)) { + return; + } + + }//end processMemberVar() + + + /** + * Processes normal variables. + * + * @param File $phpcsFile The file where this token was found. + * @param int $stackPtr The position where the token was found. + * + * @return void + */ + protected function processVariable(File $phpcsFile, $stackPtr) + { + // get variable name + $tokens = $phpcsFile->getTokens(); + $varTk = $tokens[$stackPtr]; + $varName = substr($varTk['content'], 1); + // skip the current object variable, i.e. $this + if (0 === strcmp($varName, 'this')) { + return; + } + // check(s) + if ( ! $this->checkLowerCase($phpcsFile, $stackPtr, $varName)) { + return; + } + if ( ! $this->checkLength($phpcsFile, $stackPtr, $varName)) { + return; + } + + }//end processVariable() + + + /** + * Processes variables in double quoted strings. + * + * @param File $phpcsFile The file where this token was found. + * @param int $stackPtr The position where the token was found. + * + * @return void + */ + protected function processVariableInString(File $phpcsFile, $stackPtr) + { + $tokens = $phpcsFile->getTokens(); + $stringTk = $tokens[$stackPtr]; + $stringString = $stringTk['content']; + $varAt = self::_getVariablePosition($stringString, 0); + while (false !== $varAt) { + // get variable name + $matches = array(); + preg_match('/^\$\{?([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\}?/', substr($stringString, $varAt), $matches); + $varName = $matches[1]; + // check(s) + if ( ! $this->checkLowerCase($phpcsFile, $stackPtr, $varName)) { + return; + } + if ( ! $this->checkLength($phpcsFile, $stackPtr, $varName)) { + return; + } + // prepare checking next variable + $varAt = self::_getVariablePosition($stringString, $varAt + 1); + } + + }//end processVariableInString() + + + /** + * Checks that the variable name is all in lower case, else it add an error + * to $phpcsFile. Returns true if variable name is all in lower case, false + * otherwise. + * + * @param File $phpcsFile The current file being processed. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param string $varName The name of the variable to + * procced without $, { nor }. + * + * @return bool true if variable name is all in lower case, false otherwise. + */ + protected function checkLowerCase(File $phpcsFile, $stackPtr, $varName) + { + $isInLowerCase = true; + if (0 !== strcmp($varName, strtolower($varName))) { + // get the expected variable name + $varNameWithUnderscores = preg_replace('/([A-Z])/', '_${1}', $varName); + $expectedVarName = strtolower(ltrim($varNameWithUnderscores, '_')); + // adapts the error message to the error case + if (strlen($varNameWithUnderscores) > strlen($varName)) { + $error = 'Variables should not use CamelCasing or start with a Capital.'; + } else { + $error = 'Variables should be entirely lowercased.'; + } + $error = $error . 'Please consider "' . $expectedVarName + . '" instead of "' . $varName . '".'; + // adds the error and changes return value + $phpcsFile->addError($error, $stackPtr); + $isInLowerCase = false; + } + return $isInLowerCase; + }//end checkLowerCase() + + /** + * Checks that an underscore is used at the beginning of a variable only if + * it is about a private variable. If it isn't a private variable, then it + * must not be prefixed with an underscore. Returns true if $varName is + * properly prefixed according to the variable visibility provided in + * $varProps, false otherwise. + * + * @param File $phpcsFile The current file being processed. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param string $varName The name of the variable to + * procced without $, { nor }. + * @param array $varProps Member variable properties like + * its visibility. + * + * @return bool true if variable name is prefixed with an underscore only + * when it is about a private variable, false otherwise. + */ + protected function checkVisibilityPrefix(File $phpcsFile, $stackPtr, $varName, $varProps) + { + $isVisibilityPrefixRight = true; + $scope = $varProps['scope']; + // If it's a private variable, it must have an underscore on the front. + if ($scope === 'private' && $varName{0} !== '_') { + $error = "Private variable name \"$varName\" must be prefixed with an underscore"; + $phpcsFile->addError($error, $stackPtr); + $isVisibilityPrefixRight = false; + } else if ($scope !== 'private' && $varName{0} === '_') { + // If it's not a private variable, + // then it must not start with an underscore. + if (isset ($scopeSpecified) && true === $scopeSpecified) { + $error = "Public variable name \"$varName\" must not be prefixed with an underscore"; + } else { + $error = ucfirst($scope) . " variable name \"$varName\" must not be prefixed with an underscore"; + } + $phpcsFile->addError($error, $stackPtr); + $isVisibilityPrefixRight = false; + } + return $isVisibilityPrefixRight; + }//end checkVisibilityPrefix() + + /** + * Checks that variable name length is not too short. Returns true, if it + * meets minimum length requirement, false otherwise. + * + * A variable name is too short if it is shorter than the minimal + * length and it isn't in the list of allowed short names nor declared in a + * for loop (in which it would be nested). + * The minimal length is defined in the function. It is 3 chars now. + * The list of allowed short names is defined in the function. + * It is case-sensitive. It contains only 'ci' now. + * + * @param File $phpcsFile The current file being processed. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param string $varName The name of the variable to + * procced without $, { nor }. + * + * @return bool false if variable name $varName is shorter than the minimal + * length and it isn't in the list of allowed short names nor declared in a + * for loop (in which it would be nested), otherwise true. + */ + protected function checkLength(File $phpcsFile, $stackPtr, $varName) + { + $minLength = 3; + $allowedShortName = array('ci'); + + $isLengthRight = true; + // cleans variable name + $varName = ltrim($varName, '_'); + if (strlen($varName) <= $minLength) { + // skips adding an error, if it is a specific variable name + if (in_array($varName, $allowedShortName)) { + return $isLengthRight; + } + // skips adding an error, if the variable is in a for loop + if (false !== self::_isInForLoop($phpcsFile, $stackPtr, $varName)) { + return $isLengthRight; + } + // adds the error message finally + $error = 'Very short' + . ( + $minLength > 0 ? + ' (i.e. less than ' . ($minLength + 1) . ' chars)' + : '' + ) + . ', non-word variables like "' . $varName + . '" should only be used as iterators in for() loops.'; + $phpcsFile->addError($error, $stackPtr); + $isLengthRight = false; + } + return $isLengthRight; + }//end checkLength() + + /** + * Returns the position of closest previous T_FOR, if token associated with + * $stackPtr in $phpcsFile is in a for loop, otherwise false. + * + * @param File $phpcsFile The current file being processed. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * @param string $varName The name of the variable to + * procced without $, { nor }. + * + * @return int|bool Position of T_FOR if token associated with $stackPtr in + * $phpcsFile is in the head of a for loop, otherwise false. + */ + private static function _isInForLoop(File $phpcsFile, $stackPtr, $varName) + { + $keepLookingFromPtr = $stackPtr; + while (false !== $keepLookingFromPtr) { + // looks if it is in (head or body) of a for loop + $forPtr = self::_isInForLoopHead($phpcsFile, $keepLookingFromPtr); + if (false === $forPtr) { + $forPtr = self::_isInForLoopBody($phpcsFile, $keepLookingFromPtr); + } + // checks if it is declared in here and prepares next step + if (false !== $forPtr) { + if (false !== self::_isDeclaredInForLoop($phpcsFile, $forPtr, $varName)) { + return $forPtr; + } + $keepLookingFromPtr = $forPtr; + } else { + $keepLookingFromPtr = false; + } + } + return false; + }//end _isInForLoop() + + /** + * Returns the position of closest previous T_FOR, if token associated with + * $stackPtr in $phpcsFile is in the head of a for loop, otherwise false. + * The head is the code placed between parenthesis next to the key word + * 'for' : for () {}. + * + * @param File $phpcsFile The current file being processed. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * + * @return int|bool Position of T_FOR if token associated with $stackPtr in + * $phpcsFile is in the head of a for loop, otherwise false. + */ + private static function _isInForLoopHead(File $phpcsFile, $stackPtr) + { + $isInForLoop = false; + $tokens = $phpcsFile->getTokens(); + $currentTk = $tokens[$stackPtr]; + if (array_key_exists('nested_parenthesis', $currentTk)) { + $nestedParenthesis = $currentTk['nested_parenthesis']; + foreach ( $nestedParenthesis as $openParPtr => $closeParPtr) { + $nonWhitspacePtr = $phpcsFile->findPrevious( + array(T_WHITESPACE), + $openParPtr - 1, + null, + true, + null, + true + ); + if (false !== $nonWhitspacePtr) { + $isFor = T_FOR === $tokens[$nonWhitspacePtr]['code']; + if ($isFor) { + $isInForLoop = $nonWhitspacePtr; + break; + } + } + } + } + return $isInForLoop; + }//end _isInForLoopHead() + + /** + * Returns the position of closest previous T_FOR, if token associated with + * $stackPtr in $phpcsFile is in the body of a for loop, otherwise false. + * The body are the instructions placed after parenthesis of a 'for' + * declaration, enclosed with curly brackets usually. + * 'for' : for () {}. + * + * @param File $phpcsFile The current file being processed. + * @param int $stackPtr The position of the current token + * in the stack passed in $tokens. + * + * @return int|bool Position of T_FOR if token associated with $stackPtr in + * $phpcsFile is in the body of a for loop, otherwise false. + */ + private static function _isInForLoopBody(File $phpcsFile, $stackPtr) + { + $isInForLoop = false; + $tokens = $phpcsFile->getTokens(); + // get englobing hierarchy + $parentPtrAndCode = $tokens[$stackPtr]['conditions']; + krsort($parentPtrAndCode); + + // looks for a for loop having a body not enclosed with curly brackets, + // which involves that its body contains only one instruction. + if (is_array($parentPtrAndCode) && ! empty($parentPtrAndCode)) { + $parentCode = reset($parentPtrAndCode); + $parentPtr = key($parentPtrAndCode); + $openBracketPtr = $tokens[$parentPtr]['scope_opener']; + } else { + $parentCode = 0; + $parentPtr = 0; + $openBracketPtr = 0; + } + $openResearchScopePtr = $stackPtr; + // recursive search, since a for statement may englobe other inline + // control statement or may be near to function calls, etc... + while (false !== $openResearchScopePtr) { + $closeParPtr = $phpcsFile->findPrevious( + array(T_CLOSE_PARENTHESIS), + $openResearchScopePtr, + null, + false, + null, + true + ); + // is there a closing parenthesis with a control statement before + // the previous instruction ? + if (false !== $closeParPtr) { + // is there no opening curly bracket specific to + // set of instructions, between the closing parenthesis + // and the current token ? + if ($openBracketPtr < $closeParPtr) { + // starts the search from the token before the closing + // parenthesis, if it isn't a for statement + $openResearchScopePtr = $closeParPtr - 1; + // is this parenthesis associated with a for statement ? + $closeParenthesisTk = $tokens[$closeParPtr]; + if (array_key_exists('parenthesis_owner', $closeParenthesisTk)) { + $mayBeForPtr = $closeParenthesisTk['parenthesis_owner']; + $mayBeForTk = $tokens[$mayBeForPtr]; + if (T_FOR === $mayBeForTk['code']) { + return $mayBeForPtr; + } + } + } else { + // if it is about a for loop, don't go further + // and detect it after one more loop execution, do it now + if (T_FOR === $parentCode) { + return $parentPtr; + } + // starts the search from the token before the one + // englobing the current statement + $openResearchScopePtr = $parentPtr - 1; + // re-initialize variables about the englobing structure + if (is_array($parentPtrAndCode)) { + $parentCode = next($parentPtrAndCode); + $parentPtr = key($parentPtrAndCode); + $openBracketPtr = $tokens[$parentPtr]['scope_opener']; + } + } + } else { + $openResearchScopePtr = false; + } + } + // looks for a for loop having a body enclosed with curly brackets + foreach ($parentPtrAndCode as $parentPtr => $parentCode) { + if (T_FOR === $parentCode) { + return $parentPtr; + } + } + return false; + }//end _isInForLoopBody() + + /** + * Returns true if a variable declared in the head of the for loop pointed + * by $forPtr in file $phpcsFile has the name $varName. + * + * @param File $phpcsFile The current file being processed. + * @param int $forPtr The position of the 'for' token + * in the stack passed in $tokens. + * @param string $varName The name of the variable to + * procced without $, { nor }. + * + * @return int|bool true if a variable declared in the head of the for loop + * pointed by $forPtr in file $phpcsFile has the name $varName. + */ + private static function _isDeclaredInForLoop(File $phpcsFile, $forPtr, $varName) + { + $isDeclaredInFor = false; + $tokens = $phpcsFile->getTokens(); + $forVarPtrs = self::_getVarDeclaredInFor($phpcsFile, $forPtr); + foreach ($forVarPtrs as $forVarPtr) { + $forVarTk = $tokens[$forVarPtr]; + // get variable name + $matches = array(); + preg_match('/^\$\{?([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\}?/', $forVarTk['content'], $matches); + $forVarName = $matches[1]; + if (0 === strcmp($forVarName, $varName)) { + $isDeclaredInFor = $forVarPtr; + break; + } + } + return $isDeclaredInFor; + }//end _isDeclaredInForLoop() + + /** + * Returns list of pointers to variables declared in for loop associated to + * $forPtr in file $phpcsFile. + * + * All pointers in the result list are pointing to token with code + * T_VARIABLE. An exception is raised, if $forPtr doesn't point a token with + * code T_FOR. + * + * @param File $phpcsFile The current file being processed. + * @param int $forPtr The position of the current token + * in the stack passed in $tokens. + * + * @return array List of pointers to variables declared in for loop $forPtr. + */ + private static function _getVarDeclaredInFor(File $phpcsFile, $forPtr) + { + $tokens = $phpcsFile->getTokens(); + $forTk = $tokens[$forPtr]; + if (T_FOR !== $forTk['code']) { + throw new PHP_CodeSniffer_Exception('$forPtr must be of type T_FOR'); + } + $openParPtr = $forTk['parenthesis_opener']; + $openParenthesisTk = $tokens[$openParPtr]; + $endOfDeclPtr = $phpcsFile->findNext(array(T_SEMICOLON), $openParPtr); + $forVarPtrs = array(); + $varPtr = $phpcsFile->findNext( + array(T_VARIABLE), + $openParPtr + 1, + $endOfDeclPtr + ); + while (false !== $varPtr) { + $forVarPtrs [] = $varPtr; + $varPtr = $phpcsFile->findNext( + array(T_VARIABLE), + $varPtr + 1, + $endOfDeclPtr + ); + } + return $forVarPtrs; + }//end _getVarDeclaredInFor() + + /** + * Returns the position of first occurrence of a PHP variable starting with + * $ in $haystack from $offset. + * + * @param string $haystack The string to search in. + * @param int $offset The optional offset parameter allows you to + * specify which character in haystack to start + * searching. The returned position is still + * relative to the beginning of haystack. + * + * @return mixed The position as an integer + * or the boolean false, if no variable is found. + */ + private static function _getVariablePosition($haystack, $offset = 0) + { + $var_starts_at = strpos($haystack, '$', $offset); + $is_a_var = false; + while (false !== $var_starts_at && ! $is_a_var) { + // makes sure that $ is used for a variable and not as a symbol, + // if $ is protected with the escape char, then it is a symbol. + if (0 !== strcmp($haystack[$var_starts_at - 1], '\\')) { + if (0 === strcmp($haystack[$var_starts_at + 1], '{')) { + // there is an opening brace in the right place + // so it looks for the closing brace in the right place + $hsChunk2 = substr($haystack, $var_starts_at + 2); + if (1 === preg_match('/^[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*\}/', $hsChunk2)) { + $is_a_var = true; + } + } else { + $hsChunk1 = substr($haystack, $var_starts_at + 1); + if (1 === preg_match('/^[a-zA-Z_\x7f-\xff]/', $hsChunk1)) { + // $ is used for a variable and not as a symbol, + // since what follows $ matchs the definition of + // a variable label for PHP. + $is_a_var = true; + } + } + } + // update $var_starts_at for the next variable + // only if no variable was found, since it is returned otherwise. + if ( ! $is_a_var) { + $var_starts_at = strpos($haystack, '$', $var_starts_at + 1); + } + } + if ($is_a_var) { + return $var_starts_at; + } else { + return false; + } + }//end _getVariablePosition() +}//end class + +?> diff --git a/build/CodeIgniter/ruleset.xml b/build/CodeIgniter/ruleset.xml new file mode 100644 index 0000000..8397407 --- /dev/null +++ b/build/CodeIgniter/ruleset.xml @@ -0,0 +1,47 @@ + + + CodeIgniter coding standard as described at http://codeigniter.com/user_guide/general/styleguide.html. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/build/header_comment.txt b/build/header_comment.txt new file mode 100644 index 0000000..a161be0 --- /dev/null +++ b/build/header_comment.txt @@ -0,0 +1,13 @@ +/** + * Cache + * + * A Caching library implementing psr/cache + * + * PHP version 5.6 + * + * @package Cache + * @author Timothy J. Warren + * @copyright 2016 Timothy J. Warren + * @license http://www.opensource.org/licenses/mit-license.html MIT License + * @version 1.0.0 + */ \ No newline at end of file diff --git a/build/phpcs.xml b/build/phpcs.xml new file mode 100644 index 0000000..bea1fc4 --- /dev/null +++ b/build/phpcs.xml @@ -0,0 +1,84 @@ + + + A variation of the CodeIgniter standard + + ../src/ + + utf-8 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/build/phpdox.xml b/build/phpdox.xml new file mode 100644 index 0000000..eb46b9a --- /dev/null +++ b/build/phpdox.xml @@ -0,0 +1,128 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +