From 4d29a48f79e02bf28ce8b9af539e0be4e62bbac1 Mon Sep 17 00:00:00 2001
From: Damillora <developer@damillora.com>
Date: Mon, 18 Nov 2019 02:22:25 +0700
Subject: [PATCH] Minggu 17 November 2019

---
 README.md                                     | 59 +++++++++++++++++++
 .../Controllers/IndexController.php           | 12 ++++
 backend/Mitsumine/HTTP/Request.php            |  6 ++
 backend/Mitsumine/Services/Config.php         | 12 ++++
 backend/Mitsumine/Services/Database.php       | 12 ++++
 .../Mitsumine/Services/ServiceContainer.php   | 21 +++++++
 backend/autoload.php                          | 14 +++++
 backend/config.php                            |  7 +++
 backend/index.php                             | 48 +++++++++++++++
 backend/routes.php                            |  6 ++
 frontend/index.html                           | 18 ++++++
 index.php                                     | 18 ++++++
 12 files changed, 233 insertions(+)
 create mode 100644 README.md
 create mode 100644 backend/Application/Controllers/IndexController.php
 create mode 100644 backend/Mitsumine/HTTP/Request.php
 create mode 100644 backend/Mitsumine/Services/Config.php
 create mode 100644 backend/Mitsumine/Services/Database.php
 create mode 100644 backend/Mitsumine/Services/ServiceContainer.php
 create mode 100644 backend/autoload.php
 create mode 100644 backend/config.php
 create mode 100644 backend/index.php
 create mode 100644 backend/routes.php
 create mode 100644 frontend/index.html
 create mode 100644 index.php

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..77d3add
--- /dev/null
+++ b/README.md
@@ -0,0 +1,59 @@
+# Metaforums
+An online web-based discussion forum application
+
+## Project Structure
+This project is separated between the frontend and the backend application.
+- backend/
+  The backend of this application is written in PHP, and is API focused. 
+    - index.php
+      The main handler of backend functions. Handles routing, loading of Mitsumine services, and conversion of array responses to JSON.
+    - Mitsumine/
+      Mitsumine is a set of custom-written helper classes to consolidate frequently used code.
+      - Mitsumine/HTTP
+        Mitsumine HTTP contains a number of abstractions for HTTP, such as Request class
+      - Mitsumine/Services
+        Mitsumine Services contains a number of service classes for common functionality such as Database and Session.
+    - Application/
+      Application contains classes that are the core of the application itself
+      - Controllers/
+        Controllers contain controllers that return HTTP responses
+- frontend/
+  The frontend of this application, written in HTML and utilizes T
+- index.php
+  This index file allows serving both frontend and backend from one endpoint.
+  
+## Software Stack
+
+The software is tested on the Apache server and PHP 7.3 on Arch Linux.
+
+## Backend
+
+The database used is MariaDB 10.4.8
+
+## External frontend libraries used
+
+### Vue.js
+
+Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web
+
+Vue.js allows for interactivity while being less cumbersome than manipulating the DOM manually e.g. with jQuery.
+
+[Project Website](https://vuejs.org)
+
+### jQuery
+
+jQuery is a feature-rich JavaScript library.
+
+Here, jQuery is mainly used for its AJAX functionality.
+
+[Project Website](https://jquery.com)
+
+## CSS Frameworks and Styles used
+
+### Tailwind
+
+Tailwind is a utility-first CSS framework for rapidly building custom designs
+
+[Project Website](https://tailwindcss.com)
+
+## Additional Development
diff --git a/backend/Application/Controllers/IndexController.php b/backend/Application/Controllers/IndexController.php
new file mode 100644
index 0000000..9c1e072
--- /dev/null
+++ b/backend/Application/Controllers/IndexController.php
@@ -0,0 +1,12 @@
+<?php
+namespace Application\Controllers;
+
+use Mitsumine\HTTP\Request;
+
+class IndexController {
+    public function index(Request $request) {
+        return [
+            'mitsumine' => 'yuika'
+        ];
+    }
+}
diff --git a/backend/Mitsumine/HTTP/Request.php b/backend/Mitsumine/HTTP/Request.php
new file mode 100644
index 0000000..1f59ff3
--- /dev/null
+++ b/backend/Mitsumine/HTTP/Request.php
@@ -0,0 +1,6 @@
+<?php
+namespace Mitsumine\HTTP;
+
+class Request {
+
+}
diff --git a/backend/Mitsumine/Services/Config.php b/backend/Mitsumine/Services/Config.php
new file mode 100644
index 0000000..675b739
--- /dev/null
+++ b/backend/Mitsumine/Services/Config.php
@@ -0,0 +1,12 @@
+<?php
+namespace Mitsumine\Services;
+
+class Config {
+    private $configs;
+    public function __construct() {
+        $this->configs = require 'backend/config.php';
+    }
+    public function __call($name, $args) {
+        return $this->configs[$name];
+    }
+}
diff --git a/backend/Mitsumine/Services/Database.php b/backend/Mitsumine/Services/Database.php
new file mode 100644
index 0000000..d97d696
--- /dev/null
+++ b/backend/Mitsumine/Services/Database.php
@@ -0,0 +1,12 @@
+<?php
+namespace Mitsumine\Services;
+
+use Mitsumine\Services\ServiceContainer;
+
+class Database {
+    private $conn;
+    public function __construct() {
+         $config = ServiceContainer::Config();
+         $this->conn = mysqli_connect($config->db_host(),$config->db_user(),$config->db_pass(),$config->db_name());
+    }
+}
diff --git a/backend/Mitsumine/Services/ServiceContainer.php b/backend/Mitsumine/Services/ServiceContainer.php
new file mode 100644
index 0000000..f43e917
--- /dev/null
+++ b/backend/Mitsumine/Services/ServiceContainer.php
@@ -0,0 +1,21 @@
+<?php
+namespace Mitsumine\Services;
+
+class ServiceContainer{
+    private static $services = [];
+    public static function get($service) {
+        if(!isset(self::$services[$service])) {
+            self::load($service);
+        }
+        return self::$services[$service];
+    }
+    public static function load($service) {
+        $class = 'Mitsumine\\Services\\'.$service;
+        self::$services[$service] = new $class();
+    }
+    public static function __callStatic($name, $args) {
+        // Allow services to be referenced as ServiceContainer::Service()
+
+        return self::get($name);
+    }
+}
diff --git a/backend/autoload.php b/backend/autoload.php
new file mode 100644
index 0000000..fee030b
--- /dev/null
+++ b/backend/autoload.php
@@ -0,0 +1,14 @@
+<?php
+/*
+  autoload.php
+  
+  Contains a simple autoloader function
+  
+  
+*/
+
+function mitsumine_autoloader($class) {
+    $file = str_replace('\\',DIRECTORY_SEPARATOR,$class);
+    require $file.'.php';
+}
+spl_autoload_register('mitsumine_autoloader');
diff --git a/backend/config.php b/backend/config.php
new file mode 100644
index 0000000..1a17e51
--- /dev/null
+++ b/backend/config.php
@@ -0,0 +1,7 @@
+<?php
+return [
+    'db_name' => 'metaforums',
+    'db_host' => '127.0.0.1',
+    'db_user' => 'root',
+    'db_pass' => '',
+];
diff --git a/backend/index.php b/backend/index.php
new file mode 100644
index 0000000..98f67df
--- /dev/null
+++ b/backend/index.php
@@ -0,0 +1,48 @@
+<?php
+
+require 'autoload.php';
+
+// Use helper classes from Mitsumine
+use Mitsumine\HTTP\Request;
+use Mitsumine\Services\ServiceContainer;
+
+ServiceContainer::Database();
+
+// Get all routes
+$routes = require 'routes.php';
+
+// Get request URI
+$uri = $_SERVER['PHP_SELF'];
+// Cut off index.php
+$uri = substr($uri,strlen('/index.php'),strlen($uri)-strlen('/index.php'));
+
+// Build request object to pass to controller
+$request = new Request();
+
+$request_method = $_SERVER['REQUEST_METHOD'];
+
+// Get current route from uri
+$route = $routes[$request_method.':'.$uri];
+
+
+// Duar (actually, split the method string to class name and method name)
+$method_part = explode("@",$route['controller']);
+
+// Get class name and method name
+$class = $method_part[0];
+$method = $method_part[1];
+
+// Get fully qualified class name of route
+$fqcn = 'Application\\Controllers\\'.$class; 
+$controller = new $fqcn();
+
+// Execute method specified in route
+$result = $controller->$method($request);
+
+// Convert array to JSON
+if(is_array($result)) {
+    header('Content-Type: application/json');
+    $result = json_encode($result);
+}
+echo $result;
+
diff --git a/backend/routes.php b/backend/routes.php
new file mode 100644
index 0000000..c3ae232
--- /dev/null
+++ b/backend/routes.php
@@ -0,0 +1,6 @@
+<?php
+return [
+  'GET:/api' => [
+    'controller' => 'IndexController@index',
+  ],
+];
diff --git a/frontend/index.html b/frontend/index.html
new file mode 100644
index 0000000..6c39777
--- /dev/null
+++ b/frontend/index.html
@@ -0,0 +1,18 @@
+<html>
+<head>
+<script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script>
+</head>
+<body>
+<div id="app">
+{{ message }}
+</div>
+<script>
+var app = new Vue({
+    el: '#app',
+    data: {
+        message: 'Yuika!'
+    }
+})
+</script>
+</body>
+</html>
diff --git a/index.php b/index.php
new file mode 100644
index 0000000..559d73e
--- /dev/null
+++ b/index.php
@@ -0,0 +1,18 @@
+<?php
+// Get request URI
+$uri = $_SERVER['PHP_SELF'];
+// Cut off index.php
+$uri = substr($uri,strlen('/index.php'),strlen($uri)-strlen('/index.php'));
+if(strpos($uri,'/api') !== false && strpos($uri,'/api') == 0) {
+    include 'backend/index.php';
+} else {
+    // Remove trailing slashes
+    if(substr($uri,strlen($uri)-1,1) == '/') {
+        $uri = substr($uri,0,strlen($uri)-1);
+    }
+    $file = 'frontend'.$uri.'.html';
+    if(!file_exists($file)) {
+        $file = 'frontend'.$uri.'/index.html';
+    }
+    readfile($file);
+}