PHP 8.4 기반 2,000라인 코드로 9종 AI 도구 통합 설계

How I Built an AI Image Studio with 9 Tools Using PHP 8.4 — Architecture, Bugs & Lessons

Zihang Dong 董子航2026년 4월 29일6분intermediate

AI 요약

Context

복잡한 프레임워크 없이 API 중심의 단순성을 유지하며 다수의 AI 이미지 도구를 신속히 배포해야 하는 상황. 도구별 개별 백엔드 구축 시 발생하는 중복 코드와 유지보수 비용 증가가 주요 제약 사항으로 작용.

단일 백엔드 파이프라인 구조를 통한 9종 도구의 공통 처리 로직 통합 설계
프런트엔드 기반 Prompt Template Assembly 방식을 통한 백엔드 수정 없는 신규 도구 확장 체계 구축
Memory Limit(128MB) 초과로 인한 4K 이미지 썸네일 생성 시 PHP 500 에러 해결을 위한 메모리 추정 로직 도입
DB Update 선행 후 Side Effect(썸네일 생성)를 수행하는 순서 제어를 통한 무한 Crash Loop 방지
SELECT ... FOR UPDATE를 활용한 Credit 차감 시 Race Condition 방지 및 외부 API 호출 전 Lock 해제 전략 적용

실천 포인트

1. DB Lock을 외부 네트워크 API 호출 구간까지 유지하지 않는지 검토

2. 대용량 이미지 처리 전 `getimagesizefromstring`으로 필요한 메모리를 사전 계산하여 OOM 방지

3. 성공 상태를 먼저 DB에 기록한 후 부가 작업(알림, 썸네일 등)을 `try-catch`로 처리하는 멱등성 확보

태그