zhamao-framework/src/ZM/Command/Generate/TextGenerateCommand.php

<?php

declare(strict_types=1);

namespace ZM\Command\Generate;

use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Input\InputArgument;
use ZM\Command\Command;
use ZM\Utils\ZMRequest;

#[AsCommand(name: 'generate:text', description: '生成一些文本（内部）')]
class TextGenerateCommand extends Command
{
    protected function configure()
    {
        $this->addArgument('name', InputArgument::REQUIRED, '生成的文本内容');
        $this->setDescription('生成一些框架本身的文本（内部' . PHP_EOL . '当前包含：class-alias-md，update-log-md');
    }

    /**
     * {@inheritDoc}
     */
    protected function handle(): int
    {
        return match ($this->input->getArgument('name')) {
            'class-alias-md' => $this->generateClassAliasDoc(),
            'update-log-md' => $this->generateUpdateLogs(),
            default => static::FAILURE,
        };
    }

    private function generateClassAliasDoc(): int
    {
        $file = file_get_contents(FRAMEWORK_ROOT_DIR . '/src/Globals/global_class_alias.php');
        // 提取class_alias函数的参数
        preg_match_all('/class_alias\((.+?), \'(.+?)\'\);/', $file, $matches);
        $full_maxlen = 0;
        $short_maxlen = 0;
        $line = [];
        foreach ($matches[1] as $k => $v) {
            $full_class = substr($v, 0, -7);
            $short_class = $matches[2][$k];
            $line[] = [$full_class, $short_class];
            $full_maxlen = max($full_maxlen, strlen('`' . $full_class . '`'));
            $short_maxlen = max($short_maxlen, strlen('`' . $short_class . '`'));
        }
        $this->write('| ' . str_pad('全类名', $full_maxlen) . ' | ' . str_pad('别名', $short_maxlen) . ' |');
        $this->write('| ' . str_pad('', $full_maxlen, '-') . ' | ' . str_pad('', $short_maxlen, '-') . ' |');
        foreach ($line as $v) {
            $this->write('| ' . str_pad('`' . $v[0] . '`', $full_maxlen) . ' | ' . str_pad('`' . $v[1] . '`', $short_maxlen) . ' |');
        }
        return static::SUCCESS;
    }

    private function generateUpdateLogs(): int
    {
        date_default_timezone_set(config('global.runtime.timezone', 'UTC'));
        $api = ZMRequest::get('https://api.github.com/repos/zhamao-robot/zhamao-framework/releases', ['User-Agent' => 'ZMFramework']);
        if ($api === false) {
            $this->error('获取更新日志失败');
            return static::FAILURE;
        }
        $json = json_decode($api, true);
        $line = '# 更新日志' . "\r\n\r\n> 本页面由框架命令 `./zhamao generate:text update-log-md` 自动生成\r\n\r\n";
        foreach ($json as $v) {
            $version = $v['tag_name'];
            if (str_starts_with($version, '2.')) {
                continue;
            }
            $doc_count = 0;
            $time = '> 更新时间：' . date('Y-m-d', strtotime($v['published_at']));
            $line .= '## v' . $v['tag_name'] . "\r\n\r\n" . $time . "\r\n\r\n";
            $v['body'] = trim(str_replace("## What's Changed", '', $v['body']));
            $bodies = explode("\r\n", $v['body']);
            foreach ($bodies as $ks => $vs) {
                if (str_contains($vs, '文档')) {
                    ++$doc_count;
                    if ($doc_count === 1) {
                        $bodies[$ks] = '* 本次更新包含文档更新内容 {cnt} 个';
                    } else {
                        unset($bodies[$ks]);
                    }
                }
            }
            $v['body'] = implode("\r\n", $bodies);
            if ($doc_count > 0) {
                $v['body'] = str_replace('{cnt}', strval($doc_count), $v['body']);
            }
            $line .= $v['body'] . "\r\n\r\n";
        }
        // 将双空行转换为单空行
        $line = str_replace("\r\n\r\n\r\n", "\r\n\r\n", $line);

        // 转换文本换行符格式为 LF
        $line = str_replace("\r\n", "\n", $line);

        // 将所有的链接转换为可点击的链接，例如 https://example.com -> <https://example.com>
        $line = preg_replace('/https?:\/\/(www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&\/=]*)/', '<$0>', $line);

        // 替换 PR 链接，例如 <.../pull/123> -> [PR#123](.../pull/123)
        $line = preg_replace('/<(https:\/\/github\.com\S+zhamao-framework\/pull\/(\d+))>/', '[PR#$2]($1)', $line);

        // 将 mention 转换为可点击的链接，例如 @sunxyw -> [@sunxyw](https://github.com/sunxyw)
        $line = preg_replace('/(?<=^|\s)@([\w.]+)(?<!\.)/', '[@$1](https://github.com/$1)', $line);

        // 将 Full Changelog 转换为“源码变更记录”
        $line = str_replace('Full Changelog', '源码变更记录', $line);

        if (isset($doc_count) && $doc_count > 0) {
            $line = str_replace('{cnt}', strval($doc_count), $line);
        }

        file_put_contents(FRAMEWORK_ROOT_DIR . '/docs/update/v3.md', $line);
        return static::SUCCESS;
    }
}