대량메일 API에서 PHP 파일 첨부 시 한글 파일명을 사용할 수 있나요?
💡 요약 정리
- 서버 캐릭터셋(문자 인코딩) 영향으로 한글 파일명은 수신 측에서 깨지거나 첨부 실패가 발생할 수 있습니다.
- 대량메일 API에서 PHP로 첨부할 때는 영문 파일명 사용을 권장합니다.
- 테스트에서 정상이라도, 대규모 발송 전 다양한 메일 서비스와 기기에서 재확인하세요.
1. 한글 파일명이 문제가 되는 이유
- 발송 서버와 수신 메일 서버·클라이언트의 문자 인코딩(캐릭터셋)이 다르면, 첨부 파일명의 한글이 깨지거나 첨부 자체가 누락될 수 있습니다.
- 이 때문에 수신자가 첨부를 정상적으로 받지 못하는 사례가 발생할 수 있습니다.
- 결론적으로, API 발송 시 PHP에서 파일을 첨부할 때 한글 파일명 사용은 권장되지 않습니다.
2. 권장 사항: 파일명 작성 가이드
- 영문(알파벳)과 숫자만 사용하고, 필요 시 하이픈(-)·언더스코어(_)를 사용하세요.
- 공백, 특수문자(예: !, #, &, +, =, 한글 등)는 피하세요.
- 파일 확장자(.pdf, .xlsx 등)를 반드시 포함하세요.
- 예시
- 추천: invoice_2025-09-11.pdf, report-Q3_2025.xlsx
- 비추천: 견적서(최종).pdf, 영수증#최종.pdf
3. 발송 전 점검(테스트) 방법
- 소량을 먼저 테스트 발송하세요.
- 서로 다른 메일 서비스(예: 기업용/개인용 등)로 각각 보내 확인합니다.
- 데스크톱·모바일 환경에서 모두 열어 첨부 파일명이 정상 표시되는지 확인합니다.
- 파일명이 깨지거나 첨부가 누락되면 즉시 파일명을 영문화하여 재시험하세요.
4. 자주 묻는 질문
① 테스트에서 정상인데 계속 사용해도 되나요?
- 가능합니다. 다만 수신 환경이 바뀌면 문제가 재발할 수 있어, 항상 영문 파일명 사용을 권장합니다.
② 한글 내용(본문/파일 내용)은 사용해도 되나요?
- 본문 내용이나 파일 내부 텍스트가 한글인 것은 일반적으로 문제가 되지 않습니다. 본 FAQ의 초점은 “첨부 파일명”입니다.