EC-CUBEで画像アップロードできない時の対処法

EC-CUBEを利用していると、商品画像のアップロードができなくなることがあります。この記事では、よくある原因とその具体的な解決策を分かりやすく解説します。

よくある原因と対処法

1. 拡張子の制限

EC-CUBEでは、アップロードできるファイルの拡張子が設定ファイルにより制限されています。許可されていない拡張子の画像をアップロードするとエラーになります。

app/config/eccube/packages/eccube.yaml の eccube_file_uploadable_extensions に、必要な拡張子（例：jpg、pngなど）が含まれているか確認してください。

2. ファイルサイズの制限

アップロードしようとしている画像のサイズが、PHPの制限を超えているとアップロードに失敗します。

以下の php.ini の設定を確認・調整しましょう：

• upload_max_filesize
• post_max_size

3. メモリ制限の影響

高解像度の画像を処理する際、PHPが割り当てられたメモリを超えると処理が止まります。memory_limit を増やすことで対処できます。

4. ディレクトリのパーミッション設定

画像ファイルの保存先ディレクトリに書き込み権限がない場合、アップロードが正常に完了しません。パーミッションを 755 あるいは 777 に設定することで解決することがあります。

5. ファイル名の重複

同じ名前のファイルを複数回アップロードすると、上書きや削除のタイミングで他の商品画像に影響を与えることがあります。ファイル名はできるだけ一意にしましょう。

チェックリスト

• アップロードしようとしている画像の拡張子は許可されているか？
• 画像ファイルのサイズが upload_max_filesize を超えていないか？
• PHPの memory_limit に余裕があるか？
• 保存先ディレクトリに書き込み権限があるか？
• ファイル名が既存のものと重複していないか？

代替手段：一時的なアップロードや共有に

商品画像が一時的にアップロードできない場面や、社内での確認用に画像を共有したい場合には、外部のファイルアップローダーを利用するのも一つの方法です。

uploadf.com は、PC・スマホ両対応の無料ファイルアップロードサービスで、ドラッグアンドドロップで簡単にファイルをアップロードできます。ファイルは最大100件まで同時アップロード可能で、保存期間は1ヶ月。画像形式を含む約150種類の拡張子に対応しています。

まとめ

EC-CUBEで画像アップロードができない原因は、設定ミスから環境要因まで様々です。まずは基本的なポイントをチェックし、必要に応じて外部サービスを活用しながら柔軟に対応していきましょう。

とっぷ   ヘルプ   連絡先   🏳️Language