T2Editor는 그누보드5와 연동할 뿐만 아니라, 단독으로도 사용할 수 있는 구조로 설계되어 있습니다. 독립형으로 사용할 때에는 다음 사항을 고려해야 합니다:
t2editor 폴더를 업로드하고 적절한 URL로 접근합니다.editor.lib.php를 포함한 PHP 파일에서 에디터를 불러오고 초기 설정을 수행합니다.editor.lib.php의 설정을 따릅니다./data와 /collab 디렉터리를 서버에 생성하여 권한을 707로 설정해야 합니다.독립형으로 사용할 경우 그누보드5의 게시판이나 폼과 연결되지 않으므로, 데이터 저장 및 표시를 위한 별도의 구현이 필요할 수 있습니다.
독립형 운영의 가장 큰 장점은 그누보드5의 게시판 구조에 묶이지 않고 원하는 프로젝트에 바로 붙일 수 있다는 점입니다. 자체 CMS, 사내 문서 시스템, 고객 전용 입력 폼, 간단한 관리 콘솔 등에 쉽게 이식할 수 있습니다. 반면 게시물 저장, 권한 제어, 첨부파일 정리, 스팸 차단, 관리자 UI 같은 것은 직접 설계해야 하므로 “설치가 더 자유롭다”는 것이 곧 “운영도 더 쉽다”는 뜻은 아닙니다.
독립형에서는 먼저 config/t2_config.php의 경로 상수와 URL 상수가 현재 배포 위치와 일치하는지 확인해야 합니다. 그 다음 editor.lib.php를 포함하는 테스트 페이지를 하나 만들어 최소한의 글쓰기 화면이 정상적으로 뜨는지 확인하고, 이미지 업로드·파일 업로드·자동 저장·내보내기·다크 모드 전환을 차례로 검수하는 것이 좋습니다. 기능이 하나라도 실패하면 서버 권한과 업로드 경로부터 먼저 점검해야 합니다.
그누보드5 환경에서는 어느 정도 검증과 권한 처리가 이미 존재하지만, 독립형에서는 업로드 검증과 입력 검증을 직접 준비해야 합니다. 허용 확장자, MIME 검사, 업로드 파일명 정규화, 저장 디렉터리 접근 제한, XSS 필터링 여부를 반드시 운영 전에 검토하십시오. 특히 코드 블록과 HTML 내보내기 기능을 함께 사용할 때는 뷰어 쪽 필터 정책을 명확히 해두는 것이 좋습니다.
T2Editor는 그누보드5와 연동할 뿐만 아니라, 단독으로도 사용할 수 있는 구조로 설계되어 있습니다.
이 문서는 2026-09-28에 v10.5.1 기준으로 다시 썼습니다. 9.x 이하 계열은 EOL이며 업데이트 대상이 아닙니다. 독립형으로 사용할 때에는 다음 사항을 고려해야 합니다:
ZipArchive가 없으면 내장 zlib 파서로 처리하고, 그것도 없으면 관리자 브라우저가 압축 해제를 보조합니다. ③ mbstring: 없어도 iconv 또는 UTF-8 대체 경로로 동작합니다. ④ GD/ImageMagick: 업로드를 막는 필수 판정은 아닙니다. 어느 항목이 필수인지는 에디터 하단 정보·진단 화면의 "현재 서버 점검 결과"가 등급(error/warning)과 함께 표시합니다.t2editor 폴더를 업로드하고 적절한 URL로 접근합니다.editor.lib.php를 포함한 PHP 파일에서 에디터를 불러오고 초기 설정을 수행합니다.editor.lib.php는 43줄짜리 부트스트랩이라 여기서 아무것도 설정하지 않습니다. 플러그인 목록과 로딩 우선순위의 기본값은 editor.core.php가 가지고 있고(if (!isset(...)) 가드이므로 extend/php/가 먼저 값을 정의하면 그 값을 보존), 운영 중 변경은 통합 관리 페이지에서 합니다(10.2.0). 60-plugin-development-guide.md를 보십시오.<t2editor>/data/ 하나만 쓰기 가능하면 됩니다. 그 아래 data/t2editor_db/(관리자 설정·인증 정보·협업 상태·업데이트 기록)와 data/t2editor_db/collab/은 에디터가 첫 요청 때 자동 생성합니다. 직접 만들지 마십시오. 최소 권장값은 707이며, 777은 필요 이상이라 권장하지 않습니다. 다만 숫자만 보고 무작정 chmod하지 말고, 에디터 하단 정보·진단 화면 → 현재 서버 점검 결과가 주는 실제 경로와 명령을 따르십시오. PHP 실제 쓰기 시험이 이미 통과하면 그 권한을 그대로 유지해도 됩니다. 예전에 만든 <t2editor>/collab/이 남아 있으면 10.5.1이 최초 실행 때 자동으로 새 위치로 옮깁니다.admin/t2admin.key.txt 파일명을 admin/t2admin.key로 변경 ② 관리자 페이지에서 관리자 비밀번호 설정 ③ 공용 데이터 디렉터리를 최소 권장 707로 맞추고 실제 PHP 쓰기 시험 통과 ④ 안내를 마지막까지 읽고 확인. 스탠데얼론은 CMS 인증이 없으므로 ①②가 반드시 필요합니다. 안내 화면은 설치 경로·환경에 맞춘 실제 명령과 FTP 권한 설정법까지 안내합니다. 관리자 페이지는 t2editor/admin/index.php입니다. 자세한 건 01-installation-guide.md 4절·N-02-admin-console-guide.md를 보십시오.독립형으로 사용할 경우 그누보드5의 게시판이나 폼과 연결되지 않으므로, 데이터 저장 및 표시를 위한 별도의 구현이 필요할 수 있습니다.
서버측 본문 XSS 필터는 10.5.1에 포함되어 있지 않습니다. 에디터 안의 검사는 전부 브라우저에서 돌아가므로, curl 한 줄이면 그 검사를 지나지 않습니다. 스탠데얼론은 저장 지점에서 본문을 직접 거르는 코드를 작성자가 붙여야 합니다. 자세한 건 N-06-server-sanitize-and-content-style.md를 보십시오.
독립형 운영의 가장 큰 장점은 그누보드5의 게시판 구조에 묶이지 않고 원하는 프로젝트에 바로 붙일 수 있다는 점입니다. 자체 CMS, 사내 문서 시스템, 고객 전용 입력 폼, 간단한 관리 콘솔 등에 쉽게 이식할 수 있습니다. 반면 게시물 저장, 권한 제어, 첨부파일 정리, 스팸 차단, 관리자 UI 같은 것은 직접 설계해야 하므로 “설치가 더 자유롭다”는 것이 곧 “운영도 더 쉽다”는 뜻은 아닙니다.
독립형에서는 먼저 config/t2_config.php의 경로 상수와 URL 상수가 현재 배포 위치와 일치하는지 확인해야 합니다. 그 다음 editor.lib.php를 포함하는 테스트 페이지를 하나 만들어 최소한의 글쓰기 화면이 정상적으로 뜨는지 확인하고, 이미지 업로드·파일 업로드·자동 저장·내보내기·다크 모드 전환을 차례로 검수하는 것이 좋습니다. 기능이 하나라도 실패하면 서버 권한과 업로드 경로부터 먼저 점검해야 합니다.
그누보드5 환경에서는 어느 정도 검증과 권한 처리가 이미 존재하지만, 독립형에서는 업로드 검증과 입력 검증을 직접 준비해야 합니다. 허용 확장자, MIME 검사, 업로드 파일명 정규화, 저장 디렉터리 접근 제한, XSS 필터링 여부를 반드시 운영 전에 검토하십시오. 특히 코드 블록과 HTML 내보내기 기능을 함께 사용할 때는 뷰어 쪽 필터 정책을 명확히 해두는 것이 좋습니다.
| 이전 | 새 버전 | ||
|---|---|---|---|
| 1 | --- | 1 | --- |
| 2 | title: Standalone 사용 가이드 | 2 | title: Standalone 사용 가이드 |
| 3 | document_id: 04-standalone-guide | 3 | document_id: 04-standalone-guide |
| 4 | slug: 04-standalone-guide | 4 | slug: 04-standalone-guide |
| 5 | target_editor_version: 9.0.0 | 5 | target_editor_version: 10.5.1 |
| 6 | document_type: integration | 6 | document_type: integration |
| 7 | doc_type: integration | 7 | doc_type: integration |
| 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] | 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] |
| 9 | importance: High | 9 | importance: High |
| 10 | dependency: Medium | 10 | dependency: Medium |
| 11 | core_type: Integration | 11 | core_type: Integration |
| 12 | stability: [Version-Bound] | 12 | stability: [Version-Bound] |
| 13 | stable_anchor: [] | 13 | stable_anchor: [] |
| 14 | version_bound: [] | 14 | version_bound: [] |
| 15 | related_docs: [] | 15 | related_docs: [] |
| 16 | related_files: [] | 16 | related_files: [] |
| 17 | related_functions: [] | 17 | related_functions: [] |
| 18 | related_classes_modules: [] | 18 | related_classes_modules: [] |
| 19 | related_features: [] | 19 | related_features: [] |
| 20 | related_ui: [] | 20 | related_ui: [] |
| 21 | change_risk: 수정 범위를 넓게 잡으면 관련 기능과 문서 흐름에 영향이 생길 수 있습니다. | 21 | change_risk: 수정 범위를 넓게 잡으면 관련 기능과 문서 흐름에 영향이 생길 수 있습니다. |
| 22 | reading_order: 05 | 22 | reading_order: 05 |
| 23 | summary: T2Editor를 독립형으로 사용하는 방법과 주의사항 문서 | 23 | summary: T2Editor를 독립형으로 사용하는 방법과 주의사항 문서 |
| 24 | description: T2Editor를 독립형으로 사용하는 방법과 주의사항 | 24 | description: T2Editor를 독립형으로 사용하는 방법과 주의사항 |
| 25 | tags: [standalone, T2Editor, integration] | 25 | tags: [standalone, T2Editor, integration] |
| 26 | version_tag: 9.0.0 | 26 | version_tag: 10.5.1 |
| 27 | maintenance_difficulty: Medium | 27 | maintenance_difficulty: Medium |
| 28 | test_requirement: Medium | 28 | test_requirement: Medium |
| 29 | ai_agent_risk: Medium | 29 | ai_agent_risk: Medium |
| 30 | source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] | 30 | source_basis: [현재 코드 분석 기반, 공식 릴리즈 노트 기반, 공식 배포판 실물 기반] |
| 31 | beginner_section_included: true | 31 | beginner_section_included: true |
| 32 | webmaster_section_included: true | 32 | webmaster_section_included: true |
| 33 | developer_section_included: true | 33 | developer_section_included: true |
| 34 | --- | 34 | --- |
| 35 | ## 독립형 사용 가이드 | 35 | ## 독립형 사용 가이드 |
| 36 | 36 | ||
| 37 | T2Editor는 그누보드5와 연동할 뿐만 아니라, 단독으로도 사용할 수 있는 구조로 설계되어 있습니다. 독립형으로 사용할 때에는 다음 사항을 고려해야 합니다: | 37 | T2Editor는 그누보드5와 연동할 뿐만 아니라, 단독으로도 사용할 수 있는 구조로 설계되어 있습니다. |
| 38 | - **환경 요구 사항**: PHP 7.4 이상, GD 라이브러리 및 cURL 확장 모듈이 설치된 Apache 또는 Nginx 서버가 필요합니다. | 38 | |
| 39 | > 이 문서는 2026-09-28에 v10.5.1 기준으로 다시 썼습니다. 9.x 이하 계열은 EOL이며 업데이트 대상이 아닙니다. 독립형으로 사용할 때에는 다음 사항을 고려해야 합니다: | ||
| 40 | - **환경 요구 사항**: PHP **7.4 이상**(신규 운영은 8.1 또는 8.2 권장)이 필요하며, 7.4~8.4 호환을 유지합니다. 10.0.0(2026-06-24) 노트가 PHP "권장 사양"을 8.0 이상으로 올렸지만 10.1.0(2026-06-29) 노트 "php7.4 호환 추가!"로 되돌렸고, 10.5.0 노트는 "PHP 7.4부터 8.4까지의 호환 범위를 유지"라고 적습니다. **즉 7.4에서 동작하며 8.0은 필수가 아닙니다.** 확장에 따라 요구가 갈립니다 — ① **cURL**: 업데이트·패키지 다운로드는 cURL이 없으면 OpenSSL + allow_url_fopen 스트림으로 대체되지만, **확장 마켓(서드파티 설치)은 cURL이 필수**입니다. ② **ZIP 처리**: `ZipArchive`가 없으면 내장 zlib 파서로 처리하고, 그것도 없으면 관리자 브라우저가 압축 해제를 보조합니다. ③ **mbstring**: 없어도 iconv 또는 UTF-8 대체 경로로 동작합니다. ④ **GD/ImageMagick**: **업로드를 막는 필수 판정은 아닙니다.** 어느 항목이 필수인지는 에디터 하단 정보·진단 화면의 "현재 서버 점검 결과"가 등급(error/warning)과 함께 표시합니다. | ||
| 39 | - **설치 위치**: 웹 루트 또는 원하는 경로에 `t2editor` 폴더를 업로드하고 적절한 URL로 접근합니다. | 41 | - **설치 위치**: 웹 루트 또는 원하는 경로에 `t2editor` 폴더를 업로드하고 적절한 URL로 접근합니다. |
| 40 | - **초기화**: `editor.lib.php`를 포함한 PHP 파일에서 에디터를 불러오고 초기 설정을 수행합니다. | 42 | - **초기화**: `editor.lib.php`를 포함한 PHP 파일에서 에디터를 불러오고 초기 설정을 수행합니다. |
| 41 | - **플러그인 관리**: 플러그인 로딩 및 우선순위 설정은 `editor.lib.php`의 설정을 따릅니다. | 43 | - **플러그인 관리**: 10.5.1의 `editor.lib.php`는 43줄짜리 부트스트랩이라 여기서 아무것도 설정하지 않습니다. 플러그인 목록과 로딩 우선순위의 기본값은 `editor.core.php`가 가지고 있고(`if (!isset(...))` 가드이므로 `extend/php/`가 먼저 값을 정의하면 그 값을 보존), **운영 중 변경은 통합 관리 페이지에서 합니다(10.2.0).** [[60-plugin-development-guide.md]]를 보십시오. |
| 42 | - **데이터 저장**: 독립형 사용 시에는 `/data`와 `/collab` 디렉터리를 서버에 생성하여 권한을 707로 설정해야 합니다. | 44 | - **데이터 저장**: 스탠데얼론에서는 `<t2editor>/data/` **하나만** 쓰기 가능하면 됩니다. 그 아래 `data/t2editor_db/`(관리자 설정·인증 정보·협업 상태·업데이트 기록)와 `data/t2editor_db/collab/`은 **에디터가 첫 요청 때 자동 생성합니다.** 직접 만들지 마십시오. 최소 권장값은 707이며, 777은 필요 이상이라 권장하지 않습니다. 다만 숫자만 보고 무작정 chmod하지 말고, 에디터 하단 **정보·진단 화면 → 현재 서버 점검 결과**가 주는 실제 경로와 명령을 따르십시오. PHP 실제 쓰기 시험이 이미 통과하면 그 권한을 그대로 유지해도 됩니다. 예전에 만든 `<t2editor>/collab/`이 남아 있으면 10.5.1이 최초 실행 때 자동으로 새 위치로 옮깁니다. |
| 45 | - **최초 설치 게이트**: 업로드 뒤 첫 글쓰기 화면에서 **T2Editor 최초 설치 안내**가 뜨고, 끝까지 통과하기 전까지 편집 기능이 잠깁니다. 안내가 요구하는 것은 ① `admin/t2admin.key.txt` 파일명을 `admin/t2admin.key`로 변경 ② 관리자 페이지에서 관리자 비밀번호 설정 ③ 공용 데이터 디렉터리를 최소 권장 707로 맞추고 실제 PHP 쓰기 시험 통과 ④ 안내를 마지막까지 읽고 확인. **스탠데얼론은 CMS 인증이 없으므로 ①②가 반드시 필요합니다.** 안내 화면은 설치 경로·환경에 맞춘 실제 명령과 FTP 권한 설정법까지 안내합니다. 관리자 페이지는 `t2editor/admin/index.php`입니다. 자세한 건 [[01-installation-guide.md]] 4절·[[N-02-admin-console-guide.md]]를 보십시오. | ||
| 43 | 46 | ||
| 44 | 독립형으로 사용할 경우 그누보드5의 게시판이나 폼과 연결되지 않으므로, 데이터 저장 및 표시를 위한 별도의 구현이 필요할 수 있습니다. | 47 | 독립형으로 사용할 경우 그누보드5의 게시판이나 폼과 연결되지 않으므로, 데이터 저장 및 표시를 위한 별도의 구현이 필요할 수 있습니다. |
| 45 | 48 | ||
| 49 | 서버측 본문 XSS 필터는 10.5.1에 포함되어 있지 않습니다. 에디터 안의 검사는 전부 브라우저에서 돌아가므로, curl 한 줄이면 그 검사를 지나지 않습니다. 스탠데얼론은 저장 지점에서 본문을 직접 거르는 코드를 작성자가 붙여야 합니다. 자세한 건 [[N-06-server-sanitize-and-content-style.md]]를 보십시오. | ||
| 50 | |||
| 46 | ## 참고 자료 | 51 | ## 참고 자료 |
| 47 | 52 | ||
| 48 | - 기능 설명: [DSclub T2Editor 서비스 페이지](https://dsclub.kr/service/editor) | 53 | - 기능 설명: [DSclub T2Editor 서비스 페이지](https://dsclub.kr/service/editor) |
| 49 | - 설치 안내: [DSclub T2Editor 서비스 페이지 - 설치·오류 안내](https://dsclub.kr/service/editor) | 54 | - 설치 안내: [DSclub T2Editor 서비스 페이지 - 설치·오류 안내](https://dsclub.kr/service/editor) |
| 50 | 55 | ||
| 51 | ## 독립형 운영 시 장점과 한계 | 56 | ## 독립형 운영 시 장점과 한계 |
| 52 | 57 | ||
| 53 | 독립형 운영의 가장 큰 장점은 그누보드5의 게시판 구조에 묶이지 않고 원하는 프로젝트에 바로 붙일 수 있다는 점입니다. 자체 CMS, 사내 문서 시스템, 고객 전용 입력 폼, 간단한 관리 콘솔 등에 쉽게 이식할 수 있습니다. 반면 게시물 저장, 권한 제어, 첨부파일 정리, 스팸 차단, 관리자 UI 같은 것은 직접 설계해야 하므로 “설치가 더 자유롭다”는 것이 곧 “운영도 더 쉽다”는 뜻은 아닙니다. | 58 | 독립형 운영의 가장 큰 장점은 그누보드5의 게시판 구조에 묶이지 않고 원하는 프로젝트에 바로 붙일 수 있다는 점입니다. 자체 CMS, 사내 문서 시스템, 고객 전용 입력 폼, 간단한 관리 콘솔 등에 쉽게 이식할 수 있습니다. 반면 게시물 저장, 권한 제어, 첨부파일 정리, 스팸 차단, 관리자 UI 같은 것은 직접 설계해야 하므로 “설치가 더 자유롭다”는 것이 곧 “운영도 더 쉽다”는 뜻은 아닙니다. |
| 54 | 59 | ||
| 55 | ## 권장 독립형 초기화 절차 | 60 | ## 권장 독립형 초기화 절차 |
| 56 | 61 | ||
| 57 | 독립형에서는 먼저 `config/t2_config.php`의 경로 상수와 URL 상수가 현재 배포 위치와 일치하는지 확인해야 합니다. 그 다음 `editor.lib.php`를 포함하는 테스트 페이지를 하나 만들어 최소한의 글쓰기 화면이 정상적으로 뜨는지 확인하고, 이미지 업로드·파일 업로드·자동 저장·내보내기·다크 모드 전환을 차례로 검수하는 것이 좋습니다. 기능이 하나라도 실패하면 서버 권한과 업로드 경로부터 먼저 점검해야 합니다. | 62 | 독립형에서는 먼저 `config/t2_config.php`의 경로 상수와 URL 상수가 현재 배포 위치와 일치하는지 확인해야 합니다. 그 다음 `editor.lib.php`를 포함하는 테스트 페이지를 하나 만들어 최소한의 글쓰기 화면이 정상적으로 뜨는지 확인하고, 이미지 업로드·파일 업로드·자동 저장·내보내기·다크 모드 전환을 차례로 검수하는 것이 좋습니다. 기능이 하나라도 실패하면 서버 권한과 업로드 경로부터 먼저 점검해야 합니다. |
| 58 | 63 | ||
| 59 | ## 독립형에 특히 필요한 보안 점검 | 64 | ## 독립형에 특히 필요한 보안 점검 |
| 60 | 65 | ||
| 61 | 그누보드5 환경에서는 어느 정도 검증과 권한 처리가 이미 존재하지만, 독립형에서는 업로드 검증과 입력 검증을 직접 준비해야 합니다. 허용 확장자, MIME 검사, 업로드 파일명 정규화, 저장 디렉터리 접근 제한, XSS 필터링 여부를 반드시 운영 전에 검토하십시오. 특히 코드 블록과 HTML 내보내기 기능을 함께 사용할 때는 뷰어 쪽 필터 정책을 명확히 해두는 것이 좋습니다. | 66 | 그누보드5 환경에서는 어느 정도 검증과 권한 처리가 이미 존재하지만, 독립형에서는 업로드 검증과 입력 검증을 직접 준비해야 합니다. 허용 확장자, MIME 검사, 업로드 파일명 정규화, 저장 디렉터리 접근 제한, XSS 필터링 여부를 반드시 운영 전에 검토하십시오. 특히 코드 블록과 HTML 내보내기 기능을 함께 사용할 때는 뷰어 쪽 필터 정책을 명확히 해두는 것이 좋습니다. |
| 62 | 67 | ||
| 63 | ## 참고 자료 | 68 | ## 참고 자료 |
| 64 | 69 | ||
| 65 | - DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor | 70 | - DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor |
| 66 | - DSclub 개발 및 관리 가이드: https://dsclub.kr/code/1403 | 71 | - DSclub 개발 및 관리 가이드: https://dsclub.kr/code/1403 |
| 67 | - SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016 | 72 | - SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016 |
| 73 | - 설치 절차(스탠드얼론 경로): [[01-installation-guide.md]] | ||
| 74 | - 배포판 구조: [[00-overview-macro-guide.md]] | ||
| 75 | - 서버측 정제 공백: [[N-06-server-sanitize-and-content-style.md]] | ||
| 68 | 76 | ||