Fix MySQL default connectivity

Dockerfile
- install 'default-mysql-client' PHP extension so we can log into MySQL from the PHP container if we want to interact with the database container from there.
- install and enable the pdo_mysql PHP extension with 'docker-php-ext-install pdo_mysql' and 'docker-php-ext-enable pdo_mysql'. This is required for Laravel

docker-compose.yml
- MYSQL_USER and MYSQL_PASSWORD don't seem to do much as the user 'myuser' does not seem to be created. For now, we'll use root + rootpassword

/src/.env.example
- set all the default MySQL connectivity and login information so it works out of the box
- add a default MONGODB_URI for people to replace with their ATLAS connection string

config\database.php
- change DB_URI to the standard MONGODB_URI we use in our drivers and everything else

\routes\api.php
- added a \api\test_mysql\ route to check if the MySQL connection works. It's a VERY basic test and does not check for the table, but we can improve this later. The table is created by our Docker config

Author: hubertnguyen

.devcontainer/.docker/php/Dockerfile

@@ -12,16 +12,18 @@ RUN touch /var/log/php-errors.log && chown www-data:www-data /var/log/php-errors
 
 # Update the packages
 # Install system packages required for MongoDB extension
+# 'mysql-client' so we can log into mysql from the PHP container with the command 'mysql -h mysql -u root -p' where mysql is the service name
 RUN apt-get update \
-    && apt-get install -y libssl-dev wget git unzip 
+    && apt-get install -y libssl-dev wget git unzip default-mysql-client
 
 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
+RUN docker-php-ext-install mysqli && \
+    docker-php-ext-install pdo_mysql
 
 # Test if already installed and
 # install the <latest> mongodb PHP extension
@@ -38,7 +40,8 @@ RUN bash -c '[[ -n "$(pecl list | grep xdebug)" ]]\
 # install Redis PHP driver
 RUN pecl install -o -f redis \
 &&  rm -rf /tmp/pear \
-&&  docker-php-ext-enable redis
+&&  docker-php-ext-enable redis \
+&&  docker-php-ext-enable pdo_mysql
 
 # Task: copy rep's PHP .ini files to be automatically parsed
 #

.devcontainer/docker-compose.yml

@@ -43,14 +43,13 @@ services:
     # we don't need to expose the port 9003 here for Xdebug because the 
     # connection comes from inside the PHP container to the IDE via port 9003
 
-
   # MySQL Service
   mysql:
     image: ${MYSQL_IMAGE}
     environment:
       MYSQL_ROOT_PASSWORD: rootpassword
       MYSQL_DATABASE: mydatabase
-      MYSQL_USER: rootuser
+      MYSQL_USER: myuser
       MYSQL_PASSWORD: mypassword
     volumes:
       # map local /data/ folder to container /var/lib/mysql for MySQL data persistence

src/.env.example

@@ -1,3 +1,5 @@
+MONGODB_URI=mongodb://127.0.0.1:27017/ # replace with your live MongoDB Atlas cluster!
+
 APP_NAME=Laravel
 APP_ENV=local
 APP_KEY=
@@ -8,12 +10,12 @@ LOG_CHANNEL=stack
 LOG_DEPRECATIONS_CHANNEL=null
 LOG_LEVEL=debug
 
-DB_CONNECTION=mysql
-DB_HOST=127.0.0.1
+DB_CONNECTION=mysql # this 'mysql' is the Laravel connection name
+DB_HOST=mysql       # this 'mysql' refers to the Docker environment's 'mysql' service in lieu of the IP. It is defined in the docker-compose.yml file
 DB_PORT=3306
-DB_DATABASE=laravel
-DB_USERNAME=root
-DB_PASSWORD=
+DB_DATABASE=mydatabase  # arbitrary database name for this project
+DB_USERNAME=root        # our docker MySQL root username and password, defined in docker-compose.yml
+DB_PASSWORD=rootpassword
 
 BROADCAST_DRIVER=log
 CACHE_DRIVER=file

src/config/database.php

@@ -37,13 +37,13 @@
 
         'mongodb' => [
             'driver' => 'mongodb',
-            'dsn' => env('DB_URI'),
+            'dsn' => env('MONGODB_URI'),
             'database' => 'bigsearch', // replace 'bigsearch' with your database name
         ],
 
         'mongodb_mflix' => [
             'driver' => 'mongodb',
-            'dsn' => env('DB_URI'),
+            'dsn' => env('MONGODB_URI'),
             'database' => 'sample_mflix',
         ],
 
@@ -157,4 +157,4 @@
 
     ],
 
-];
+];

src/routes/api.php

@@ -263,4 +263,17 @@
     $result = DB::connection('mongodb')->getCollection('laracoll')->createIndex($indexKeys, $indexOptions); 
 
     return ['status' => 'executed', 'data' => $result ];
+});
+
+
+/* 
+    Laravel check on the MySQL connection
+*/
+Route::get('/test_mysql/', function (Request $request) {
+    try {
+        DB::connection()->getPdo();
+        return ['status' => 'executed', 'data' => 'Successfully connected to the DB.' ];
+    } catch (\Exception $e) {
+        return ['status' => 'FAIL. exception', 'data' => $e ];
+    }
 });