突破 PHPMyAdmin 導入大檔案限制：php.ini 三大參數完整調優指南

WAMP/MAMP/LAMP 環境下，PHPMyAdmin 導入資料庫檔案預設限制 2MB。修改 php.ini 三大核心參數即可突破限制，本文提供完整配置、驗證與避坑指南。

核心三參數修改

找到 php.ini (WAMP: C:\wamp\bin\php\php版本\php.ini 或 PHPMyAdmin 介面「設定」頁查看載入路徑)

修改範例 (導入 200MB 檔案)

upload_max_filesize = 300M
post_max_size = 300M
memory_limit = 512M

生效步驟

1. 修改 php.ini 並儲存
2. 重啟 Web 服務：
   • WAMP: 左鍵圖示 → Restart All Services
   • Apache: httpd -k restart 或 systemctl restart httpd
   • Nginx+PHP-FPM: systemctl restart php-fpm (Nginx 無需重啟)
3. 驗證：PHPMyAdmin 首頁或 phpinfo() 確認三參數已更新

常見陷阱與解決

陷阱 1：PHPMyAdmin 介面仍顯示「最大限制：2,048 KB」

現象： 修改參數重啟後，PHPMyAdmin 導入頁面提示文字未變。

真相： 該提示為 PHPMyAdmin 靜態文字或舊版本硬編碼，**實際上傳已無限制**。直接拖曳大檔案測試即可。

陷阱 2：Nginx 客戶端請求體限制

若使用 Nginx，還需修改 nginx.conf：

http {
    client_max_body_size 300M;  # 預設 1M
    ...
}

重啟 Nginx：nginx -s reload

陷阱 3：PHP 執行超時

大檔案解析耗時長，需調整：

max_execution_time = 300  # 秒，預設 30 秒
max_input_time = 300      # 解析輸入資料時間
; 0 表示無限制 (生產環境慎用)

陷阱 4：MySQL 封包限制

my.cnf / my.ini：

[mysqld]
max_allowed_packet = 256M  # 預設 4M/16M
; 重啟 MySQL 生效

超大檔案 (>500MB) 替代方案

命令列導入最佳實踐 (推薦生產環境)

# 壓縮傳輸 + 管道導入 (最快)
ssh user@source "mysqldump -u root -p --single-transaction --quick db_name | gzip" | gunzip | mysql -u root -p -h target_host db_name

# 或本地檔案
mysql -u root -p --max_allowed_packet=256M db_name < dump.sql

# 進度監控 (需安裝 pv)
pv dump.sql | mysql -u root -p db_name

參數關係圖解

memory_limit (最大)
    ↑
post_max_size (中間)  ← 含上傳檔案 + 其他 POST 欄位
    ↑
upload_max_filesize (最小)  ← 單檔案上限
    ↑
實際檔案大小

驗證清單

• [ ] php.ini 三參數已修改且生效 (php -i | grep -E 'upload_max|post_max|memory_limit')
• [ ] Web 服務已重啟
• [ ] Nginx client_max_body_size 已調整 (如適用)
• [ ] MySQL max_allowed_packet 已調整
• [ ] PHP max_execution_time 足夠大
• [ ] 實測導入 2x 目標大小檔案成功