前後端分離雖成主流,但在某些場景下,由 PHP 根據伺服器端資料(使用者權限、設定參數、資料庫內容)動態輸出 JavaScript,仍具不可替代優勢:
Content-Type: application/javascript.php 偽裝為 .js<?php
// dynamic.js.php
header('Content-Type: application/javascript; charset=UTF-8');
header('Cache-Control: public, max-age=3600'); // 快取 1 小時
// 從資料庫/設定檔讀取動態資料
$apiBase = 'https://api.example.com/v1';
$cdnDomain = 'https://cdn.example.com';
$userId = isset($_SESSION['user_id']) ? (int)$_SESSION['user_id'] : 0;
$featureFlags = ['newDashboard' => true, 'betaFeatures' => false];
// 輸出 JS 變數/物件
echo "window.APP_CONFIG = " . json_encode([
'apiBase' => $apiBase,
'cdnDomain' => $cdnDomain,
'userId' => $userId,
'features' => $featureFlags,
], JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) . ";\n";
// 輸出函數/邏輯
echo <<<'JS'
window.APP_UTILS = {
formatPrice: function(amount, currency = 'TWD') {
return new Intl.NumberFormat('zh-TW', {
style: 'currency', currency: currency, minimumFractionDigits: 0
}).format(amount);
},
getCsrfToken: function() {
return document.querySelector('meta[name="csrf-token"]')?.content || '';
}
};
JS;
# /dynamic.js 實際對應 /dynamic.js.php
location /dynamic.js {
try_files $uri /dynamic.js.php;
}
前端引用:<script src="/dynamic.js"></script>,瀏覽器視為靜態 JS 檔案,可被快取、壓縮、CDN 分發。
<?php header('Content-Type: application/x-javascript; charset=UTF-8'); ?>
{pc:content action="position" posid="1" order="id DESC" num="7" catid="11"}
<?php
function js_escape($str) {
return addcslashes(trim($str), "\0..\37'\"\\\n\r\t");
}
?>
{loop $data $v}
document.write('<a href="{$v[url]}"><img src="{$v[thumb]}" alt=""></a>');
{/loop}
{/pc}
注意: 模板引擎標籤在 PHP 解析前先由模板引擎處理,產出純 PHP/JS 混合碼再執行。
.js 檔<?php
// ad_loader.php
$adType = (int)($_GET['type'] ?? 0);
if ($adType === 20) { // 對聯廣告
ob_start();
include __DIR__ . '/templates/ads/duilian.js';
$jsContent = ob_get_clean();
header('Content-Type: application/javascript; charset=UTF-8');
header('Cache-Control: public, max-age=300');
echo $jsContent;
exit;
}
// templates/ads/duilian.js
var duilianConfig = {
swfUrl: '= $swfUrl ?? '' ?>',
linkUrl: '= $linkUrl ?? '' ?>',
closeBtn: '= $closeBtnImg ?? '' ?>',
position: 'fixed',
zIndex: 9999
};
// 後續純 JS 邏輯...
(function init() {
if (!duilianConfig.swfUrl) return;
// 建立 DOM、綁定事件...
})();
<script src="https://tg.example.com/ad_loader.php?type=20"></script>
json_encode() 輸出資料結構,自動處理逸出、Unicodeaddcslashes() 或 json_encode() 防 XSSecho $userInput 到 JS 中max-age=86400 + 版本查詢字串 ?v=1.2.3)no-cache,配合 ETag/Last-Modified<?php
// 開發環境顯示錯誤,生產環境記錄日誌
if (APP_ENV === 'development') {
ini_set('display_errors', 1);
error_reporting(E_ALL);
} else {
ini_set('display_errors', 0);
error_reporting(E_ALL & ~E_NOTICE);
}
// 捕獲致命錯誤避免輸出破碎 JS
register_shutdown_function(function() {
$error = error_get_last();
if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR])) {
header('Content-Type: application/javascript');
echo "console.error('JS 動態載入失敗: " . addslashes($error['message']) . "');";
}
});
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| PHP 動態輸出 JS | 零額外請求、伺服器端邏輯複用 | 難以快取、前後端耦合、IDE 提示弱 | 配置注入、舊專案、CMS 區塊 |
| AJAX / Fetch 取資料 | 關注點分離、快取彈性、前端框架友善 | 額外請求延遲、需處理載入狀態 | 現代 SPA、資料密集型頁面 |
| 內聯 <script> 模板 | 簡單直接、無額外請求 | CSP 限制、混雜 HTML/JS、難維護 | 極簡專案、關鍵初始化資料 |
| Webpack/ESBuild 注入環境變數 | 建置時決定、生產最佳化、Source Map | 需建置流程、動態資料不適用 | 現代前端工程化專案 |
PHP 動態產生 JS 是把雙面刃。模式一適合輸出配置物件、小型邏輯;模式二適合大段靜態邏輯配少量動態參數。核心原則:盡量輸出資料而非邏輯,將複雜行為留給前端靜態檔案,利用 json_encode 確保安全,配合合適的快取策略。現代專案應逐步遷移至「前端靜態資源 + API 取資料」架構,保留動態 JS 僅作為過渡或特定場景方案。