re-organizing the repo structure to add Docker / devcontainer

.devcontainer directory and LEMP container(s) added, but the setup for Laravel is not yet working.
There are issues with setting up PHP and NGINX to serve only /public/ on the homepage of localhost

Author: hubertnguyen

.devcontainer/.docker/nginx/conf.d/error_reporting.ini

@@ -0,0 +1 @@
+error_reporting=E_ALL

.devcontainer/.docker/nginx/conf.d/php.conf

@@ -0,0 +1,14 @@
+
+server {
+    listen 80 default_server;
+    listen [::]:80 default_server;
+    root   /var/www/htdoc;
+    index  index.php;
+
+    location ~* \.php$ {
+        fastcgi_pass   php:9000;
+        include        fastcgi_params;
+        fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        fastcgi_param  SCRIPT_NAME     $fastcgi_script_name;
+    }
+}

.devcontainer/.docker/php/Dockerfile

@@ -0,0 +1,54 @@
+# defined in docker-compose.yml, from docker-env.env
+ARG RUNTIME_PHP_IMAGE
+
+# Use the specified image as the base
+FROM ${RUNTIME_PHP_IMAGE}
+
+# Update the packages
+# Install system packages required for MongoDB extension
+RUN apt-get update \
+    && apt-get install -y libssl-dev wget git unzip 
+
+RUN pecl apt update \
+    && apt install libzip-dev -y \
+    && docker-php-ext-install zip \
+    && rm -rf /var/lib/apt/lists/*
+
+# Required for MySQL to work in PHP
+RUN docker-php-ext-install mysqli
+
+# Test if already installed and
+# install the <latest> mongodb PHP extension
+# RUN pecl install mongodb && docker-php-ext-enable mongodb
+RUN bash -c '[[ -n "$(pecl list | grep mongodb)" ]]\
+ || (pecl install mongodb && docker-php-ext-enable mongodb)'
+
+# Test if already installed and
+# install and enable XDEBUG <latest>
+# RUN pecl install xdebug && docker-php-ext-enable xdebug
+RUN bash -c '[[ -n "$(pecl list | grep xdebug)" ]]\
+ || (pecl install xdebug && docker-php-ext-enable xdebug)'
+
+# install Redis PHP driver
+RUN pecl install -o -f redis \
+&&  rm -rf /tmp/pear \
+&&  docker-php-ext-enable redis
+
+# Task: copy rep's PHP .ini files to be automatically parsed
+#
+# directory is related to the PHP service context
+# dot NOT use ./filename.ext for root files
+#         use filename.ext
+COPY docker-php.ini /usr/local/etc/php/conf.d/
+COPY xdebug.ini /usr/local/etc/php/conf.d/
+
+# Install Composer
+# ----------------------------------------------------------
+# download composer
+RUN curl -sS https://getcomposer.org/installer | php
+# copy composer to a place where it can be globally executed
+RUN mv composer.phar /usr/local/bin/composer
+
+# NOT REQUIRED
+# Change to non-root privilege
+# USER www-data

.devcontainer/.docker/php/docker-php.ini

@@ -0,0 +1 @@
+# hubert stuff

.devcontainer/.docker/php/xdebug.ini

@@ -0,0 +1,11 @@
+# already loaded in /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
+#zend_extension=xdebug
+
+[xdebug]
+xdebug.mode=debug
+xdebug.client_host=host.docker.internal
+xdebug.start_with_request=yes
+;xdebug.discover_client_host=1
+xdebug.client_port=9003
+xdebug.idekey=PHPSTORM
+xdebug.log=/tmp/xdebug.log

.devcontainer/.env

@@ -0,0 +1,25 @@
+# PATHs are relative to docker-compose.yml
+
+NGINX_IMAGE=nginx:alpine
+NGINX_HOST_PORT=80
+NGINX_CONTAINER_PORT=80
+NGINX_HOST_CONFD_DIR=./.docker/nginx/conf.d
+NGINX_CONTAINER_CONFD_DIR=/etc/nginx/conf.d
+
+WEBROOT_HOST_PATH=../src/public
+WEBROOT_CONTAINER_PATH=/var/www/htdoc
+
+NGINX_WEBROOT_HOST_PATH=../src/public
+NGINX_WEBROOT_CONTAINER_PATH=/var/www/htdoc
+
+MYSQL_IMAGE=mysql:5.7
+MYSQL_DATA_HOST_PATH=./data/mysql
+MYSQL_DATA_CONTAINER_PATH=/var/lib/mysql
+MYSQL_HOST_PORT=3306
+MYSQL_CONTAINER_PORT=3306
+
+PHP_IMAGE=php:8.2-fpm
+
+
+REDIS_DATA_HOST_PATH=./data/redis
+REDIS_DATA_CONTAINER_PATH=/etc/data

.devcontainer/.gitignore

@@ -0,0 +1,2 @@
+/data/
+/www/

.devcontainer/devcontainer.json

@@ -0,0 +1,37 @@
+{
+	// Mandatory definition for .devcontainer
+	//
+	// which service AS DEFINED IN .devcontainer/docker-compose.yml 
+	// do we want VS Code to attach to?
+	// here, we choose the "php" service since that's where our code is executed
+    "service": "php",
+
+	// we have multiple containers (nginx, PHP, MySQL, redis)
+	// so we'll use a compose .yml file instead of defining the services in devcontainer.json
+    "dockerComposeFile": "./docker-compose.yml",
+
+	// Mandatory definition for .devcontainer
+	//
+	// workspaceFolder describes the CONTAINER folder
+	// in which the "service" (php here) is configured to mount the project
+	// in our case, "/var/www/htdoc" refers to 
+	// ${WEBROOT_HOST_PATH}:${WEBROOT_CONTAINER_PATH} in our "php" service "volumeS"
+	// these are defined in .devcontainer/.env as follows:
+	// WEBROOT_HOST_PATH=../src
+	// WEBROOT_CONTAINER_PATH=/var/www/htdoc
+	"workspaceFolder": "/var/www/htdoc",
+	
+	// NOT REQUIRED, because our mounts are defined in the .yml file
+	//
+	// mount defined in docker-compose.yml
+	//"mounts": [
+	//	"source=${localWorkspaceFolder},target=/src,type=bind"
+	//],
+
+	// "xdebug.php-debug" = official XDEBUG extension
+	"customizations": {
+		"vscode": {
+			"extensions": ["xdebug.php-debug"]
+		}
+	}
+}

.devcontainer/docker-compose.yml

@@ -0,0 +1,70 @@
+# build command: docker compose build
+# docker uses the .env file BY DEFAULT. Any other name and you'll have to specify it in the command line
+# docker compose --env-file FILENAME.env build
+
+# docker compose version
+version: '3.4'
+
+# Services
+services:
+
+  # Nginx Service
+  nginx:
+    
+    image: ${NGINX_IMAGE}
+    ports:
+      - ${NGINX_HOST_PORT}:${NGINX_CONTAINER_PORT}
+
+    # path is relative to where the docker-compose.yml file is.
+    # local-path : container-path
+    #
+    volumes:
+    # public web files
+    - ${NGINX_WEBROOT_HOST_PATH}:${NGINX_WEBROOT_CONTAINER_PATH}
+    # .ini location
+    - ${NGINX_HOST_CONFD_DIR}:${NGINX_CONTAINER_CONFD_DIR}
+    depends_on:
+      - php
+      - mysql
+
+  # PHP Service
+  php:    
+    build:
+      context: ./.docker/php
+      dockerfile: Dockerfile
+      args:
+        RUNTIME_PHP_IMAGE: ${PHP_IMAGE}
+    image: ${PHP_IMAGE}
+    # container-path
+    working_dir: ${WEBROOT_CONTAINER_PATH}
+    # disk local-path
+    volumes:
+      - ${WEBROOT_HOST_PATH}:${WEBROOT_CONTAINER_PATH}
+    
+
+  # MySQL Service
+  mysql:
+    image: ${MYSQL_IMAGE}
+    environment:
+      MYSQL_ROOT_PASSWORD: rootpassword
+      MYSQL_DATABASE: mydatabase
+      MYSQL_USER: rootuser
+      MYSQL_PASSWORD: mypassword
+    volumes:
+      # map local /data/ folder to container /var/lib/mysql for MySQL data persistence
+      - ${MYSQL_DATA_HOST_PATH}:${MYSQL_DATA_CONTAINER_PATH}
+    ports:
+      - "${MYSQL_HOST_PORT}:${MYSQL_CONTAINER_PORT}"
+
+
+  redis:
+      image: redis:latest
+      ports:
+        - "6379:6379"
+      volumes:
+        - ${REDIS_DATA_HOST_PATH}:${REDIS_DATA_CONTAINER_PATH}
+
+# Notes:
+#
+# From Docker Compose version 3.4 the name of the volume can be dynamically generated from environment variables placed in an .env file (this file has to be in the same folder as docker-compose.yml is).
+#