萬盛學電腦網

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

解決 Smarty 與 CSS 大括號語法衝突的三種實用方案

在使用 Smarty 模板引擎開發 PHP 專案時,開發者常會遇到一個經典問題:Smarty 的定界符 { } 與 CSS 樣式表中的大括號發生衝突。當您嘗試在模板的 <head> 區塊直接內嵌 CSS 時,Smarty 會嘗試解析樣式規則中的大括號,導致「無法識別的標記」錯誤,中斷頁面渲染。

問題示例

以下代碼會觸發錯誤,因為 Smarty 會誤將 p { margin: 2px } 中的大括號視為模板變量或邏輯標記:

<html>
<head>
<title>{$title}</title>
<style type="text/css">
p { margin: 2px; }
</style>
</head>
...

三種解決方案

方案一:外部引入 CSS 文件(推薦)

將樣式表獨立為 .css 文件,再透過 <link> 標籤引入。這不僅能徹底避開語法衝突,更符合前端工程化的最佳實踐——結構、樣式、行為分離,且便於瀏覽器快取與 CDN 分發。

<html>
<head>
<title>{$title}</title>
<link rel="stylesheet" type="text/css" href="css/default.css" />
</head>
...

方案二:使用 {literal} 標籤包裹樣式區塊

若必須在模板內嵌 CSS,可用 Smarty 內建的 {literal}...{/literal} 區塊告訴引擎「此處內容勿解析,原樣輸出」。

<html>
<head>
<title>{$title}</title>
{literal}
<style type="text/css">
p { margin: 2px; }
</style>
{/literal}
</head>
...

此法雖快速,但會使模板混入大量表現層代碼,不利於維護,建議僅用於少量臨時樣式。

方案三:修改 Smarty 定界符

在 PHP 實例化 Smarty 時,自訂左右定界符,例如改為 <!--{ 與 }-->,即可避開大括號衝突:

<?php
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->left_delimiter  = '<!--{';
$smarty->right_delimiter = '}-->';
...
?>

此法雖治本,但會改變整個專案的模板寫法,且可能影響第三方套件相容性,採用前請評估影響範圍。

最佳實踐建議

三種方案皆可解決問題,但 方案一(外部引入)最為優雅:它遵循關注點分離原則,無需修改框架配置,亦無運行期額外開銷。只要專案架構允許,請優先採用外部 CSS 文件策略。

copyright © 萬盛學電腦網 all rights reserved