{"id":18431577,"url":"https://github.com/jkaninda/laravel-php-fpm","last_synced_at":"2025-04-06T04:07:18.131Z","repository":{"id":37042535,"uuid":"504534001","full_name":"jkaninda/laravel-php-fpm","owner":"jkaninda","description":"🐳 Simplified Docker PHP-FPM image created to run Laravel or any php based application, 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:21:23.000Z","size":228,"stargazers_count":93,"open_issues_count":0,"forks_count":30,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-30T03:02:59.566Z","etag":null,"topics":["docker","docker-container","docker-image","laravel","laravel-docker","laravel-kafka","laravel-microservices","laravel-redis","microservice","mysql","nginx","php","php-fpm","php-kafka","php-microservice","php-rdkafka","php-redis","postgresql"],"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-17T12:53:40.000Z","updated_at":"2025-03-13T17:16:21.000Z","dependencies_parsed_at":"2023-11-13T07:27:39.000Z","dependency_job_id":"fca90625-30c2-4880-8a81-5b18fafcd097","html_url":"https://github.com/jkaninda/laravel-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%2Flaravel-php-fpm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkaninda%2Flaravel-php-fpm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkaninda%2Flaravel-php-fpm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jkaninda%2Flaravel-php-fpm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jkaninda","download_url":"https://codeload.github.com/jkaninda/laravel-php-fpm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247430865,"owners_count":20937874,"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-container","docker-image","laravel","laravel-docker","laravel-kafka","laravel-microservices","laravel-redis","microservice","mysql","nginx","php","php-fpm","php-kafka","php-microservice","php-rdkafka","php-redis","postgresql"],"created_at":"2024-11-06T05:25:31.900Z","updated_at":"2025-04-06T04:07:18.104Z","avatar_url":"https://github.com/jkaninda.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"### 🐳 **Docker Image: Laravel PHP-FPM**  \n\nA **ready-to-use container** designed for running PHP-based applications, including Laravel microservices.\nThis Docker image comes with **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/laravel-php-fpm/actions/workflows/build.yml/badge.svg)](https://github.com/jkaninda/laravel-php-fpm/actions/workflows/build.yml)\n[![Tests](https://github.com/jkaninda/laravel-php-fpm/actions/workflows/tests.yml/badge.svg)](https://github.com/jkaninda/laravel-php-fpm/actions/workflows/tests.yml)\n![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/jkaninda/laravel-php-fpm?style=flat-square)\n![Docker Pulls](https://img.shields.io/docker/pulls/jkaninda/laravel-php-fpm?style=flat-square)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/jkaninda/laravel-php-fpm\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg\" width=\"400\" alt=\"Logo\"\u003e\n  \u003c/a\u003e\n  \u003c/p\u003e\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/laravel-php-fpm)\n- [Github](https://github.com/jkaninda/laravel-php-fpm)\n---\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---\n\n## **Specifications**\n\n### **PHP Extensions**\n- Composer  \n- OpenSSL  \n- XML  \n- PDO (MySQL and PostgreSQL)  \n- Rdkafka  \n- Redis  \n- Mbstring  \n- PCNTL  \n- ZIP  \n- GD  \n- BCMath  \n- Memcached  \n- Opcache  \n\n### **Additional Features**\n- Laravel Cron Jobs  \n- Laravel Scheduler  \n- Supervisord  \n- Node.js and NPM  \n\n---\n\n## **Getting Started**\n\n### **Simple Docker-Compose Example**\n```yaml\nservices:\n  php-fpm:\n    image: jkaninda/laravel-php-fpm:latest\n    container_name: php-fpm\n    restart: unless-stopped\n    user: www-data # For production\n    volumes:\n      - ./:/var/www/html\n    networks:\n      - default\n  nginx-server:\n     image: jkaninda/nginx-fpm:alpine\n     container_name: nginx-server\n     restart: unless-stopped\n     ports:\n      - 80:80\n     volumes:\n      - ./:/var/www/html\n     environment:\n       - DOCUMENT_ROOT=/var/www/html/public\n       - CLIENT_MAX_BODY_SIZE=20M\n       - PHP_FPM_HOST=php-fpm:9000 \n     networks:\n      - default\n```\n\n### **Basic Commands**\n- **Start Containers**  \n  ```sh\n  docker compose up -d\n  ```\n\n- **Create a Laravel Project**  \n  ```sh\n  docker compose exec php-fpm composer create-project --prefer-dist laravel/laravel .\n  ```\n\n- **Generate Application Key**  \n  ```sh\n  docker compose exec php-fpm php artisan key:generate\n  ```\n\n- **Create Storage Symlink**  \n  ```sh\n  docker compose exec php-fpm php artisan storage:link\n  ```\n\n- **Fix Permissions**  \n  ```sh\n  docker compose exec php-fpm chmod -R 777 storage bootstrap/cache\n  ```\n\n- **Run Laravel Migrations**  \n  ```sh\n  docker compose exec php-fpm php artisan migrate\n  ```\n\n- **Access the Container Shell**  \n  ```sh\n  docker exec -it php-fpm bash\n  ```\n\n---\n\n## **Advanced Usage with Nginx**\n\n### **Docker-Compose with Nginx**\nExample of using a custom nginx config:\n\n```yaml\nversion: '3'\nservices:\n  php-fpm:\n    image: jkaninda/laravel-php-fpm\n    container_name: php-fpm\n    restart: unless-stopped\n    volumes:\n      - ./:/var/www/html\n    networks:\n      - default\n\n  nginx-server:\n    image: nginx:alpine\n    container_name: nginx-server\n    restart: unless-stopped\n    ports:\n      - 80:80\n    volumes:\n      - ./:/var/www/html\n      - ./default.conf:/etc/nginx/conf.d/default.conf\n    environment:\n      - DOCUMENT_ROOT=/var/www/html/public\n      - CLIENT_MAX_BODY_SIZE=20M\n      - PHP_FPM_HOST=php-fpm:9000\n    networks:\n      - default\n```\n\n### **Nginx Configuration (default.conf)**\n\n```conf\nserver {\n    listen 80;\n    index index.php index.html;\n    root /var/www/html/public;\n\n    location ~ \\.php$ {\n        try_files $uri =404;\n        fastcgi_split_path_info ^(.+\\.php)(/.+)$;\n        fastcgi_pass php-fpm:9000;\n        fastcgi_index index.php;\n        include fastcgi_params;\n        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n        fastcgi_param PATH_INFO $fastcgi_path_info;\n    }\n\n    location / {\n        try_files $uri $uri/ /index.php?$query_string;\n        gzip_static on;\n    }\n\n    client_max_body_size 15M;\n    server_tokens off;\n    fastcgi_hide_header X-Powered-By;\n}\n```\n\n---\n\n## **Custom Build**\n\n### **Dockerfile Example**\n```Dockerfile\nFROM jkaninda/laravel-php-fpm:8.3\n# Copy Laravel project files\nCOPY . /var/www/html\nVOLUME /var/www/html/storage\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## **Supervisord Integration**\n\n### **Adding Custom Supervisor Processes**\nPlace configurations in `/etc/supervisor/conf.d/`.  \nExample Kafka consumer process:  \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## **Custom PHP Configurations**\nPlace your custom `php.ini` file at:  \n```\n/usr/local/etc/php/conf.d/\n```\n\n---\n\n## **Storage Permissions Fix**\nIf you encounter permission issues, run:  \n\n```sh\ndocker compose exec php-fpm /bin/bash\nchown -R www-data:www-data /var/www/html\nchmod -R 775 /var/www/html/storage\n```\n\n---\n\n### ⭐️ **Support the Project**  \nIf you find this project useful, please give it a ⭐️ on GitHub! 😊  ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjkaninda%2Flaravel-php-fpm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjkaninda%2Flaravel-php-fpm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjkaninda%2Flaravel-php-fpm/lists"}