萬盛學電腦網

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

PHP 讀取本地 .php 檔案原始碼並顯示:file_get_contents、fopen、htmlspecialchars 完整實戰

核心挑戰

直接 include/require 會執行 PHP 代碼而非顯示原始碼。需以「純文本」方式讀取檔案內容,並對 HTML 特殊字元轉義後輸出。

方法一:file_get_contents() + htmlspecialchars()(推薦)

<?php
// a.php 內容:
// <?php echo "i am a.php"; ?>

// b.php 顯示 a.php 原始碼
$source = file_get_contents('a.php');
echo htmlspecialchars($source, ENT_QUOTES, 'UTF-8');
?>

關鍵點

  • file_get_contents():將整個檔案讀入字串,不解析 PHP 標籤
  • htmlspecialchars():將 < > & " ' 轉為 HTML 實體,防止瀏覽器渲染標籤
  • ENT_QUOTES:同時轉義雙引號與單引號
  • 'UTF-8':明確指定編碼,避免多位元組字元錯誤

方法二:fopen() + fread()(大檔案/流式控制)

<?php
$file = fopen('a.php', 'r');
if ($file) {
    $source = '';
    while (!feof($file)) {
        $source .= fread($file, 8192); // 分塊讀取
    }
    fclose($file);
    echo htmlspecialchars($source, ENT_QUOTES, 'UTF-8');
}
?>

適用於:超大檔案(避免記憶體耗盡)、需控制讀取位置、管道/串流資源。

方法三:highlight_file() / highlight_string()(語法高亮)

<?php
// 直接輸出高亮 HTML(含行號、顏色)
highlight_file('a.php');  // 檔案
// 或
highlight_string($source); // 字串

// 返回字串而非輸出(PHP 4.2+)
$highlighted = highlight_file('a.php', true);
echo $highlighted;
?>

優點:內建語法高亮、行號、CSS 類別可自訂樣式。
缺點:輸出 HTML 結構固定,難以深度定制。

方法四:show_source()(highlight_file 別名)

<?php
show_source('a.php'); // 同 highlight_file()
?>

完整可用的原始碼查看器範例

<?php
// viewer.php?file=target.php
$baseDir = __DIR__ . '/source';
$requested = $_GET['file'] ?? '';

if ($requested === '') {
    echo "Usage: viewer.php?file=filename.php";
    exit;
}

// 安全:防止目錄遍歷
$realBase = realpath($baseDir);
$realTarget = realpath($baseDir . '/' . $requested);

if ($realTarget === false || strpos($realTarget, $realBase) !== 0) {
    http_response_code(403);
    echo "Forbidden: Path traversal attempt";
    exit;
}

if (!is_file($realTarget) || pathinfo($realTarget, PATHINFO_EXTENSION) !== 'php') {
    http_response_code(404);
    echo "Not found or not a PHP file";
    exit;
}

$source = file_get_contents($realTarget);
// 選項 A:純文本顯示(可複製)
echo '
';
echo htmlspecialchars($source, ENT_QUOTES, 'UTF-8');
echo '
'; // 選項 B:語法高亮(取消註釋下行,註釋上方 pre 區塊) // echo highlight_file($realTarget, true); ?>

遠端 .php 檔案讀取說明

讀取遠端 URL(file_get_contents('https://example.com/a.php'))會得到執行後的輸出(HTML/JSON 等),而非原始碼。除非伺服器配置錯誤暴露原始碼,否則無法透過 HTTP 獲取遠端 PHP 源代碼——這是伺服器端執行模型的基本安全特性。

對比總結

方法適用場景優點缺點
file_get_contents + htmlspecialchars中小檔案、原始碼展示、API 回應簡潔、完全控制輸出格式大檔案佔記憶體
fopen + fread大檔案、流式處理、記憶體受限可控緩衝、低記憶體代碼較繁瑣
highlight_file()教學、除錯、代碼審查、文檔生成內建高亮、行號、CSS 可定制輸出格式固定、較難嵌入 SPA
include/require執行 PHP 代碼正常業務邏輯無法顯示原始碼

安全提醒

  1. 🔒 路徑遍歷防護:必須使用 realpath() 驗證目標在允許目錄內
  2. 🔒 副檔名白名單:僅允許 .php、.inc、.txt 等
  3. 🔒 權限最小化:PHP 進程僅需讀取權限,不可寫入
  4. 🔒 敏感資訊過濾:生產環境原始碼查看器應過濾密鑰、資料庫憑證等

總結

讀取本地 PHP 原始碼的核心公式:file_get_contents() → htmlspecialchars() → 輸出。若需語法高亮,改用 highlight_file()。生產環境嚴禁暴露任意檔案讀取介面,必須實施路徑驗證、權限控制、審計日誌。理解「包含執行」與「讀取顯示」的本質區別,是 PHP 開發者的基本功。

copyright © 萬盛學電腦網 all rights reserved