mirror of
https://github.com/jkaninda/nginx-php-fpm.git
synced 2025-12-06 21:49:41 +01:00
241 lines
6.1 KiB
Markdown
241 lines
6.1 KiB
Markdown
### 🐳 **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
|
||
```
|
||
|
||
---
|
||
|
||
### Explore Another Project: Goma Gateway
|
||
|
||
Are you building a microservices architecture?
|
||
Do you need a powerful yet lightweight API Gateway or a high-performance reverse proxy to secure and manage your services effortlessly?
|
||
|
||
Check out my other project — **[Goma Gateway](https://github.com/jkaninda/goma-gateway)**.
|
||
|
||
**Goma Gateway** is a high-performance, declarative API Gateway built for modern microservices. It comes with a rich set of built-in middleware, including:
|
||
|
||
* Basic, JWT, OAuth2, LDAP, and ForwardAuth authentication
|
||
* Caching and rate limiting
|
||
* Bot detection
|
||
* Built-in load balancing
|
||
* Simple configuration with minimal overhead
|
||
* ...and more!
|
||
|
||
**Protocol support:** REST, GraphQL, gRPC, TCP, and UDP
|
||
|
||
**Security:** Automatic HTTPS via Let’s Encrypt or use your own TLS certificates
|
||
|
||
Whether you're managing internal APIs or exposing public endpoints, **Goma Gateway** helps you do it efficiently, securely, and with minimal complexity.
|
||
|
||
---
|
||
|
||
## ⭐️ **Support the Project**
|
||
If this project helped you, do not skip on giving it a star. Thanks!
|
||
|
||
|