EC-CUBE Lab
produced by Cajiya
EC-CUBEに関するカスタマイズ方法やトラブルへの対処方法を発信

EC-CUBE 4系でテンプレートアップロード時に2MB制限エラーが発生する問題の解決方法

公開日: 2025年10月12日 | 更新日: 2025年11月27日
テンプレート(管理画面) 送信失敗 EC-CUBE 4系全般 設定変更

要望や症状

発生する症状

EC-CUBE 4系の管理画面でテンプレートファイルをアップロードしようとすると、「2MB上限」というエラーメッセージが表示され、ファイルのアップロードが失敗してしまいます。

この問題は特に、デザインテンプレートや大きなサイズのテーマファイルをアップロードする際に頻繁に発生します。

理由や原因

原因

この問題の原因は、サーバー側のPHP設定値である upload_max_filesize が2MBに制限されていることです。そのため、2MBを超えるサイズのファイルをアップロードしようとすると、サーバー側で処理が拒否されてしまいます。

EC-CUBE 4系では、従来のバージョンにあった管理画面上でのファイルサイズ制限設定(TEMPLATE_SIZE パラメータ)が削除されており、完全にサーバー側のPHP設定に依存する仕様に変更されています。

解決策

解決方法

PHPの設定値を変更する

サーバーのPHP設定ファイル(php.ini)で以下の値を適切なサイズに変更します。

# アップロード可能な最大ファイルサイズ
upload_max_filesize = 10M

# POSTデータの最大サイズ(upload_max_filesizeより大きく設定)
post_max_size = 12M

# 最大実行時間(大きなファイルのアップロード用)
max_execution_time = 300

# メモリ制限
memory_limit = 256M

設定変更の手順

1. php.iniファイルの場所を確認します

php --ini

2. 設定ファイルを編集します

テキストエディタでphp.iniファイルを開き、上記の値を適切なサイズに変更します。この際、upload_max_filesize の値は post_max_size より小さく設定する必要があります。

3. Webサーバーを再起動します

設定変更を反映するため、使用しているWebサーバーを再起動します。

# Apacheの場合
sudo systemctl restart apache2

# Nginx + PHP-FPMの場合
sudo systemctl restart nginx
sudo systemctl restart php-fpm

4. 設定が正しく反映されているか確認します

EC-CUBE管理画面のシステム設定 > システム情報から、PHP設定値が正しく変更されているかを確認できます。または、phpinfo() 関数を使用して現在の設定値を確認することも可能です。

共用サーバーでの対応方法

共用サーバーでphp.iniファイルの編集ができない場合は、EC-CUBEのルートディレクトリに .htaccess ファイルを作成または編集して設定を変更できます。

# .htaccess
php_value upload_max_filesize 10M
php_value post_max_size 12M
php_value max_execution_time 300
php_value memory_limit 256M

設定時の注意事項

設定値を過度に大きくすると、サーバーリソースを圧迫する可能性があります。セキュリティ上の観点からも、必要最小限のサイズに設定することを強く推奨します。

また、共用サーバーをご利用の場合、ホスティング会社側の制限により、設定変更が反映されない場合があります。その際は、サーバー管理者またはホスティング会社にお問い合わせください。

免責事項

本記事に掲載しているコードや手順は、執筆時点での情報および特定の環境下での動作確認に基づいています。 EC-CUBEのバージョン、サーバー環境、導入済みプラグインとの競合などにより、予期せぬ不具合が発生する可能性があります。

本記事の内容を実行した結果、生じた損害(データの消失、サイトの停止、機会損失など)について、当サイトおよび管理者は一切の責任を負いかねます。 実装にあたっては、必ずバックアップを取得し、検証環境(テスト環境)での動作確認を行った上で、ご自身の責任において実施してください。

この記事は参考になりましたか?

著者プロフィール: 株式会社カジヤ

当社はWeb業界の専門家として、培った経験や技術、自社事業を通して得た知見を土台に、 お客様の事業の成長を後押しすることを提供価値として活動する、Web事業の成長支援会社です。 EC-CUBE公式のパートナー制度「EC-CUBE インテグレートパートナー」に登録してしており、上位11%にあたる「ゴールドランク」に認定された実績があり、新しい通販サイトの構築から、カスタマイズ、リニューアルまで幅広く対応します。

EC-CUBE 4系全般 の関連記事

商品 データ不整合 EC-CUBE 4系全般
EC-CUBEで取り扱い終了商品の削除ができない理由と対応方法

EC-CUBEでは、取り扱いを終了した商品を削除したい場合に、削除ができない状態になることがあります...

👍 1 / 👎 0 2025年10月12日
インストール・セットアップ EC-CUBE 4系全般 設定変更
EC-CUBEサイトのドメイン変更時の設定変更方法

EC-CUBEで構築したサイトを新しいドメインで公開する際に、どのような設定変更が必要かわからない場...

👍 0 / 👎 0 2025年10月12日
メール通知 通知/コミュニケーション EC-CUBE 4系全般
メール件名のショップ名を英語表記に変更する方法

EC-CUBE 4系で、メール件名の先頭に自動挿入される店舗名を英語表記に変更したい場合があります。...

👍 0 / 👎 0 2025年10月12日
フロント共通 機能不動作 EC-CUBE 4系全般
CloudFrontを利用時にリンクのドメインがEC2のパブリックDNSになってしまう問題の解決方法

EC-CUBE 4.2をAWS ECS on EC2上で構築し、CloudFrontをCDNとして利...

👍 1 / 👎 0 2025年10月12日
サイト全体 500エラー EC-CUBE 4系全般
EC-CUBEでメモリ不足エラーが発生した場合の対処方法

EC-CUBEの運用中に以下のようなメモリ不足エラーが発生することがあります。 ### エラー...

👍 1 / 👎 0 2025年10月12日

設定変更 の関連記事

インストール・セットアップ EC-CUBE 4系全般 設定変更
EC-CUBEサイトのドメイン変更時の設定変更方法

EC-CUBEで構築したサイトを新しいドメインで公開する際に、どのような設定変更が必要かわからない場...

👍 0 / 👎 0 2025年10月12日
フロント共通 機能不動作 EC-CUBE 4系全般
CloudFrontを利用時にリンクのドメインがEC2のパブリックDNSになってしまう問題の解決方法

EC-CUBE 4.2をAWS ECS on EC2上で構築し、CloudFrontをCDNとして利...

👍 1 / 👎 0 2025年10月12日
サイト全体 500エラー EC-CUBE 4系全般
EC-CUBEでメモリ不足エラーが発生した場合の対処方法

EC-CUBEの運用中に以下のようなメモリ不足エラーが発生することがあります。 ### エラー...

👍 1 / 👎 0 2025年10月12日
管理画面共通 パフォーマンス劣化 EC-CUBE 4系全般
EC-CUBEのlogフォルダ肥大化の管理方法

var/log/prodフォルダ内のログファイルが肥大化し、ディスク容量を圧迫している状況が発生しま...

👍 1 / 👎 0 2025年10月12日
管理画面共通 機能不動作 EC-CUBE 4系全般
.htaccessを使用したIPアドレス制限とメンテナンス画面表示の設定方法

EC-CUBE 4系において、機能リリースなどのタイミングで一般のユーザーにはメンテナンスモードを表...

👍 1 / 👎 0 2025年10月12日