Repolode
TrafeX

TrafeX/docker-php-nginx

PHP 앱을 바로 서비스할 수 있는 PHP-FPM 8.5와 Nginx를 함께 실행하는 경량 Alpine Linux Docker 이미지입니다.

스타
1,529
포크
759
열린 이슈
2
마지막 커밋
7일 전

어떤 프로젝트인가요?

이 프로젝트는 Alpine Linux에서 PHP-FPM 8.5와 Nginx 1.28을 함께 제공하는 Docker 이미지로, 웹 서버 스택을 직접 구성하지 않아도 PHP 애플리케이션을 서비스할 수 있습니다. 코드를 /var/www/html에 마운트하기만 하면 서비스를 시작할 수 있으며, Nginx, PHP, PHP-FPM 설정 파일은 볼륨 마운트로 덮어쓸 수 있습니다.

이미지는 크기가 작고 유휴 상태에서 리소스를 적게 사용하는 것을 목표로 합니다. AMD64, ARMv6, ARMv7, ARM64를 지원하고 용량은 약 40MB이며, 트래픽이 있을 때만 프로세스를 실행하는 PHP-FPM의 on-demand 프로세스 관리자를 사용합니다. Nginx, PHP-FPM, supervisord는 권한이 없는 nobody 사용자로 실행되고, 모든 서비스의 로그는 docker logs에서 확인할 수 있도록 컨테이너 출력으로 전송됩니다.

이 저장소는 컨테이너에서 Nginx와 PHP-FPM을 함께 실행하는 방법을 이해하기 쉽게 보여주는 예제로 활용할 수 있습니다. 가이드에서는 Xdebug와 Composer 추가, 로드 밸런서 뒤에서 실제 클라이언트 IP 처리, 이메일 전송 방법을 다룹니다.

핵심 기능

  • 01Alpine Linux 기반의 약 40MB 경량 이미지에서 PHP-FPM 8.5와 Nginx 1.28을 실행합니다.
  • 02AMD64, ARMv6, ARMv7, ARM64 플랫폼을 지원합니다.
  • 03PHP-FPM의 on-demand 프로세스 관리자를 사용해 트래픽이 있을 때만 리소스를 사용합니다.
  • 04Nginx, PHP-FPM, supervisord를 권한이 없는 nobody 사용자로 실행합니다.
  • 05모든 서비스의 로그를 컨테이너 출력으로 전송합니다.
  • 06설정 파일을 마운트해 Nginx, PHP, PHP-FPM 설정을 덮어쓸 수 있습니다.

활용 사례

  • 사용자 지정 웹 서버 이미지를 만들지 않고 컨테이너에서 PHP 애플리케이션을 서비스할 때.
  • Raspberry Pi 보드와 같은 저전력 ARM 기기에서 PHP 사이트를 실행할 때.
  • 맞춤형 Docker 구성을 위한 최소한의 PHP 기반 이미지로 사용할 때.
  • 컨테이너에서 Nginx와 PHP-FPM이 연결되는 방식을 익힐 때.

빠른 시작

  1. 1

    Docker로 컨테이너를 시작합니다

    docker run -p 80:8080 trafex/php-nginx
  2. 2

    자신의 코드를 마운트하여 PHP-FPM과 Nginx로 제공합니다

    docker run -p 80:8080 -v ~/my-codebase:/var/www/html trafex/php-nginx

사용 전 알아둘 점

  • 이 이미지는 최소한의 예제이며 Alpine의 PHP 8.5 및 Nginx 1.28 패키지에만 맞게 구성되어 있습니다.
  • 설정을 맞춤화하려면 자체 설정 파일을 컨테이너에 마운트해야 합니다.

토픽

자주 묻는 질문

docker-php-nginx은(는) 무엇인가요?
PHP 앱을 바로 서비스할 수 있는 PHP-FPM 8.5와 Nginx를 함께 실행하는 경량 Alpine Linux Docker 이미지입니다. 이 프로젝트는 Alpine Linux에서 PHP-FPM 8.5와 Nginx 1.28을 함께 제공하는 Docker 이미지로, 웹 서버 스택을 직접 구성하지 않아도 PHP 애플리케이션을 서비스할 수 있습니다. 코드를 /var/www/html에 마운트하기만 하면 서비스를 시작할 수 있으며, Nginx, PHP, PHP-FPM 설정 파일은 볼륨 마운트로 덮어쓸 수 있습니다.
docker-php-nginx은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
docker-php-nginx은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
docker-php-nginx은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. docker-php-nginx의 마지막 커밋은 2026년 10월 31일입니다.
docker-php-nginx은(는) 어디에 사용할 수 있나요?
사용자 지정 웹 서버 이미지를 만들지 않고 컨테이너에서 PHP 애플리케이션을 서비스할 때. Raspberry Pi 보드와 같은 저전력 ARM 기기에서 PHP 사이트를 실행할 때. 맞춤형 Docker 구성을 위한 최소한의 PHP 기반 이미지로 사용할 때. 컨테이너에서 Nginx와 PHP-FPM이 연결되는 방식을 익힐 때.
docker-php-nginx는 어떻게 설치하나요?
Docker로 컨테이너를 시작합니다: docker run -p 80:8080 trafex/php-nginx 자신의 코드를 마운트하여 PHP-FPM과 Nginx로 제공합니다: docker run -p 80:8080 -v ~/my-codebase:/var/www/html trafex/php-nginx
docker-php-nginx은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/TrafeX/docker-php-nginx

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트