내 블로그는 어떻게 돌아가고 있을까
PHP와 MariaDB로 만든 Joblog의 화면 구성부터 게시글 조회, 관리자 CMS, 공통 코드와 CLI 글쓰기 흐름까지 정리했다.
블로그를 직접 만들고 기능을 하나씩 붙이다 보니 처음보다 다루는 범위가 많이 늘었다. 폴더와 게시글을 보여주는 화면에서 시작해서 관리자, 검색, 비밀 메모장, 공통 코드 관리까지 들어갔다.
모바일 대응과 라이트 모드도 추가했다. 기능을 더 만들기 전에 지금 이 블로그가 어떤 구조로 돌아가는지 한번 정리해두고 싶었다.
</> PHP와 MariaDB를 중심에 뒀다
현재 Joblog는 PHP가 요청을 받고 MariaDB에서 데이터를 읽는 구조다. 화면은 HTML과 CSS로 구성하고, 브라우저에서 일어나는 동작은 JavaScript로 처리한다. 일부 관리자 기능에는 jQuery와 기존 플러그인도 사용한다.
사용자 화면과 관리자 화면은 같은 프로젝트 안에 있다. 사용자 화면의 진입점은 루트의 index.php이고, 관리자는 admin/ 아래에 모여 있다. 별도 API 서버가 있는 구성은 아니다. JSON 응답이 필요한 기능을 PHP 엔드포인트로 나눠두었다.
사용자 화면의 폴더 탐색과 게시글 탭은 에디터처럼 구성했다. 화면의 모양은 데스크톱 앱에 가깝지만, 실제 데이터 처리는 PHP와 DB를 통해 이루어진다.
index.php # 사용자 화면 진입
public/components/ # 폴더, 탭, 본문, 푸터
public/api/ # 게시글과 검색 응답
public/js/ # 브라우저 동작
admin/ # 관리자
admin/tools/ # CLI 작업자</> 첫 화면과 글을 바꿀 때의 흐름이 다르다
처음 접속하면 PHP가 폴더 트리와 본문에 필요한 데이터를 가져와 페이지를 만든다. 폴더, 탭, 본문, 푸터는 public/components/의 렌더링 함수를 사용한다.
이후 다른 글을 선택할 때는 페이지 전체를 다시 불러오지 않는다. public/js/post.js의 loadPost()가 게시글 API를 호출하고, 응답을 받아 본문 영역을 바꾼다.
fetch('/public/api/post.php?post_id=' + postId)
.then(response => response.json())
.then(data => {
// 받은 제목, 본문, 댓글을 화면에 반영한다.
});게시글 API는 DB에서 제목과 본문, 댓글 등을 조회해 JSON으로 반환한다. 조회수 증가와 글 조회 로그 기록도 이 경로에 들어 있다. 브라우저에서는 탭과 주소를 함께 갱신해 글 사이를 이동한다.
같은 글을 동시에 여러 번 요청하지 않도록 진행 중인 요청을 저장하는 처리도 있다. 조회수 증가 위치와 초기 로딩 동작이 겹치면 글 하나를 열었는데 조회수가 여러 번 오를 수 있어서, 이 부분은 화면 동작과 서버 처리를 같이 봐야 했다.
</> 관리자는 같은 데이터를 다루는 별도 화면이다
관리자에서는 게시글과 폴더를 등록하고 공개 여부를 변경한다. 공통 진입 파일에서 세션을 확인하고, 각 화면에서 필요한 DB 작업을 수행한다.
게시글 작성에는 SmartEditor2를 사용한다. 에디터의 HTML을 저장 전에 textarea와 동기화하고, 제목과 설명, 폴더, 본문, 공개 여부를 게시글 테이블에 저장한다. 작성 중인 내용은 post_draft에 따로 저장한다.
저장된 본문은 Markdown을 다시 변환하는 방식이 아니다. HTML 자체를 보관하고 사용자 화면에서 표시한다. 그래서 어떤 태그와 클래스를 사용할 것인지가 글 작성 규칙의 일부가 됐다.
</> 본문 디자인도 하나의 규칙으로 관리한다
코드를 설명할 때는 코드 블록을 사용하고, 문제나 보충 설명은 문장 블록으로 구분한다. 같은 용도로 작성한 내용이 글마다 다른 모양이 되지 않도록 클래스 이름을 정했다.
<div class="dev-note">
<p>본문에 필요한 보충 설명</p>
</div>
<div class="code-block">
<pre><code class="language-sql">SELECT id FROM post;</code></pre>
</div>코드의 언어별 강조는 Prism이 맡는다. 본문을 AJAX로 교체한 뒤에는 새로 들어온 코드에도 강조 처리를 실행한다. 짧은 용어 설명은 term-tip 클래스와 data-tip 속성으로 표현한다.
문장 블록의 색상은 공통 코드의 POST_BLOCK 그룹에서도 관리한다. 클래스명과 배경색, 테두리색, 글자색을 읽어 CSS 응답을 생성하고, 사용자 화면과 관리자 미리보기에서 같은 설정을 사용한다.
글쓰기 에디터의 편집 영역은 별도 iframe이다. 사용자 화면과 미리보기에 적용한 스타일이 편집 영역까지 자동으로 적용되는 것은 아니다. 이 차이는 현재 구조에서도 구분해서 봐야 한다.
</> 분류 값은 공통 코드로 연결했다
비밀 메모장의 태그는 처음에 계정과 일반을 화면에 직접 적어두었다. 선택 항목이 늘어날 때마다 소스를 수정해야 해서 공통 코드 관리와 연결했다.
TBL_CODE_PARENT는 그룹을, TBL_CODE_DETAIL은 그룹 아래의 항목을 보관한다. 메모 태그는 NOTE_TAG, 본문 색상 블록은 POST_BLOCK으로 나눴다. 사용 여부와 삭제 여부, 순번도 함께 관리한다.
다만 코드에 등록했다고 모든 동작이 자동으로 생기는 것은 아니다. 계정 태그를 선택했을 때 ID와 비밀번호를 입력받거나 변경 이력을 남기는 동작은 PHP와 JavaScript에 구현되어 있다. 공통 코드는 선택할 값과 표시 설정을 제공하는 역할이다.
</> AI 초안 생성은 작업 큐를 거친다
글쓰기 도우미에는 외부 모델 API를 호출하는 경로와 Codex CLI를 사용하는 경로가 있다. CLI 경로는 웹 요청 안에서 글이 완성될 때까지 기다리지 않도록 했다.
관리자에서 생성 요청을 보내면 ai_cli_job에 작업이 등록된다. 별도 PHP 작업자가 대기 중인 작업을 가져와 Codex CLI를 실행하고, 생성한 제목과 설명, 본문을 임시저장한다. 관리자 화면은 작업 상태를 조회하다가 완료된 초안 링크를 보여준다.
- 웹에서 작성할 경험과 요구사항을 등록한다.
- 작업자가 대기 중인 요청을 가져간다.
- Codex CLI의 JSON 결과를 읽는다.
- 본문을 정리해 임시저장하고 완료 상태로 변경한다.
- 작성자가 초안을 열어 확인한다.
이 작업자는 사용자 systemd 서비스로 실행하도록 구성했다. 웹 서버 계정과 CLI 인증을 가진 계정이 다르기 때문에, 웹 서버에 인증 파일을 전달하는 대신 작업 큐를 사이에 뒀다. CLI 사용량과 인증 상태는 해당 계정 설정을 따른다.
</> 모바일과 테마는 기존 화면 위에 붙였다
모바일에서는 왼쪽 탐색 영역을 접고 본문을 넓게 사용한다. 폴더 버튼을 누르면 메뉴가 열리고, 글을 선택하면 메뉴를 닫는다. 긴 폴더명은 한 줄에서 말줄임으로 표시한다.
라이트와 다크 모드는 HTML 루트의 테마 속성으로 구분한다. 선택은 브라우저 저장소에 남기고 다음 접속 때 다시 적용한다. 코드 블록은 라이트 모드에서도 어두운 배경을 유지한다.
기존 CSS에는 고정 색상이 많았다. 배경만 바꾸면 헤더나 카드가 다크 색상으로 남았다. 화면 전체를 한 번에 바꾸기보다 각 영역의 배경, 글자, 테두리 대비를 함께 확인해야 했다.
</> 현재 구조에서 남아 있는 부분
지금 코드는 화면에서 SQL을 직접 실행하는 부분이 많다. 루트와 관리자에 DB 연결 파일이 따로 있고, 첫 화면과 AJAX 조회 경로도 각각 관리한다. 기능을 수정할 때 어느 경로까지 영향을 주는지 확인할 필요가 있다.
앞으로는 공통 조회와 저장 로직을 더 모으고 싶다. 입력 검증과 권한 확인도 각 기능에서 같은 기준으로 적용되는지 점검해야 한다. 본문 HTML과 확장 블록을 계속 늘릴수록 허용할 태그와 속성의 기준도 중요해진다.
현재 Joblog는 PHP와 DB를 중심으로 필요한 기능을 쌓아온 블로그다. 지금 구조를 기록해두면 다음 기능을 붙일 때도 어느 부분을 수정해야 하는지 덜 헤맬 것 같다.
댓글