早期網站常見「計數器」、「廣告輪播」、「天氣資訊」等功能,透過 <script src="counter.php"></script> 方式嵌入靜態 HTML 頁面。核心機制:PHP 設定 Content-Type: application/javascript,輸出合法 JS 程式碼(通常是 document.write() 或變數賦值)。
<?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');";
<!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>
<?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 在解析階段執行,會暫停 DOM 建構 |
| 無法延遲/非同步 | 不支援 async/defer,影響首屏速度 |
| XSS 風險 | 若 PHP 輸出未逸出使用者資料,極易注入惡意腳本 |
| 除錯困難 | 開發者工具難以對應來源、Source Map 不支援 |
| CSP 衝突 | 內聯腳本需 'unsafe-inline',削弱內容安全政策 |
<?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 | 聊天、協作編輯、遊戲、即時儀表板 |
application/json,前端元件化消費Accept: application/json 判斷,支援雙模式輸出<script src="...php"> 作為降級<script> 載入 JS SDK,SDK 內部用 Fetch 串接你的 API,而非直接輸出 HTML/JS 混合碼「HTML 中用 JS 呼叫 PHP」是 Web 早期的智慧結晶,解決了靜態頁面動態化的需求。但隨著前端工程化、CSP、效能預算、安全標準演進,「後端輸出資料,前端負責渲染」已成鐵律。理解經典模式運作原理,有助於維護舊系統;掌握現代模式,才能打造快速、安全、可維護的新應用。