萬盛學電腦網

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

PHP 動態產生 JavaScript 的兩種實戰模式與最佳實踐

為什麼需要 PHP 動態產生 JS?

前後端分離雖成主流,但在某些場景下,由 PHP 根據伺服器端資料(使用者權限、設定參數、資料庫內容)動態輸出 JavaScript,仍具不可替代優勢:

  • 避免額外 AJAX 請求,減少首屏載入延遲
  • 將敏感配置(API 金鑰、內部路由)僅在必要時輸出
  • 舊專案逐步現代化的過渡方案
  • CMS 區塊、廣告位、追蹤碼的動態注入

模式一:PHP 腳本直接輸出 JS(附 URL 重寫)

核心步驟

  1. 設定 Content-Type: application/javascript
  2. 輸出符合 JS 語法的程式碼
  3. (選擇性)透過 Web Server 重寫將 .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;

Nginx 重寫規則

# /dynamic.js 實際對應 /dynamic.js.php
location /dynamic.js {
    try_files $uri /dynamic.js.php;
}

前端引用:<script src="/dynamic.js"></script>,瀏覽器視為靜態 JS 檔案,可被快取、壓縮、CDN 分發。

PHPCMS 風格範例(模板標籤混合)

<?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 混合碼再執行。

模式二:PHP include 靜態 JS 檔案並注入變數

適用場景

  • 大段靜態 JS 邏輯維護於獨立 .js 檔
  • 僅需注入少量動態變數(如廣告 ID、SWF 路徑)
  • 團隊前後端分工:前端維護 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: '',
    linkUrl: '',
    closeBtn: '',
    position: 'fixed',
    zIndex: 9999
};

// 後續純 JS 邏輯...
(function init() {
    if (!duilianConfig.swfUrl) return;
    // 建立 DOM、綁定事件...
})();

前端引用

<script src="https://tg.example.com/ad_loader.php?type=20"></script>

關鍵最佳實踐

1. 輸出編碼與安全

  • 使用 json_encode() 輸出資料結構,自動處理逸出、Unicode
  • 輸出字串到 JS 字面值時,用 addcslashes() 或 json_encode() 防 XSS
  • 絕不 直接 echo $userInput 到 JS 中

2. 快取策略

  • 靜態化程度高的 JS:長快取(max-age=86400 + 版本查詢字串 ?v=1.2.3)
  • 高度個人化的 JS:短快取或 no-cache,配合 ETag/Last-Modified

3. 錯誤處理與除錯

<?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']) . "');";
    }
});

4. 替代方案評估

方案優點缺點適用場景
PHP 動態輸出 JS零額外請求、伺服器端邏輯複用難以快取、前後端耦合、IDE 提示弱配置注入、舊專案、CMS 區塊
AJAX / Fetch 取資料關注點分離、快取彈性、前端框架友善額外請求延遲、需處理載入狀態現代 SPA、資料密集型頁面
內聯 <script> 模板簡單直接、無額外請求CSP 限制、混雜 HTML/JS、難維護極簡專案、關鍵初始化資料
Webpack/ESBuild 注入環境變數建置時決定、生產最佳化、Source Map需建置流程、動態資料不適用現代前端工程化專案

總結

PHP 動態產生 JS 是把雙面刃。模式一適合輸出配置物件、小型邏輯;模式二適合大段靜態邏輯配少量動態參數。核心原則:盡量輸出資料而非邏輯,將複雜行為留給前端靜態檔案,利用 json_encode 確保安全,配合合適的快取策略。現代專案應逐步遷移至「前端靜態資源 + API 取資料」架構,保留動態 JS 僅作為過渡或特定場景方案。

copyright © 萬盛學電腦網 all rights reserved