PhpDeprecationDetector

PHPDEPRECATIONDETECTOR

PHPDEPRECATIONDETECTOR - Analisador do código PHP para pesquisar os usos da funcionalidade depreciada em versões mais recentes - detector de deprecações.

PhpdePrecationDetector Detecta:

• Uso de funções, variáveis, constantes e diretivos ini-diretos .
• Uso da funcionalidade de funções depreciada.
• Uso de nomes ou truques proibidos (por exemplo, identificadores reservados em versões mais recentes).

Ele literalmente ajuda a encontrar código que pode falhar após a migração para a versão mais recente do PHP.

1. Instalação
2. Uso

• Scanner de console
• JSON RELATÓRIO FORMATO

Instalação

Arquivo phar

1. Basta baixar um Phar da página de lançamentos e fazer executáveis

chmod +x phpdd-x.x.x.phar

2. um. Instalação local : use -a da pasta atual:

    . /phpdd-x.x.x.phar -h

   b. Instalação global : mova -o para uma das pastas listadas no seu $PATH e funcione de qualquer pasta:

   sudo mv phpdd-x.x.x.phar /usr/local/bin/phpdd
   phpdd -h

Compositor

Outra maneira de instalar o PHPDD é via compositor.

1. Instale o compositor:

curl -sS https://getcomposer.org/installer | php

2. Instale o PHPDD no compositor global Dir:

./composer.phar global require wapmorgan/php-deprecation-detector dev-master

3. Corra de qualquer pasta:

phpdd -h

Uso

Scanner de console

Para digitalizar seus arquivos ou pasta, inicie phpdd e passe nomes de arquivo ou diretório.

 Description:
  Analyzes PHP code and searches issues with deprecated functionality in newer interpreter versions.

Usage:
  scan [options] [--] <files>...

Arguments:
  files                                    Which files you want to analyze (separate multiple names with a space)?

Options:
  -t, --target[=TARGET]                    Sets target PHP interpreter version. [default: "8.0"]
  -a, --after[=AFTER]                      Sets initial PHP interpreter version for checks. [default: "5.3"]
  -e, --exclude[=EXCLUDE]                  Sets excluded file or directory names for scanning. If need to pass few names, join it with comma.
  -s, --max-size[=MAX-SIZE]                Sets max size of php file. If file is larger, it will be skipped. [default: "1mb"]
      --file-extensions[=FILE-EXTENSIONS]  Sets file extensions to be parsed. [default: "php, php5, phtml"]
      --skip-checks[=SKIP-CHECKS]          Skip all checks containing any of the given values. Pass a comma-separated list for multiple values.
      --output[=OUTPUT]                    The output type required. Options: stdout, json, junit. Defaults to stdout.
      --output-file[=OUTPUT-FILE]          File path to store results where output is not stdout.
  -h, --help                               Display help for the given command. When no command is given display help for the scan command
  -q, --quiet                              Do not output any message
  -V, --version                            Display this application version
      --ansi                               Force ANSI output
      --no-ansi                            Disable ANSI output
  -n, --no-interaction                     Do not ask any interactive question
  -v|vv|vvv, --verbose                     Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

• Ao fornecer opção adicional --target você pode especificar a versão do PHP para executar menos verificações. Versões de destino disponíveis: 5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0. Uma versão maior inclui regras para verificação de todas as anteriores.
• Ao fornecer -Opção --exclude , você pode excluir pastas ou arquivos específicos da Analyze. Por exemplo, --exclude vendor impedirá a verificação de bibliotecas de terceiros.
• Ao fornecer a opção --skip-checks você pode excluir verificações específicas da Analyze.
• Se seus arquivos tiverem extensão incomum, você poderá especificar todas as opções de --file-extensions . Por padrão, usa php , phtml e php5 .
• Se você precisar gerar resultado de análise legível por máquina, use a opção --output-file para especificar o caminho para armazenar o arquivo de saída, conforme especificado em --output (JSON ou JUNIT).

Exemplo de uso

 > ./bin/phpdd tests/
Max file size set to: 1.000 MiB
Folder /media/wapmorgan/Локальный диск/Документы/PhpDeprecationDetector/tests
- PHP 5.3 (3) - your version is greater or equal
+------------+---------+---------------------------------------------------------------------+
| File:Line  | Type    | Issue                                                               |
+------------+---------+---------------------------------------------------------------------+
| /5.3.php:2 | removed | Function dl() is removed.                                           |
| /5.3.php:3 | removed | Ini define_syslog_variables is removed.                             |
| /5.3.php:5 | changed | Function usage piet() (@call_with_passing_by_reference) is changed. |
|            |         | Call with passing by reference is deprecated. Problem is "&$hoho"   |
+------------+---------+---------------------------------------------------------------------+

- PHP 5.4 (2) - your version is greater or equal
+------------+---------+-----------------------------------------------+
| File:Line  | Type    | Issue                                         |
+------------+---------+-----------------------------------------------+
| /5.4.php:2 | removed | Function mcrypt_generic_end() is removed.     |
|            |         | Consider replace with mcrypt_generic_deinit() |
| /5.4.php:3 | removed | Function magic_quotes_runtime() is removed.   |
+------------+---------+-----------------------------------------------+
...
...
...

JSON RELATÓRIO FORMATO

Além disso, você pode armazenar analisar resultar no formato JSON para verificação automática. PASS --output-file=FILENAME para gravar resultado no arquivo de nome do arquivo ou não definido como saída como stdout .

JUNIT RELATÓRIO FORMATO

Além disso, você pode armazenar analisar resultar em formato JUNIT para verificação automática. PASS --output-file=FILENAME para gravar resultado no arquivo de nome do arquivo ou não definido como saída como stdout .

Formato de JSON - Dicionário com itens:

• Infomessage [] info_messages - Lista de mensagens de informação sobre análise do processo.
• Problema [] Problemas - Lista de questões encontradas em seu código.
• Substitua sugestão [] substitua_suggestions - lista de sugestões de substituição com base no seu código.
• NOTA [] NOTAS - Lista de notas sobre novas funções Comportamento.

Descrição dos itens:

• Estrutura de informações :
  • Tipo de string - Tipo de mensagem - qualquer um dos (info | aviso)
  • Mensagem da string - Texto da mensagem
• Estrutura de problemas :
  • Versão da String - Versão de intérprete que possui a edição atual ( como 7.2 )
  • Arquivo de String - Caminho relativo para o arquivo em que a questão encontrada ( como SRC/ProblemClass.php )
  • Caminho da String - Caminho absoluto para o arquivo no qual a edição encontrou ( como /var/www/html/project/src/problemclass.php )
  • linha int - linha no arquivo em que a questão encontrou
  • Coluna int - coluna na linha em que a edição encontrou
  • Categoria de String - Categoria de edição - qualquer um dos (alterados | Removido | Violação)
  • Tipo de string - Tipo de problema de concreto ( como "constante" ou "identificador" )
  • Verificador de string - objeto de emissão de concreto que pode causar problemas ( como magic_quotes_runtime ou preg_replace() (@preg_replace_e_modifier) )
• Substitua a estrutura de sugestion:
  • Tipo de string - Tipo de objeto de substituição ( como variável ou ini )
  • Problema de string - Objeto de substituição ( como mcrypt_generic_end () ou cada () )
  • Substituição de string - sugestão para substituir ( como mcrypt_generic_deinit () ou foreach () )
• Estrutura de nota :
  • Tipo de string - Tipo de nota ( como function_usage ou deprecado_feature )
  • Problema da String - Nota Objeto ( como preg_replace() (@preg_replace_e_modifier) ​​ou parse_str() (@parse_str_without_argument) )
  • Nota de string - Nota o texto ( como Usage of "e" modifier in preg_replace is deprecated: "asdasdsd~ie" ou Call to parse_str() without second argument is deprecated )

Construir

docker run --rm --interactive --tty --volume $PWD :/app composer:2.2.4 sh
# and inside a container:
docker-php-ext-install bcmath
composer require macfja/phar-builder
echo phar.readonly=0 >> /usr/local/etc/php/php-cli.ini
composer run-script build