feat: docker with built-in PHP webserver (#28)

Author: tbreuss

Dockerfile

@@ -0,0 +1,31 @@
+ARG PHP_VERSION=8.3
+
+FROM composer:lts AS composer
+
+FROM php:$PHP_VERSION-cli
+
+WORKDIR /app
+VOLUME /app
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        git \
+        libicu-dev \
+        libfreetype-dev \
+        libjpeg62-turbo-dev \
+        libpng-dev \
+        unzip \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN docker-php-ext-configure gd --with-freetype --with-jpeg \
+    && docker-php-ext-install -j$(nproc) gd intl
+
+RUN pecl channel-update pecl.php.net \
+    && pecl install xdebug \
+    && docker-php-ext-enable xdebug
+
+RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
+
+COPY --from=composer /usr/bin/composer /usr/bin/composer
+
+EXPOSE 80

README.md

@@ -4,16 +4,12 @@
 
 # Website Kickstarter for Herbie CMS
 
-## Installation 
+## Run Website Using PHP and Composer
 
-You can start your new Herbie CMS website by using Composer.
+Create project and install dependencies.
 
     composer create-project getherbie/start-website mywebsite
 
-This will install a simple demo website and all required dependencies.
-
-## Run website using built-in web server
-
 In your terminal go to the web directory and start the built-in web server.
 
     cd mywebsite/web
@@ -32,24 +28,18 @@ If you want to debug using Xdebug (3.x), start the web server as follows.
 
 For this to work, Xdebug must of course be installed.
 
-## Run website using Docker
+## Run Website Using Docker and Docker Compose
+
+Create project and install dependencies.
 
-The Docker configuration files can be found here:
+    docker run --rm -v $PWD:/app composer create-project --ignore-platform-reqs getherbie/start-website mywebsite
 
-```
-docker-compose.yml
-docker
-    - nginx
-        - app.conf
-docker
-    - php
-        - Dockerfile
-        - php.ini
-```
+Go to the `mywebsite` directory and start website.
 
-Start the Docker container by using `docker-compose up -d` in the root directory of the website.
+    cd mywebsite
+    docker compose up website
 
-Then, open <http://0.0.0.0:8888> in your browser.
+Open <http://localhost:8888> with your browser.
 
 ## More Information
 

compose.yml

@@ -0,0 +1,38 @@
+services:
+  website:
+    build:
+      context: .
+      args:
+        - PHP_VERSION=${PHP_VERSION:-8.3}
+    profiles: [website]
+    environment:
+      - XDEBUG_MODE=debug
+      - XDEBUG_CONFIG="client_host=host.docker.internal"
+    working_dir: "/app" 
+    command: ["php", "-S", "0.0.0.0:80", "-t", "/app/web"]
+    volumes:
+      - .:/app
+    ports:
+      - "8888:80"
+    depends_on:
+      - install
+  install:
+    build:
+      context: .
+      args:
+        - PHP_VERSION=${PHP_VERSION:-8.3}      
+    profiles: [website]
+    working_dir: "/app" 
+    command: ["composer", "install"]
+    volumes:
+      - .:/app
+  bash:
+    build:
+      context: .
+      args:
+        - PHP_VERSION=${PHP_VERSION:-8.3}      
+    profiles: [website]
+    working_dir: "/app"
+    command: ["bash"]
+    volumes:
+      - .:/app