1. 사이트 설정 개요
DXCMS 관리자 패널의 [사이트 설정] 메뉴는 사이트 전체에 적용되는 핵심 환경 변수를 한 곳에서 관리하는 통합 설정 도구입니다. 기본 사이트 정보부터 캡챠•SEO•푸터 사업자 정보•홈 페이지 설정까지 48개 설정 항목을 6개 섹션으로 구분하여 제공합니다.
📌 접근 경로: 관리자 대시보드 → 사이트 설정 (URL: /admin/settings) DB 테이블: settings (setting_group='general')
1.1 화면 구성
| 영역 |
설명 |
| 페이지 헤더 |
"시스템 환경 설정" 제목 + 캐시 상태 배지 + [캐시 초기화] 버튼 + [세션 청소] 버튼. |
| 메시지 배너 |
저장·캐시 초기화·세션 청소 결과 메시지(초록=성공 / 빨강=오류). |
| ① 기본 사이트 정보 (좌) |
사이트명·URL·메타 설명·푸터 카피라이트. |
| ② 디자인 및 언어 설정 (우) |
테마·언어·시간대. |
| ③ 첨부파일 및 업로드 정책 (좌) |
최대 업로드 용량·차단 확장자. |
| ④ 보안 및 접근 설정 (우) |
회원가입 허용·캡챠·URL Rewrite. |
| ⑤ SEO 최적화 (전체 폭) |
OG 이미지·트위터·GA·네이버 웹마스터·구글 서치 콘솔·robots.txt. |
| ⑥ 푸터 사업자 정보 (전체 폭) |
상호명·대표자·사업자번호·통신판매업·에스크로·연락처·SNS·이용약관·개인정보처리방침. |
| ⑦ 홈 페이지 설정 (전체 폭) |
제작 진행률·배포 예정일. |
| [모든 설정사항 저장하기] 버튼 |
하단 제출 버튼. 48개 항목 전체를 한 번에 저장. |
1.2 설정 저장 처리 방식
DXCMS 사이트 설정은 다음과 같은 특별한 방식으로 저장됩니다.
| DB 직접 로드 |
페이지 표시 시 캐시($dx_config)를 사용하지 않고 settings 테이블을 직접 조회합니다. 캐시 오류로 설정값이 잘못 표시되는 것을 원천 차단합니다. |
| UPSERT 방식 |
INSERT INTO ... ON DUPLICATE KEY UPDATE 패턴. 키가 없으면 신규 생성, 있으면 값 업데이트. 누락된 설정 키도 자동 생성됩니다. |
| 체크박스 0 명시 저장 |
use_captcha·use_signup·url_rewrite 체크박스 3개는 미체크 시 "0"을 명시적으로 저장합니다. PHP $_POST에 키가 없어 설정이 삭제되는 문제 방지. |
| 즉시 적용 |
저장 직후 dx_set_config()로 현재 요청의 $dx_config도 즉시 갱신됩니다. 같은 페이지에서 바뀐 설정을 즉시 확인 가능. |
| 캐시 무효화 |
저장 시 DxCache::delete("dx_settings")로 설정 캐시만 선택적으로 삭제합니다. |
| setting_group |
모든 사이트 설정 항목은 setting_group="general"로 저장됩니다. |
2. 캐시 상태 및 서버 관리
페이지 헤더 우측에 현재 캐시 상태와 2개의 서버 관리 버튼이 표시됩니다. 설정 저장과 무관하게 언제든지 실행할 수 있습니다.
2.1 캐시 상태 배지
| 배지 표시 |
캐시 드라이버 |
설명 |
| FILE CACHE ACTIVE ✅ |
file |
파일 기반 캐시 활성. /data/cache/ 디렉터리에 캐시 파일 저장. 일반적인 PHP 공유 호스팅 환경. |
| APCU CACHE ACTIVE ✅ |
apcu |
APCu 메모리 캐시 활성. 서버 메모리에 캐시. PHP APCu 확장 설치 필요. 고성능. |
| NO CACHE DETECTED |
none |
캐시 비활성. 모든 요청마다 DB를 직접 조회합니다. 성능에 영향. |
2.2 캐시 초기화
[캐시 초기화] 버튼을 클릭하면 DxCache::flush()가 실행되어 전체 캐시가 즉시 삭제됩니다.
| 실행 조건 |
DxCache 클래스가 존재할 때만 실행. 없으면 아무 동작 안 함. |
| 성공 메시지 |
"캐시가 초기화되었습니다." |
| 사용 시점 |
설정 변경 후 즉시 반영이 안 될 때, 테마/플러그인 업데이트 후, 이상한 설정값이 표시될 때. |
| 영향 범위 |
설정 캐시(dx_settings) 포함 전체 캐시 삭제. 다음 요청부터 DB 직접 조회 후 재캐시. |
2.3 세션 청소
[세션 청소] 버튼을 클릭하면 /data/sessions/ 디렉터리의 오래된 세션 파일이 삭제됩니다. 버튼 옆 숫자 배지로 현재 세션 파일 수를 확인할 수 있습니다.
| 삭제 기준 |
마지막 수정 시각(filemtime)이 현재로부터 7,200초(2시간) 이상 지난 세션 파일만 삭제. |
| 대상 파일 |
/data/sessions/sess_* 패턴 파일. |
| 확인 창 |
"2시간 이상 지난 세션 파일을 삭제합니다. 계속하시겠습니까?" 확인 창 표시 후 진행. |
| 결과 메시지 |
"세션 청소 완료 — 전체: N개 | 삭제: N개 | 실패: N개 | 남은 파일: N개". |
| 사용 시점 |
서버 /data/sessions/ 디렉터리 용량이 커질 때, 정기적 서버 정리 시. |
| 현재 접속자 영향 |
삭제 기준이 2시간 이상이므로 현재 로그인 중인 사용자 세션은 삭제되지 않습니다. |
3. 기본 사이트 정보
사이트의 기본 신원 정보를 설정합니다. 이 값들은 브라우저 탭•메타 태그•소셜 공유•푸터 등 사이트 전반에 사용됩니다.
| 필드명 |
DB 키 |
설명 및 사용 위치 |
| 사이트 정식 명칭 |
site_name |
브라우저 탭 제목·헤더 로고 텍스트·OG:title 등에 사용. 기본값: "DesignOneX CMS". |
| 시스템 URL 주소 |
site_url |
https:// 포함 전체 URL. 예: https://mysite.com. 소셜 로그인 콜백 URL·이메일 링크·절대 경로 생성에 필수. |
| 사이트 메타 설명 |
site_description |
HTML <meta name="description"> 태그·OG:description에 사용. 검색 결과 미리보기 텍스트. 150자 이내 권장. |
| 하단 카피라이트 (Footer) |
footer_text |
사이트 하단 푸터에 표시되는 텍스트. 예: Copyright © 2026 MyBrand. All rights reserved. |
⚠️ site_url은 정확히 입력해야 합니다. 소셜 로그인 콜백 URL, 이메일 내 링크, XML 사이트맵 등 여러 기능이 이 값에 의존합니다. http/https 구분과 마지막 슬래시(/) 유무를 서버 실제 환경과 일치시키세요.
4. 디자인 및 언어 설정
사이트의 외관과 지역화(Localization) 관련 설정입니다.
| 필드명 |
DB 키 |
설명 |
| 적용 디자인 테마 |
theme |
/themes/ 디렉터리의 하위 폴더 목록 드롭다운. 선택한 테마가 전체 사이트 프론트엔드에 적용됨. [테마 관리] 메뉴와 동일한 효과. 기본값: default. |
| 기본 서비스 언어 |
language |
현재 지원: 대한민국(ko) / 글로벌(en). 언어팩 파일 로드 기준. |
| 시스템 기준 시간대 |
timezone |
현재 지원: 서울(Asia/Seoul, KST+9) / UTC / 뉴욕(America/New_York, EST). 게시글 등록일·로그 시각 기준. PHP date_default_timezone_set()에 적용. |
💡 테마를 여기서 변경하면 [테마 관리] 메뉴에서 변경한 것과 동일하게 즉시 적용됩니다. 두 메뉴는 모두 settings 테이블의 theme 키를 공유합니다.
5. 첨부파일 및 업로드 정책
파일 업로드의 용량 제한과 보안 차단 확장자를 설정합니다.
| 필드명 |
DB 키 |
설명 및 유의사항 |
| 파일당 최대 업로드 제한 |
upload_max_size |
바이트(Byte) 단위 정수. 예: 10,485,760 = 10MB. 기본값: 10,485,760(10MB). PHP의 upload_max_filesize·post_max_size 중 작은 값을 초과해도 실제 업로드는 PHP 설정 값 기준으로 제한됩니다. |
| 보안 차단 확장자 |
upload_allowed_ext |
쉼표(,)로 구분한 차단 확장자 목록. 입력된 확장자의 파일은 업로드가 거부됩니다. 기본값: exe,msi,bat,cmd,com,scr,ps1,vbs,js,jar,sh,php,asp,aspx,jsp. 필드명이 "차단"임에 유의. |
5.1 용량 변환 참고표
| 바이트 값 |
MB 환산 |
추천 용도 |
| 1,048,576 |
1 MB |
아이콘·썸네일 전용 |
| 5,242,880 |
5 MB |
일반 이미지 첨부 |
| 10,485,760 |
10 MB |
기본값. 문서·이미지 첨부 |
| 52,428,800 |
50 MB |
영상·대용량 파일 허용 |
| 104,857,600 |
100 MB |
대형 파일 다운로드 사이트 |
⚠️ 이 설정은 DXCMS 애플리케이션 레벨의 제한입니다. 실제 업로드는 PHP.ini의 upload_max_filesize와 post_max_size 값도 충족해야 합니다. 서버 설정이 낮으면 DXCMS 값을 높여도 업로드가 제한됩니다.
6. 보안 및 접근 설정
회원가입 허용 여부, 캡챠, URL 구조 등 사이트 접근 정책을 설정합니다.
6.1 체크박스 설정 3종
| 설정명 |
DB 키 (기본값) |
설명 및 주의사항 |
| 공공 회원가입 허용 |
use_signup (1) |
체크 ON: 모든 방문자가 회원가입 가능. 체크 OFF: 관리자가 직접 회원 추가만 가능(관리자 → 회원 관리 → 회원 추가). 비공개 커뮤니티·내부 시스템에 적합. |
| 캡챠 (CAPTCHA) 적용 |
use_captcha (0) |
체크 ON: 회원가입·비회원 글쓰기에 캡챠 표시. 아래 드라이버 선택 패널이 펼쳐짐. 스팸·봇 방지. |
| SEO 친화적 URL Rewrite |
url_rewrite (1) |
체크 ON: /index.php?page=xxx 대신 /page/xxx 형태의 깔끔한 URL 사용. 서버에 mod_rewrite(Apache) 또는 try_files(Nginx)가 설정된 경우에만 활성화하세요. |
⚠️ url_rewrite를 서버가 지원하지 않는 환경에서 ON으로 설정하면 404 오류가 발생합니다. 활성화 전 서버의 .htaccess(Apache) 또는 Nginx 설정을 먼저 확인하세요.
6.2 캡챠 드라이버 선택
use_captcha가 ON이면 캡챠 드라이버 선택 패널이 표시됩니다. DxCaptcha::getAllDrivers()로 사용 가능한 드라이버 목록을 로드합니다.
| 드라이버 |
DB 키 |
설명 및 필요 설정 |
| 내장 CAPTCHA |
builtin |
별도 API 키 없이 즉시 사용. DXCMS 자체 이미지 생성 방식. 단순 봇 방지. 항상 "사용 가능" 상태. |
| reCAPTCHA v2 |
recaptcha_v2 |
구글 reCAPTCHA v2 체크박스. Site Key·Secret Key 필요. 추가 설정: 테마(light/dark)·크기(normal/compact). |
| reCAPTCHA v3 |
recaptcha_v3 |
구글 reCAPTCHA v3 점수 기반(보이지 않는 캡챠). Site Key·Secret Key·임계값(0.0~1.0) 설정. 1.0에 가까울수록 엄격. |
| hCaptcha |
hcaptcha |
hCaptcha 서비스. Site Key·Secret Key 필요. 테마·크기 설정 가능. |
| Cloudflare Turnstile |
turnstile |
Cloudflare Turnstile(자동 통과형). Site Key·Secret Key 필요. 테마·appearance 설정. |
6.3 캡챠 드라이버별 세부 설정
| 드라이버 |
설정 키 |
설명 |
| reCAPTCHA v2 |
recaptcha_v2_site_key recaptcha_v2_secret_key recaptcha_v2_theme recaptcha_v2_size |
Site Key·Secret Key: Google reCAPTCHA 콘솔(google.com/recaptcha)에서 발급. 테마: light/dark. 크기: normal/compact. |
| reCAPTCHA v3 |
recaptcha_v3_site_key recaptcha_v3_secret_key recaptcha_v3_threshold |
임계값(threshold): 0.0~1.0. 기본 0.5. 낮을수록 관대(봇 통과 가능성↑), 높을수록 엄격(정상 사용자도 차단 가능). |
| hCaptcha |
hcaptcha_site_key hcaptcha_secret_key hcaptcha_theme hcaptcha_size |
hcaptcha.com에서 Site Key·Secret Key 발급. 테마: light/dark. 크기: normal/compact. |
| Cloudflare Turnstile |
turnstile_site_key turnstile_secret_key turnstile_theme turnstile_appearance |
dash.cloudflare.com에서 발급. 테마: light/dark/auto. appearance: always/execute/interaction-only. |
💡 캡챠 드라이버 라디오 버튼을 변경하면 해당 드라이버의 세부 설정 패널이 즉시 표시됩니다. 키가 설정되지 않은 드라이버는 "키 미설정" 배지가 표시됩니다.
7. SEO 최적화 설정
검색 엔진 최적화(SEO) 및 소셜 공유(Open Graph) 관련 설정입니다. 이 섹션은 전체 폭으로 표시됩니다.
7.1 SEO 설정 전체 필드
| 필드명 |
DB 키 |
설명 및 입력 가이드 |
| 기본 공유 이미지 (OG Image) |
og_default_image |
게시글에 이미지가 없을 때 소셜 공유 미리보기에 표시될 기본 이미지 URL. 권장 크기: 1200×630px. 예: https://mysite.com/og.jpg. |
| 트위터(X) 계정 |
twitter_site |
Twitter Card 메타 태그의 twitter:site에 사용. @ 포함 입력. 예: @mysite. |
| Google 애널리틱스 ID |
google_analytics |
GA4 측정 ID. G-로 시작. 예: G-XXXXXXXXXX. 테마에서 이 값을 읽어 gtag 코드 자동 삽입. |
| 네이버 웹마스터 인증 코드 |
naver_webmaster |
네이버 서치어드바이저(searchadvisor.naver.com) HTML 태그 인증 코드. 예: abcdef1234567890. <meta name="naver-site-verification">에 삽입. |
| Google 서치 콘솔 Code |
google_webmaster |
Google Search Console 소유권 확인 코드. HTML 태그 방식의 content 값. 예: abc123xyz. <meta name="google-site-verification">에 삽입. |
| Robots.txt 직접 편집 |
robots_txt |
검색 엔진 크롤러에게 크롤링 규칙을 지시하는 robots.txt 내용을 직접 작성. 저장 후 /robots.txt URL에 즉시 반영. |
7.2 robots.txt 기본 예시
robots.txt는 검색 엔진의 크롤링 범위를 제어합니다. 아래는 일반적으로 사용되는 기본 설정입니다.
| 모든 크롤러 전체 허용 |
User-agent: * Allow: / |
| 특정 디렉터리 차단 |
User-agent: * Disallow: /admin/ Disallow: /data/ Allow: / |
| 특정 크롤러만 차단 |
User-agent: AhrefsBot Disallow: / User-agent: * Allow: / |
| 사이트맵 경로 추가 |
Sitemap: https://mysite.com/sitemap.xml |
💡 [sitemap.xml 보기] 링크로 DXCMS가 자동 생성하는 사이트맵을 확인할 수 있습니다. [robots.txt 보기] 링크로 현재 저장된 robots.txt 내용을 새 탭에서 확인할 수 있습니다.
8. 푸터 사업자 정보 / 연락처
사이트 하단 푸터에 표시되는 사업자 정보, 연락처, SNS 링크, 법적 고지 URL을 설정합니다. 전자상거래 사이트의 경우 전자상거래 등에서의 소비자보호에 관한 법률에 따라 사업자 정보 표시가 의무입니다.
8.1 사업자 기본 정보
| 필드명 |
DB 키 |
설명 및 표시 예시 |
| 상호명 |
footer_company_name |
법인 또는 사업체 이름. 예: 디자인원엑스 (DESIGNONEX). |
| 대표자명 |
footer_ceo_name |
대표이사 또는 개인사업자 대표. 예: 홍길동. |
| 사업자번호 |
footer_biz_no |
사업자 등록번호. 예: 123-45-67890. 국세청 사업자정보 확인 링크와 연동하는 경우 정확히 입력. |
| 통신판매업 신고번호 |
footer_biz_mail_no |
온라인 쇼핑몰·전자상거래 시 필수. 예: 2025-서울강남-0000. |
| 에스크로 서비스 등록번호 |
footer_escrow_no |
구매안전서비스(에스크로) 가입 시 표시. 예: 제 A07-20260105-0033 호. |
| 푸터 설명 문구 |
footer_desc |
사이트 슬로건·한 줄 소개. 예: 단 하나의 차별된 경험을 만든다. |
8.2 연락처 및 SNS
| 필드명 |
DB 키 |
설명 |
| 연락처 이메일 |
footer_contact_email |
고객 문의 이메일. 예: contact@example.com. mailto: 링크로 활용. |
| 연락처 전화번호 |
footer_contact_phone |
고객 센터 번호. 예: 010-1234-5678. tel: 링크로 활용. |
| 인스타그램 URL |
footer_sns_instagram |
인스타그램 프로필 전체 URL. 예: https://instagram.com/yourpage. |
| GitHub URL |
footer_sns_github |
GitHub 프로필 또는 조직 페이지 URL. 예: https://github.com/yourpage. |
8.3 법적 고지 URL
| 필드명 |
DB 키 |
설명 |
| 이용약관 URL |
footer_terms_url |
이용약관 페이지 URL. 기본값: #. 별도 페이지를 만들어 연결하거나 외부 URL 사용. |
| 개인정보처리방침 URL |
footer_privacy_url |
개인정보처리방침 페이지 URL. 기본값: #. 개인정보보호법에 따른 필수 항목. |
💡 이용약관과 개인정보처리방침은 별도 페이지를 만들어 URL을 연결하는 것을 권장합니다. [관리자 → 페이지 관리]에서 정적 페이지를 생성하고 slug를 설정한 후 해당 URL을 입력하세요.
9. 홈 페이지 설정
사이트 홈 화면에 표시되는 개발/배포 상태 관련 정보를 설정합니다.
| 필드명 |
DB 키 |
설명 |
| 제작 진행률 (%) |
release_progress |
0~100 사이의 정수. 홈 페이지 대시보드의 프로그레스 바에 표시. 기본값: 72. 개발 중인 기능의 진행 상황을 시각화. |
| 배포 예정일 |
release_date |
YYYY-MM-DD 형식. 기본값: 2026-06-14. 홈 대시보드 카운트다운 또는 정보 표시에 활용. |
💡 제작 진행률과 배포 예정일은 사이트 구축 중인 경우 홈 화면에 표시하는 진행 상황 안내 용도입니다. 사이트 완성 후에는 progress=100, 배포일을 실제 오픈일로 변경하거나, 테마에서 해당 UI 요소를 숨기세요.
10. 전체 설정 키 레퍼런스
사이트 설정 화면에서 저장하는 모든 48개 setting_key를 정리합니다.
| setting_key |
그룹 및 설명 |
| site_name |
기본 사이트 정보 — 사이트 정식 명칭. 기본값: DesignOneX CMS. |
| site_description |
기본 사이트 정보 — 메타 description. |
| site_url |
기본 사이트 정보 — 시스템 URL. https:// 포함. 소셜 로그인 콜백 등에 필수. |
| theme |
디자인 — 적용 테마 폴더명. 기본값: default. |
| language |
언어 — 서비스 언어 코드(ko/en). 기본값: ko. |
| timezone |
시간대 — PHP 타임존. 기본값: Asia/Seoul. |
| upload_max_size |
업로드 — 파일당 최대 바이트. 기본값: 10485760(10MB). |
| upload_allowed_ext |
업로드 — 차단 확장자 목록(쉼표 구분). |
| use_captcha |
보안 — 캡챠 사용 여부. 0 또는 1. |
| captcha_driver |
보안 — 캡챠 드라이버 ID. builtin/recaptcha_v2/recaptcha_v3/hcaptcha/turnstile. |
| captcha_difficulty |
보안 — 캡챠 난이도(드라이버별 다름). |
| captcha_expire |
보안 — 캡챠 만료 시간(초). |
| recaptcha_v2_site_key |
캡챠 — reCAPTCHA v2 Site Key. |
| recaptcha_v2_secret_key |
캡챠 — reCAPTCHA v2 Secret Key. |
| recaptcha_v2_theme |
캡챠 — reCAPTCHA v2 테마(light/dark). |
| recaptcha_v2_size |
캡챠 — reCAPTCHA v2 크기(normal/compact). |
| recaptcha_v3_site_key |
캡챠 — reCAPTCHA v3 Site Key. |
| recaptcha_v3_secret_key |
캡챠 — reCAPTCHA v3 Secret Key. |
| recaptcha_v3_threshold |
캡챠 — reCAPTCHA v3 임계값(0.0~1.0). 기본: 0.5. |
| hcaptcha_site_key |
캡챠 — hCaptcha Site Key. |
| hcaptcha_secret_key |
캡챠 — hCaptcha Secret Key. |
| hcaptcha_theme |
캡챠 — hCaptcha 테마(light/dark). |
| hcaptcha_size |
캡챠 — hCaptcha 크기(normal/compact). |
| turnstile_site_key |
캡챠 — Cloudflare Turnstile Site Key. |
| turnstile_secret_key |
캡챠 — Cloudflare Turnstile Secret Key. |
| turnstile_theme |
캡챠 — Turnstile 테마(light/dark/auto). |
| turnstile_appearance |
캡챠 — Turnstile appearance(always/execute/interaction-only). |
| use_signup |
보안 — 회원가입 허용 여부. 0 또는 1. 기본값: 1. |
| url_rewrite |
보안 — SEO 친화적 URL Rewrite. 0 또는 1. 기본값: 1. |
| footer_text |
기본 사이트 정보 — 푸터 카피라이트 텍스트. |
| og_default_image |
SEO — 기본 OG 이미지 URL. |
| twitter_site |
SEO — 트위터 계정(@포함). |
| robots_txt |
SEO — robots.txt 전체 내용. |
| google_analytics |
SEO — Google Analytics GA4 ID(G-로 시작). |
| naver_webmaster |
SEO — 네이버 서치어드바이저 인증 코드. |
| google_webmaster |
SEO — Google 서치 콘솔 인증 코드. |
| release_progress |
홈 페이지 — 제작 진행률(0~100). 기본값: 72. |
| release_date |
홈 페이지 — 배포 예정일(YYYY-MM-DD). 기본값: 2026-06-14. |
| footer_company_name |
푸터 사업자 — 상호명. |
| footer_ceo_name |
푸터 사업자 — 대표자명. |
| footer_biz_no |
푸터 사업자 — 사업자등록번호. |
| footer_biz_mail_no |
푸터 사업자 — 통신판매업 신고번호. |
| footer_escrow_no |
푸터 사업자 — 에스크로 서비스 등록번호. |
| footer_contact_email |
푸터 연락처 — 이메일. |
| footer_contact_phone |
푸터 연락처 — 전화번호. |
| footer_sns_instagram |
푸터 SNS — 인스타그램 URL. |
| footer_sns_github |
푸터 SNS — GitHub URL. |
| footer_terms_url |
푸터 법적 — 이용약관 URL. 기본값: #. |
| footer_privacy_url |
푸터 법적 — 개인정보처리방침 URL. 기본값: #. |
| footer_desc |
푸터 — 설명 문구/슬로건. |
💡 제작 진행률과 배포 예정일은 사이트 구축 중인 경우 홈 화면에 표시하는 진행 상황 안내 용도입니다. 사이트 완성 후에는 progress=100, 배포일을 실제 오픈일로 변경하거나, 테마에서 해당 UI 요소를 숨기세요.
10. 전체 설정 키 레퍼런스
사이트 설정 화면에서 저장하는 모든 48개 setting_key를 정리합니다.
11. 전체 사용 절차
11.1 사이트 첫 설정 절차
- 관리자 대시보드 → [사이트 설정] 메뉴 클릭
- [기본 사이트 정보] 섹션: 사이트명•URL•메타 설명 입력
- [디자인 및 언어 설정] 섹션: 테마•언어•시간대 선택
- [첨부파일 및 업로드 정책] 섹션: 업로드 용량 설정
- [보안 및 접근 설정] 섹션: 회원가입 허용•캡챠•URL Rewrite 설정
- [SEO 최적화] 섹션: OG 이미지•GA•웹마스터 코드•robots.txt 설정
- [푸터 사업자 정보] 섹션: 상호명•대표자•사업자번호 등 입력
- [모든 설정사항 저장하기] 버튼 클릭
- "설정이 저장되었습니다." 성공 메시지 확인
- 사이트 프론트엔드에서 변경 사항 확인
11.2 설정 즉시 반영 안 될 때
- [캐시 초기화] 버튼 클릭
- "캐시가 초기화되었습니다." 메시지 확인
- 브라우저 강력 새로고침 (Ctrl+Shift+R 또는 Cmd+Shift+R)
- 그래도 안 되면 서버 캐시 레이어(Nginx FastCGI Cache 등) 확인
12. 자주 묻는 질문 (FAQ)
Q1. 설정을 저장했는데 사이트에 반영이 되지 않습니다.
A. DxCache가 활성화된 경우 캐시가 만료될 때까지 기존 설정이 표시될 수 있습니다. [캐시 초기화] 버튼을 클릭하여 즉시 캐시를 삭제하세요. 그래도 안 되면 브라우저 강력 새로고침(Ctrl+Shift+R)을 시도하세요.
Q2. DB에서 설정값을 불러오지 못했다는 오류가 표시됩니다.
A. dx_settings 테이블이 없거나 DB 연결에 문제가 있는 경우입니다. DB 접속 정보(config/database.php)를 확인하고, install/migrate.php를 실행하여 테이블을 생성하세요.
Q3. URL Rewrite를 ON으로 했더니 404 오류가 발생합니다.
A. 서버에 mod_rewrite(Apache) 또는 try_files 지시어(Nginx)가 설정되어 있지 않은 것입니다. 호스팅사에 .htaccess 사용 가능 여부를 확인하거나, Nginx 환경이면 try_files 설정을 추가하세요. 문제가 해결될 때까지 url_rewrite를 OFF로 설정하세요.
Q4. 캡챠를 설정했는데 작동하지 않습니다.
A. ① use_captcha가 "1"로 저장되었는지 확인. ② captcha_driver가 올바른 드라이버 ID로 설정되었는지 확인. ③ 해당 드라이버의 Site Key•Secret Key가 입력되었는지 확인(배지에 "사용 가능" 표시 확인). ④ 테마 템플릿에 캡챠 출력 훅이 삽입되어 있는지 확인.
Q5. 업로드 용량을 늘렸는데 여전히 제한됩니다.
A. DXCMS 설정 외에 PHP.ini의 upload_max_filesize와 post_max_size도 충분히 높아야 합니다. 공유 호스팅에서는 php.ini를 직접 편집하거나 .htaccess에 php_value upload_max_filesize 50M 형식으로 추가하세요. VPS/독립 서버는 php.ini를 직접 수정하고 PHP-FPM을 재시작하세요.
Q6. 세션 청소 시 현재 로그인한 사용자에게 영향이 있나요?
A. 없습니다. 세션 청소는 마지막 수정 시각이 2시간(7,200초) 이상 지난 파일만 삭제합니다. 현재 활성 세션은 최근에 갱신되므로 삭제되지 않습니다.
Q7. robots.txt를 저장하면 실제 /robots.txt에 바로 반영되나요?
A. 네. 저장 즉시 반영됩니다. DXCMS는 /robots.txt 요청 시 settings 테이블의 robots_txt 값을 읽어 응답합니다. 저장 후 [robots.txt 보기] 링크로 확인하세요.
