v2

Author: ShiniDev

.envexample

@@ -0,0 +1,4 @@
+MYSQL_ROOT_PASSWORD="root"
+MYSQL_DATABASE="localdb"
+MYSQL_USER="admin"
+MYSQL_PASSWORD="1234"

.gitignore

@@ -0,0 +1 @@
+.env

.vscode/launch.json

@@ -10,9 +10,8 @@
             "request": "launch",
             "port": 9003,
             "pathMappings": {
-                "/var/www/html": "${workspaceFolder}/src",
-            },
-            "log": true,
+                "/var/www/html": "${workspaceFolder}/src"
+            }
         },
         {
             "name": "Launch currently open script",

Caddyfile

@@ -0,0 +1,7 @@
+localhost {
+	reverse_proxy nginx:80
+}
+
+pma.localhost {
+	reverse_proxy phpmyadmin:80
+}

README.md

@@ -1,3 +1,21 @@
 ## Purpose
 
 The purpose of this repository is so that I can continuously improve my local development environment by adapting good practices and using my experience while using this structure.
+
+## Install
+
+**Prerequisites:**
+
+* You need Docker and Docker Compose installed.
+* You need to add the following entry to your system's `hosts` file to access the phpMyAdmin page:
+    ```
+    127.0.0.1 pma.localhost
+    ```
+
+**Running the Environment:**
+
+1.  Navigate to the root directory of this project in your terminal.
+2.  Run the following command to build and start the services in detached mode:
+    ```bash
+    docker-compose up -d
+    ```

build/php/Dockerfile

@@ -0,0 +1,13 @@
+FROM php:8.3-fpm
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git unzip zip curl pkg-config \
+    libzip-dev libicu-dev libpng-dev libjpeg-dev libfreetype6-dev \
+    libxml2-dev default-libmysqlclient-dev libonig-dev \
+    && apt-get clean && rm -rf /var/lib/apt/lists/*
+RUN docker-php-ext-install pdo pdo_mysql mbstring xml intl opcache bcmath
+RUN docker-php-ext-configure gd --with-freetype --with-jpeg \
+    && docker-php-ext-install gd
+RUN pecl install xdebug && docker-php-ext-enable xdebug
+RUN pecl install redis && docker-php-ext-enable redis
+RUN rm -rf /tmp/pear
+RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"

compose.yml

@@ -1,53 +1,52 @@
 services:
-  # PHP Service (using PHP-FPM)
-  php:
-    build:
-      context: ./php
-      dockerfile: Dockerfile
-    container_name: my_php_app_php
+  caddy:
+    image: caddy:alpine
+    ports:
+      - "80:80"
+      - "443:443"
+      - "443:443/udp"
+    volumes:
+      - ./Caddyfile:/etc/caddy/Caddyfile:ro
+      - caddy_data:/data
+      - caddy_config:/config
+    restart: unless-stopped
+  nginx:
+    image: nginx:alpine
+    restart: unless-stopped
     volumes:
+      - ./config/nginx:/etc/nginx/conf.d:ro
       - ./src:/var/www/html
-    working_dir: /var/www/html
-    environment:
-      DB_HOST: "db"
-      DB_DATABASE: "myappdb"
-      DB_USER: "myappuser"
-      DB_PASSWORD: "myapppassword"
-    networks:
-      - app-network
-  # Web Server Service (using nginx)
-  webserver:
-    image: nginx:stable-alpine
-    container_name: my_php_app_webserver
-    ports:
-      - "8080:80"
+    depends_on:
+      - php-fpm
+  php-fpm:
+    build: ./build/php/
+    restart: unless-stopped
     volumes:
       - ./src:/var/www/html
-      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
+      - ./config/php/xdebug.ini:/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini:ro
+      - ./config/php/zz-php-fpm.ini:/usr/local/etc/php-fpm.d/zz-php-fpm.ini:ro
+      - ./config/php/zz-php.ini:/usr/local/etc/php/conf.d/zz-php.ini:ro
     depends_on:
-      - php
-    networks:
-      - app-network
-  # Database Service (using MySQL)
+      - db
+    environment:
+      DB_HOST: "db" # The db service
+      DB_NAME: ${MYSQL_DATABASE}
+      DB_USER: ${MYSQL_USER}
+      DB_PASSWORD: ${MYSQL_PASSWORD}
+  phpmyadmin:
+    image: phpmyadmin/phpmyadmin
+    environment:
+      PMA_HOST: db
+      PMA_PORT: 3306
   db:
-    image: mysql:8.0
-    container_name: my_php_app_db
-    ports:
-      - "33066:3306"
+    image: mysql
+    restart: always
     environment:
-      MYSQL_ROOT_PASSWORD: "rootpassword"
-      MYSQL_DATABASE: "myappdb"
-      MYSQL_USER: "myappuser"
-      MYSQL_PASSWORD: "myapppassword"
-    volumes:
-      - db_data:/var/lib/mysql
-    networks:
-      - app-network
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+      MYSQL_DATABASE: ${MYSQL_DATABASE}
+      MYSQL_USER: ${MYSQL_USER}
+      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
 
 volumes:
-  db_data:
-
-
-networks:
-  app-network:
-    driver: bridge
+  caddy_data:
+  caddy_config:

config/nginx/nginx.conf

@@ -0,0 +1,49 @@
+server {
+    listen 80;
+    listen [::]:80;
+    server_name localhost;
+
+    #access_log  /var/log/nginx/host.access.log  main;
+    root /var/www/html;
+    index index.php index.html index.htm;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    #error_page  404              /404.html;
+
+    # redirect server error pages to the static page /50x.html
+    #
+    error_page 500 502 503 504 /50x.html;
+    location = /50x.html {
+        root /usr/share/nginx/html;
+    }
+
+    # proxy the PHP scripts to Apache listening on 127.0.0.1:80
+    #
+    #location ~ \.php$ {
+    #    proxy_pass   http://127.0.0.1;
+    #}
+
+    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
+    #
+    location ~ \.php$ {
+        try_files $uri =404;
+        fastcgi_split_path_info ^(.+\.php)(/.+)$;
+        # The `php` here is the service name defined in compose.yml
+        fastcgi_pass php-fpm:9000;
+        fastcgi_index index.php;
+        include fastcgi_params;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        fastcgi_param PATH_INFO $fastcgi_path_info;
+    }
+
+    # deny access to .htaccess files, if Apache's document root
+    # concurs with nginx's one
+    #
+    #location ~ /\.ht {
+    #    deny  all;
+    #}
+}
+

php/xdebug.ini renamed to config/php/xdebug.ini

@@ -2,7 +2,7 @@
 zend_extension=xdebug
 xdebug.mode=debug
 xdebug.start_with_request=yes
-xdebug.client_host=172.17.0.1
+xdebug.discover_client_host=true
 xdebug.client_port=9003 ; Default is 9003
 xdebug.log_level=7
 xdebug.log=/tmp/xdebug.log ; Optional: for debugging Xdebug itself