PhpDeprecationDetector

phpdeprecationdetector

PHPDEPRECATIONDETECTOR- PHP代码的分析仪搜索新解释器版本中弃用功能的用法 - 折旧检测器。

phpdeprecationdetector检测：

• 使用弃用的功能，变量，常数和INI导入。
• 使用弃用功能功能。
• 使用禁止名称或技巧（例如，在较新版本中保留的标识符）。

从字面上看，它可以帮助您找到在迁移到更新的PHP版本后可能会失败的代码。

1. 安装
2. 用法

• 控制台扫描仪
• JSON报告格式

安装

PHAR文件

1. 只需从发行页面下载一个PHAR并使可执行

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

2. 一个。本地安装：从当前文件夹中使用它：

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

   b。全局安装：将其输入到您的$PATH中列出的一个文件夹中，然后从任何文件夹中运行：

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

作曲家

安装PHPDD的另一种方法是通过作曲家。

1. 安装作曲家：

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

2. 在Global Composer Dir中安装PHPDD：

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

3. 从任何文件夹中运行：

phpdd -h

用法

控制台扫描仪

要扫描您的文件或文件夹启动phpdd并传递文件或目录名称。

 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

• 通过提供其他选项--target您可以指定PHP版本以更少的检查。可用的目标版本：5.3、5.4、5.5、5.6、7.0、7.1、7.2、7.3、7.4、8.0。较大的版本包括从所有以前的检查规则。
• 通过提供--exclude选项，您可以从分析中排除特定文件夹或文件。例如， --exclude vendor将阻止检查第三方库。
• 通过提供--skip-checks选项，您可以将特定的支票排除在分析中。
• 如果您的文件具有不寻常的扩展名，则可以按--file-extensions选项指定所有Exts。默认情况下，它使用php ， phtml和php5 。
• 如果您需要生成机器可读分析结果，请使用--output-file选项来指定按照--output （JSON或JUNIT）指定的输出文件的路径。

用法的示例

 > ./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报告格式

另外，您可以以JSON格式存储分析以进行自动检查。通过--output-file=FILENAME结果写入文件名文件或未设置为输出到stdout 。

Junit报告格式

另外，您可以以Junit格式存储分析结果以进行自动检查。通过--output-file=FILENAME结果写入文件名文件或未设置为输出到stdout 。

JSON的格式- 带有项目的字典：

• Infomessage [] info_messages-有关分析过程的信息消息列表。
• 问题[]问题- 代码中发现的问题列表。
• 替换[]替换_suggestions-基于您的代码替换建议列表。
• 注意[]注释- 有关新功能行为的注释清单。

项目描述：

• 通知结构：
  • 字符串类型- 消息类型 -​​ 任何一个（信息|警告）
  • 字符串消息- 消息文字
• 问题结构：
  • 字符串版本- 具有当前问题的解释器版本（例如7.2 ）
  • 字符串文件- 文件中的相对路径（例如src/cools coolsclass.php ）
  • 字符串路径- 在其中找到的问题的绝对路径（例如/var/www/html/project/src/probremclass.php ）
  • int行- 在文件中发现的文件中
  • int列- 在哪个问题中排队
  • 字符串类别- 问题类别 - 任何（更改|删除|违规）
  • 字符串类型- 具体问题类型（例如“常数”或“标识符” ）
  • 字符串检查器- 可能引起问题的具体问题对象（例如magic_quotes_runtime或preg_replace() (@preg_replace_e_modifier) ）
• 替换结构：
  • 字符串类型- 替换对象类型（例如变量或INI ）
  • 字符串问题- 替换对象（例如mcrypt_generic_end（）或每个（） ）
  • 字符串替换- 建议替换为（例如mcrypt_generic_deinit（）或foreach（） ）
• 注意结构：
  • 字符串类型- note类型（例如function_usage或retebecated_feature ）
  • 字符串问题- 注意对象（例如preg_replace() (@preg_replace_e_modifier)或parse_str() (@parse_str_without_argument) ）
  • 字符串注释- 注释文本（例如， Usage of "e" modifier in preg_replace is deprecated: "asdasdsd~ie"或Call to parse_str() without second argument is deprecated ）

建造

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