shinsenter/phpfpm-nginx repository overview

⁠shinsenter/phpfpm-nginx

🌏 (PHP) PHP + Nginx Docker images for both production and development.

• Docker Hub: https://hub.docker.com/r/shinsenter/phpfpm-nginx⁠
• GitHub Packages: https://code.shin.company/php/pkgs/container/phpfpm-nginx⁠
• You can also find and use other pre-built Docker images for some popular PHP applications and frameworks here⁠.
• Main documentation: shinsenter/php⁠

⁠Introduction

Our PHP Docker images, available on Docker Hub⁠, are designed for easy configuration of PHP and PHP-FPM settings via environment variables, with no image rebuild required.

These images also come with the latest version of Composer⁠.

⁠Usage

docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./myproject:/var/www/html \
    shinsenter/phpfpm-nginx:latest

Refer to our documentation⁠ to learn how to customize these Docker images for your projects.

⁠Using HTTPS

The Docker images come with pre-generated SSL certificate files for testing HTTPS locally:

• /etc/ssl/site/server.crt
• /etc/ssl/site/server.key

To use valid HTTPS certificates in production, replace these files with your own certificate and key, either by copying or mounting them from the host into the container.

⁠Using Dockerfile

FROM shinsenter/phpfpm-nginx:latest

# Copy your own certs into the container
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

⁠Using docker run

docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./myproject:/var/www/html \
    -v ./my_domain.crt:/etc/ssl/site/server.crt \
    -v ./my_domain.key:/etc/ssl/site/server.key \
    shinsenter/phpfpm-nginx:latest

⁠Using docker-compose

services:
  web:
    image: shinsenter/phpfpm-nginx:latest
    volumes:
      - ./myproject:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

⁠Customize Nginx

You can add your Nginx configurations by mounting or copying your *.conf files into the /etc/nginx/custom.d/ directory of the container. The config files here will be loaded into the Nginx's default server.

⁠Supported Platforms

Check our Docker Hub⁠ for all available platforms. The Docker images are available for both Debian and Alpine versions.

⁠Stable Image Tags

The release versions on this GitHub repository⁠ don't guarantee that Docker images built from the same source code will always be identical.

We build new Docker images daily to ensure they stay up-to-date with the latest upstream updates for PHP, base OS, Composer, etc. The images in this repo are regularly updated under the same tag names.

But you can pull the image from shinsenter/phpfpm-nginx:latest, and tag it with a name that indicates its stability, such as your-repo/phpfpm-nginx:stable using the below commands:

docker pull shinsenter/phpfpm-nginx:latest
docker tag  shinsenter/phpfpm-nginx:latest your-repo/phpfpm-nginx:stable
docker push your-repo/phpfpm-nginx:stable

Then use the image your-repo/phpfpm-nginx:stable as a base image to build containers for production.

⁠Contributing

If you find these images useful, consider donating via PayPal⁠ or opening an issue on GitHub⁠.

⁠License

This project is licensed under the terms of the GNU General Public License v3.0⁠.

Please respect the work that went into these images. If you reuse ideas from this project, credit is appreciated.

From Vietnam 🇻🇳 with love.