버전 호환성 매트릭스 (현행판 10.5.1 기준)

이 문서는 2026-09-28에 다시 썼습니다.

원본은 target_editor_version: 9.0.0 기준이었고, 버전표가 9.0.0(2026-04-07)에서 멈춰 있었습니다.

그 사이 v10 계열 9개 판본이 나왔습니다. 그 구간이 이 문서의 공백이었습니다.

0. 한 줄 요약

1. 판본별 상태 매트릭스

계열 11개 · 합계 94개. 배포일은 all-versions.json 원문 값이며 일자 표기가 80/94건이 2026.03.26 같은 점 형식입니다(표기 혼재는 아래 6절).

| 계열 | 판본 수 | 첫 판본 | 최종판 | 최종판일 | 계열 수명 | 상태 | 판본 존재 근거 | |---|:-:|---|---|---|:-:|---|---| | v1 | 19 | 1.0.0-beta | 1.6.3 | 2025-05-01 | 90일 | EOL | S1b + T2Editor-v1 설명 [EOL] | | v2 | 3 | 2.0.0_B | 2.0.0 | 2025-06-03 | 34일 | EOL | S1b + T2Editor-v2 [EOL] | | v3 | 10 | 3.0.0 | 3.0.9 | 2025-10-06 | 122일 | EOL | S1b + T2Editor-v3 [EOL] | | v4 | 3 | 4.0.0 | 4.0.2 | 2025-10-08 | 2일 | EOL | S1b + T2Editor-v4 [EOL] | | v5 | 32 | 5.1.0-beta1.0.2 | 5.10.0 | 2025-12-08 | 62일 | EOL | S1b + T2Editor-v5 [EOL] | | v6 | 1 | 6.0.0 | 6.0.0 | 2025-12-09 | 1일 | EOL | S1b + T2Editor-v6 [EOL] | | v7 | 3 | 7.0.0 | 7.0.2 | 2025-12-19 | 6일 | EOL | S1b + T2Editor-v7 [EOL] | | v8 | 6 | 8.0.0 | 8.2.0 | 2026-03-26 | 87일 | EOL | S1b + T2Editor-v8 [EOL] | | v9 | 7 | 9.0.0 | 9.3.0 | 2026-05-29 | 53일 | EOL | S1b + T2Editor-v9 [EOL] | | v10 | 9 | 10.0.0 | 10.5.1 | 2026-07-27 | 34일 | 현행 공개 | S1 current_public + T2Editor-v10 설명 계열 상태 현행 공개 판본 | | v11 | 1 | 11.0.0-beta1.0.0 | — | 2026-09-07 | — | 개발 중(비공개) | S1 in_dev + gh api 결과 private: true |

1-1. 계열 EOL 표기의 실측 위치 — 릴리즈 노트에는 없습니다

계열이 끝났다는 표시는 94개 릴리즈 노트 어디에도 계열 단위로는 없습니다. 실제로 측정한 결과:

• 94개 릴리즈 노트(description) 전문 스캔 → 계열 단위 EOL 공지 0/10 계열
• 94개 title 스캔 → 계열 단위 EOL 공지 0건 (1건은 15일 뒤 대체된 베타 1.0.0-beta의 제목 주석)
• EOL 문자열은 GitHub 아카이브 저장소 설명에만 있습니다. tak2-08/T2Editor-v1 ~ T2Editor-v9 9개 저장소 설명이 각각 [EOL] T2Editor vN 계열 배포본 N개 … · 계열 상태 EOL 형식입니다. v10 저장소 설명에는 [EOL] 이 없고 계열 상태 현행 공개 판본 입니다.
• 업그레이드 위험 신호를 릴리즈 노트에서 찾으려고 하면 주의 0/94, breaking 0/94 입니다.
• ⚠ 위 EOL 저장소 9개는 2026-09-27 당일 일괄 생성되었습니다. 즉 최초 0일, 최대 18개월 사후 고지입니다.

따라서 EOL 판정은 배포 노트를 읽어서 알 수 없습니다. 이 표를 보십시오.

1-2. 이 위키가 94판본 중 9개(9.6%)만 알고 있었습니다

서버가 보관하는 판본 정보가 비어 있으므로 문서 frontmatter만이 유일한 판본 기록입니다.

2. PHP 요구사항 — v10 안에서 바뀐 이력 (가장 자주 오독되는 지점)

v10 계열 안에서 PHP 요구사항이 두 번 뒤집혔습니다. 릴리즈 노트만 읽으면 어느 쪽인지 알 수 없습니다.

2-1. 10.5.1 코드가 말하는 최종값 (권위 있는 값)

2-2. 이 표에서 바로 답 나오는 질문

Q. 서버 PHP가 7.4인데 10.5.1을 올려도 되나요?

A. 예. 7.4.0이 10.5.1의 최소값이고 7.4는 정식 지원 범위에 포함됩니다. 10.0.0 노트의 "8.0 이상"은 10.1.0에서 이미 되돌려졌습니다. 서버를 8.0으로 올려야 할 이유가 이 문서 기준으로는 없습니다.

Q. 그럼 10.0.0 → 10.1.0 사이(2주)에 8.0으로 올린 서버는?

A. 되돌릴 필요가 없습니다. 7.4 경로가 살아 있고, 8.0 이상에서만 깨지는 코드가 이 문서 기준으로는 없습니다. [확인 필요] — 10.0.0~10.0.1에서 8.0+ 전용 API를 쓴 흔적은 10.5.1 코드로 역추적할 수 없습니다(10.0.0 판본 실물 미확보).

Q. PHP 8.4에서도 되나요?

A. 미확인. 릴리즈 노트는 "7.4부터 8.4까지"라 하고 코드가 노출하는 사양은 tested_through: 8.2 입니다. 두 1차 근거가 다릅니다. 8.3~8.4에서 실제로 검증됐는지는 이 문서로 답할 수 없습니다. 운영 환경이라면 8.2를 권장합니다(진단 코드도 8.1/8.2를 권장).

Q. PHP 8.5 이상은?

A. 미확인. 어느 1차 근거에도 8.5 언급이 없습니다.

Q. disable_functions에 뭘 빼놓으면 안 되나요?

A. 위 9종. 하나라도 빠지면 업데이트·설치가 error 로 멈춥니다. 진단 화면이 정확한 함수명을 알려 줍니다.

Q. max_execution_time / memory_limit?

A. 각각 120초 이상 / 128M 이상을 권장하며 warning 등급입니다(설치 차단 아님). admin/environment_api.core.php:169-190.

3. CMS 연동 매트릭스 (v10.5.1 코드 실측)

판본이 자동으로 어떻게 결정되는지 integration/cms/adapters/ 네 개가 답합니다.

| CMS | 설치 경로 | 자동 감지 근거 (실측) | 감지 우선순위 | 데이터 경로 | 관리자 인증 | |---|---|---|:-:|---|---| | 그누보드5 | <g5>/plugin/editor/t2editor/ | 편집기 폴더가 <root>/plugin/editor 안 + config.php·common.php·lib/common.lib.php 3개 존재 + config.php에 _GNUBOARD_ 정의 | 300 (1순위) | 미디어 <g5>/data/editor · 내부 데이터 <g5>/data/t2editor_db | CMS 관리자 로그인 또는 자체 비밀번호 (10.5.1부터) | | 라이믹스 | <rx>/modules/editor/skins/t2editor/ | 편집기 폴더가 <root>/modules/editor/skins 안 + config/config.inc.php 존재 + (common/autoload.php 또는 defaults/config.php 또는 common/defaults/config.php) | 250 (2순위) | <rx>/files | 동일 | | 독립 실행 | 웹에서 보이는 아무 폴더 | 위 둘 어디에도 걸리지 않으면 항상 최종 fallback | −1000 (최후) | <에디터폴더>/data | 자체 비밀번호 필수 | | 워드프레스 | 설치 자리가 아님 | — (환경 감지 판정 함수가 항상 false 반환) | 200 (우선순위 있으나 감지 안 됨) | 워드프레스 미디어 라이브러리 경유 | 워드프레스 capability |

근거: integration/cms/adapters/gnuboard5.php:9-14, 96-98, 113-130 · rhymix.php:9-14, 152-161 · standalone.php:5-12 · wordpress.php:3, 90-96

3-1. ⭐ 워드프레스는 "지원한다"가 아니라 "브리지만 준다"

이 행은 이전 문서에서 오독되기 쉬웠으므로 코드 원문으로 적습니다.

• integration/cms/adapters/wordpress.php:3 원문 주석:

워드프레스는 설치환경 감지가 아니라 선택적 업로드·브라우저 브리지 capability만 제공한다.

• integration/cms/adapters/wordpress.php:93 — 'validate_context' => function () { return false; }

⇒ 워드프레스 어댑터는 환경 감지에서 한 번도 선택되지 않습니다.

그래서 워드프레스 사용자가 받는 것과 받지 못하는 것:

워드프레스 최소 지원 판본: [확인 필요]. 릴리즈 노트 10.3.0에 "워드프레스 업로드 연동 지원"이라는 한 줄만 있고 최소 판본·최소 PHP 표기가 없습니다.

3-2. 그누보드5·라이믹스 최소 지원 판본: [확인 필요]

• 그누보드5 — 코드에는 _GNUBOARD_ 정의가 있는지만 봅니다. 판본 하한을 검사하는 코드가 없습니다. 8.x 판본 실물도 없어 v10 계열의 하한을 확정할 수 없습니다.
• 라이믹스 — 10.3.0 노트에 "라이믹스 2.1.x 호환성 추가"가 있습니다. 그 이전 판본에서 v10.5.1이 동작하는지에 대한 코드가 없습니다(RX_VERSION 분기 0건). 2.1.x 미만 지원 여부는 [확인 필요].

3-3. CMS별로 데이터가 쌓이는 곳이 다릅니다 (백업·옮길 때 필수)

10.5.0에서 이 구조를 다시 정리했습니다 (10.5.1이 그누보드5 경로를 확정):

• 10.5.0 — "그누보드5에서는 data/editor, 라이믹스에서는 files, 독립 실행 환경에서는 T2Editor/data를 기준으로 데이터를 관리합니다. 업로드 미디어를 제외한 관리자 설정, 캐시, 협업 상태, 업데이트 상태 등의 내부 데이터는 t2editor_db 아래에 모아 CMS 데이터 폴더가 불필요하게 복잡해지지 않도록 했습니다. 기존 위치에 저장된 데이터와 경로 정보는 가능한 범위에서 새 구조로 이전하거나 계속 인식합니다."
• 10.5.1 — "이미지와 첨부파일은 기존처럼 data/editor 폴더에 저장됩니다. 관리자 설정, 인증 정보, 협업 데이터, 업데이트 기록, 서드파티 설치 정보는 data/t2editor_db 폴더에 별도로 저장됩니다. 기존 data/editor/t2editor_db 데이터는 새 위치로 자동 이전됩니다."

코드: config/t2_storage.php:253-258 (이전 중첩 위치 <데이터>/editor/t2editor_db 인식), :345-364 (실제 이전)

3-4. CMS 감지가 실패해 보일 때 (실측된 실패 패턴)

4. PHP 확장 매트릭스 (v10.5.1 · PHP 파일 86개 전수 검색)

검색 범위: releases/v10.5.1 트리의 .php 86개 전부. grep 0건은 "쓰지 않는다"는 뜻이지 "설치해도 된다"는 보장은 아닙니다.

4-1. ⭐ "이 조합에선 안 된다"고 말할 수 있는 칸

기존 문서가 댓글에서 발견하도록 방치했던 부분을 여기서 고백합니다.

1. ext-dom이 없으면 "링크 미리보기 카드"가 위험합니다.

v10.5.1의 링크 미리보기 카드는 웹 페이지를 받아 new DOMDocument() 로 파싱합니다. 확장 존재 검사가 코드에 없습니다. ext-dom이 없는 서버에서 이 경로가 도달하면 어떻게 되는지는 런타임에서 재현하지 않았으므로 [확인 필요] 로 둡니다. 다만 폴백 코드가 없다는 것은 확인했습니다(전수 grep class_exists('DOMDocument') 0건).

우회: 그 기능이 필요 없다면 끄면 됩니다. 필요하면 서버 관리자에게 ext-dom 설치를 요청하십시오.

2. cURL도 없고 OpenSSL도 없는 서버는 업데이트·서드파티 설치가 막힙니다.

코드가 error 로 판정합니다. ZIP 처리에 브라우저 폴백이 있는 것과 파일을 내려받는 수송 경로가 막힌 것은 다른 문제입니다. 브라우저 보조 해제는 ZIP을 여는 단계의 대체일 뿐, 원본 ZIP을 받아올 수송 자체는 못 대체합니다.

3. mbstring도 iconv도 없는 서버의 문자열 처리 정확도는 [확인 필요]입니다.

v10.5.1은 "UTF-8 대체 처리" 경로를 넣었습니다(config/t2_utf8.php). 그 경로가 mbstring과 같은 결과를 내는지 이 문서에서는 재현하지 않았습니다. 정확한 문자가 필요한 곳(예: 파일명 바이트 단위 처리)에서 문제가 생길 수 있다는 뜻이며, 실제로 생기는지는 미확인입니다.

4. GD가 없으면 WebP 변환이 안 됩니다 — 업로드 자체는 됩니다.

GIF/WebP는 변환 없이 원본 저장, JPEG/PNG/BMP는 GD가 있을 때만 WebP로 변환하고 없으면 원본 확장자로 저장합니다. 따라서 "GD가 없다"는 이유로 업로드가 실패하면 안 됩니다. 실패한다면 원인은 GD가 아니라 권한·확장자·용량입니다.

5. 그누보드5가 관리자라는데 CMS 로그인이 안 되면 10.5.1에서도 남아 있는 경로가 있습니다.

10.5.1 자체 로그인이 생겼으므로, CMS 인증이 실패해도 admin/t2admin.key 활성화 + 자체 비밀번호로 관리자 페이지에 들어갈 수 있습니다.

5. 권한·설치 방식 매트릭스 (v10.5.1)

⚠ 775를 넣지 마십시오. 775는 v11 계약입니다(T2Editor v11 설치 문서 기준). v10 계약은 707입니다. 판본이 다르면 계약이 다릅니다.

6. 데이터 그 자체에 관한 주의 (사용자 영향이 큽니다)

이 표가 뜻하는 것: v10 계열도 34일 만에 9판본으로 교체되며, 계열이 끝날 때 이를 알리는 신호가 릴리즈 노트에 없습니다. 5절의 판본표가 유일한 안내지입니다. 업그레이드 전에 이 문서를 다시 확인하십시오.

⚠ 또한, 10.0.0에는 업그레이드 영향 요약표가 없습니다. 10.0.0은 아키텍처를 바꿨는데도 "이렇게 오르지 마라"는 안내가 없습니다. v9 → v10 이관이 필요한 사람은 N-03-migration-v9-to-v10.md를 보십시오.

7. 판본을 확인하는 방법 (v10.5.1 실측 4가지)

readme.txt 안에 버전 숫자가 두 개 있습니다. 먼저 그 구분이 필요합니다.

| # | 방법 | 무엇을 보는가 | 근거 | |:-:|---|---|---| | 1 | 배포판 루트 readme.txt 2행 | ver_10.5.1 ← 에디터 판본 | readme.txt:2 / 판독 코드 editor.core.php:415-422 get_readme_version() = preg_match('/ver_([0-9.]+)/') | | 2 | 에디터 하단 버전 정보 클릭 → 진단 패널 | 실행 환경·미디어 블록 크기·저장 필드 | editor.core.php:553 / 10.3.0 노트 | | 3 | 관리자 페이지 버전 정보 (로그인 필요) | get_readme_version() 반환값 | admin/api.core.php:464 | | 4 | 관리자 페이지 → 업데이트 | 새 판본 존재 여부 | admin/update_api.core.php:2434 |

⚠ readme.txt의 Version: 3.0.0 은 에디터 버전이 아닙니다. readme.txt:11 의 Version: 3.0.0 은 라이선스 계약 판본입니다(:70 영어 절에도 동일). 에디터 판본은 같은 파일 2행의 ver_ 값입니다. 이 둘을 혼동하면 안 됩니다.

7-1. 배포판에 없는 파일 (알려진 혼동)

7-2. 라이선스 검증이 실제로 무엇을 비교하는가

editor.core.php:396-404 — readme.txt의 한글 조항·영문 조항·파일 참조 정보 각 해시를 내장 기대값과 hash_equals 로 비교합니다. 즉 판본별 라이선스 파일이 아니라 파일 내용 대조 방식입니다. readme.txt를 직접 편집하면 인증이 깨집니다.

8. v11 을 준비한다면 (v10에 없는 것 — 사실 목록)

v11은 2026-09-07 베타이고 별도 private 저장소이며 공개 배포판이 아닙니다. 그래서 이 목록은 "지금 쓰라"는 권고가 아니라 "v10에서 찾지 못하시면 그것도 이유입니다"라는 설명입니다.

주의: 이 목록 때문에 "v10이 안전하지 않다"고 읽으면 오독입니다. 이 문서는 v10 안에서 고르는 문서이지, v11을 권하는 문서가 아닙니다. v10을 쓰는 분은 3절·4절의 매트릭스가 답입니다.

9. 미확인 칸 목록 (근거가 없어 지어내지 않은 것)

이 문서에 남긴 미확인 / [확인 필요] 전부입니다. 지어낸 값은 없습니다.

| # | 항목 | 왜 미확인인가 | 채우는 방법 | |:-:|---|---|---| | 1 | PHP 8.4 실지원 여부 | 릴리즈 노트는 "7.4~8.4", 코드는 tested_through: 8.2 — 1차 근거 2개가 서로 다름 | 8.4 서버에서 v10.5.1 실제 설치·글쓰기 | | 2 | PHP 8.5 이상 | 어느 1차 근거에도 언급 없음 | 동일 | | 3 | 그누보드5 최소 지원 판본 | 코드에 판-version 검사가 없고 v9 이하 실물 소스 없음 | 그누보드5 각 판본 환경에서 v10.5.1 설치 시험 | | 4 | 라이믹스 최소 지원 판본 | 10.3.0이 "2.1.x 호환 추가", 그 이전 분기 코드 없음 | 2.1.x 이전 환경 시험 | | 5 | 워드프레스 최소 지원 판본·PHP | 10.3.0 한 줄 외 표기 없음 | 워드프레스 환경에서 브리지 업로드 시험 | | 6 | ext-dom 부재 시 링크 미리보기 카드 동작 | 폴백 코드 0건은 확인, 실제 동작은 재현 안 함 | ext-dom 제거 환경에서 링크 주소 붙여넣기 | | 7 | mbstring+iconv 동시 부재 시 문자열 처리 정확도 | 대체 경로 존재는 확인, 결과 동일성은 미측정 | 두 확장을 끈 서버에서 한글 파일명 업로드 | | 8 | v9 이하 판본의 PHP 요구사항 | 8.x·9.x 실물 소스 미확보 | releases/v9.3.0 등 브랜치 트리 확인 | | 9 | v9 → v10 커스텀 플러그인 hook API 1:1 대응표 | v9 실물 소스 없음 | 두 판본 트리 병렬 대조 | | 10 | v9의 collab 폴더 구조·권한 계약 | v9 실물 소스 없음 | 동일 | | 11 | 8.x 라이선스 누락 사례의 진실 | 8.x 실물 소스 없음 | 동일 | | 12 | 5.7.2 라이선스 정책 변경 내용 | 판본은 실존하나 변경 내용 1차 근거 없음 | 5.7.2 readme.txt 원문 대조 | | 13 | 10.0.0~10.0.1에서 8.0+ 전용 API 사용 여부 | 그 판본 실물 미확보 | 해당 브랜치 트리 | | 14 | 배포 파형(download_count=1)의 행위 주체 | 판본 목록만으로는 판정 불가 | — (기존 문서의 해석 금지 문구를 따름) | | 15 | 워드프레스 어댑터 우선순위 200의 실효성 | 감지 함수가 항상 false 라 관측 불가 | 코드 변경 이력 확인 |

N-xx 번호 체계 메모 (2026-09-28 확정)

이 위키의 N- 번호는 2026-09-28에 등록부를 확정하면서 붙였습니다. 확정된 신규 문서는 4건입니다.

N-01 · N-04 · N-07은 비어 있습니다. 번호를 미리 예약하면 그 번호가 "예정된 문서가 있다"는 뜻으로 읽히고, 실제로 그런 문서가 생기지 않으면 독자가 찾다 포기합니다. 필요해지는 시점에 그때 번호를 쓰십시오. 이전 문안에서 [[N-02-admin-console-guide.md]]·[[N-05-cms-adapter-and-data-paths.md]]처럼 가리키던 링크는 이 등록부 기준으로 교정되었습니다(N-08 → N-02, 라이믹스 경로는 N-05에 포함).

10. 참고 자료

• 공식 배포판 목록(94판본): 이 위키 내부 데이터 all-versions.json
• 공식 릴리즈 노트(v10 9건 전문): 이 위키 내부 데이터 v10-release-notes.json
• 배포판 실물: tak2-08/T2Editor-v10 저장소 · 브랜치 releases/v10.5.1
• 계열 상태: tak2-08/T2Editor-v1 ~ T2Editor-v11 저장소 설명
• v11 설치·연동 문서: T2Editor v11 guide.txt (v10 항목이 아님을 구분하는 용도로만 인용)
• 판본별 이슈 대응: 72-version-issues-guide.md
• 최초 설치 절차: 01-installation-guide.md
• 오류 대응: 71-error-handling-guide.md
• v9 → v10 이관: N-03-migration-v9-to-v10.md

11. 문서 관리 메모

• 9절의 미확인 칸이 줄었다면 "알려지지 않았다"가 "문제가 없다"로 읽힙니다. 칸을 지우지 말고 9절 표를 같이 고치십시오.

• 이 문서는 판본이 바뀌면 매트릭스 전체가 낡습니다. 현행판이 바뀌면 1절·2절·7절을 먼저 고치고 나머지를 검토하십시오.
• 6절 수치는 배포 판본 목록에서 기계로 다시 뽑을 수 있습니다. 사람이 옮겨 적지 마십시오.
• 어떤 칸에 미확인이 있으면 그 칸을 지우지 말고 §9 표를 함께 고치십시오. 지워지면 "알려지지 않았다"가 "문제가 없다"로 읽힙니다.