From 4e8677d8c1d6bec9a1cad80ba7a801b2aea096e7 Mon Sep 17 00:00:00 2001
From: KWON <thexero@gmail.com>
Date: Fri, 26 Dec 2025 15:38:45 +0900
Subject: [PATCH] =?UTF-8?q?feat:=20phpMyAdmin=20=EC=BB=A8=ED=85=8C?=
 =?UTF-8?q?=EC=9D=B4=EB=84=88=20=EC=B6=94=EA=B0=80=20=EB=B0=8F=20=ED=8F=AC?=
 =?UTF-8?q?=ED=8A=B8=20=EB=B3=80=EA=B2=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- phpMyAdmin 8888 포트에서 제공
- MariaDB와 자동 연결
- PHP 8.2 포트 8082로 변경 (기존 80에서)
- README.md 업데이트: 서비스 접속 정보 테이블 추가
---
 README.md          | 20 +++++++++++++++++++-
 docker-compose.yml | 17 +++++++++++++++++
 2 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 82e3be1..34ea4d4 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 Cafe24 10G자이언트플러스 호스팅 환경과 최대한 유사한 개발 환경 구축을 목표로 합니다.
 
 ## 지원 PHP 버전
-- **PHP 8.2** (포트: 80) - 현재 운영 중인 버전
+- **PHP 8.2** (포트: 8082) - 현재 운영 중인 버전
 - **PHP 8.4** (포트: 8084) - 추후 업그레이드 대비용
 
 > 두 버전이 동시에 실행되며, 동일한 웹루트와 MariaDB를 공유합니다.
@@ -50,6 +50,21 @@ docker compose up -d
 > docker login reg.firstgarden.co.kr
 > ```
 
+## 접속 정보
+
+| 서비스 | URL | 포트 |
+|--------|-----|------|
+| **PHP 8.2** | http://localhost:8082 | 8082 |
+| **PHP 8.4** | http://localhost:8084 | 8084 |
+| **phpMyAdmin** | http://localhost:8888 | 8888 |
+| **MariaDB** | localhost:3306 | 3306 |
+
+### phpMyAdmin 접속
+- **URL**: http://localhost:8888
+- **사용자명**: `.env`의 `MYSQL_USER` 값
+- **비밀번호**: `.env`의 `MYSQL_PASSWORD` 값
+- **데이터베이스**: `.env`의 `MYSQL_DATABASE` 값
+
 ## 접속 정보
 - **PHP 8.2**: http://localhost
 - **PHP 8.4**: http://localhost:8084
@@ -60,6 +75,9 @@ docker compose up -d
 - `WEB_ROOT` - 웹소스 경로 (기본값: `./www`)
 - `MYSQL_PORT` - MariaDB 포트 (기본값: 3306)
 - `MYSQL_ROOT_PASSWORD` - MariaDB 루트 비밀번호
+- `MYSQL_USER` - MariaDB 사용자명 (phpMyAdmin 로그인에도 사용됨)
+- `MYSQL_PASSWORD` - MariaDB 사용자 비밀번호 (phpMyAdmin 로그인에도 사용됨)
+- `MYSQL_DATABASE` - MariaDB 데이터베이스명
 - `TZ` - 타임존 (기본값: Asia/Seoul)
 
 ---
diff --git a/docker-compose.yml b/docker-compose.yml
index 0106ace..4ee83f4 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -72,3 +72,20 @@ services:
       - ./data/mariadb:/var/lib/mysql
       - ./logs/mariadb:/var/log/mysql
     restart: unless-stopped
+
+  phpmyadmin:
+    image: phpmyadmin:latest
+    container_name: cafe24-phpmyadmin
+    ports:
+      - "8888:80"
+    env_file:
+      - .env
+    environment:
+      PMA_HOST: mariadb
+      PMA_PORT: 3306
+      PMA_USER: ${MYSQL_USER}
+      PMA_PASSWORD: ${MYSQL_PASSWORD}
+      PMA_DB: ${MYSQL_DATABASE}
+    depends_on:
+      - mariadb
+    restart: unless-stopped