tomh104/nat-as-server
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

improved debugging + health endpoint

Browse Source
This commit is contained in:
tom.hempel
2026-06-01 19:09:27 +02:00
parent a5e58e88c1
commit 6895aa5674
4 changed files with 117 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

96
common.php
View File

@ -6,17 +6,67 @@ require_once __DIR__ . '/lib/text_sanitize.php';
/**
* Values loaded from the project .env file (see qdb_load_dotenv).
* Checked before getenv so a stale/wrong FPM pool variable cannot override .env.
*
* @var array<string, string>
*/
$GLOBALS['qdb_dotenv'] = [];
function qdb_env_file_path(): string {
return __DIR__ . '/.env';
}
/**
* Parse a dotenv file (cached per path). Does not use getenv/putenv.
*
* @return array<string, string>
*/
function qdb_parse_env_file(string $path): array {
static $cache = [];
if (isset($cache[$path])) {
return $cache[$path];
}
$out = [];
if (!is_readable($path)) {
return $cache[$path] = $out;
}
$lines = file($path, FILE_IGNORE_NEW_LINES);
if ($lines === false) {
return $cache[$path] = $out;
}
foreach ($lines as $line) {
$line = trim($line);
if ($line === '' || $line[0] === '#') {
continue;
}
$eq = strpos($line, '=');
if ($eq === false) {
continue;
}
$name = trim(substr($line, 0, $eq));
$value = trim(substr($line, $eq + 1));
if ($name === '') {
continue;
}
$len = strlen($value);
if ($len >= 2) {
$q = $value[0];
if (($q === '"' && $value[$len - 1] === '"') || ($q === "'" && $value[$len - 1] === "'")) {
$value = substr($value, 1, -1);
}
}
$out[$name] = $value;
}
return $cache[$path] = $out;
}
/**
* Read an environment variable (.env file first, then getenv / $_ENV / $_SERVER).
* PHP-FPM often disables putenv(); .env is applied via qdb_dotenv + $_ENV.
*/
function qdb_env_get(string $name): ?string {
$fileVars = qdb_parse_env_file(qdb_env_file_path());
if (isset($fileVars[$name]) && $fileVars[$name] !== '') {
return $fileVars[$name];
}
if (isset($GLOBALS['qdb_dotenv'][$name]) && $GLOBALS['qdb_dotenv'][$name] !== '') {
return $GLOBALS['qdb_dotenv'][$name];
}
@ -42,52 +92,24 @@ function qdb_env_set(string $name, string $value): void {
}
}
/**
* Load KEY=value pairs from .env in the project root.
* Values from the file take precedence over PHP-FPM / getenv for the same keys.
*/
/** Load KEY=value pairs from .env into $GLOBALS['qdb_dotenv'] and $_ENV. */
function qdb_load_dotenv(string $path): void {
if (!is_readable($path)) {
return;
}
$lines = file($path, FILE_IGNORE_NEW_LINES);
if ($lines === false) {
return;
}
foreach ($lines as $line) {
$line = trim($line);
if ($line === '' || $line[0] === '#') {
continue;
}
$eq = strpos($line, '=');
if ($eq === false) {
continue;
}
$name = trim(substr($line, 0, $eq));
$value = trim(substr($line, $eq + 1));
if ($name === '') {
continue;
}
$len = strlen($value);
if ($len >= 2) {
$q = $value[0];
if (($q === '"' && $value[$len - 1] === '"') || ($q === "'" && $value[$len - 1] === "'")) {
$value = substr($value, 1, -1);
}
}
foreach (qdb_parse_env_file($path) as $name => $value) {
$GLOBALS['qdb_dotenv'][$name] = $value;
qdb_env_set($name, $value);
}
}
qdb_load_dotenv(__DIR__ . '/.env');
qdb_load_dotenv(qdb_env_file_path());
// --- MASTER-KEY (Server-seitig zum Speichern der DB) ---
// Per ENV 'QDB_MASTER_KEY' (Base64- oder ASCII-String) oder Fallback auf bisherigen Wert.
// Per ENV 'QDB_MASTER_KEY' (Base64- oder ASCII-String).
function get_master_key_bytes(): string {
$env = qdb_env_get('QDB_MASTER_KEY');
if ($env === null) {
throw new RuntimeException('QDB_MASTER_KEY environment variable is not set. Cannot proceed without a master key.');
$hint = is_readable(qdb_env_file_path()) ? 'missing QDB_MASTER_KEY in .env'
: '.env not readable by PHP (' . qdb_env_file_path() . ')';
throw new RuntimeException('QDB_MASTER_KEY is not set. ' . $hint);
}
$b = base64_decode($env, true);
if ($b !== false && strlen($b) > 0) {