DXCMS v10.3.0 — 라우터 AI (1)

0. 핵심 규칙 (먼저 읽기)

1. 모든 HTTP 요청은 루트 index.php 하나로 들어온다. core/, admin/ 등의 PHP 파일은 직접 실행되지 않는다(웹서버가 차단).
2. 라우터는 두 겹이다. 먼저 DxRouter(라라벨 스타일, routes/*.php)가 매칭을 시도하고, 하나도 매칭되지 않을 때만 Router + Dispatcher(기존 URL 규칙 기반)가 실행된다.
3. 새 URL을 추가할 때의 기본 선택: routes/web.php에 DxRouter로 추가한다. 코어 파일(Router.php, Dispatcher.php)은 업그레이드 시 덮어써지므로 수정하지 않는다.
4. 파일 시작은 항상 if (!defined('DX_CMS')) exit('Direct access not allowed.');
5. DxRouter로 등록한 라우트는 extend/middle/을 실행하지 않고 $GLOBALS['dx_route']도 세팅되지 않는다. (§6, §9)
6. DxRouter의 csrf 미들웨어는 존재하지 않는 함수를 호출한다. 쓰지 말 것. (§5.4)
7. URL 생성은 항상 dx_base_url('path'). 하드코딩 /path 금지(서브디렉토리 설치·url_rewrite=0 환경에서 깨진다).

1. 요청 처리 흐름

브라우저
  → .htaccess / nginx try_files  → index.php
index.php
  STEP1  core/*.php 로드 (Router, Dispatcher, DxRouter, DxContainer 포함)
  STEP2  세션·보안 헤더
  STEP3  data/config.php 로드 (DB 연결)
  STEP4  load_plugins() → initSecurity(WAF/IP차단) → DxSite → DxTheme → Auth
         → DxContainer::registerCoreServices()
         → extend/top/*.php 실행
  STEP5  routes/*.php 전부 require_once (파일명 정렬순)
         → if (!DxRouter::dispatch()) {                 ← ① 라라벨 스타일
               (new Dispatcher(new Router()))->dispatch(); ← ② 파일/DB 기반
           }
         → extend/bottom/*.php → ob_end_flush()

② Dispatcher::dispatch() 내부 순서:

1. Router::resolve() → 라우트 배열 생성
2. $GLOBALS['dx_route'] = $route
3. extend/middle/*.php 실행 + 훅 dx_extend_middle
4. switch ($route['type']) → 각 dispatchXxx()

미설치(data/config.php 없음) 시 /install/로 리다이렉트. // 중복 슬래시는 301로 정규화.