[워드프레스] 2. 폴더 : 워드프레스 디렉터리 구조 완벽 정리

워드프레스 해부 2편 - 워드프레스 디렉터리 구조 완벽 정리

작성자

카테고리:

* 이 게시물은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.

(워드프레스 해부 ②) 폴더

지난 편에서 설치 루트에 세 개의 코어 폴더가 있는 걸 봤다. 이번엔 그걸 하나씩 열어본다. 각 폴더가 무슨 일을 하는지 알면, “여길 건드려도 되나?”를 매번 고민할 필요가 없어진다.

  • wp-admin/ — 관리자 화면(대시보드)을 그리는 코드. 로그인 뒤 보는 그 화면들이 여기서 나온다. 절대 수정하지 않는다.
  • wp-includes/ — 워드프레스의 함수 라이브러리. WP_Query, 훅 시스템, REST API 같은 코어 기능이 다 여기 산다. 여기는 더더욱 건드리면 안 된다.
  • wp-content/ — 여기가 “내 영역”이다. 테마, 플러그인, 업로드, 그리고 mu-plugins(강제 활성 플러그인), languages(번역).

경계가 이렇게 갈리는 이유는 업데이트 때문이다. 워드프레스를 업데이트하면 wp-admin과 wp-includes는 통째로 새 버전으로 교체된다. 그래서 여기에 코드를 끼워넣으면 다음 업데이트 때 흔적도 없이 사라진다. 반대로 wp-content는 업데이트가 건드리지 않는다. 그래서 커스터마이징은 무조건 wp-content 안에서만 한다 — 테마, 플러그인, 또는 mu-plugins로.

직접 해보기

$ ls wp-includes | head
# functions.php, class-wp-query.php, rest-api/ ... 코어의 심장부

$ ls -R wp-content/uploads | head
# 2026/
# 2026/07/
#   image-1.jpg ...  ← 올린 미디어가 연/월 폴더로 정리됨

업로드 폴더가 2026/07/처럼 연·월로 쪼개져 있는 게 보일 거다. 미디어를 올린 시점 기준으로 자동 분류된다. 이 구조 덕에 파일이 수만 개여도 한 폴더에 몰리지 않는다.

✅ 확인 — wp-includes를 수정하면 안 되는 이유를 한 문장으로 말할 수 있으면 이 편은 통과다. 정답: “업데이트 때 통째로 교체돼서 수정이 날아가고, 코어를 고치면 사이트 전체가 깨질 수 있으니까.”

wp-content 안을 열어보면

진짜 ‘내 것’이 사는 곳이다. 코어를 백업할 필요는 없어도 여기와 DB만 챙기면 사실상 사이트 전체다. 주요 폴더는 이렇다.

폴더내용건드려도?
plugins/설치한 플러그인플러그인 개발 시 O
themes/테마(자식 테마 포함)자식 테마에서 O
uploads/미디어(연·월 폴더로 정리)직접 삭제는 주의
mu-plugins/있으면 자동 활성 ‘필수 플러그인’고급용
languages/번역 파일보통 자동

wp-config.php와 루트 파일들

설치 루트엔 index.php(모든 요청의 관문), wp-config.php(DB 접속·보안 키·상수 — 가장 민감한 파일), .htaccess(아파치 리라이트)가 있다. 특히 wp-config.php가 웹에서 그대로 읽히면 DB 암호가 통째로 새니, 권한과 위치에 신경 써야 한다. 한 단계 위 디렉터리로 올려두는 것도 워드프레스가 지원하는 안전책이다.

안 건드리는 게 규칙 — 대신 이렇게

wp-admin·wp-includes 같은 코어를 직접 고치면, 업데이트 때 전부 덮어써져 수정이 사라진다(그리고 보안 구멍이 된다). 기능을 바꾸고 싶으면 코어가 아니라 훅(액션·필터)으로, 테마를 바꾸고 싶으면 자식 테마로 한다. ‘코어는 읽기만, 변경은 wp-content에서’ — 이게 안전의 핵심 원칙이다.

권한과 소유권 — 실무 팁

일반적으로 디렉터리 755·파일 644가 기본이고, uploads/는 웹서버가 쓸 수 있어야 하며, wp-config.php는 더 엄격하게(640이나 600) 잠근다. 파일 소유자는 웹서버 사용자로 두는 게 보통이다. 참고로 이 블로그도 워드프레스 파일이 아파치 소유라 사람 계정이 함부로 덮어쓰지 못하게 돼 있다 — 실수와 침해를 동시에 줄이는 배치다.

다음 편은 루트에 홀로 있던 그 파일, wp-config.php의 핵심 상수들을 완전 분석한다. 워드프레스에서 제일 중요한 파일 하나를 꼽으라면 이거다.

자주 묻는 질문 (FAQ)

wp-content 폴더가 왜 중요한가요?

테마·플러그인·업로드 등 내가 만든 것이 전부 wp-content에 있습니다. 코어는 업데이트로 덮이지만 wp-content는 내 자산이라 백업의 핵심입니다.

wp-admin·wp-includes를 수정해도 되나요?

안 됩니다. 코어 파일은 업데이트 때 덮여 사라집니다. 수정은 테마·플러그인·자식 테마에서 하세요.

코멘트

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다