PHP 專案引入 Minify 合並壓縮 JS/CSS 完整部署指南（精簡版）

核心價值

• 減少 HTTP 請求：多文件合並為一。
• 減小體積：移除空白、註釋、壓縮標識符。
• 自動緩存：支援 ETag、Last-Modified、版本號查詢串。
• 零構建流程：PHP 運行時動態處理，適合老專案快速接入。

三步接入

1. 安裝

composer require mrclay/minify
# 或手動下載 https://github.com/mrclay/minify/releases 解壓 min/ 到 DocumentRoot

2. 配置分組 (min/groupsConfig.php)

<?php
return [
  'js-common' => [
    '//js/jquery-3.6.0.min.js',
    '//js/bootstrap.bundle.min.js',
    '//js/app.js'
  ],
  'css-common' => [
    '//css/bootstrap.min.css',
    '//css/app.css'
  ]
];

3. 頁面引用

<script src="/min/g=js-common&v=20240115"></script>
<link rel="stylesheet" href="/min/g=css-common&v=20240115">

關鍵配置 (min/config.php)

<?php
$min_cachePath = '/tmp/minify_cache'; // 必須可寫
$min_allowDebugFlag = true;           // 開發時 ?debug=1 看未壓縮源碼
// $min_serveOptions['maxAge'] = 31536000; // 生產環境緩存 1 年

Web 服務器重寫規則

# Apache .htaccess (放在 min/ 目錄)
RewriteEngine On
RewriteRule ^g=([^&]+) index.php?g=$1 [L,QSA]
RewriteRule ^f=([^&]+) index.php?f=$1 [L,QSA]

# Nginx
location /min/ {
  try_files $uri $uri/ /min/index.php?$query_string;
}

開發 vs 生產環境差異

現代替代方案對比

• Vite/Webpack/Rollup：構建時處理，支援 Tree-shaking、代碼分割、TS/Vue/React，**新專案首選**。
• Minify：運行時處理，無構建依賴，**存量 PHP 專案快速優化首選**。

總結

Minify 以「Composer 一鍵安裝、分組配置、重寫規則、版本號緩存」四步完成 JS/CSS 合並壓縮部署。對於無法引入前端構建鏈的老舊 PHP 專案，是性價比最高的優化手段。

1. 上一篇文章： HTML5 網頁音樂播放器實戰：基於 jPlayer 實現播放列表、移動端適配與搜狗音樂源接入
2. 下一篇文章： Base64 編碼算法原理深度解析：從位運算到 PHP 手寫實現

PHP 相關知識

PHP Session 進階應用：自定義儲存處理器與分散式儲存實戰

Session 核心配置參數詳解 php.ini 中關鍵 S

PHP 微信公眾平台開發（四）：關鍵字自動回覆功能實現

PHP 微信公眾平台開發（四）：關鍵字自動回覆功能實現 微信

Windows 平台安裝 PHP Redis 擴充模組完整教學

Windows 平台安裝 PHP Redis 擴充模組完整教

PHP 數據采集入庫實戰（一）：列表頁 URL 批量采集與入庫

PHP 數據采集入庫實戰（一）：列表頁 URL 批量采集與入