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])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);
htmlspecialchars 跳脫全文,再於回呼中對屬性值二次編碼。[url=...]、[quote=作者] 等進階語法。[b][i]文字[/i][/b] 等巢狀結構。UBB 解析器是理解「標記語言 → HTML」轉換原理的優秀練習。從簡單替換到正規表示式回呼,再到狀態機解析,每一步都對應著編譯器前端的核心概念。實務上請優先使用成熟庫,自行實作僅供學習或極特殊需求。