/**
 * [@base] => /api/v1
 */
class ApiController extends Controller {

    /**
     * [@method] => GET
     * [@route] => /users/{id}
     */
    public function getUser($id) {
        # - Route automatically registered: GET /api/v1/users/{id}
    }
}

# - Fluent query builder
$users = Aether()->_db()->_mysql('mydb')
    ->_table('users')
    ->_select('id', 'name', 'email')
    ->_where('status', 'active')
    ->_join('profiles', 'users.id = profiles.user_id')
    ->_send();

# - Insert
Aether()->_db()->_mysql('mydb')
    ->_table('users')
    ->_insert('name', 'John')
    ->_insert('email', 'john@example.com')
    ->_send();

# - Update
Aether()->_db()->_mysql('mydb')
    ->_table('users')
    ->_update()
    ->_set('name', 'Jane')
    ->_where('id', 1)
    ->_send();

# - Login gateway
$auth = new LoginAuthGateway($email, $password);
if ($auth->_tryAuth()) {
    # - User logged in, session created
}

# - Check authentication status
if (Aether()->_session()->_auth()->_isLoggedIn()) {
    $user = Aether()->_session()->_auth()->_getUser();
    # - Access user properties: uid, username, email, perms
}

# - In app/App/App.php
private static $_middlewares = [
    RatelimitMiddleware::class,      # - 100 requests per 60 seconds
    CsrfMiddleware::class,            # - CSRF protection
    SecurityHeadersMiddleware::class, # - Security headers
    AuthMiddleware::class,            # - Authentication guard
    MaintenanceMiddleware::class      # - Maintenance mode
];

# - JSON response
Aether()->_http()->_response()->_json([
    'status' => 'success',
    'data' => $data
], 200)->_send();

# - HTML response
Aether()->_http()->_response()->_html($html, 200)->_send();

# - XML, TEXT, PDF formats also supported

# - In controller
protected function _render(string $view, array $params = []) {
    ViewInstance::_make($view, $params);
}

# - Usage
$this->_render('home', [
    'loggedin' => Aether()->_session()->_auth()->_isLoggedIn(),
    'user' => $user
]);

# - APCU cache
$cache = Aether()->_cache()->_apcu();
$cache->_set('key', $value, 3600); # - TTL in seconds
$value = $cache->_get('key');

# - Access all services through one entry point
Aether()->_db()->_mysql('database');
Aether()->_cache()->_apcu();
Aether()->_http()->_response();
Aether()->_session()->_auth();
Aether()->_io()->_file();
Aether()->_config()->_get('KEY');

# - Read JSON file
$data = Aether()->_io()->_file(IOTypeEnum::JSON, 'data.json')->_readDecoded();

# - Write ENV file
Aether()->_io()->_file(IOTypeEnum::ENV, '.env')->_write($content);

# - Read lines
$lines = Aether()->_io()->_file(IOTypeEnum::TEXT, 'file.txt')->_readLines();

<?php
# - index.php
require_once __DIR__ . '/autoload.php';

$app = new \Aether\Aether();
$app->_run();

<?php
# - app/App/Controller/HomeController.php
namespace App\Controller;

use App\AppController;

class HomeController extends AppController {
    /**
     * [@method] => GET
     * [@route] => /
     */
    public function home() {
        $this->_render('home', [
            'loggedin' => Aether()->_session()->_auth()->_isLoggedIn(),
        ]);
    }
}

<?php
# - app/App/Controller/Api/UserController.php
namespace App\Controller\Api;

use Aether\Router\Controller\Controller;

/**
 * [@base] => /api/v1/users
 */
class UserController extends Controller {
    /**
     * [@method] => GET
     * [@route] => /{id}
     */
    public function show($id) {
        $user = Aether()->_db()->_mysql($_ENV['DB_NAME'])
            ->_table('users')
            ->_select('*')
            ->_where('id', $id)
            ->_send();
        
        if (empty($user)) {
            return Aether()->_http()->_response()->_json([
                'error' => 'User not found'
            ], 404)->_send();
        }
        
        return Aether()->_http()->_response()->_json($user[0], 200)->_send();
    }
    
    /**
     * [@method] => POST
     * [@route] => /
     */
    public function create() {
        $unpacker = new \Aether\Http\HttpParameterUnpacker();
        $name = $unpacker->_getAttribute('name');
        $email = $unpacker->_getAttribute('email');
        
        Aether()->_db()->_mysql($_ENV['DB_NAME'])
            ->_table('users')
            ->_insert('name', $name)
            ->_insert('email', $email)
            ->_send();
        
        return Aether()->_http()->_response()->_json([
            'status' => 'success',
            'message' => 'User created'
        ], 201)->_send();
    }
}

# - Select with conditions
$users = Aether()->_db()->_mysql('mydb')
    ->_table('users')
    ->_select('id', 'name', 'email')
    ->_where('status', 'active')
    ->_send();

# - Check existence
$exists = Aether()->_db()->_mysql('mydb')
    ->_table('users')
    ->_exist()
    ->_where('email', 'user@example.com')
    ->_send();

# - Raw query
$result = Aether()->_db()->_mysql('mydb')->_raw("SELECT COUNT(*) FROM users");

<?php
namespace App\Middleware;

use Aether\Middleware\MiddlewareInterface;

class CustomMiddleware implements MiddlewareInterface {
    public function _handle(callable $_next) {
        # - Before request
        # - ...
        
        $_next();
        
        # - After request
        # - ...
    }
}

private static $_middlewares = [
    CustomMiddleware::class,
    # - ... other middleware
];

<?php
namespace App\Modules\CustomModule;

use Aether\Modules\AetherModule;

class CustomModule extends AetherModule {
    protected string $_name = 'CustomModule';
    protected float $_version = 1.0;
    protected string $_description = 'Custom module description';
    
    public function _onLoad() {
        # - Module initialization logic
    }
    
    public static function _make(): AetherModule {
        return new self();
    }
}

use Aether\Config\ProjectConfig;

$value = ProjectConfig::_get('DB_HOST', 'localhost'); # - with default
$value = ProjectConfig::_get('DB_HOST'); # - without default