萬盛學電腦網

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

PHP 實作 UBB 代碼解析器類別

前言

UBB (Universal Bulletin Board) 代碼是論壇常用的輕量標記語言。本文提供一個完整的 PHP 類別,將 UBB 標籤轉換為 HTML,支援常見格式:粗體、斜體、底線、連結、圖片、字型、顏色、Email、跑馬燈等。

完整類別實作

<?php
class UBBParser
{
    // 模式與替換規則:[pattern => replacement]
    protected $patterns = [
        // 區塊標籤
        '/\[b\](.*?)\[\/b\]/is'           => '<strong>$1</strong>',
        '/\[i\](.*?)\[\/i\]/is'           => '<em>$1</em>',
        '/\[u\](.*?)\[\/u\]/is'           => '<u>$1</u>',
        '/\[s\](.*?)\[\/s\]/is'           => '<del>$1</del>',
        '/\[code\](.*?)\[\/code\]/is'     => '<pre><code>$1</code></pre>',
        '/\[quote\](.*?)\[\/quote\]/is'   => '<blockquote>$1</blockquote>',

        // 連結
        '/\[url\](https?:\/\/.*?)\[\/url\]/is'         => '<a href="$1" target="_blank" rel="noopener">$1</a>',
        '/\[url=(https?:\/\/.*?)\](.*?)\[\/url\]/is'   => '<a href="$1" target="_blank" rel="noopener">$2</a>',

        // 圖片
        '/\[img\](https?:\/\/.*?)\[\/img\]/is'         => '<img src="$1" alt="" />',
        '/\[img=(.*?)\](.*?)\[\/img\]/is'              => '<img src="$1" alt="$2" />',

        // 字型大小
        '/\[size=(\d+)\](.*?)\[\/size\]/is'            => '<span style="font-size:$1px">$2</span>',

        // 字型顏色
        '/\[color=([#\w]+)\](.*?)\[\/color\]/is'       => '<span style="color:$1">$2</span>',

        // 字型字體
        '/\[font=([^\]]+)\](.*?)\[\/font\]/is'         => '<span style="font-family:$1">$2</span>',

        // Email
        '/\[email\](.*?)\[\/email\]/is'                => '<a href="mailto:$1">$1</a>',
        '/\[email=(.*?)\](.*?)\[\/email\]/is'          => '<a href="mailto:$1">$2</a>',

        // 列表
        '/\[list\](.*?)\[\/list\]/is'                  => '<ul>$1</ul>',
        '/\[\*\](.*?)\[\/\*\]/is'                      => '<li>$1</li>',

        // 對齊
        '/\[left\](.*?)\[\/left\]/is'                  => '<div style="text-align:left">$1</div>',
        '/\[center\](.*?)\[\/center\]/is'              => '<div style="text-align:center">$1</div>',
        '/\[right\](.*?)\[\/right\]/is'                => '<div style="text-align:right">$1</div>',

        // 換行
        '/\[br\]/i'                                    => '<br />',
    ];

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

        // 2. 處理換行
        $text = nl2br($text);

        // 3. 套用 UBB 模式替換
        $text = preg_replace(array_keys($this->patterns), array_values($this->patterns), $text);

        return $text;
    }
}

// 使用範例
$parser = new UBBParser();
$input = '[b]粗體文字[/b] [url=https://example.com]連結[/url] [color=red]紅字[/color]';
echo $parser->parse($input);
?>

進階功能擴充

支援巢狀標籤

上述簡單 preg_replace 無法正確處理巢狀標籤(如 [b][i]文字[/i][/b])。需使用遞迴正則或狀態機解析。建議採用成熟庫如 ezyang/htmlpurifier 搭配自訂定義,或使用 bbcode PECL 擴充套件。

整合 HTML Purifier 防 XSS

require_once 'HTMLPurifier.auto.php';

$config = HTMLPurifier_Config::createDefault();
$config->set('HTML.DefinitionID', 'ubb-custom');
$config->set('HTML.DefinitionRev', 1);
$purifier = new HTMLPurifier($config);

// 先轉 UBB -> HTML,再經 Purifier 淨化
$html = $purifier->purify($parser->parse($rawText));

效能優化建議

  • 將模式編譯快取於靜態屬性,避免每次實例化重新建立陣列。
  • 大量文字處理時,考慮使用 preg_replace_callback 合併多個模式一次掃描。
  • 生產環境啟用 OPcache。

總結

本類別提供輕量級 UBB 解析,適合簡單留言板、評論系統。複雜巢狀需求建議改用成熟解析器或 BBCode PECL 擴充套件。

copyright © 萬盛學電腦網 all rights reserved