Subdir-safe PHP: Apps zuverlässig in Unterordnern betreiben (inkl. Helper & Demo)

Zurück zur Übersicht…

Wenn du PHP-Apps oder Dokumentationen unter /public/<app> betreiben willst (z. B. /public/test, /public/docs/doc1, …), stolperst du schnell über kaputte Pfade:
Assets laden nicht, Includes zeigen ins Leere, und bei mehreren Instanzen (doc1, doc2, doc3) wird’s ganz wild. Dieser Artikel zeigt einen robusten, wiederverwendbaren Ansatz, der in beliebigen Unterordnern funktioniert – ohne harte /assets/...-Pfade.

TL;DR
Definiere zur Laufzeit APP_FS_BASE (Dateisystem-Basis) und APP_URL_BASE (URL-Basis) der aktuellen App und nutze konsequent app_*-Helper. So laufen dieselben Dateien in jedem Subfolder stabil.

✨ Das Problem in kurz

Absolute URLs wie /assets/app.css brechen in Subdirs (/test/…), weil sie immer vom Domain-Root ausgehen.
Relative Includes sind fragil, wenn Skripte aus verschiedenen Verzeichnissen aufgerufen werden.
Mehrere Instanzen derselben App (/docs/doc1, /docs/doc2, …) benötigen dieselbe Codebasis mit unterschiedlicher Base.

Ziel: Ein Satz Helper, der immer die richtigen Pfade/URLs erzeugt – pro App-Unterordner, ohne Rumgehacke.

Direkt zur Testapp

Readme

Die Lösung: `_boot.php` mit Base & Helpern

Lege in jeder App (also in /public/) eine _boot.php ab. Sie erkennt die Base automatisch und stellt saubere Helper bereit.

Copy to Clipboard

<?php
declare(strict_types=1);

/**
 * Bootstrap für Apps in Unterordnern von /public (z. B. /public/test)
 * Definiert:
 *  - APP_ROOT      -> Projektwurzel (eine Ebene über /public)
 *  - PUBLIC_DIR    -> /public
 *  - APP_FS_BASE   -> Dateisystem-Basis der aktuellen App (z. B. /public/test)
 *  - APP_URL_BASE  -> URL-Basis der aktuellen App (z. B. /test)
 * Helper:
 *  h(), public_path(), app_path(), app_url(),
 *  asset_path(), asset_url(), asset_url_v(), url_for(),
 *  app_asset_path(), app_asset_url(), app_asset_url_v()
 */

if (!function_exists('_norm')) {
  function _norm(string $p): string { return rtrim(str_replace('\\','/',$p), '/'); }
}

/* -------- FS-Basen -------- */
if (!defined('PUBLIC_DIR')) {
  $pub = realpath(__DIR__ . '/..') ?: dirname(__DIR__);  // _boot liegt in /public/<app>/
  define('PUBLIC_DIR', _norm($pub));
}
if (!defined('APP_ROOT')) {
  define('APP_ROOT', _norm(dirname(PUBLIC_DIR)));
}
if (!defined('APP_FS_BASE')) {
  define('APP_FS_BASE', _norm(realpath(__DIR__) ?: __DIR__)); // Ordner der aktuellen App
}

/* -------- URL-Basis -------- */
if (!defined('APP_URL_BASE')) {
  $sn   = $_SERVER['SCRIPT_NAME'] ?? '/';
  $base = rtrim(str_replace('\\','/', dirname($sn)), '/');
  if ($base === '') $base = '/';
  define('APP_URL_BASE', $base); // z. B. "/test" oder "/"
}

/* -------- Helper -------- */
if (!function_exists('h')) {
  function h(string $s): string {
    return htmlspecialchars($s, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
  }
}
if (!function_exists('public_path')) {
  function public_path(string $rel=''): string {
    return $rel === '' ? PUBLIC_DIR : PUBLIC_DIR . '/' . ltrim($rel, '/');
  }
}
if (!function_exists('app_path')) {
  function app_path(string $rel=''): string {
    return $rel === '' ? APP_FS_BASE : APP_FS_BASE . '/' . ltrim($rel, '/');
  }
}
if (!function_exists('app_url')) {
  function app_url(string $rel=''): string {
    $u = rtrim(APP_URL_BASE, '/');
    return $rel === '' ? ($u === '' ? '/' : $u) : ($u === '' ? '/' : $u) . '/' . ltrim($rel, '/');
  }
}

/* ---- Assets relativ zur App (subdir-safe) ---- */
if (!defined('APP_ASSETS_DIR')) {
  define('APP_ASSETS_DIR', 'assets'); // Standardordner, via config überschreibbar
}

if (!function_exists('asset_path')) {
  function asset_path(string $rel): string {
    return app_path(APP_ASSETS_DIR . '/' . ltrim($rel, '/'));
  }
}
if (!function_exists('asset_url')) {
  function asset_url(string $rel): string {
    return app_url(APP_ASSETS_DIR . '/' . ltrim($rel, '/'));
  }
}
if (!function_exists('asset_url_v')) {
  function asset_url_v(string $rel): string {
    $fs = asset_path($rel);
    $v  = is_file($fs) ? (string)filemtime($fs) : '0';
    return asset_url($rel) . '?v=' . $v; // Cache-Busting via mtime
  }
}
if (!function_exists('url_for')) {
  function url_for(string $rel=''): string { return app_url($rel); }
}

/* Kollisionsfreie Aliase (optional) */
if (!function_exists('app_asset_path')) {
  function app_asset_path(string $rel): string { return asset_path($rel); }
}
if (!function_exists('app_asset_url')) {
  function app_asset_url(string $rel): string { return asset_url($rel); }
}
if (!function_exists('app_asset_url_v')) {
  function app_asset_url_v(string $rel): string { return asset_url_v($rel); }
}

Was das bringt:
Egal ob deine App unter /, /test, /docs/doc2 liegt – app_url('css/app.css') erzeugt immer die korrekte URL zu deiner App und asset_path('css/app.css') den korrekten FS-Pfad.

Optional: `config.app.php` (Overrides)

Falls du Dinge fest verdrahten willst (z. B. hinter einem Reverse Proxy oder in Shared-Hosting-Setups), lege eine config.app.php neben die _boot.php:

Copy to Clipboard

Wenn vorhanden, wird diese Datei vor deinen Includes geladen (z. B. in deiner index.php einfach zuerst _boot.php einbinden – die config.app.php wird von dort gezogen oder du include’st sie selbst).

Demo: `index.php` – subdir-safe im Alltag

In deiner App-index.php genügt ein require '_boot.php'; – danach hast du alles, was du brauchst:

Copy to Clipboard

Regel: Niemals href="/assets/…" schreiben – immer über app_asset_url(...) gehen. Sonst bricht’s in /test & Co.

Optional: `config.app.php` (Overrides)

Falls du Dinge fest verdrahten willst (z. B. hinter einem Reverse Proxy oder in Shared-Hosting-Setups), lege eine config.app.php neben die _boot.php:

Copy to Clipboard

Wenn vorhanden, wird diese Datei vor deinen Includes geladen (z. B. in deiner index.php einfach zuerst _boot.php einbinden – die config.app.php wird von dort gezogen oder du include’st sie selbst).

Optionales Theme: `includes/theme.php` + CSS-Variablen

Willst du Farben zentral konfigurieren, lege eine includes/theme.php in deiner App an:

Copy to Clipboard

Und nutze sie in der index.php:

Copy to Clipboard

So bleiben Farben themed, ohne dass du Pfade riskierst.

Optional: `config.app.php` (Overrides)

Falls du Dinge fest verdrahten willst (z. B. hinter einem Reverse Proxy oder in Shared-Hosting-Setups), lege eine config.app.php neben die _boot.php:

Copy to Clipboard

Wenn vorhanden, wird diese Datei vor deinen Includes geladen (z. B. in deiner index.php einfach zuerst _boot.php einbinden – die config.app.php wird von dort gezogen oder du include’st sie selbst).

Optionales Theme: `includes/theme.php` + CSS-Variablen

Willst du Farben zentral konfigurieren, lege eine includes/theme.php in deiner App an:

Copy to Clipboard

Und nutze sie in der index.php:

Copy to Clipboard

So bleiben Farben themed, ohne dass du Pfade riskierst.

Optional: `config.app.php` (Overrides)

Falls du Dinge fest verdrahten willst (z. B. hinter einem Reverse Proxy oder in Shared-Hosting-Setups), lege eine config.app.php neben die _boot.php:

Copy to Clipboard

Wenn vorhanden, wird diese Datei vor deinen Includes geladen (z. B. in deiner index.php einfach zuerst _boot.php einbinden – die config.app.php wird von dort gezogen oder du include’st sie selbst).

Mini-Checkliste

_boot.php liegt in jeder App unter /public/<app>.
Alle URLs/Pfade über app_* Helper bauen.
Optional config.app.php für Subpfad/Assets/Export.
Keine harten /assets/...-Pfade.
Ggf. theme.php für Farben/CSS-Variablen.

Last Updated: 31. August 2025By johannesTags: CSS, Folder, php, Theme

Was dir noch gefallen könnte

Ratz Fatz Mailer – ein Kontaktformular auf die Schnelle 🚀
Categories: PHP, PHP-Klassen, Programmierung, Technology
Doppelten Mailversand in Formidable Forms verhindern
Categories: Programmierung
Verzeichnisbaum-Generator 🚀: Mit einem PHP-Skript die Verzeichnisse auflisten und analysieren
Categories: PHP, PHP-Klassen, Programmierung, Technology

Subdir-safe PHP: Apps zuverlässig in Unterordnern betreiben (inkl. Helper & Demo)

Subdir-safe PHP: Apps zuverlässig in Unterordnern betreiben (inkl. Helper & Demo)

Zurück zur Übersicht…

✨ Das Problem in kurz

Die Lösung: `_boot.php` mit Base & Helpern

Optional: `config.app.php` (Overrides)

Demo: `index.php` – subdir-safe im Alltag

Optional: `config.app.php` (Overrides)

Optionales Theme: `includes/theme.php` + CSS-Variablen

Optional: `config.app.php` (Overrides)

Optionales Theme: `includes/theme.php` + CSS-Variablen

Optional: `config.app.php` (Overrides)

Mini-Checkliste

Was dir noch gefallen könnte

Ratz Fatz Mailer – ein Kontaktformular auf die Schnelle 🚀

Doppelten Mailversand in Formidable Forms verhindern

Verzeichnisbaum-Generator 🚀: Mit einem PHP-Skript die Verzeichnisse auflisten und analysieren

Lebe kreativ, denke positiv und genieße die kleinen Dinge

Menü

Aktuelles

Dialyse & Wässern: Was rausgeht, was bleibt

Subdir-safe PHP: Apps zuverlässig in Unterordnern betreiben (inkl. Helper & Demo)

Die besten Getreide für Dialysepatienten

Social Links

Subdir-safe PHP: Apps zuverlässig in Unterordnern betreiben (inkl. Helper & Demo)

Subdir-safe PHP: Apps zuverlässig in Unterordnern betreiben (inkl. Helper & Demo)

Zurück zur Übersicht…

✨ Das Problem in kurz

Die Lösung: _boot.php mit Base & Helpern

Optional: config.app.php (Overrides)

Demo: index.php – subdir-safe im Alltag

Optional: config.app.php (Overrides)

Optionales Theme: includes/theme.php + CSS-Variablen

Optional: config.app.php (Overrides)

Optionales Theme: includes/theme.php + CSS-Variablen

Optional: config.app.php (Overrides)

Mini-Checkliste

Was dir noch gefallen könnte

Ratz Fatz Mailer – ein Kontaktformular auf die Schnelle 🚀

Doppelten Mailversand in Formidable Forms verhindern

Verzeichnisbaum-Generator 🚀: Mit einem PHP-Skript die Verzeichnisse auflisten und analysieren

Lebe kreativ, denke positiv und genieße die kleinen Dinge

Menü

Aktuelles

Dialyse & Wässern: Was rausgeht, was bleibt

Subdir-safe PHP: Apps zuverlässig in Unterordnern betreiben (inkl. Helper & Demo)

Die besten Getreide für Dialysepatienten

Social Links

Die Lösung: `_boot.php` mit Base & Helpern

Optional: `config.app.php` (Overrides)

Demo: `index.php` – subdir-safe im Alltag

Optional: `config.app.php` (Overrides)

Optionales Theme: `includes/theme.php` + CSS-Variablen

Optional: `config.app.php` (Overrides)

Optionales Theme: `includes/theme.php` + CSS-Variablen

Optional: `config.app.php` (Overrides)