Aktualizace

Aktualizace instalace Laravixu je jeden příkaz. Tento článek vysvětluje, co ten příkaz dělá, jak fungují upozornění na aktualizace a co dělat, když některý krok selže.

Před aktualizací#

• Zálohujte databázi. Upgrade spouští migrace; záloha je vaše tlačítko zpět.
• Přečtěte si changelog — Laravix se aktivně vyvíjí a před první stabilní verzí jsou možné breaking changes.

Spuštění aktualizace#

php artisan laravix:upgrade

Příkaz zobrazí aktuální verzi, nechá vás potvrdit, že máte zálohu (dotaz přeskočíte přes --force), a poté spustí:

1. composer update laravix/cms --with-all-dependencies — stáhne nejnovější jádro a kompatibilní závislosti a vypíše tabulku změněných verzí balíčků.
2. php artisan migrate --force — aplikuje nové databázové migrace.
3. php artisan vendor:publish --tag=laravix-assets --force — znovu publikuje assety administrace.
4. php artisan filament:assets — přegeneruje publikované assety Filamentu.
5. php artisan optimize:clear — promaže cache.

Když selže krok s Composerem, ničeho dalšího se příkaz nedotkne. Když selže pozdější krok, příkaz řekne který — zbývající kroky ze seznamu výše doběhněte ručně.

Očekávaný výsledek: Laravix CMS upgraded: 1.x.x → 1.y.y.

Tip: Příkaz hledá Composer v PATH a pak composer.phar v kořeni projektu. Konkrétní binárku můžete určit proměnnou prostředí COMPOSER_BINARY.

Upozornění na aktualizace v administraci#

Administrace kontroluje na Packagistu nová vydání laravix/cms (cache 12 hodin) a při dostupné aktualizaci zobrazuje lištu s příkazem k upgradu. Kontrolu vypnete — třeba na serverech bez přístupu k internetu — nastavením:

CMS_UPDATE_CHECK=false

Čeho se aktualizace nedotkne#

• Vaší šablony. Složka themes/ patří vám; upgrade ji nikdy nepřepisuje. Novinky výchozí šablony dostávají jen čerstvé instalace — chcete-li je, převezměte je ručně.
• Obsahu a nastavení — kromě schémových migrací zůstávají data, jak jsou.
• Vašeho kódu — aplikační providery, resources a pluginy jsou vaše.

Řešení problémů#

Composer hlásí konflikty verzí. Jiná závislost projektu drží něco, co nové jádro potřebuje. Prozkoumejte přes composer why-not laravix/cms <verze> a uvolněte konfliktní omezení.

Administrace po upgradu vypadá rozbitě. Nepublikovaly se assety. Spusťte ručně kroky 3–5 a obnovte prohlížeč (hard refresh).

Související články#

• Instalace
• Nasazení do produkce
• CLI příkazy