CLI příkazy
Laravix dodává šest Artisan příkazů v namespace laravix:. Tohle je jejich kompletní reference; standardní Laravel příkazy (migrate, queue:work, scout:import, …) platí jako obvykle.
laravix:install
Interaktivní prvotní setup: databáze, assety, první web a super admin.
php artisan laravix:install [volby]
| Volba | Efekt |
|---|---|
--force |
Poběží, i když už weby existují |
--site-name= |
Název prvního webu |
--domain= |
Doména prvního webu |
--admin-name= |
Jméno super admina |
--admin-email= |
E-mail super admina |
--admin-password= |
Heslo super admina (min. 8 znaků) |
--no-interaction |
Místo dotazů selže (vyžaduje volby výše; databáze už musí být dostupná) |
Instalace do kontejnerů přidává volby příkazu laravix:docker:
| Volba | Efekt |
|---|---|
--docker |
Vygeneruje Docker prostředí a provede instalaci uvnitř něj |
--db= |
Databázová služba v kontejneru: mysql, pgsql nebo sqlite |
--search |
Přidá kontejner Meilisearch |
--mail |
Přidá kontejner Mailpit |
--redis |
Přidá kontejner Redis |
--no-worker |
Vynechá kontejner s queue workerem |
--no-scheduler |
Vynechá kontejner se schedulerem |
--port= |
Port na hostiteli, na kterém web běží |
--continue= |
Interní: pokračování instalace uvnitř kontejneru ze stavového souboru. Není určeno ke spouštění ručně |
Co dělá, popořadě: zeptá se na způsob běhu Laravixu (Docker, nebo lokální služby — přeskočí se s --no-interaction nebo když už compose.yaml existuje), pak buď předá řízení docker větvi, nebo pokračuje lokálně setupem databáze (při nedostupnosti nabídne SQLite/MySQL/PostgreSQL a zapíše .env), pojistka proti existující instalaci, migrate --force, storage:link, laravix:theme:link, publikace assetů/configu/views a assetů Filamentu, publikace výchozí šablony (přeskočí se, když themes/default existuje), vytvoření prvního webu (režim šablony), vytvoření super admina přes laravix:user.
V docker větvi si nejdřív vyžádá údaje o webu a adminovi, zapíše docker soubory a .env, v případě potřeby vygeneruje aplikační klíč, nastartuje kontejnery a počká na ně, a pak sám sebe spustí znovu uvnitř kontejneru s --continue.
laravix:docker
Vygeneruje Docker prostředí (compose.yaml, docker/, .env) pro lokální vývoj.
php artisan laravix:docker [volby]
| Volba | Efekt |
|---|---|
--db= |
Databázová služba: mysql, pgsql nebo sqlite |
--search |
Přidá kontejner Meilisearch |
--mail |
Přidá kontejner Mailpit |
--redis |
Přidá kontejner Redis |
--no-worker |
Vynechá kontejner s queue workerem |
--no-scheduler |
Vynechá kontejner se schedulerem |
--port= |
Port na hostiteli, na kterém web běží |
--force |
Přepíše existující compose.yaml |
Bez --force příkaz odmítne běžet, když už compose.yaml existuje, takže nikdy tiše nepřepíše prostředí, které jste si ručně doladili. Kontejnery s queue workerem a schedulerem se generují ve výchozím stavu. Co skončí v jednotlivých souborech, popisuje Vývojové prostředí v Dockeru.
laravix:theme:link
Zpřístupní adresář dist/ každé šablony pod public/themes, aby na něj dosáhl prohlížeč.
php artisan laravix:theme:link [--force]
--forcenahradí odkazy, které už existují.- Za šablonu se považují jen adresáře s platným
theme.json. laravix:installho spustí za vás; ručně ho spusťte po přidání šablony nebo když styly šablony najednou vrací 404.
Viz Struktura šablony.
laravix:user
Vytvoří uživatele, který se může přihlásit do administrace.
php artisan laravix:user [--name=] [--email=] [--password=] [--super]
--supervytvoří super admina (přístup ke všem webům).- Bez
--superse příkaz zeptá — a u běžného uživatele si vyžádá web a roli (admin,editor,viewer). - Selže na obsazeném e-mailu; heslo musí mít alespoň 8 znaků.
Zároveň je to nejrychlejší cesta, jak připojit úplně nového uživatele k webu bez e-mailové pozvánky.
laravix:upgrade
Aktualizace jádra Laravixu: composer update, migrace a znovupublikování assetů.
php artisan laravix:upgrade [--force]
--force přeskočí potvrzení „zálohujte databázi". Když je k dispozici novější minor verze, příkaz zvedne constraint laravix/cms ve vašem composer.json místo toho, aby zůstal na rozsahu, se kterým jste instalovali. Kompletní chování krok za krokem a zotavení po chybě popisuje Aktualizace. Respektuje proměnnou prostředí COMPOSER_BINARY, když Composer není v PATH.
laravix:publish-scheduled
Publikuje naplánovaný obsah, jehož published_at už nastalo.
php artisan laravix:publish-scheduled
Vypíše, kolik položek publikoval. Běžně ho nikdy nespouštíte ručně — balíček ho plánuje každou minutu, takže funguje všude, kde je v cronu zapojený php artisan schedule:run (viz Nasazení do produkce). Ruční spuštění se hodí při lokálním testování plánování.
Užitečné standardní příkazy v kontextu Laravixu
| Příkaz | K čemu |
|---|---|
php artisan vendor:publish --tag=laravix-theme |
Čerstvá kopie výchozí šablony do themes/default |
php artisan vendor:publish --tag=laravix-config |
Publikace config/laravix.php k úpravám |
php artisan vendor:publish --tag=laravix-assets --force |
Znovupublikování assetů administrace (součást upgradu) |
php artisan scout:import "Laravix\Cms\Models\Content" |
(Znovu)sestavení vyhledávacího indexu |
php artisan scout:sync-index-settings |
Odeslání nastavení indexu do Meilisearch |
php artisan queue:work |
Zpracování úloh variant obrázků |