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