feat: enhance Docker deployment with phpMyAdmin integration

Author: jmrashed

.env.example

@@ -3,11 +3,11 @@ APP_ENV=local
 APP_DEBUG=true
 APP_URL=http://localhost:8000
 
-DB_HOST=localhost
+DB_HOST=db
 DB_PORT=3306
 DB_DATABASE=test_db
 DB_USERNAME=root
-DB_PASSWORD=
+DB_PASSWORD=password
 
 JWT_SECRET=your-secret-key-here
 JWT_EXPIRE=3600

CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.5.0] - 2025-11-20
+
+### Added
+- **phpMyAdmin Integration** - Web-based database management interface
+  - Automatic phpMyAdmin service in Docker Compose
+  - Pre-configured connection to project database
+  - Access via http://localhost:8081
+  - Secure authentication with MySQL credentials
+
+### Improved
+- **Docker Configuration** - Enhanced containerized deployment
+  - Fixed environment variable loading in Config class
+  - Improved docker-entrypoint.sh for reliable startup
+  - Better database connection handling in containers
+  - Optimized migration execution during container startup
+
+### Fixed
+- **Environment Configuration** - Config class now properly reads Docker environment variables
+- **Docker Entrypoint** - Changed from 'fresh' to 'migrate' to avoid foreign key constraint issues
+- **Database Connection** - Resolved connection issues in Docker containers
+
+### Docker Services
+- **App Service** - PHP 8.1 Apache container on port 8000
+- **Database Service** - MySQL 8.0 container on port 3307
+- **phpMyAdmin Service** - Web interface on port 8081
+
 ## [1.4.0] - 2025-10-21
 
 ### Added

Dockerfile

@@ -1,5 +1,14 @@
 FROM php:8.1-apache
 
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    git \
+    unzip \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Composer
+RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
+
 # Install PHP extensions
 RUN docker-php-ext-install pdo pdo_mysql
 
@@ -18,4 +27,10 @@ ENV APACHE_DOCUMENT_ROOT /var/www/html/public
 RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf
 RUN sed -ri -e 's!/var/www/!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf
 
-EXPOSE 80
+# Copy entrypoint script
+COPY docker-entrypoint.sh /usr/local/bin/
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+EXPOSE 80
+
+ENTRYPOINT ["docker-entrypoint.sh"]

README.md

@@ -590,6 +590,24 @@ docker-compose logs -f app
 docker-compose down
 ```
 
+### Docker Services
+
+The Docker setup includes three services:
+
+- **App Service** - PHP 8.1 Apache server on `http://localhost:8000`
+- **Database Service** - MySQL 8.0 on port `3307`
+- **phpMyAdmin Service** - Web database interface on `http://localhost:8081`
+
+### Database Management
+
+Access phpMyAdmin at `http://localhost:8081` to manage your database:
+- **Server**: db
+- **Username**: root
+- **Password**: password
+- **Database**: test_db
+
+This provides a user-friendly web interface for database administration, table management, and query execution.
+
 ## 🛠️ Requirements
 
 - PHP 8.0+

app/config/database.php

@@ -1,8 +1,8 @@
 <?php
-$servername = "localhost";
+$servername = "db";
 $username   = "root";
-$password   = "";
-$database   = "hrms_db";
+$password   = "password";
+$database   = "test_db";
 
 $conn = new mysqli($servername, $username, $password, $database);
 

app/core/Config.php

@@ -27,6 +27,6 @@ private function loadEnv()
 
     public static function get($key, $default = null)
     {
-        return self::$config[$key] ?? $default;
+        return getenv($key) ?: (self::$config[$key] ?? $default);
     }
 }

app/database/Migrator.php

@@ -44,22 +44,33 @@ public function migrate()
 
     public function seed()
     {
-        $seeders = glob($this->seedersPath . '/*.php');
-        sort($seeders);
+        // Define seeder order based on dependencies
+        $seederOrder = [
+            'DepartmentsSeeder',
+            'UsersSeeder',
+            'EmployeeProfilesSeeder',
+            'LeaveTypesSeeder',
+            'LeaveRequestsSeeder',
+            'AttendanceSeeder',
+            'PayrollSeeder'
+        ];
 
-        foreach ($seeders as $seeder) {
-            $className = 'App\\Database\\Seeders\\' . basename($seeder, '.php');
-            require_once $seeder;
-            
-            try {
-                $sql = $className::run();
-                $this->db->exec($sql);
-                echo "Seeded: " . basename($seeder) . "\n";
-            } catch (\PDOException $e) {
-                if (strpos($e->getMessage(), 'Duplicate entry') !== false) {
-                    echo "Skipped (already exists): " . basename($seeder) . "\n";
-                } else {
-                    throw $e;
+        foreach ($seederOrder as $seederName) {
+            $seederFile = $this->seedersPath . '/' . $seederName . '.php';
+            if (file_exists($seederFile)) {
+                $className = 'App\\Database\\Seeders\\' . $seederName;
+                require_once $seederFile;
+
+                try {
+                    $sql = $className::run();
+                    $this->db->exec($sql);
+                    echo "Seeded: " . $seederName . ".php\n";
+                } catch (\PDOException $e) {
+                    if (strpos($e->getMessage(), 'Duplicate entry') !== false) {
+                        echo "Skipped (already exists): " . $seederName . ".php\n";
+                    } else {
+                        throw $e;
+                    }
                 }
             }
         }
@@ -71,9 +82,19 @@ public function rollback()
         rsort($migrations);
 
         foreach ($migrations as $migration) {
-            $className = 'App\\Database\\Migrations\\' . basename($migration, '.php');
+            $baseName = basename($migration, '.php');
+            $className = 'App\\Database\\Migrations\\' . substr($baseName, 4); // Remove number prefix
+            if (strpos($baseName, '001_') === 0) $className .= '001';
+            elseif (strpos($baseName, '002_') === 0) $className = 'App\\Database\\Migrations\\CreateDepartmentsTable002';
+            elseif (strpos($baseName, '003_') === 0) $className = 'App\\Database\\Migrations\\CreateEmployeeProfilesTable003';
+            elseif (strpos($baseName, '004_') === 0) $className = 'App\\Database\\Migrations\\CreateAttendanceTable004';
+            elseif (strpos($baseName, '005_') === 0) $className = 'App\\Database\\Migrations\\CreateLeaveTypesTable005';
+            elseif (strpos($baseName, '006_') === 0) $className = 'App\\Database\\Migrations\\CreateLeaveRequestsTable006';
+            elseif (strpos($baseName, '007_') === 0) $className = 'App\\Database\\Migrations\\CreatePayrollTable007';
+            elseif (strpos($baseName, '008_') === 0) $className = 'App\\Database\\Migrations\\CreatePerformanceReviewsTable008';
+            elseif (strpos($baseName, '009_') === 0) $className = 'App\\Database\\Migrations\\CreateTokensTable009';
+
             require_once $migration;
-            
             $sql = $className::down();
             $this->db->exec($sql);
             echo "Rolled back: " . basename($migration) . "\n";

docker-compose.yml

@@ -21,9 +21,21 @@ services:
       MYSQL_ROOT_PASSWORD: password
       MYSQL_DATABASE: test_db
     ports:
-      - "3306:3306"
+      - "3307:3306"
     volumes:
       - db_data:/var/lib/mysql
 
+  phpmyadmin:
+    image: phpmyadmin/phpmyadmin
+    environment:
+      PMA_HOST: db
+      PMA_PORT: 3306
+      PMA_USER: root
+      PMA_PASSWORD: password
+    ports:
+      - "8081:80"
+    depends_on:
+      - db
+
 volumes:
-  db_data:
+ db_data:

docker-entrypoint.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+set -e
+
+cd /var/www/html
+
+# Copy .env.example to .env if .env doesn't exist
+if [ ! -f .env ]; then
+    cp .env.example .env
+fi
+
+# Install Composer dependencies
+composer install --no-interaction --optimize-autoloader
+
+# Wait for MySQL to be ready
+echo "Waiting for MySQL to be ready..."
+until php -r "new PDO('mysql:host=db;dbname=test_db', 'root', 'password');" 2>/dev/null; do
+    echo "MySQL is unavailable - sleeping"
+    sleep 2
+done
+echo "MySQL is up - executing migrations"
+
+# Run migrations
+php migrate.php migrate
+
+# Start Apache
+apache2-foreground