Clone Nabih Pure PHP Architecture

backend/app/bootstrap.php

@@ -0,0 +1,86 @@
+<?php
+/**
+ * Nabeh Application Bootstrap Loader
+ * Handles PSR-4 Autoloading, security settings, and error handling.
+ */
+
+// Define absolute path to application root
+define('APP_ROOT', dirname(__DIR__));
+
+// 1. PSR-4 Autoloader
+spl_autoload_register(function ($class) {
+    // Namespace prefix
+    $prefix = 'App\\';
+    // Directory mapping for the prefix
+    $base_dir = APP_ROOT . '/app/';
+
+    $len = strlen($prefix);
+    if (strncmp($prefix, $class, $len) !== 0) {
+        return; // Move to next registered autoloader
+    }
+
+    $relative_class = substr($class, $len);
+    $file = $base_dir . str_replace('\\', '/', $relative_class) . '.php';
+
+    if (file_exists($file)) {
+        require $file;
+    }
+});
+
+// 2. Load Environment Variables
+try {
+    // Find the closest .env file path (supporting local development and CloudPanel server directories)
+    $env_file = APP_ROOT . '/.env';
+    if (!file_exists($env_file)) {
+        if (file_exists(APP_ROOT . '/../../../.env')) {
+            $env_file = APP_ROOT . '/../../../.env';
+        } elseif (file_exists(APP_ROOT . '/../.env')) {
+            $env_file = APP_ROOT . '/../.env';
+        }
+    }
+    \App\Core\Env::load($env_file);
+} catch (\Exception $e) {
+    // In production, log error; in development, print it
+    error_log('Env Load Error: ' . $e->getMessage());
+}
+
+// 3. Configure Error Reporting based on environment
+$isDebug = filter_var(getenv('APP_DEBUG') ?: true, FILTER_VALIDATE_BOOLEAN);
+
+if ($isDebug) {
+    ini_set('display_errors', '1');
+    ini_set('display_startup_errors', '1');
+    error_reporting(E_ALL);
+} else {
+    ini_set('display_errors', '0');
+    error_reporting(0);
+}
+
+// 4. Global Uncaught Exception Handler
+// Catches any unhandled exception anywhere in the app and returns a clean JSON error
+// instead of leaking PHP stack traces to the browser.
+set_exception_handler(function (\Throwable $e) {
+    $isDebug = filter_var(getenv('APP_DEBUG') ?: true, FILTER_VALIDATE_BOOLEAN);
+
+    error_log('[EXCEPTION] ' . get_class($e) . ': ' . $e->getMessage() . ' in ' . $e->getFile() . ':' . $e->getLine());
+
+    if (!headers_sent()) {
+        header('Content-Type: application/json; charset=utf-8');
+        http_response_code(500);
+    }
+
+    $body = ['error' => 'Internal Server Error'];
+
+    // In debug mode, expose details to the developer only
+    if ($isDebug) {
+        $body['debug'] = [
+            'exception' => get_class($e),
+            'message'   => $e->getMessage(),
+            'file'      => $e->getFile(),
+            'line'      => $e->getLine(),
+        ];
+    }
+
+    echo json_encode($body, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
+    exit(1);
+});