그누보드 스마트에디터 이미지 업로드 용량 제한 및 리사이즈 설정 가이드

페이지 정보

작성자 최고관리자
댓글 0건 조회 10회 작성일 26-10-05 16:52

본문

그누보드 스마트에디터에서 이미지 업로드 시 발생하는 용량 제한 문제를 해결하고, 업로드된 이미지를 자동으로 리사이즈하여 게시판 레이아웃을 최적화하는 방법을 안내합니다.

그누보드 스마트에디터 이미지 업로드 용량 및 리사이즈 설정

그누보드 스마트에디터의 이미지 업로드 용량 제한과 자동 리사이즈 기능은 extend/smarteditor_upload_extend.php 파일을 통해 설정할 수 있습니다. 수정 전 반드시 해당 파일의 원본을 백업하시기 바랍니다.

1. 이미지 업로드 용량 제한 설정

이미지 업로드 용량 제한은 SMARTEDITOR_UPLOAD_SIZE_LIMIT 상수를 통해 제어합니다. 설정된 용량을 초과하는 파일은 업로드가 차단되며, 무한 로딩 현상이 발생할 수 있습니다.

설정 위치: extend/smarteditor_upload_extend.php
설정 방법: define('SMARTEDITOR_UPLOAD_SIZE_LIMIT', 20); (기본값 20MB)
주의사항: 용량 제한에 걸리면 리사이즈 로직이 실행되기 전에 업로드가 차단되므로, 리사이즈 기능을 사용하려면 먼저 업로드 용량 제한을 충분히 확보해야 합니다.

2. 이미지 자동 리사이즈 설정

이미지 리사이즈는 용량이 아닌 가로·세로 크기를 기준으로 작동합니다. 리사이즈를 활성화하려면 먼저 기능을 켜야 합니다.

기능 활성화: define('SMARTEDITOR_UPLOAD_RESIZE', 1); (1: 사용, 0: 사용 안 함)
최대 크기 지정:
- define('SMARTEDITOR_UPLOAD_MAX_WIDTH', 1200); (최대 가로 폭)
- define('SMARTEDITOR_UPLOAD_MAX_HEIGHT', 2800); (최대 세로 높이)
동작 방식: 설정된 가로·세로 크기보다 큰 이미지를 업로드할 경우, 원본 비율을 유지하며 설정된 최대 수치에 맞춰 자동으로 축소됩니다. 고정된 크기로 강제 변환되는 것이 아니라 최대 수치를 기준으로 비율에 맞게 줄어듭니다.

스마트에디터 이미지 자동 리사이즈 설정 방법

그누보드 스마트에디터에서 업로드되는 이미지를 자동으로 리사이즈하려면 extend/smarteditor_upload_extend.php 파일을 수정해야 합니다. 이 설정은 업로드된 이미지가 지정된 최대 가로/세로 크기를 초과할 경우, 원본 비율을 유지하며 자동으로 축소합니다.

설정 단계

파일 백업: 수정 전 반드시 extend/smarteditor_upload_extend.php 파일을 별도의 폴더에 백업하십시오.
리사이즈 기능 활성화: 해당 파일에서 SMARTEDITOR_UPLOAD_RESIZE 상수를 찾아 값을 1로 변경합니다.
```
define('SMARTEDITOR_UPLOAD_RESIZE', 1); // 1이면 사용, 0이면 사용안함
```

최대 크기 지정: 리사이즈 기준이 될 최대 가로(MAX_WIDTH)와 세로(MAX_HEIGHT) 수치를 설정합니다.

define('SMARTEDITOR_UPLOAD_MAX_WIDTH', 1200); // 최대 가로 크기
define('SMARTEDITOR_UPLOAD_MAX_HEIGHT', 2800); // 최대 세로 크기

주의사항 및 확인

용량 제한과의 관계: 리사이즈 기능은 업로드가 정상적으로 완료된 후 실행됩니다. 따라서 SMARTEDITOR_UPLOAD_SIZE_LIMIT으로 설정된 용량 제한을 초과하는 파일은 업로드 자체가 차단되어 리사이즈 로직이 작동하지 않습니다. 리사이즈를 원한다면 먼저 업로드 용량 제한을 적절히 설정해야 합니다.
리사이즈 방식: 설정된 수치는 고정 크기가 아닌 '최대 수치'입니다. 이미지의 가로 또는 세로 중 하나라도 설정값을 초과하면, 비율에 맞춰 자동으로 축소됩니다.
적용 확인: 설정 변경 후, 제한 용량보다 작지만 설정한 가로/세로 크기보다 큰 이미지를 업로드하여 정상적으로 리사이즈되어 저장되는지 확인하십시오.

구버전 그누보드 참고

extend 확장 파일이 없는 그누보드 이전 버전에서는 업로드 핸들러 파일(예: UploadHandler.php)을 직접 수정하여 용량 제한 등을 설정해야 합니다.

구버전 그누보드 스마트에디터 업로드 설정

extend/smarteditor_upload_extend.php 파일이 존재하지 않는 구버전 그누보드 환경에서는 스마트에디터의 업로드 핸들러 파일을 직접 수정하여 용량 제한을 설정할 수 있습니다. 다만, 구버전의 경우 최신 버전과 달리 이미지 자동 리사이즈 로직이 기본적으로 포함되어 있지 않을 수 있습니다.

1. 업로드 용량 제한 설정

plugin/editor/smarteditor2/photo_uploader/popup/php/UploadHandler.php 파일을 수정합니다.

용량 제한 변경: 파일 내 $post_max_size 관련 설정을 찾아 원하는 용량(MB 단위)으로 수정합니다.
```
$post_max_size = $this->get_config_bytes('2M'); // 2MB로 제한 시
```
안내 메시지 한글화: 용량 초과 시 발생하는 영문 메시지를 한글로 변경하려면 해당 파일 내 메시지 정의 부분을 수정합니다.
```
'post_max_size' => '허용 용량을 초과하였습니다.',
```

2. 자동 리사이즈 기능 확인 및 주의사항

기능 구현 여부: 구버전 환경의 UploadHandler.php에는 이미지 자동 리사이즈 로직이 기본적으로 포함되어 있지 않습니다. 따라서 해당 기능을 사용하려면 별도의 리사이즈 라이브러리를 도입하거나 관련 코드를 직접 구현해야 합니다.
백업 필수: 파일을 수정하기 전 반드시 원본 파일을 백업하십시오.
서버 설정 확인: 해당 설정값은 서버의 php.ini에 정의된 post_max_size 및 upload_max_filesize 값보다 작거나 같아야 정상적으로 동작합니다.

상황별 설정 가이드

내 상황	선택 기준	다음 행동
업로드 시 무한 로딩 발생	용량 제한 초과	`extend/smarteditor_upload_extend.php`의 `SMARTEDITOR_UPLOAD_SIZE_LIMIT` 상향
큰 이미지 자동 리사이즈 필요	기능 비활성화 상태	`SMARTEDITOR_UPLOAD_RESIZE`를 `1`로 변경 후 최대 크기 지정
구버전 그누보드 사용	`extend` 폴더 부재	`plugin/editor/smarteditor2/photo_uploader/popup/php/UploadHandler.php` 수정

설정 시 주의사항

백업: 수정 전 반드시 원본 파일을 별도 폴더에 복사하십시오.
우선순위: 용량 제한에 걸리면 리사이즈 로직이 실행되지 않으므로, 용량 제한을 먼저 확보해야 합니다.
리사이즈 방식: 설정된 수치는 고정 크기가 아닌 '최대 수치'이며, 원본 비율을 유지하며 축소됩니다.

실전 FAQ

Q. 용량 제한을 늘렸는데도 리사이즈가 작동하지 않습니다.

리사이즈는 업로드가 정상적으로 완료된 후 실행됩니다. 업로드 용량 제한(SMARTEDITOR_UPLOAD_SIZE_LIMIT)이 파일 크기보다 작으면 업로드 자체가 차단되어 리사이즈 로직에 도달하지 못합니다. 용량 제한을 파일 크기보다 크게 설정했는지 다시 확인하십시오.

Q. 리사이즈 설정 후에도 이미지가 원본 크기로 올라갑니다.

SMARTEDITOR_UPLOAD_RESIZE 상수가 1로 설정되어 있는지 확인하십시오. 또한, 서버 환경에서 GD 라이브러리가 활성화되어 있는지 확인해야 합니다. 관리자 > 환경설정 > phpinfo()에서 gd 항목이 enabled 상태인지 확인하십시오.

Q. 구버전 그누보드라 extend 폴더에 설정 파일이 없습니다.

구버전은 plugin/editor/smarteditor2/photo_uploader/popup/php/UploadHandler.php 파일을 직접 수정해야 합니다. 해당 파일 내 $post_max_size 설정을 찾아 용량을 조정하십시오. 단, 구버전은 자동 리사이즈 로직이 기본 포함되지 않았을 수 있어 별도 구현이 필요할 수 있습니다.

참고자료

기타 참고자료

이전글PHP에서 소수점 이하 특정 자릿수 버림 함수 구현 방법 26.10.05
다음글그누보드 그룹 접근 권한 목록 페이지 차단 설정 26.10.05

댓글목록

등록된 댓글이 없습니다.