Download the PHP package phbsis/kr04-php-lint without Composer

KR04 PHP Linter

Este projeto foi criado para atender ao cronograma de tarefas das OKRs de oito semanas na Chaordic Systems. Porém, pode ser perfeitamente usado, modificado ou adaptado pela comunidade. O KR04 foi criado para verificar se os códigos PHP do seu projeto estão de acordo com alguns padrões, dentre eles: Sintaxe, PSR-2, PSR-3 e Chaordic Patterns.

Dependências

• PHP 5.6+
• Composer

Instalação

Para instalar o KR04 use o Composer. Esta documentação assume que você já tem o Composer instalado em sua máquina. Caso precise instalar o Composer siga a documentação oficial. Abaixo é possível observar um exemplo de configuração do arquivo composer.json.

Após configurar o arquivo composer.json, rode o comando composer install e aguarde o final da instalação.

Ao final do processo, se tudo ocorrer com sucesso, será possível observar o arquivo checker-kr04 na raiz do projeto; este será usado como executável da biblioteca KR04.

Como usar o KR04

Por padrão, a biblioteca já vem com os checadores de Sintaxe, PSR-2, PSR-3 e padrões usados na Chaordic Systems. É importante informar que não foram implementadas todas as regras das PSRs citadas acima. Continuando com as informações de uso, assumindo que você já se encontra no diretório raiz do seu projeto, basta rodar no terminal o comando:

Parâmetros especiais no terminal

O KR04 também possui alguns parâmetros que podem ser passados ao executar a verificação de seus aquivos PHP. Abaixo é possível ver a lista de atributos que já são usados pelo sistema. Caso seja necessário, também é possível receber os parâmetros nas Classes Checkers através da Injeção de Dependência de KR04\Cli\Commands que toda Checker possui.

list : Lista todos os Checkers registrados no sistema.

stop : Para a execução no primeiro erro encontrado.

only : Executa somente os Checkers passados como parâmetro.

except : Executa todos os demais Checkers, exceto os passados como parâmetro.

Criando novas regras de verificação

Novas regras podem ser criadas para atenderem às particularidades dos seus projetos. Para criar uma nova regra é muito simples, porém algumas passos devem ser seguidos para o correto funcionamento do sistema. Uma nova classe de regra (Checker) se parece com o seguinte:

Toda classe a ser usada como Checker precisa seguir essas regras:

• Ter o namespace setado como KR04\Checkers
• Herdar a classe KR04\Checkers\Checker
• Implementar o método protected function configure()

Salvando a nova Class Checker

O KR04 usa a PSR-4 em sua implementação e isso proporciona uma flexibilidade de paths para um mesmo namespace. Sendo assim, para que as suas regras não se misturem com as implementadas por default, o namespace KR04\Checkers também corresponde ao path ./checkers/, ou seja, um diretório chamado de checkers na raiz do seu projeto. Dessa forma, para salvar suas classes, crie um diretório com este nome na raiz do projeto e salve suas classes dentro deste diretório.

Acessando o conteúdo dos arquivos

Toda classe Checker tem acesso ao atributo $this->loader. Este atributo guarda a referência para um objeto do Tipo KR04\Files\Loader que contém o método público $this->loader->getOutput(), que por sua vez retorna um array com o conteúdo dos arquivos carregados. A hierarquia desse array se parece com o seguinte:

Note que este array contém o seguinte padrão:

• Cada índice do array é preenchido com o path do arquivo corrente.
• Cada índice do array, quando acessado, retornar um sub array com o conteúdo do arquivo corrente, sendo um índice deste sub array contendo o arquivo na íntegra (índice string) ou por linhas (índice array). É importante dizer que o índice ‘array’ retorna um sub array, onde cada posição representa uma linha do arquivo.

Registrando a Nova Classe na fila de execução

Para que sua classe seja executada, a mesma precisa ser registrada no container de execução. Este registro pode ser feito através do método setChecker(…) passando como parâmetro o nome completo da classe no arquivo checker-kr04. É possível ver um exemplo de um registro a seguir:

Ignorando diretórios e arquivos

Nem sempre queremos carregar determinados arquivos, sabendo disso, implementamos algumas formas de facilmente configurar o KR04. Para realizar este tipo de ação, basta adicionar o path relativo do arquivo como índice no array $this->ignoreFile. Este array encontra-se no arquivo ./vendor/phbsis/kr04-php-lint/src/Config/Config.php. Há um método específico que inicia as configurações pra este tipo de ação. Abaixo é possível observar um exemplo de arquivos a serem ignorados:

O mesmo procedimento pode ser seguido para ignorar diretórios (e seus subdiretórios), porém, o array responsável por conter essa ‘blacklist’ de diretórios é outro: $this->ignoreDirectory. Abaixo é possível observar um exemplo de diretórios a serem ignorados:

Ignorando blocos de código ou apenas uma linha

Existem tags específicas para indicar um trecho de código a ser ignorado, são elas:

• @ignore: Inicia um bloco de código a ser ignorado
• @ignoreline: Indica que a linha deve ser ignorada
• @endignore: Finaliza um bloco de código ignorado

Abaixo é possível observar alguns exemplos usando as tags citadas: Uso de @ignore e @endignore

Uso do @ignoreline

Créditos

Este projeto foi desenvolvido por Edson B S Monteiro - [email protected] Esta aplicação foi desenvolvida orgulhosamente em uma distribuição Linux. =)

LAUS DEO