멀티테넌트 PHP 플랫폼의 canonical·소프트 404 버그 4종

관리자 2026-11-01 22:34 조회 30
## 개요 도메인 수백 개를 한 코드베이스로 서비스하는 플랫폼에서 검색 노출에 직접 영향을 준 canonical·404 버그 네 가지를 고친 기록이다. ## 1. 내부용 도메인명이 공개 주소로 노출 로그인 페이지가 공개용 `canonical_domain` 대신 내부 식별용 `domain_name`(`.local`)을 canonical 에 썼다. 104개 도메인에 영향이 있었고 검색에 관리자 로그인 페이지가 노출됐다. 컬럼의 **용도(내부용/공개용)** 를 구분해 공개 값을 쓰도록 고쳤다. ## 2. 빈 문자열은 NULL 이 아니다 `canonical_url` 에 NULL 이 아니라 **빈 문자열**이 들어 있어 `??` 폴백이 동작하지 않았다. `?? ` 는 NULL 만 걸러 낸다. 빈 문자열까지 걸러야 하면 `!empty()` 또는 `?:` 를 쓴다. 존재하지 않는 도메인이 canonical 로 지정된 건도 함께 정리했다. ## 3. 쿼리스트링이 사라지는 canonical `parse_url($url, PHP_URL_PATH)` 는 쿼리스트링을 제거한다. 게시판 상세(`?id=`)의 canonical 이 목록이나 홈으로 **수렴**했다. 38개 테마의 헤드 파일에서 경로 변수를 `$path` 에서 쿼리 포함 `$uri` 로 바꿔 해결했다. ## 4. 라우터 기본값이 만든 소프트 404 라우터의 `$templateFile` 기본값이 `'index.php'` 라서 **임의의 URL이 전부 홈을 200 으로 반환**하고 canonical 도 자기 자신이 됐다. 기본값을 `null` 로 바꾸고 체인 끝에서 진짜 404 를 내도록 수정했다. ## 점검 방법 - 임의의 경로(`/없는-페이지-12345`)가 404 를 반환하는지 도메인별로 확인한다. - 게시판 상세 URL 의 canonical 이 요청 URL(쿼리 포함)과 일치하는지 샘플링한다. - 응답 본문의 `link rel=canonical` 호스트가 공개 도메인인지 정규식으로 전수 검사한다.
KO