Merge pull request #30 from woocommerce/improve/hooksniff

Add validation for since tag version

Author: roykho

src/WooCommerce/Sniffs/Commenting/CommentHooksSniff.php

@@ -68,7 +68,6 @@ public function process(File $phpcsFile, $stackPtr)
             }
 
             if (true === $correctly_placed) {
-
                 if (\T_COMMENT === $tokens[ $previous_comment ]['code']) {
                     $phpcsFile->addError(
                         'A "hook" comment must be a "/**" style docblock comment.',
@@ -83,6 +82,17 @@ public function process(File $phpcsFile, $stackPtr)
                     // Iterate through each comment to check for "@since" tag.
                     foreach ($tokens[ $comment_start ]['comment_tags'] as $tag) {
                         if ($tokens[$tag]['content'] === '@since') {
+                            // Check if there is a version after the @since tag.
+                            if (! preg_match('/\d+\.\d+\.?\d?/', $tokens[$tag+2]['content'])) {
+                                $phpcsFile->addError(
+                                    'A "@since" tag was found but no version declared. Required format <x.x> or <x.x.x>',
+                                    $stackPtr,
+                                    'MissingSinceVersionComment'
+                                );
+
+                                return;
+                            }
+
                             return;
                         }
                     }