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 擴充套件。
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 合併多個模式一次掃描。本類別提供輕量級 UBB 解析,適合簡單留言板、評論系統。複雜巢狀需求建議改用成熟解析器或 BBCode PECL 擴充套件。