notes/bin/migrate.php

#!/usr/bin/php
<?php

array_shift($argv);

$opt = getopt('c::f:v', [ 'folder:', 'confirm', 'verbose' ]);

if ( ! $opt ) {
    exit("Bad arguments provided, you must specify a fullpath using the -f or --folder option\n");
}

$iterator = new RecursiveIteratorIterator(new class(new RecursiveDirectoryIterator($opt['folder'] ?? $opt['f'], FilesystemIterator::SKIP_DOTS)) extends RecursiveFilterIterator {
    public function accept() : bool {
        return true;
    }
}, RecursiveIteratorIterator::SELF_FIRST);

$files = array();

foreach ($iterator as $info) {
    if ($info->getExtension() !== "php" || $info->isDir() ) {
        continue;
    }

    echo sprintf("\n### MIGRATING FILE %s\n", $info->getFilename());

    $opened = false;

    $attr = $newContent = [];

    $content = file_get_contents($info->getPathname());

    foreach(explode(PHP_EOL, $content) as $lineIdx => $line) {
        $tline = trim($line);

        if ($tline === "/**") {
            $opened = true;
        }
        elseif ($tline === '*/') {
            $opened = false;
        }
        elseif (substr($tline, 0, 1) === '*') {
            $annotation = trim(substr($tline, 1));

            if (strpos($annotation, '@') === 0 ) {
                $argpos = strpos($annotation, '(');

                if ($argpos !== false) {
                    $name = substr($annotation, 1,  $argpos - 1);
                    $args = substr($annotation, $argpos + 1, strrpos($annotation, ')') - $argpos - 1);

                    try{
                        $array = eval("return [{$args}];");

                        $renderedArgs = [];

                        foreach($array as $key => $argument) {

                            if ( is_array($argument) ) {
                                $argument = var_export($argument, true);
                            }
                            elseif ( is_bool($argument) ) {
                                $argument = $argument ? 'true' : 'false';
                            }
                            elseif (! is_numeric($argument) ) {
                                $argument = "\"$argument\"";
                            }

                            if (is_numeric($key)) {
                                $renderedArgs[] = $argument;
                            }
                            else {
                                $renderedArgs[] = "$key: $argument";
                            }
                        }

                        $renderedArgs = implode(', ', $renderedArgs);
                    }
                    catch(\Throwable $e) {
                        echo sprintf("!!! WARNING : %s in file (%s) line %d ; using previous notation.\n", $e->getMessage(), $info->getPathname(), $lineIdx + 1);

                        $renderedArgs = str_replace(' => ', ': ', $args);
                    }
                }
                else {
                    $name = substr($annotation, 1);
                    $renderedArgs = "";
                }

                $attr[] = $attribute = sprintf("%s#[%s%s]%s", str_repeat(" ", strlen($line) - strlen(ltrim($line)) >= 4 ? 4 : 0), $name, $renderedArgs ? "($renderedArgs)" : "", $renderedArgs ? " # migrated from: $args" : "");

                $newContent[] = $attribute;
            }
        }
        else {
            $newContent[] = $line;
        }
    }

    $newContent = implode(PHP_EOL, $newContent);

    if ($attr) {
        if ( isset($opt['verbose']) || isset($opt['v']) ) {
            echo $newContent;
        }

        if ( isset($opt['confirm']) || isset($opt['c']) ) {
            file_put_contents($info->getPathname(), $newContent);

            echo sprintf("\n### FILE CONVERSION COMPLETED %s\n", $info->getFilename());
        }
        else {
            echo sprintf("\n### FILE CONVERSION ANALYZED, NOTHING WRITTEN UNTIL --confirm or -c FLAG IS PROVIDED %s\n", $info->getFilename());
        }
    }
    else {
        echo sprintf("\n### NOTHING TO DO ON FILE %s\n", $info->getFilename());
    }

}