rebuild to module

This commit is contained in:
2026-03-03 02:13:17 +01:00
parent ffb52c6789
commit e61f9fb889
23 changed files with 7618 additions and 73 deletions

247
src/App/ModuleManager.php Normal file
View File

@@ -0,0 +1,247 @@
<?php
declare(strict_types=1);
namespace App;
final class ModuleManager
{
private array $modules = [];
private array $callbacks = [];
public function __construct(
private ?\PDO $basePdo,
private string $modulesPath
) {
if ($this->basePdo) {
BaseSchema::ensure($this->basePdo);
}
$this->scanModules();
}
public function all(): array
{
return $this->modules;
}
public function get(string $name): ?array
{
return $this->modules[$name] ?? null;
}
public function isEnabled(string $name): bool
{
$module = $this->get($name);
return (bool)($module['enabled'] ?? false);
}
public function setEnabled(string $name, bool $enabled): void
{
if (!$this->basePdo) {
return;
}
$module = $this->get($name);
if (!$module) {
return;
}
$stmt = $this->basePdo->prepare(
"INSERT INTO nexus_modules (name, title, version, enabled, installed_at, updated_at)
VALUES (:name, :title, :version, :enabled, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
ON CONFLICT(name) DO UPDATE SET
enabled = excluded.enabled,
title = excluded.title,
version = excluded.version,
updated_at = CURRENT_TIMESTAMP"
);
$stmt->execute([
'name' => $name,
'title' => (string)($module['title'] ?? $name),
'version' => (string)($module['version'] ?? ''),
'enabled' => $enabled ? 1 : 0,
]);
$this->modules[$name]['enabled'] = $enabled;
}
public function settings(string $name): array
{
if (!$this->basePdo) {
return [];
}
$stmt = $this->basePdo->prepare(
"SELECT settings FROM nexus_module_settings WHERE name = :name LIMIT 1"
);
$stmt->execute(['name' => $name]);
$row = $stmt->fetch(\PDO::FETCH_ASSOC);
if (!$row || empty($row['settings'])) {
return [];
}
$decoded = json_decode((string)$row['settings'], true);
return is_array($decoded) ? $decoded : [];
}
public function saveSettings(string $name, array $settings): void
{
if (!$this->basePdo) {
return;
}
$payload = json_encode($settings, JSON_UNESCAPED_UNICODE);
if ($payload === false) {
return;
}
$stmt = $this->basePdo->prepare(
"INSERT INTO nexus_module_settings (name, settings, updated_at)
VALUES (:name, :settings, CURRENT_TIMESTAMP)
ON CONFLICT(name) DO UPDATE SET
settings = excluded.settings,
updated_at = CURRENT_TIMESTAMP"
);
$stmt->execute([
'name' => $name,
'settings' => $payload,
]);
}
public function modulePdo(string $name, array $fallback = []): ?\PDO
{
$settings = $this->settings($name);
$db = $settings['db'] ?? $fallback;
if (!is_array($db) || empty($db)) {
return null;
}
if (!isset($db['options'])) {
$db['options'] = [
\PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION,
\PDO::ATTR_DEFAULT_FETCH_MODE => \PDO::FETCH_ASSOC,
];
}
$pdo = Database::createFromArray($db);
if ($name === 'kea' && !empty($settings['kea_auto_init'])) {
Database::ensureKeaSchema($pdo, [
'auto_init' => true,
'init_cmd' => $settings['kea_init_cmd'] ?? null,
'init_script' => $settings['kea_init_script'] ?? null,
'kea_db_version' => $settings['kea_db_version'] ?? '',
]);
}
return $pdo;
}
public function resolvePage(string $name, string $page): ?string
{
$module = $this->get($name);
if (!$module) {
return null;
}
if (!preg_match('/^[a-zA-Z0-9_\-]+$/', $page)) {
return null;
}
$path = $module['path'] . '/pages/' . $page . '.php';
if (is_file($path)) {
return $path;
}
return null;
}
public function bootEnabled(): void
{
foreach ($this->modules as $name => $module) {
if (!empty($module['enabled'])) {
$bootstrap = $module['path'] . '/bootstrap.php';
if (is_file($bootstrap)) {
require_once $bootstrap;
}
}
}
}
public function registerFunction(string $module, string $name, callable $fn): void
{
$key = $module . ':' . $name;
$this->callbacks[$key] = $fn;
}
public function call(string $module, string $name, mixed ...$args): mixed
{
$key = $module . ':' . $name;
if (!isset($this->callbacks[$key])) {
throw new \RuntimeException("Module callback not found: {$key}");
}
return ($this->callbacks[$key])(...$args);
}
private function scanModules(): void
{
$this->modules = [];
if (!is_dir($this->modulesPath)) {
return;
}
foreach (glob($this->modulesPath . '/*', GLOB_ONLYDIR) as $dir) {
$name = basename($dir);
$manifest = $dir . '/module.json';
if (!is_file($manifest)) {
continue;
}
$raw = file_get_contents($manifest);
$data = $raw ? json_decode($raw, true) : null;
if (!is_array($data)) {
continue;
}
$module = [
'name' => $name,
'title' => $data['title'] ?? $name,
'version' => $data['version'] ?? '',
'description' => $data['description'] ?? '',
'setup' => $data['setup'] ?? [],
'db_defaults' => $data['db_defaults'] ?? [],
'path' => $dir,
'enabled' => false,
];
$module['enabled'] = $this->loadEnabledState($name, $module);
$this->modules[$name] = $module;
}
}
private function loadEnabledState(string $name, array $module): bool
{
if (!$this->basePdo) {
return false;
}
$stmt = $this->basePdo->prepare(
"SELECT enabled FROM nexus_modules WHERE name = :name LIMIT 1"
);
$stmt->execute(['name' => $name]);
$row = $stmt->fetch(\PDO::FETCH_ASSOC);
if ($row !== false) {
return (bool)$row['enabled'];
}
$stmt = $this->basePdo->prepare(
"INSERT INTO nexus_modules (name, title, version, enabled, installed_at, updated_at)
VALUES (:name, :title, :version, 0, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)"
);
$stmt->execute([
'name' => $name,
'title' => (string)$module['title'],
'version' => (string)$module['version'],
]);
return false;
}
}