Disallow certain annotations in doc blocks

gistfile1.txt

<?php

class RgStandard_Sniffs_Rg_DisallowAnnotationSniff implements PHP_CodeSniffer_Sniff {

    private $disallowedAnnotations = [
        '@abstract' => 'Please use the language construct instead.'
    ];

    public function register() {
        return [T_DOC_COMMENT];
    }

    public function process(PHP_CodeSniffer_File $phpcsFile, $stackPointer) {
        $tokens = $phpcsFile->getTokens();
        $content = $tokens[$stackPointer]['content'];
        foreach ($this->disallowedAnnotations as $annotation => $alternative) {
            if (strpos($content, $annotation) !== false) {
                $phpcsFile->addError('The annotation "' . $annotation . '" is not allowed. ' . $alternative, $stackPointer);
            }
        }
    }

}