<?php

namespace App\Ops;

/**
 * Sperrdateien, die dafür sorgen, dass nichts außer public/ über das Netz erreichbar ist - auch
 * wenn die Domain versehentlich auf den Projektordner zeigt (ADR 116).
 *
 * Die meisten liegen im Release (bin/, config/, src/ …, vendor/ und der Projektstamm). Zwei
 * entstehen erst auf dem Server: var/ gibt es im Archiv nicht, und die Datei im Projektstamm soll
 * auch eine Installation bekommen, die von einer Fassung vor 1.30.0 aktualisiert wurde - deren
 * Updater kannte sie noch nicht. Angelegt wird nur, was fehlt; eine eigene .htaccess des Betreibers
 * im Projektstamm bleibt unberührt.
 */
final class Protection
{
    private static bool $checked = false;

    public static function ensure(string $root): void
    {
        if (self::$checked) {
            return;
        }
        self::$checked = true;
        $sperren = $root.'/config/schutz/sperren.htaccess';
        $stamm = $root.'/config/schutz/stamm.htaccess';
        foreach ([$root.'/var/.htaccess' => $sperren, $root.'/vendor/.htaccess' => $sperren, $root.'/.htaccess' => $stamm] as $ziel => $vorlage) {
            if (!is_file($ziel) && is_dir(\dirname($ziel)) && is_file($vorlage)) {
                @copy($vorlage, $ziel);
            }
        }
    }

    /** Für Tests: die nächste Anfrage prüft wieder. */
    public static function reset(): void
    {
        self::$checked = false;
    }
}