add missing files

Author: rw4lll

example-app/entrypoint.sh

@@ -0,0 +1,12 @@
+#!/bin/sh
+set -e
+
+# Check if the storage directory is empty (initial start)
+if [ ! "$(ls -A /var/www/storage)" ]; then
+  echo "Initializing storage directory..."
+  cp -R /var/www/storage-init/. /var/www/storage
+  chown -R www-data:www-data /var/www/storage
+fi
+
+# Run the default command
+exec "$@"

example-app/nginx.conf

@@ -0,0 +1,30 @@
+events {
+    worker_connections  1024;
+}
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+
+    sendfile        on;
+    keepalive_timeout  65;
+
+    server {
+        listen 80;
+        server_name localhost;
+
+        root /var/www/public;
+        index index.php index.html;
+
+        location / {
+            try_files $uri $uri/ /index.php?$query_string;
+        }
+
+        location ~ \.php$ {
+            fastcgi_pass php-fpm:9000;
+            fastcgi_index index.php;
+            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+            include fastcgi_params;
+        }
+    }
+}

production/nginx-fpm/.env.example

@@ -0,0 +1,23 @@
+# Sync user ID and group ID to avoid permission issues
+UID=1000  # Replace with your user ID
+GID=1000  # Replace with your group ID
+
+# Path to your Laravel application
+LARAVEL_APP_PATH=/absolute/path/to/your-laravel-app
+
+# Nginx configuration
+# The host where Nginx will be accessible.
+NGINX_HOST=localhost
+
+# The port on which Nginx will listen. Typically, this would be port 80.
+NGINX_PORT=80
+
+# PostgreSQL database configuration
+# The name of the database to be used by your Laravel application.
+DB_DATABASE=laravel
+
+# The username for accessing the PostgreSQL database.
+DB_USERNAME=laravel
+
+# The password for accessing the PostgreSQL database.
+DB_PASSWORD=secret

production/nginx-fpm/compose.yaml

@@ -0,0 +1,95 @@
+services:
+  web:
+    image: nginx:alpine
+    build:
+      context: ../../example-app
+      dockerfile: ../production/nginx-fpm/nginx/Dockerfile
+    volumes:
+      - laravel-storage:/var/www/storage:ro  # Mount the storage volume (in case you want to use storage:link)
+    networks:
+      - laravel
+    ports:
+      - "${NGINX_PORT}:80"
+    environment:
+      - NGINX_HOST=${NGINX_HOST}
+    depends_on:
+      php-fpm:
+        condition: service_healthy  # Wait for php-fpm health check
+
+  php-fpm:
+    # For the php-fpm service, we will create a custom image to install the necessary PHP extensions and setup proper permissions.
+    build:
+      context: ../../example-app
+      dockerfile: ../production/nginx-fpm/php-fpm/Dockerfile
+    volumes:
+      - laravel-storage:/var/www/storage  # Mount the storage volume
+    environment:
+      - APP_NAME=TestApp
+      - APP_KEY=base64:y6S7gjyAO/PVAJMBvJSJUCO8qiz92qvcNAPRKH3hpj4=
+      - APP_DEBUG=true
+    networks:
+      - laravel
+    healthcheck:
+      test: ["CMD-SHELL", "php-fpm-healthcheck || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+    # The `depends_on` section tells Docker Compose to
+    # start the database before your application.
+    depends_on:
+      postgres:
+        condition: service_healthy
+  
+  php-cli:
+    build:
+      context: ../../example-app
+      dockerfile: ../production/nginx-fpm/php-cli/Dockerfile
+    tty: true   # Keep the terminal open
+    stdin_open: true  # Keep stdin open to attach to the container
+    environment:
+      - APP_NAME=TestApp
+    networks:
+      - laravel
+
+  postgres:
+    image: postgres:16
+    restart: always
+    user: postgres
+    secrets:
+      - db-password
+    ports:
+      - "5432:5432"
+    environment:
+      - POSTGRES_DB=${DB_DATABASE}
+      - POSTGRES_USER=${DB_USERNAME}
+      - POSTGRES_PASSWORD_FILE=/run/secrets/db-password
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    networks:
+      - laravel
+    healthcheck:
+      test: [ "CMD", "pg_isready" ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:alpine
+    networks:
+      - laravel
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+
+networks:
+  laravel:
+
+volumes:
+  postgres-data:
+  laravel-storage:
+
+secrets:
+  db-password:
+    file: db-password.txt

production/nginx-fpm/db-password.txt

@@ -0,0 +1 @@
+secret

production/nginx-fpm/nginx/Dockerfile

@@ -0,0 +1,35 @@
+# Stage 1: Build assets
+FROM debian AS builder
+
+# Install Node.js and build tools
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    nodejs \
+    npm \
+    && apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+# Set working directory
+WORKDIR /var/www
+
+# Copy Laravel application code
+COPY . /var/www
+
+# Install Node.js dependencies and build assets
+RUN npm install && npm run build
+
+# Stage 2: Nginx production image
+FROM nginx:alpine
+
+# Copy custom Nginx configuration
+COPY nginx.conf /etc/nginx/nginx.conf
+
+# Copy Laravel's public assets (from the builder stage)
+COPY --from=builder /var/www/public /var/www/public
+
+# Ensure proper permissions for www-data (Nginx default user)
+#RUN chown -R www-data:www-data /var/www/public
+
+# Expose port 80
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]

production/nginx-fpm/php-cli/Dockerfile

@@ -0,0 +1,70 @@
+# Stage 1: Build environment and Composer dependencies
+FROM php:8.3-cli AS builder
+
+# Install system dependencies and PHP extensions required for Laravel + MySQL/PostgreSQL support
+# Some dependencies are required for PHP extensions only in the build stage
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    unzip \
+    libpq-dev \
+    libonig-dev \
+    libssl-dev \
+    libxml2-dev \
+    libcurl4-openssl-dev \
+    libicu-dev \
+    libzip-dev \
+    && docker-php-ext-install -j$(nproc) \
+    pdo_mysql \
+    pdo_pgsql \
+    pgsql \
+    opcache \
+    intl \
+    zip \
+    bcmath \
+    soap \
+    && pecl install redis \
+    && docker-php-ext-enable redis \
+    && apt-get autoremove -y && apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+# Set the working directory inside the container
+WORKDIR /var/www
+
+# Copy the entire Laravel application code into the container
+COPY . /var/www
+
+# Install Composer and dependencies
+RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer \
+    && composer install --no-dev --optimize-autoloader --no-interaction --no-progress --prefer-dist
+
+# Stage 2: Production environment
+FROM php:8.3-cli
+
+# Install client libraries required for php extensions in runtime
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libpq-dev \
+    libicu-dev \
+    libzip-dev \
+    && apt-get autoremove -y && apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+# Copy PHP extensions and libraries from the builder stage
+COPY --from=builder /usr/local/lib/php/extensions/ /usr/local/lib/php/extensions/
+COPY --from=builder /usr/local/etc/php/conf.d/ /usr/local/etc/php/conf.d/
+COPY --from=builder /usr/local/bin/docker-php-ext-* /usr/local/bin/
+
+# Use the default production configuration for PHP runtime arguments
+RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
+
+# Copy the application code and dependencies from the build stage
+COPY --from=builder /var/www /var/www
+
+# Set working directory
+WORKDIR /var/www
+
+# Ensure correct permissions
+RUN chown -R www-data:www-data /var/www
+
+# Switch to the non-privileged user to run the application
+USER www-data
+
+# Default command: Provide a bash shell to allow running any command
+CMD ["bash"]

production/nginx-fpm/php-fpm/Dockerfile

@@ -0,0 +1,109 @@
+# Stage 1: Build environment and Composer dependencies
+FROM php:8.3-fpm AS builder
+
+# Install system dependencies and PHP extensions required for Laravel + MySQL/PostgreSQL support
+# Some dependencies are required for PHP extensions only in the build stage
+# We don't need to install Node.js or build assets, as it was done in the Nginx image
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    unzip \
+    libpq-dev \
+    libonig-dev \
+    libssl-dev \
+    libxml2-dev \
+    libcurl4-openssl-dev \
+    libicu-dev \
+    libzip-dev \
+    && docker-php-ext-install -j$(nproc) \
+    pdo_mysql \
+    pdo_pgsql \
+    pgsql \
+    opcache \
+    intl \
+    zip \
+    bcmath \
+    soap \
+    && pecl install redis \
+    && docker-php-ext-enable redis \
+    && apt-get autoremove -y && apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+# Set the working directory inside the container
+WORKDIR /var/www
+
+# Copy the entire Laravel application code into the container
+# -----------------------------------------------------------
+# In Laravel, the `composer install` command often triggers
+# scripts that need access to the entire application code.
+# For example, the `post-autoload-dump` event might execute
+# Artisan commands like `php artisan package:discover`. If the
+# application code (including the `artisan` file) is not
+# present, these commands will fail, leading to build errors.
+# 
+# By copying the entire application code before running 
+# `composer install`, we ensure that all necessary files are 
+# available, allowing these scripts to run successfully.
+# In other cases, it would be possible to copy composer files
+# first, to leverage Docker's layer caching mechanism.
+# -----------------------------------------------------------
+COPY . /var/www
+
+# Install Composer and dependencies
+RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer \
+    && composer install --no-dev --optimize-autoloader --no-interaction --no-progress --prefer-dist
+
+# Stage 2: Production environment
+FROM php:8.3-fpm
+
+# Install only runtime libraries needed in production
+# libfcgi-bin and procps are required for the php-fpm-healthcheck script
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libpq-dev \
+    libicu-dev \
+    libzip-dev \
+    libfcgi-bin \
+    procps \
+    && apt-get autoremove -y && apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+# Download and install php-fpm health check script
+RUN curl -o /usr/local/bin/php-fpm-healthcheck \
+    https://raw.githubusercontent.com/renatomefi/php-fpm-healthcheck/master/php-fpm-healthcheck \
+    && chmod +x /usr/local/bin/php-fpm-healthcheck
+
+# Copy the initialization script
+COPY ./entrypoint.sh /usr/local/bin/entrypoint.sh
+RUN chmod +x /usr/local/bin/entrypoint.sh
+
+# Copy the initial storage structure
+COPY ./storage /var/www/storage-init
+
+# Copy PHP extensions and libraries from the builder stage
+COPY --from=builder /usr/local/lib/php/extensions/ /usr/local/lib/php/extensions/
+COPY --from=builder /usr/local/etc/php/conf.d/ /usr/local/etc/php/conf.d/
+COPY --from=builder /usr/local/bin/docker-php-ext-* /usr/local/bin/
+
+# Use the default production configuration for PHP runtime arguments
+RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
+
+# Enable PHP-FPM status page by modifying zz-docker.conf with sed
+RUN sed -i '/\[www\]/a pm.status_path = /status' /usr/local/etc/php-fpm.d/zz-docker.conf
+# Update the variables_order to include E (for ENV)
+#RUN sed -i 's/variables_order = "GPCS"/variables_order = "EGPCS"/' "$PHP_INI_DIR/php.ini"
+
+# Copy the application code and dependencies from the build stage
+COPY --from=builder /var/www /var/www
+
+# Set working directory
+WORKDIR /var/www
+
+# Ensure correct permissions
+RUN chown -R www-data:www-data /var/www
+
+# Switch to the non-privileged user to run the application
+USER www-data
+
+# Change the default command to run the entrypoint script
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
+
+# Expose port 9000 and start php-fpm server
+EXPOSE 9000
+CMD ["php-fpm"]