PHP 壓縮 HTML 輸出：移除空白、換行、註解的完整函式與最佳實務

為什麼要壓縮 HTML？

• 減少傳輸體積：移除多餘空白、換行、註解，通常可縮減 10%~30% 響應大小。
• 提升載入速度：尤其在行動裝置、弱網環境下效果明顯。
• 輕微混淆：降低原始碼可讀性（非安全手段，僅增加閱讀難度）。

核心壓縮函式

<?php
/**
 * 壓縮 HTML 輸出
 * @param string $html 原始 HTML 字串
 * @return string 壓縮後 HTML
 */
function compress_html(string $html): string {
    // 1. 移除換行符、製表符
    $html = str_replace(["\r\n", "\r", "\n", "\t"], '', $html);

    // 2. 移除 HTML 註解（保留條件式註解 ）
    $html = preg_replace('//s', '', $html);

    // 3. 合併多餘空白字元（空格、換行、Tab）為單一空格
    //    但保留 
, , <script>, <style> 內容不壓縮
    $html = preg_replace_callback(
        '/(<(?:pre|textarea|script|style)[^>]*>.*?<\/(?:pre|textarea|script|style)>)/is',
        function ($m) { return $m[0]; }, // 暫存保護區塊
        $html
    );
    // 實際壓縮：將 > < 之間的多空白縮為單空格，移除標籤間多餘空白
    $html = preg_replace('/>\s+</', '><', $html);
    $html = preg_replace('/\s{2,}/', ' ', $html);

    // 4. 移除標籤屬性值引號內的多餘空白（謹慎使用，可能影響 JS/JSON）
    // $html = preg_replace('/\s*=\s*/', '=', $html); // 視需求啟用

    return trim($html);
}</code></pre>

<h2>整合到專案的三種方式</h2>

<h3>1. 輸出緩衝區攔截（最通用）</h3>
<pre><code><?php
// 入口檔案（如 index.php、front-controller.php）最頂端
ob_start(function ($buffer) {
    // 可選：僅壓縮 Content-Type 為 text/html
    $headers = headers_list();
    $isHtml = false;
    foreach ($headers as $h) {
        if (stripos($h, 'Content-Type:') === 0 && stripos($h, 'text/html') !== false) {
            $isHtml = true; break;
        }
    }
    return $isHtml ? compress_html($buffer) : $buffer;
});</code></pre>

<h3>2. 框架中介軟體</h3>
<ul>
  <li><strong>Laravel</strong>：建立 Middleware 在 <code>handle()</code> 回傳前壓縮 <code>$response->getContent()</code>。</li>
  <li><strong>Symfony</strong>：Kernel 事件 <code>kernel.response</code> 處理。</li>
  <li><strong>ThinkPHP</strong>：行為 <code>action_end</code> 或中介軟體。</li>
</ul>

<h3>3. Web Server 層級（效能最佳）</h3>
<p><strong>Nginx</strong>：<code>gzip on; gzip_types text/html; gzip_min_length 1000;</code>（傳輸層壓縮，非源碼壓縮）</p>
<p><strong>Apache</strong>：<code>mod_deflate</code> 或 <code>mod_pagespeed</code>（自動重寫 HTML）</p>

<h2>進階：保護特定區塊不壓縮</h2>
<pre><code>// 在 compress_html 內部，使用 preg_replace_callback 保護
$protected = [];
$html = preg_replace_callback(
    '/(<(?:pre|textarea|script|style)[^>]*>.*?<\/(?:pre|textarea|script|style)>)/is',
    function ($m) use (&$protected) {
        $placeholder = '@@PROTECTED_' . count($protected) . '@@';
        $protected[] = $m[0];
        return $placeholder;
    },
    $html
);
// ... 執行壓縮邏輯 ...
// 還原保護區塊
foreach ($protected as $i => $content) {
    $html = str_replace('@@PROTECTED_' . $i . '@@', $content, $html);
}</code></pre>

<h2>效能與風險評估</h2>
<table border="1" cellpadding="5" cellspacing="0">
  <thead><tr><th>指標</th><th>源碼壓縮 (PHP)</th><th>傳輸壓縮</th></tr></thead>
  <tbody>
    <tr><td>CPU 開銷</td><td>中（每請求正則處理）</td><td>低（Web Server 原生）</td></tr>
    <tr><td>體積減少</td><td>10~30%</td><td>70~90%（gzip/brotli）</td></tr>
    <tr><td>快取友善</td><td>需注意快取鍵包含壓縮版本</td><td>完全透明</td></tr>
    <tr><td>風險</td><td>正則錯誤導致 HTML 結構破壞</td><td>極低</td></tr>
  </tbody>
</table>

<h2>最佳實務建議</h2>
<ol>
  <li><strong>優先啟用 Gzip/Brotli</strong>：Nginx/Apache 開啟 <code>gzip</code>、<code>brotli</code>，效益遠大於源碼壓縮。</li>
  <li><strong>源碼壓縮作為補充</strong>：針對無法啟用傳輸壓縮的舊環境、或需極致體積優化的靜態頁。</li>
  <li><strong>嚴格測試</strong>：上線前跑完整 E2E 測試，確認 <code><pre></code>、<code><script></code>、內嵌 JSON、Vue/React 模板語法不被誤傷。</li>
  <li><strong>快取策略</strong>：若使用頁面快取，確保快取儲存的是「已壓縮版本」，避免重複壓縮。</li>
</ol>

<h2>總結</h2>
<p>PHP 壓縮 HTML 的核心是「移除無意義空白與註解」，搭配輸出緩衝區攔截可零侵入式整合。但現代 Web 架構下，<strong>啟用 Nginx/Apache Gzip/Brotli 才是 ROI 最高的方案</strong>；源碼壓縮僅作為輔助或特殊場景補充。謹記保護 <code><pre></code>/<code><textarea></code>/<code><script></code> 等敏感區塊，並建立完善測試流程，才能安心上線。</p>
							<div class="qcxs_ie_he"></div>
						</div>
						<div class="akevx_own"> <script language='javascript' src='/ad/p.js'></script></div>
						<div class="akevx_mj"> </div>	
						<div class="qcxs_ie_he"></div>
						
						<ol class="qmsbvx_hsb ovv_hex">
							<li>上一篇文章： <a class='LinkPrevArticle' href='https://code.yunyiwangluo.com/bianchen/gyphp/42967.html' >Smarty 快取機制全解析：全域、區塊、區域三種模式實戰教學</a> <li>下一篇文章： <a class='LinkNextArticle' href='https://code.yunyiwangluo.com/bianchen/gyphp/42969.html'  >PHP 文件註解標籤完整規範：PHPDoc 標準與團隊協作最佳實務</a> 
						</ol>
					</div>
				</div>
				<div class="qirnxbd bg1 mt20">
					<div class="jdbsbav">
						<a href='https://code.yunyiwangluo.com/bianchen/gyphp/' target="_blank">PHP 相關知識</a>
						<div class="jdbsbav_hx"></div>
					</div>
					<div class="qirnxbd_rbx">
						
						<div class="oiendx">
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/139171.html' target="_blank"><img  src='https://code.yunyiwangluo.com/bianchen/UploadFiles_4619/201701/2017011616514287.png'  width='100' height='70' alt='Ubuntu 系統從源碼編譯安裝 Gearman 作業佇列完整教程'  border='0'></a>
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/139171.html' target="_blank"><strong>Ubuntu 系統從源碼編譯安裝 Gearman 作業佇列完整教程</strong></a>
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/139171.html' target="_blank"><p>前言
Gearman 是分布式任務佇列系統，支持多語言客戶端</p></a>			
						</div>
						
						<div class="oiendx">
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/137200.html' target="_blank"><img  src='https://code.yunyiwangluo.com/bianchen/UploadFiles_4619/201701/2017011615121428.png'  width='100' height='70' alt='PHP MySQL 資料庫操作實戰：mysqli 預處理語句、事務控制、防注入與效能優化'  border='0'></a>
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/137200.html' target="_blank"><strong>PHP MySQL 資料庫操作實戰：mysqli 預處理語句、事務控制、防注入與效能優化</strong></a>
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/137200.html' target="_blank"><p>PHP MySQL 現代化操作指南（mysqli 版）
隨著</p></a>			
						</div>
						
						<div class="oiendx">
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/155457.html' target="_blank"><img  src='https://code.yunyiwangluo.com/bianchen/UploadFiles_4619/201701/2017011717491894.png'  width='100' height='70' alt='PHP ZipArchive 壓縮打包與下載完整實作：目錄遍歷、多檔打包、串流輸出'  border='0'></a>
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/155457.html' target="_blank"><strong>PHP ZipArchive 壓縮打包與下載完整實作：目錄遍歷、多檔打包、串流輸出</strong></a>
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/155457.html' target="_blank"><p>前言：打包下載是後台管理的高頻需求
用戶勾選多個檔案 → 伺</p></a>			
						</div>
						
						<div class="oiendx">
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/140271.html' target="_blank"><img  src='https://code.yunyiwangluo.com/bianchen/UploadFiles_4619/201701/2017011617414262_S.jpg'  width='100' height='70' alt='PHP 實現無限層級留言板功能：從數據庫設計到遞歸輸出完整指南'  border='0'></a>
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/140271.html' target="_blank"><strong>PHP 實現無限層級留言板功能：從數據庫設計到遞歸輸出完整指南</strong></a>
							<a href='https://code.yunyiwangluo.com/bianchen/gyphp/140271.html' target="_blank"><p>PHP 實現無限層級留言板功能完整指南
想要打造類似暢言、網</p></a>			
						</div>
						
						<div class="qcxs_ie_he"></div>
					</div>
				</div>
			</div>
			<div class="eccsgxsg mt20">
				
				<div class="akevx_oin"> </div>	
				<div class="nenxnxb bg1 mt20">
					<div class="enxvsfgg">
						<div class="enxvsfgg_1"></div>
					</div>
					<div class="pdirbvx lbhevs ovv_hex">
						
						<a href='https://code.yunyiwangluo.com/bianchen/gyphp/160616.html' target="_blank">Windows 98 PWS 安裝 PHP 4.0 正式版圖文教程</a>
						
						<a href='https://code.yunyiwangluo.com/bianchen/gyphp/156329.html' target="_blank">PHP 實作查詢百度與 Google 收錄狀況：範例程式碼</a>
						
						<a href='https://code.yunyiwangluo.com/bianchen/gyphp/142857.html' target="_blank">PHP Session 防止非法後台訪問實戰：登入驗證、權限攔截與安全跳轉</a>
						
						<a href='https://code.yunyiwangluo.com/bianchen/gyphp/41635.html' target="_blank">PHP 連接多個 MySQL 數據庫的正確姿勢：解決「總是使用最後一個連接」的坑</a>
						
						<a href='https://code.yunyiwangluo.com/bianchen/gyphp/149135.html' target="_blank">PHP 將文本文件數據遷移至 MySQL 數據庫：完整腳本與分頁顯示實現</a>
						
						<a href='https://code.yunyiwangluo.com/bianchen/gyphp/153936.html' target="_blank">PHP 遞迴效能測試：CGI vs Apache 模組模式下的差異分析</a>
						
						<a href='https://code.yunyiwangluo.com/bianchen/gyphp/41244.html' target="_blank">PHP 多文件 include 導致 global 變量失效？用 $GLOBALS 陣列徹底解決</a>
						
					</div>
				</div>
			
				<div class="eqibneb bg1 mt20">
					<div class="lkebxsg">欄目導航</div>
					<div class="eqibneb_1 ovv_hex">
						<li><a class='childclass' href='https://code.yunyiwangluo.com/bianchen/phpjc/' target="_self">PHP 基礎</a></li>
<li><a class='childclass' href='https://code.yunyiwangluo.com/bianchen/phpzh/' target="_self">PHP 綜合知識</a></li>
<li><a class='childclass' href='https://code.yunyiwangluo.com/bianchen/phprm/' target="_self">PHP 入門</a></li>
<li><a class='childclass' href='https://code.yunyiwangluo.com/bianchen/gyphp/' target="_self">PHP 相關知識</a></li>
					</div>
					
				</div>
			</div>
			<div class="qcxs_ie_he"></div>
		</div>
	</div>
		<div class="qcxs_ie_he"></div>
	<div class="ebrxbsbf">Copyright © <a href="https://code.yunyiwangluo.com/" target="_blank" title="程式碼之家">程式碼之家</a> All Rights Reserved   </div>


</body>
</html>