{"id":18431553,"url":"https://github.com/jkaninda/nginx-php-fpm","last_synced_at":"2025-04-06T08:13:39.348Z","repository":{"id":54473281,"uuid":"509017003","full_name":"jkaninda/nginx-php-fpm","owner":"jkaninda","description":"🐳 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.","archived":false,"fork":false,"pushed_at":"2024-12-27T18:00:05.000Z","size":85,"stargazers_count":86,"open_issues_count":0,"forks_count":28,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-30T07:08:26.905Z","etag":null,"topics":["docker","docker-compose","docker-image","laravel","laravel-microservices","nginx","nodejs","npm","php","php-fpm","php-microservice","rdka","redis"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jkaninda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-30T09:32:49.000Z","updated_at":"2025-03-17T17:13:53.000Z","dependencies_parsed_at":"2023-12-16T07:36:34.514Z","dependency_job_id":"e59830b2-dd49-4ed9-a552-8ed72ef28fd7","html_url":"https://github.com/jkaninda/nginx-php-fpm","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkaninda%2Fnginx-php-fpm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkaninda%2Fnginx-php-fpm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkaninda%2Fnginx-php-fpm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkaninda%2Fnginx-php-fpm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jkaninda","download_url":"https://codeload.github.com/jkaninda/nginx-php-fpm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247451665,"owners_count":20940944,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","docker-image","laravel","laravel-microservices","nginx","nodejs","npm","php","php-fpm","php-microservice","rdka","redis"],"created_at":"2024-11-06T05:25:26.216Z","updated_at":"2025-04-06T08:13:39.331Z","avatar_url":"https://github.com/jkaninda.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"### 🐳 **Docker Image: Nginx PHP-FPM**  \n\nA **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.  \n\n[![Build](https://github.com/jkaninda/nginx-php-fpm/actions/workflows/build.yml/badge.svg)](https://github.com/jkaninda/nginx-php-fpm/actions/workflows/build.yml)\n[![Tests](https://github.com/jkaninda/nginx-php-fpm/actions/workflows/tests.yml/badge.svg)](https://github.com/jkaninda/nginx-php-fpm/actions/workflows/tests.yml)\n![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/jkaninda/nginx-php-fpm?style=flat-square)\n![Docker Pulls](https://img.shields.io/docker/pulls/jkaninda/nginx-php-fpm?style=flat-square)\n\n\n#### **Features**  \n- **PHP Application Support**: Optimized to run Laravel or any PHP-based applications.  \n- **Integrated Extensions**:  \n  - **Database**: MySQL and PostgreSQL.  \n  - **Caching**: Redis and Memcached.  \n  - **Messaging**: Kafka for event-driven architecture.  \n  - **Task Scheduling**: Laravel Scheduler and Cron jobs support.  \n- **Custom Configuration**: Pre-configured with sensible defaults, allowing seamless customization.  \n- **Event Handling**: Support for advanced event-driven processes.  \n- **Optimized for Microservices**: Built with modern PHP microservices in mind.  \n\nThis image is ideal for developers looking for a streamlined, high-performance solution to deploy PHP applications with essential tools already integrated.\n\n---\n## **Links**  \n- [Docker Hub](https://hub.docker.com/r/jkaninda/nginx-php-fpm)  \n- [GitHub Repository](https://github.com/jkaninda/nginx-php-fpm)  \n\n## **Supported PHP Versions**  \n- 8.4  \n- 8.3  \n- 8.2  \n- 8.1  \n- 8.0  \n- 7.4  \n- 7.2  \n\n## **Specifications**  \nThis Docker image comes pre-installed with the following:  \n- **PHP Extensions**:  \n  - Composer  \n  - OpenSSL  \n  - XML  \n  - PDO  \n  - Rdkafka  \n  - Redis  \n  - Mbstring  \n  - PCNTL  \n  - ZIP  \n  - GD  \n  - BCMath  \n  - Memcached  \n\n- **Additional Features**:  \n  - Laravel Cron Jobs \u0026 Scheduler  \n  - Supervisord  \n  - Node.js \u0026 NPM  \n\n## **Basic Usage with Docker Compose**\n\n### **Example `docker-compose.yml`**\n```yaml\nservices:\n  app:\n    image: jkaninda/nginx-php-fpm:8.3\n    container_name: app\n    restart: unless-stopped\n    user: www-data # Optional for production\n    volumes:\n      # Project root\n      - ./src:/var/www/html\n    ports:\n      - \"80:80\"\n    networks:\n      - default\n```\n\n### **Commands**  \n\n#### Start the service:\n```sh\ndocker compose up -d\n```\n\n#### Create a new Laravel project:\n```sh\ndocker compose exec app composer create-project --prefer-dist laravel/laravel .\n```\n\n#### Generate application key:\n```sh\ndocker compose exec app php artisan key:generate\n```\n\n#### Create a storage symlink:\n```sh\ndocker compose exec app php artisan storage:link\n```\n\n#### Fix storage and cache permissions:\n```sh\ndocker compose exec app chmod -R 777 storage bootstrap/cache\n```\n\n#### Run Laravel migrations:\n```sh\ndocker compose exec app php artisan migrate\n```\n\n#### Access the container shell:\n```sh\ndocker exec -it app bash\n```\n\n---\n\n## **Advanced Nginx PHP-FPM Setup**\n\n### **Extended `docker-compose.yml` Example**\n```yaml\nversion: '3'\nservices:\n  app:\n    image: jkaninda/nginx-php-fpm\n    container_name: app\n    restart: unless-stopped\n    ports:\n      - \"80:80\"\n    volumes:\n      # Project root\n      - ./:/var/www/html\n      - ~/.ssh:/root/.ssh # Use private CVS if needed\n      # Optional custom PHP config\n      # - ./php.ini:/usr/local/etc/php/conf.d/php.ini\n    environment:\n      - APP_ENV=development # or production\n      - LARAVEL_PROCS_NUMBER=2 # Optional: Queue worker processes\n      # - CLIENT_MAX_BODY_SIZE=20M # Optional\n      # - DOMAIN=example.com # Optional\n      - DOCUMENT_ROOT=/var/www/html # Optional\n```\n\n### **Default Web Root**  \n```\n/var/www/html\n```\n\n---\n\n## **Custom Build Example**\n\n### **Dockerfile**\n```Dockerfile\nFROM jkaninda/nginx-php-fpm:8.3\n# Copy Laravel project files\nCOPY . /var/www/html\n# Storage Volume\nVOLUME /var/www/html/storage\n\nWORKDIR /var/www/html\n\n# Fix permissions\nRUN chown -R www-data:www-data /var/www/html\n\nUSER www-data\n```\n\n---\n\n## **Custom Nginx Configuration**\n\nTo enable custom Nginx configurations, use the following files:  \n- `/var/www/html/conf/nginx/nginx.conf`  \n- `/var/www/html/conf/nginx/nginx-site.conf`  \n\n---\n\n## **Supervisord Integration**\n\nSupervisord can be used to manage tasks or processes within the container.  \n\n### **Example Configuration for Kafka Consumer**\n```conf\n[program:kafkaconsume-worker]\nprocess_name=%(program_name)s_%(process_num)02d\ncommand=php /var/www/html/artisan kafka:consumer\nautostart=true\nautorestart=true\nnumprocs=1\nuser=www-data\nredirect_stderr=true\nstdout_logfile=/var/www/html/storage/logs/kafka.log\n```\n\n---\n\n## **Fixing Storage Permissions**  \n\nIf you encounter storage permission issues, run the following commands:  \n\n```sh\ndocker compose exec php-fpm /bin/bash\n```\n\nThen inside the container:  \n```sh\nchown -R www-data:www-data /var/www/html/\nchmod -R 775 /var/www/html/storage\n```\n\n---\n\n## **Star the Project**  \n\nIf you find this project useful, please give it a ⭐️ on GitHub to show your support! 😊  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjkaninda%2Fnginx-php-fpm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjkaninda%2Fnginx-php-fpm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjkaninda%2Fnginx-php-fpm/lists"}