php.ini 文件上傳核心配置詳解：upload_max_filesize、post_max_size、memory_limit 關聯與最佳實踐

核心配置項速查表

參數關聯鏈

memory_limit > post_max_size > upload_max_filesize
      ↑              ↑                ↑
   腳本內存      請求體總大小      單文件上限

若上傳 50MB 文件：upload_max_filesize=50M、post_max_size=60M、memory_limit=128M、max_execution_time=300、upload_tmp_dir=/data/tmp/uploads (確保目錄存在且 PHP 進程用戶可寫)。

常見誤區

• 只改 upload_max_filesize：導致 POST 體超過 post_max_size，$_FILES 為空，無報錯難排查。
• 忽略 upload_tmp_dir：Windows 手動部署常忘記，導致「上傳失敗無錯誤信息」。
• memory_limit 設過小：大文件移動、圖片處理時觸發 Allowed memory exhausted。
• max_execution_time=0：生產環境慎用，防止掛起進程佔滿資源；建議設置合理上限 (如 300s) 並配合 Nginx client_max_body_size、proxy_read_timeout。

生產環境檢查清單

1. 建立專用臨時目錄：mkdir -p /var/tmp/php_upload && chown www-data:www-data /var/tmp/php_upload
2. 修改 php.ini 並重載 PHP-FPM：systemctl reload php-fpm
3. 同步調整 Nginx：client_max_body_size 100m;
4. 測試：上傳 10MB/50MB/100MB 文件，驗證 $_FILES['error'] 為 UPLOAD_ERR_OK。

配置修改後必須重載 PHP 進程生效。Windows 下修改 php.ini 需重啟 Apache/IIS。