萬盛學電腦網

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

HTML 網頁透過 JavaScript 呼叫 PHP 內容:跨域資料嵌入的經典模式與現代替代方案

經典模式:PHP 輸出 JavaScript 程式碼

早期網站常見「計數器」、「廣告輪播」、「天氣資訊」等功能,透過 <script src="counter.php"></script> 方式嵌入靜態 HTML 頁面。核心機制:PHP 設定 Content-Type: application/javascript,輸出合法 JS 程式碼(通常是 document.write() 或變數賦值)。

計數器完整範例(教學用)

FileCount.php(伺服器端)

<?php
$countFile = __DIR__ . '/num.txt';

// 檔案鎖定防止競態條件
$fp = fopen($countFile, 'c+'); // 開啟讀寫,不截斷,若不存在則建立
if (!$fp) {
    echo "document.write('Counter error');";
    exit;
}

if (flock($fp, LOCK_EX)) { // 獨佔鎖
    $count = (int)fread($fp, 20);
    $count++;
    ftruncate($fp, 0);
    rewind($fp);
    fwrite($fp, (string)$count);
    fflush($fp);
    flock($fp, LOCK_UN);
}
fclose($fp);

// 輸出 JavaScript
header('Content-Type: application/javascript; charset=UTF-8');
header('Cache-Control: no-cache, must-revalidate'); // 計數器不快取
echo "document.write('訪客數: $count');";

靜態 HTML 頁面嵌入

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>靜態頁面嵌入 PHP 計數器</title>
</head>
<body>
    <h1>歡迎光臨</h1>
    <div id="counter">
        <script src="FileCount.php"></script>
    </div>
</body>
</html>

進階模式:輸出 JSONP(支援跨域與結構化資料)

<?php
// api.php
header('Content-Type: application/javascript; charset=UTF-8');

$callback = $_GET['callback'] ?? 'callback';
// 安全:僅允許字母數字底線
if (!preg_match('/^[a-zA-Z_][a-zA-Z0-9_]*$/', $callback)) {
    $callback = 'callback';
}

$data = [
    'time' => date('c'),
    'server' => $_SERVER['SERVER_NAME'],
    'random' => mt_rand(1, 100),
];

echo "$callback(" . json_encode($data, JSON_UNESCAPED_UNICODE) . ");";
<script>
function handleData(data) {
    console.log('伺服器時間:', data.time);
    document.getElementById('server-time').textContent = data.time;
}
</script>
<script src="api.php?callback=handleData"></script>
<div id="server-time">載入中...</div>

現代替代方案:為什麼不再推薦 document.write?

缺點說明
阻塞渲染document.write 在解析階段執行,會暫停 DOM 建構
無法延遲/非同步不支援 async/defer,影響首屏速度
XSS 風險若 PHP 輸出未逸出使用者資料,極易注入惡意腳本
除錯困難開發者工具難以對應來源、Source Map 不支援
CSP 衝突內聯腳本需 'unsafe-inline',削弱內容安全政策

現代最佳實踐:Fetch + DOM 更新

後端:純 JSON API

<?php
// api/counter.php
header('Content-Type: application/json; charset=UTF-8');
header('Access-Control-Allow-Origin: *'); // 或指定網域

$countFile = __DIR__ . '/../data/counter.txt';
$fp = fopen($countFile, 'c+');
flock($fp, LOCK_EX);
$count = (int)fread($fp, 20) + 1;
ftruncate($fp, 0); rewind($fp);
fwrite($fp, (string)$count);
flock($fp, LOCK_UN);
fclose($fp);

echo json_encode(['count' => $count, 'updated' => date('c')]);

前端:非同步載入與優雅降級

<div id="counter" data-api="/api/counter.php">
    <span class="loading">載入中...</span>
    <noscript><a href="/counter-stats.php">查看訪客統計</a></noscript>
</div>

<script>
(async () => {
    const container = document.getElementById('counter');
    const api = container.dataset.api;
    try {
        const resp = await fetch(api, {credentials: 'same-origin'});
        if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
        const data = await resp.json();
        container.innerHTML = `訪客數: ${data.count.toLocaleString()}`;
    } catch (e) {
        console.error('計數器載入失敗:', e);
        container.innerHTML = '無法載入統計';
    }
})();
</script>

對比總結:何時用哪種?

方案優點缺點適用場景
PHP 輸出 JS (document.write)極簡單、相容極舊瀏覽器、無需前端邏輯阻塞、不安全、難維護、違反 CSP維護舊專案、極簡內嵌工具、無法控制前端代碼的第三方嵌入
PHP 輸出 JSONP跨域支援、結構化資料僅限 GET、回調函數污染全域、安全性較差老舊跨域需求、不支援 CORS 的舊環境
Fetch + JSON API (推薦)非阻塞、CORS 標準、錯誤處理豐富、支援 Stream、易測試需現代瀏覽器(或 Polyfill)、前端需寫 JS所有新專案、SPA、元件化架構
Server-Sent Events (SSE)單向即時推送、自動重連、HTTP/2 友善僅單向、連線數限制、IE 不支援即時通知、股價、日誌串流
WebSocket雙向即時、低延遲、二進位支援複雜度高、需專用伺服器、負載均衡需支援 Sticky Session聊天、協作編輯、遊戲、即時儀表板

遷移建議

  1. 新專案: 直接採用 Fetch + JSON API,後端輸出 application/json,前端元件化消費
  2. 舊專案漸進式升級:
    1. 後端新增 Accept: application/json 判斷,支援雙模式輸出
    2. 前端逐頁改寫為 Fetch,保留舊 <script src="...php"> 作為降級
    3. 全站遷移完成後,移除 PHP 輸出 JS 邏輯
  3. 第三方嵌入: 若你是提供嵌入碼給他人網站,優先提供 <script> 載入 JS SDK,SDK 內部用 Fetch 串接你的 API,而非直接輸出 HTML/JS 混合碼

結語

「HTML 中用 JS 呼叫 PHP」是 Web 早期的智慧結晶,解決了靜態頁面動態化的需求。但隨著前端工程化、CSP、效能預算、安全標準演進,「後端輸出資料,前端負責渲染」已成鐵律。理解經典模式運作原理,有助於維護舊系統;掌握現代模式,才能打造快速、安全、可維護的新應用。

copyright © 萬盛學電腦網 all rights reserved