萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 實作 UBB 編碼解析器:從簡單替換到正規表示式完整方案

什麼是 UBB Code?

UBB(Universal Bulletin Board)代碼是早期論壇常用的輕量標記語言,以方括號標籤替代 HTML,如 [b]粗體[/b]、[url]連結[/url]。雖然現代專案多採用 Markdown 或 HTMLPurifier,但維護舊系統或特定需求時,仍需自行實作解析器。

基礎版:字串替換實作(教學用)

原始碼示範以 str_replace 與 explode 處理圖片、連結、Email 三類標籤:

<?php
function get_ubb(string $text): string
{
    // 圖片標籤 [img]url[/img]
    $text = str_replace('[img]', '<img src="', $text);
    $text = str_replace('[/img]', '">', $text);

    // 連結標籤 [url]url[/url]
    $arr = explode('[/url]', $text);
    $all = '';
    for ($i = 0; $i < count($arr) - 1; $i++) {
        $tt = explode('[url]', $arr[$i]);
        $url = $tt[1] ?? '';
        $all .= $tt[0] . '<a href="' . htmlspecialchars($url) . '" target="_blank">' . htmlspecialchars($url) . '</a>';
    }
    $text = (count($arr) === 1) ? $text : $all . $arr[count($arr) - 1];

    // Email 標籤 [email]mail[/email]
    $arr = explode('[/email]', $text);
    $all = '';
    for ($i = 0; $i < count($arr) - 1; $i++) {
        $tt = explode('[email]', $arr[$i]);
        $mail = $tt[1] ?? '';
        $all .= $tt[0] . '<a href="mailto:' . htmlspecialchars($mail) . '">' . htmlspecialchars($mail) . '</a>';
    }
    $text = (count($arr) === 1) ? $text : $all . $arr[count($arr) - 1];

    return $text;
}

缺點分析

  • 無法處理巢狀標籤(如 [b][i]文字[/b][/i])
  • 不支援屬性(如 [url=example.com]文字[/url])
  • 缺乏 XSS 防護,直接輸出使用者輸入極度危險
  • 效能差:多次 explode 遍歷字串

進階版:正規表示式 + 回呼函式完整解析

<?php
class UbbParser
{
    private array $patterns = [
        // [b]粗體[/b]
        '/\[b\](.*?)\[\/b\]/is' => '<strong>$1</strong>',
        // [i]斜體[/i]
        '/\[i\](.*?)\[\/i\]/is' => '<em>$1</em>',
        // [u]底線[/u]
        '/\[u\](.*?)\[\/u\]/is' => '<u>$1</u>',
        // [url]連結[/url] 或 [url=網址]文字[/url]
        '/\[url=?(.*?)\](.*?)\[\/url\]/is' => function ($m) {
            $url = $m[1] ?: $m[2];
            $text = $m[2];
            return '<a href="' . htmlspecialchars($url) . '" target="_blank" rel="noopener">' . htmlspecialchars($text) . '</a>';
        },
        // [img]圖片網址[/img] 或 [img=寬度,高度]網址[/img]
        '/\[img=?(.*?)\](.*?)\[\/img\]/is' => function ($m) {
            $attr = $m[1] ? ' ' . htmlspecialchars($m[1]) : '';
            $src = htmlspecialchars($m[2]);
            return '<img src="' . $src . '"' . $attr . ' alt="">';
        },
        // [email]信箱[/email] 或 [email=信箱]文字[/email]
        '/\[email=?(.*?)\](.*?)\[\/email\]/is' => function ($m) {
            $mail = $m[1] ?: $m[2];
            $text = $m[2];
            return '<a href="mailto:' . htmlspecialchars($mail) . '">' . htmlspecialchars($text) . '</a>';
        },
        // [quote]引用[/quote] 或 [quote=作者]內容[/quote]
        '/\[quote=?(.*?)\](.*?)\[\/quote\]/is' => function ($m) {
            $author = $m[1] ? ' data-author="' . htmlspecialchars($m[1]) . '"' : '';
            return '<blockquote' . $author . '>' . $this->parse($m[2]) . '</blockquote>';
        },
        // [code]程式碼[/code]
        '/\[code\](.*?)\[\/code\]/is' => '<pre><code>$1</code></pre>',
        // [list]清單[/list] 簡易支援
        '/\[list\](.*?)\[\/list\]/is' => function ($m) {
            $items = preg_split('/\[\*\]/', $m[1]);
            $html = '<ul>';
            foreach ($items as $item) {
                if (trim($item)) $html .= '<li>' . $this->parse(trim($item)) . '</li>';
            }
            return $html . '</ul>';
        },
    ];

    public function parse(string $text): string
    {
        // 先跳脫 HTML 特殊字元,防止 XSS
        $text = htmlspecialchars($text, ENT_QUOTES, 'UTF-8');

        // 遞迴處理巢狀標籤(最多 5 層防無限迴圈)
        for ($depth = 0; $depth < 5; $depth++) {
            $changed = false;
            foreach ($this->patterns as $pattern => $replace) {
                if (is_callable($replace)) {
                    $text = preg_replace_callback($pattern, $replace, $text, -1, $count);
                } else {
                    $text = preg_replace($pattern, $replace, $text, -1, $count);
                }
                if ($count > 0) $changed = true;
            }
            if (!$changed) break;
        }
        return $text;
    }
}

// 使用範例
$parser = new UbbParser();
$input = '[b]Hello[/b] [url=https://php.net]PHP[/url] [img]https://example.com/logo.png[/img]';
echo $parser->parse($input);

關鍵改進點

  1. XSS 防護:先 htmlspecialchars 跳脫全文,再於回呼中對屬性值二次編碼。
  2. 支援屬性與巢狀:正規表示式捕獲群組處理 [url=...]、[quote=作者] 等進階語法。
  3. 遞迴解析:迴圈多次替換直到無變化,支援 [b][i]文字[/i][/b] 等巢狀結構。
  4. 可擴充設計:陣列配置模式,新增標籤只需加入陣列元素。

生產環境建議

  • 採用成熟庫:Text_Wiki、cebe/markdown(支援 UBB 擴充)
  • 若必須自行實作,務必加入:長度限制、標籤白名單、HTMLPurifier 後處理。
  • 效能優化:編譯正規表示式、快取解析結果、避免過深遞迴。

結語

UBB 解析器是理解「標記語言 → HTML」轉換原理的優秀練習。從簡單替換到正規表示式回呼,再到狀態機解析,每一步都對應著編譯器前端的核心概念。實務上請優先使用成熟庫,自行實作僅供學習或極特殊需求。

copyright © 萬盛學電腦網 all rights reserved