https://github.com/jkaninda/nginx-php-fpm
🐳 Simplified Docker image Nginx PHP-FPM container created to run Laravel or any php based applications, with extensions for Redis, Memcached, MySQL, Postgres, Events, Redis, Kafka, Laravel Schedule, Cron job and custom default configuration.
https://github.com/jkaninda/nginx-php-fpm
docker docker-compose docker-image laravel laravel-microservices nginx nodejs npm php php-fpm php-microservice rdka redis
Last synced: 24 days ago
JSON representation
🐳 Simplified Docker image Nginx PHP-FPM container created to run Laravel or any php based applications, with extensions for Redis, Memcached, MySQL, Postgres, Events, Redis, Kafka, Laravel Schedule, Cron job and custom default configuration.
- Host: GitHub
- URL: https://github.com/jkaninda/nginx-php-fpm
- Owner: jkaninda
- License: mit
- Created: 2022-06-30T09:32:49.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-27T18:00:05.000Z (4 months ago)
- Last Synced: 2025-03-30T07:08:26.905Z (about 1 month ago)
- Topics: docker, docker-compose, docker-image, laravel, laravel-microservices, nginx, nodejs, npm, php, php-fpm, php-microservice, rdka, redis
- Language: Dockerfile
- Homepage:
- Size: 83 KB
- Stars: 86
- Watchers: 4
- Forks: 28
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### 🐳 **Docker Image: Nginx PHP-FPM**
A **ready-to-use container** designed for running PHP-based applications, including Laravel microservices. This Docker image combines **Nginx** and **PHP-FPM**, offering a robust foundation for your projects with built-in support for essential extensions and configurations.
[](https://github.com/jkaninda/nginx-php-fpm/actions/workflows/build.yml)
[](https://github.com/jkaninda/nginx-php-fpm/actions/workflows/tests.yml)
#### **Features**
- **PHP Application Support**: Optimized to run Laravel or any PHP-based applications.
- **Integrated Extensions**:
- **Database**: MySQL and PostgreSQL.
- **Caching**: Redis and Memcached.
- **Messaging**: Kafka for event-driven architecture.
- **Task Scheduling**: Laravel Scheduler and Cron jobs support.
- **Custom Configuration**: Pre-configured with sensible defaults, allowing seamless customization.
- **Event Handling**: Support for advanced event-driven processes.
- **Optimized for Microservices**: Built with modern PHP microservices in mind.
This image is ideal for developers looking for a streamlined, high-performance solution to deploy PHP applications with essential tools already integrated.
---
## **Links**
- [Docker Hub](https://hub.docker.com/r/jkaninda/nginx-php-fpm)
- [GitHub Repository](https://github.com/jkaninda/nginx-php-fpm)
## **Supported PHP Versions**
- 8.4
- 8.3
- 8.2
- 8.1
- 8.0
- 7.4
- 7.2
## **Specifications**
This Docker image comes pre-installed with the following:
- **PHP Extensions**:
- Composer
- OpenSSL
- XML
- PDO
- Rdkafka
- Redis
- Mbstring
- PCNTL
- ZIP
- GD
- BCMath
- Memcached
- **Additional Features**:
- Laravel Cron Jobs & Scheduler
- Supervisord
- Node.js & NPM
## **Basic Usage with Docker Compose**
### **Example `docker-compose.yml`**
```yaml
services:
app:
image: jkaninda/nginx-php-fpm:8.3
container_name: app
restart: unless-stopped
user: www-data # Optional for production
volumes:
# Project root
- ./src:/var/www/html
ports:
- "80:80"
networks:
- default
```
### **Commands**
#### Start the service:
```sh
docker compose up -d
```
#### Create a new Laravel project:
```sh
docker compose exec app composer create-project --prefer-dist laravel/laravel .
```
#### Generate application key:
```sh
docker compose exec app php artisan key:generate
```
#### Create a storage symlink:
```sh
docker compose exec app php artisan storage:link
```
#### Fix storage and cache permissions:
```sh
docker compose exec app chmod -R 777 storage bootstrap/cache
```
#### Run Laravel migrations:
```sh
docker compose exec app php artisan migrate
```
#### Access the container shell:
```sh
docker exec -it app bash
```
---
## **Advanced Nginx PHP-FPM Setup**
### **Extended `docker-compose.yml` Example**
```yaml
version: '3'
services:
app:
image: jkaninda/nginx-php-fpm
container_name: app
restart: unless-stopped
ports:
- "80:80"
volumes:
# Project root
- ./:/var/www/html
- ~/.ssh:/root/.ssh # Use private CVS if needed
# Optional custom PHP config
# - ./php.ini:/usr/local/etc/php/conf.d/php.ini
environment:
- APP_ENV=development # or production
- LARAVEL_PROCS_NUMBER=2 # Optional: Queue worker processes
# - CLIENT_MAX_BODY_SIZE=20M # Optional
# - DOMAIN=example.com # Optional
- DOCUMENT_ROOT=/var/www/html # Optional
```
### **Default Web Root**
```
/var/www/html
```
---
## **Custom Build Example**
### **Dockerfile**
```Dockerfile
FROM jkaninda/nginx-php-fpm:8.3
# Copy Laravel project files
COPY . /var/www/html
# Storage Volume
VOLUME /var/www/html/storage
WORKDIR /var/www/html
# Fix permissions
RUN chown -R www-data:www-data /var/www/html
USER www-data
```
---
## **Custom Nginx Configuration**
To enable custom Nginx configurations, use the following files:
- `/var/www/html/conf/nginx/nginx.conf`
- `/var/www/html/conf/nginx/nginx-site.conf`
---
## **Supervisord Integration**
Supervisord can be used to manage tasks or processes within the container.
### **Example Configuration for Kafka Consumer**
```conf
[program:kafkaconsume-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/html/artisan kafka:consumer
autostart=true
autorestart=true
numprocs=1
user=www-data
redirect_stderr=true
stdout_logfile=/var/www/html/storage/logs/kafka.log
```
---
## **Fixing Storage Permissions**
If you encounter storage permission issues, run the following commands:
```sh
docker compose exec php-fpm /bin/bash
```
Then inside the container:
```sh
chown -R www-data:www-data /var/www/html/
chmod -R 775 /var/www/html/storage
```
---
## **Star the Project**
If you find this project useful, please give it a ⭐️ on GitHub to show your support! 😊