# Zálohování databáze Livio ## Uložení Zálohy se ukládají do `public/backup/mysql/` ve formátu `livio_RRRR-MM-DD_HHMMSS.sql.gz`. Soubor je vytvořen dočasně, kontroluje se úplné rozbalení GZIP a teprve poté se atomicky zveřejní pod konečným názvem. Po úspěchu zůstává nejvýše 10 nejnovějších záloh. Při chybě nové zálohy se starší soubory nemažou. Adresář `public/backup/` je blokovaný pravidly `.htaccess` a obsahuje také PHP index jako záložní ochranu. Soukromé soubory záloh, zámek a provozní stav jsou ignorované Gitem. Na serveru, který `.htaccess` nerespektuje, nesmí být tento adresář ve veřejném kořeni; ověření ochrany je podmínkou produkčního nasazení. ## Ruční spuštění V menu **Vývojář → MySQL DUMP** lze vytvořit zálohu a stáhnout kterýkoliv soubor z posledních 10 záloh. Server ověřuje aktivní relaci a přesnou systémovou roli `vyvojar`; soubor se předá jako příloha pouze přes API. Přímý veřejný přístup do záložní složky zůstává zablokovaný. ## URL CRON Hostingový plánovač může volat: ```text https:///mysql_dump.php?token= ``` Případně lze použít hlavičku `Authorization: Bearer `, pokud ji plánovač podporuje. Token se nastavuje v lokální/serverové `public/config/config.php` pod `backup.cron_token`; příklad struktury je v `public/config/config.example.php`. Vytvořte nejméně 32 náhodných bajtů zapsaných jako hexadecimální řetězec, nastavte jej samostatně pro každé prostředí a uložte URL jen do zabezpečeného plánovače. Volání bez platného tokenu vrací 404. Endpoint vyžaduje HTTPS (s výjimkou loopbacku). Token v query stringu může být zaznamenán do přístupového logu webserveru; preferujte hlavičku, pokud ji hosting nabízí, a při podezření token vyměňte. Service Worker tuto adresu záměrně vynechává ze zpracování, aby přímé volání CRONu dostalo JSON odpověď PHP endpointu, nikoliv uloženou stránku aplikace. Příklad vytvoření tokenu v důvěryhodném PHP prostředí: ```php echo bin2hex(random_bytes(32)); ``` ## Vytváření dumpu Skript nejprve hledá `mariadb-dump` nebo `mysqldump` v systémové cestě. Pokud není dostupný, použije PHP exportér nad připojením Livio. Ten exportuje tabulky a data, pohledy, triggery, procedury, funkce a události; pokud nelze inventarizovat nebo získat definici některého objektu, záloha selže a není označena jako úspěšná. Přístupové údaje se načítají pouze ze stávajícího `public/config/config.php`. PHP CLI na Laragonu: ```text php public/mysql_dump.php ``` Pro hostingový URL CRON použijte adresu výše. CRON se nikde automaticky neaktivuje. ## Obnova a ověření Pro kontrolu integrity lze GZIP rozbalit do dočasného SQL souboru. Obnovu provádějte jen do samostatné testovací databáze, nikdy přímo do aktivní databáze Livio. Dump obsahuje definice databázových objektů a jejich data; obnovení rutin a událostí může podle serveru vyžadovat odpovídající oprávnění účtu.