Autoload Register, Server Path -- Critical Update

Author: Fredrick Peter

README.md

@@ -89,6 +89,8 @@ was pretty tough. So i decided to create a much more easier way of communicating
 * [Get Database Connection](#get-database-connection)
 * [Database Import](#database-import)
 * [Update Env Variable](#update-env-variable)
+* [OrmDotEnv Servers](#OrmDotEnv-servers)
+* [Autoload Register](#autoload-register)
 * [Collation And Charset](#collation-and-charset)
 * [Extend DB Class](#extend-db-class)
 * [Helpers](#helpers)
@@ -108,7 +110,7 @@ Prior to installing `php-orm-database` get the [Composer](https://getcomposer.or
 **Step 1** — update your `composer.json`:
 ```composer.json
 "require": {
-    "peterson/php-orm-database": "^4.0.1"
+    "peterson/php-orm-database": "^4.1.1"
 }
 ```
 
@@ -1241,6 +1243,34 @@ Returns - Boolean
 true|false
 ```
 
+## OrmDotEnv Servers
+- Returns assoc arrays of Server
+    - `server/|domain/|protocol`
+
+```
+use builder\Database\OrmDotEnv;
+
+OrmDotEnv::getServers();
+
+or
+dot_env()::getServers('server');
+dot_env()->getServers('domain');
+```
+
+## Autoload Register
+- You can use register collection of all folder files
+    - This automatically includes all file in that folder and sub-folders
+
+```
+use builder\Database\AutoloadRegister;
+
+AutoloadRegister::load('folder');
+
+or
+autoload_register()::load('folder');
+autoload_register()->load('folder');
+```
+
 ## Collation And Charset
 - Collation and Charset Data `listing`
 
@@ -1295,6 +1325,7 @@ class PostClass extends DB{
 | migration()               | Return instance of `(new Migration)` class    |
 | schema()                  | Return instance of `(new Schema)` class       |
 | dot_env()                 | Return instance of `(new OrmDotEnv)` class    |
+| autoload_register()       | Return instance of `(new AutoloadRegister)` class  |
 | autoload_env()            | Return instance of `(new AutoloadEnv)` class  |
 | env_start()               | Same as `AutoloadEnv::start()`    |
 | config_database()         | Same as `Direct DB Connection` get access to `DATABASE_CONNECTION` Constant   |

src/AutoloadEnv.php

@@ -33,13 +33,14 @@ static public function start(?array $options = [])
             'bg'    => $options['bg']   ?? 'default',
         ];
 
+        
         /*
         |--------------------------------------------------------------------------
         | Instance of class
         |--------------------------------------------------------------------------
         */
         $ormDotEnv = new OrmDotEnv($default['path']);
-        
+
 
         /*
         |--------------------------------------------------------------------------

src/AutoloadRegister.php

@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace builder\Database;
+
+use RecursiveIteratorIterator;
+use RecursiveDirectoryIterator;
+use builder\Database\Schema\OrmDotEnv;
+
+class AutoloadRegister{
+    
+    /**
+     * Autoload All Folder and Sub-Folder files
+     * 
+     * @param string $path_to_folder
+     * - Specify the folder to autoload
+     * - Do not include the root path, as The Application already have a copy of your path
+     * - e.g [classes] or [app/main]
+     * 
+     * @return void
+     */
+    static public function load(?string $path_to_folder = null)
+    {
+        // If path is not null
+        if(!empty($path_to_folder)){
+            spl_autoload_register(function ($className) use($path_to_folder) {
+                self::register($path_to_folder);
+            });
+        }
+    }
+
+    /**
+     * Register method
+     * 
+     * @param string  $path_to_folder
+     * 
+     * @return void
+     */
+    static private function register($path_to_folder)
+    {
+        // directory full path
+        $directory = self::convertPath($path_to_folder);
+
+        // Create a recursive iterator to iterate through the directory
+        $iterator = new RecursiveIteratorIterator(
+            new RecursiveDirectoryIterator(
+                $directory, 
+                RecursiveDirectoryIterator::SKIP_DOTS
+            ),
+            RecursiveIteratorIterator::LEAVES_ONLY
+        );
+
+        // Loop through the iterator
+        foreach ($iterator as $file) {
+            // Check if the item is a file and has a PHP extension
+            if ($file->isFile() && $file->getExtension() === 'php') {
+                include_once $file->getPathname();
+            }
+        }
+    }
+
+    /**
+     * Convert path
+     * 
+     * @param string  $path_to_folder
+     * 
+     * @return string
+     */
+    static private function convertPath($path_to_folder)
+    {
+        $ormDotEnv = new OrmDotEnv();
+        return str_replace(
+            '/', 
+            '\\', 
+            $ormDotEnv->getDirectory() . "/{$path_to_folder}" 
+        );
+    }
+    
+}

src/Schema/OrmDotEnv.php

@@ -28,9 +28,11 @@ class OrmDotEnv extends Constants{
     public function __construct(?string $path = null) 
     {
         // if base path was presented
-        if(!is_null($path) && !empty($path)){
+        if(!empty($path)){
             $this->base_dir = $path;
         }
+
+        // auto set the base dir property
         $this->getDirectory($this->base_dir);
 
         // add to global property

src/Traits/ServerTrait.php

@@ -37,15 +37,14 @@ public function __call( $key, $value )
      */
     public function getDirectory()
     {
-        if(empty($this->base_dir) || is_null($this->base_dir)){
-            // get default project root document path
+        if(empty($this->base_dir)){
+            // get default project root path
             $this->base_dir = $this->clean_path( $this->server_root() );
         }else{
             $this->base_dir = $this->clean_path($this->base_dir);
         }
 
-        // remove .env string if found along with directory path
-        return str_replace('.env', '', $this->base_dir);
+        return $this->base_dir;
     }
 
     /**
@@ -55,7 +54,95 @@ public function getDirectory()
      */
     private function server_root()
     {
-        return rtrim(str_replace('src', '',  str_replace('\\', '/', realpath('.'))  ), '/');
+        return $this->getServers('server');
+    }
+
+    /**
+     * Get the base URL and domain information.
+     *
+     * @param string $mode 
+     * - [optional] get direct info of data 
+     * - server|domain|protocol
+     * 
+     * @return mixed
+     * - An associative array containing\ server|domain|protocol
+     */
+    static public function getServers(?string $mode = null)
+    {
+        // Determine the protocol (http or https)
+        $protocol   = isset($_SERVER['HTTPS']) && strtolower($_SERVER['HTTPS']) !== 'off' ? 'https://' : 'http://';
+
+        // Construct the server root path
+        $docRoot = $_SERVER['DOCUMENT_ROOT'];
+
+        // Get the server name (hostname)
+        $serverName = $_SERVER['SERVER_NAME'];
+
+        // get Base directory path
+        $basePath = self::getMatchedData('init.php');
+
+        // if false, then get absolute path
+        if($basePath === false){
+            $basePath = self::getRootPathToProject(realpath('.'));
+        }
+
+        // Construct the server root URL
+        $serverPath = rtrim("{$docRoot}{$basePath}", '/');
+
+        // Construct the domain
+        $domainPath = rtrim("{$protocol}{$serverName}{$basePath}", '/');
+
+        // Data
+        $data = [
+            'server'    => $serverPath,
+            'domain'    => $domainPath,
+            'protocol'  => $protocol,
+        ];
+
+        return $data[$mode] ?? $data;
+    }
+
+    /**
+     * Get the data of the string that matches the search string in the given backtrace.
+     *
+     * @param string $searchString The string to search for.
+     * 
+     * @return string|false 
+     * -The matched data or null if no match is found.
+     */
+    static private function getMatchedData(?string $searchString)
+    {
+        // backtrace file column data
+        $backtrace = array_column(debug_backtrace(), 'file');
+
+        if(is_array($backtrace)){
+            foreach ($backtrace as $trace) {
+                if (strpos($trace, $searchString) !== false) {
+                    return self::getRootPathToProject($trace, $searchString);
+                }
+            }
+        }
+        
+        return false;
+    }
+
+    /**
+     * Clean and get Root Path to Project
+     *
+     * @param string $path
+     * @param string $string
+     * 
+     * @return string|null
+     */
+    static private function getRootPathToProject(?string $path = null, ?string $string = null)
+    {
+        // Construct the server root path
+        $docRoot = $_SERVER['DOCUMENT_ROOT'];
+
+        $traceData  = str_replace('\\', '/', (string) $path);
+        $traceData  = str_replace([$docRoot, (string) $string], '', $traceData);
+
+        return $traceData;
     }
 
     /**

src/helpers.php

@@ -4,9 +4,10 @@
 use builder\Database\DBImport;
 use builder\Database\AutoloadEnv;
 use builder\Database\Query\MySqlExec;
+use builder\Database\AutoloadRegister;
 use builder\Database\Schema\OrmDotEnv;
-use builder\Database\Migrations\Migration;
 use builder\Database\Migrations\Schema;
+use builder\Database\Migrations\Migration;
 
 if (! function_exists('db')) {
     /**
@@ -29,7 +30,7 @@ function db(?array $options = [])
      */
     function import()
     {
-        return (new DBImport);
+        return new DBImport();
     }
 }
 
@@ -41,7 +42,7 @@ function import()
      */
     function dot_env()
     {
-        return (new OrmDotEnv);
+        return new OrmDotEnv();
     }
 }
 
@@ -53,7 +54,7 @@ function dot_env()
      */
     function migration()
     {
-        return (new Migration);
+        return new Migration();
     }
 }
 
@@ -65,7 +66,24 @@ function migration()
      */
     function schema()
     {
-        return (new Schema);
+        return new Schema();
+    }
+}
+
+if (! function_exists('autoload_register')) {
+    /**
+     * Autoload All Folder and Sub-Folder files
+     * 
+     * @param string $path_to_folder
+     * - Specify the folder to autoload
+     * - Do not include the root path, as The Application already have a copy of your path
+     * - e.g [classes] or [app/main]
+     * 
+     * @return void\builder\Database\AutoloadRegister
+     */
+    function autoload_register()
+    {
+        return new AutoloadRegister();
     }
 }
 
@@ -77,7 +95,7 @@ function schema()
      */
     function autoload_env()
     {
-        return (new AutoloadEnv);
+        return new AutoloadEnv();
     }
 }
 
@@ -89,7 +107,7 @@ function autoload_env()
      */
     function db_exec()
     {
-        return (new MySqlExec);
+        return new MySqlExec();
     }
 }