25 require_once __DIR__ .
'/Maintenance.php';
26 require_once __DIR__ .
'/../vendor/autoload.php';
35 $retVal = parent::enterNode( $node );
41 $this->currentFile = $filename;
60 foreach ( $this->foundNodes
as $version => &$nodes ) {
61 uasort( $nodes,
function ( $a, $b ) {
62 return ( $a[
'filename'] . $a[
'name'] ) < ( $b[
'filename'] . $b[
'name'] ) ? -1 : 1;
65 ksort( $this->foundNodes );
74 if ( !$node->stmts ) {
77 foreach ( $node->stmts
as $stmt ) {
79 $stmt instanceof PhpParser\Node\Expr\FuncCall
80 && $stmt->name->toString() ===
'wfDeprecated'
89 $retVal = parent::enterNode( $node );
91 if ( $node instanceof PhpParser\Node\Stmt\ClassLike ) {
92 $this->currentClass = $node->name;
95 if ( $node instanceof PhpParser\Node\FunctionLike ) {
96 $docComment = $node->getDocComment();
100 if ( !preg_match(
'/@deprecated.*(\d+\.\d+)/', $docComment->getText(),
$matches ) ) {
105 if ( $node instanceof PhpParser\Node\Stmt\ClassMethod ) {
106 $name = $this->currentClass .
'::' . $node->name;
111 $this->foundNodes[ $version ][] = [
112 'filename' => $node->filename,
113 'line' => $node->getLine(),
129 parent::__construct();
136 $files =
new RecursiveDirectoryIterator(
$IP .
'/includes' );
137 $files =
new RecursiveIteratorIterator( $files );
138 $files =
new RegexIterator( $files,
'/\.php$/' );
139 return iterator_to_array( $files,
false );
146 $chunkSize = ceil(
count( $files ) / 72 );
148 $parser = (
new PhpParser\ParserFactory )->create( PhpParser\ParserFactory::PREFER_PHP7 );
149 $traverser =
new PhpParser\NodeTraverser;
151 $traverser->addVisitor( $finder );
153 $fileCount =
count( $files );
155 for ( $i = 0; $i < $fileCount; $i++ ) {
157 $code = file_get_contents( $file );
159 if ( strpos(
$code,
'@deprecated' ) === -1 ) {
163 $finder->setCurrentFile( substr( $file->getPathname(), strlen(
$IP ) + 1 ) );
164 $nodes =
$parser->parse(
$code, [
'throwOnError' =>
false ] );
165 $traverser->traverse( $nodes );
167 if ( $i % $chunkSize === 0 ) {
168 $percentDone = 100 * $i / $fileCount;
169 fprintf( STDERR,
"\r[%-72s] %d%%", str_repeat(
'#', $i / $chunkSize ), $percentDone );
173 fprintf( STDERR,
"\r[%'#-72s] 100%%\n",
'' );
177 $versionFmt =
"\n* Deprecated since \033[37;1m%s\033[0m:\n";
178 $entryFmt =
" %s \033[33;1m%s\033[0m (%s:%d)\n";
180 $versionFmt =
"\n* Deprecated since %s:\n";
181 $entryFmt =
" %s %s (%s:%d)\n";
184 foreach ( $finder->getFoundNodes()
as $version => $nodes ) {
185 printf( $versionFmt, $version );
186 foreach ( $nodes
as $node ) {
189 $node[
'hard'] ?
'+' :
'-',
196 printf(
"\nlegend:\n -: soft-deprecated\n +: hard-deprecated (via wfDeprecated())\n" );