Lokálny vývojársky server pre Joomlu: ako ho rozbehnúť bez zbytočných komplikácií

Staging na hostingu je fajn - kým nepotrebujete vrátiť databázu o krok späť, prepnúť PHP o dve verzie nižšie alebo otestovať doplnok, ktorý si vyžaduje iné rozšírenie PHP, než aké beží na produkcii.

Vtedy je lokál na vašom počítači jediné miesto, kde si môžete dovoliť čokoľvek pokaziť bez toho, aby to niekto videl. Lenže práve lokál je aj miesto, kde sa dá stráviť celý deň bojom s konfiguráciou namiesto práce na webe. Tento návod je o tom, ako sa k funkčnému prostrediu dostať za rozumný čas - a čo si pri tom pripraviť, aby ste sa vedeli vrátiť späť.

Čo vlastne potrebujete (a čo nie)

Joomla 5.x (aktuálna línia k októbru 2026; presnú číslovku verzie si overte na joomla.org, medzičasom sa posúva) potrebuje:

• PHP 8.1 alebo novšie - minimálnu a podporované verzie PHP si overte v oficiálnych technických požiadavkách Joomly na joomla.org, pretože sa medzi verziami menia. Ak vyvíjate doplnok, testujte na verzii, ktorú má produkcia, nie na najnovšej.
• MySQL / MariaDB - minimálne podporované verzie si overte v oficiálnych technických požiadavkách Joomly na joomla.org, pretože sa medzi verziami menia.
• Webový server - Apache alebo nginx. Pre lokál je Apache s mod_rewrite najjednoduchšia cesta.

Čo nepotrebujete: plnú repliku produkčného servera. Ak váš hosting beží na LiteSpeed s vlastnou cache, lokálne to nenapodobníte a ani sa o to nesnažte. Lokál slúži na vývoj šablóny, ladenie doplnkov a testovanie migrácií - nie na meranie výkonu.

Tri cesty, tri rôzne kompromisy

XAMPP (Windows, macOS, Linux) - klasika, ktorá funguje. Balík Apache + MariaDB + PHP v jednom inštalátore. Výhoda: za 15 minút máte bežiacu inštaláciu. Nevýhoda: prepnutie PHP verzie znamená editovať konfiguračné súbory, a ak potrebujete dve verzie PHP súčasne pre dva projekty, narazíte. Vhodné, ak robíte jeden web a nechcete sa učiť nič nové.

Laragon (Windows) - to isté, ale s lepším ovládaním: prepnutie PHP verzie cez menu, rýchle vytvorenie virtuálneho hostiteľa, zabudovaný terminál. Zdarma. Ak ste na Windows a robíte viac projektov, toto je najmenšie trenie.

Docker (všetky platformy) - na Docker Hube existuje oficiálny obraz joomla; jeho presný obsah a podporované verzie si overte v dokumentácii obrazu. Spustíte docker compose up a máte bežiaci web. Výhoda: presne definované verzie, ľahko zálohovateľné, prenositeľné medzi počítačmi. Nevýhoda: prvá konfigurácia zaberie hodinu a na Windows potrebujete WSL2. Ak s Dockerom nemáte skúsenosť, nezačínajte s ním len kvôli lokálu - naučíte sa viac o Dockeri než o Joomle.

Pre väčšinu čitateľov joomlaportal.sk, ktorí si chcú lokál postaviť na jeden projekt, je Laragon alebo XAMPP správna voľba. Docker má zmysel, keď už tím pracuje na viacerých projektoch a potrebuje zhodné prostredie.

Postup: od inštalátora k bežiacemu webu

1. Nainštalujte balík a spustite Apache aj MySQL. Overte, že na http://localhost vidíte úvodnú stránku servera.
2. Vytvorte databázu - v phpMyAdmin (býva súčasťou balíka) novú databázu s názvom napr. joomla_local, kódovanie utf8mb4_unicode_ci. Kódovanie je dôležité kvôli diakritike; utf8 bez mb4 vám pri niektorých znakoch a emoji spôsobí problémy, ktoré sa ťažko hľadajú.
3. Stiahnite Joomlu z joomla.org (plný balík, nie len aktualizačný). Rozbaľte do priečinka, ktorý server vidí - v XAMPP je to zvyčajne htdocs/joomla, v Laragon www/joomla; presné umiestnenie si overte v dokumentácii vášho balíka.
4. Prejdite inštalátorom v prehliadači. Prihlásenie do databázy: používateľ root s heslom podľa predvoleného nastavenia vášho balíka (lokálne, nie na produkcii - viď nižšie).
5. Nastavte si virtuálneho hostiteľa - napr. mojweb.local, ktorý ukazuje na priečinok s Joomlou. Bez toho budete mať v adresách localhost/joomla/... a šablóna s absolútnymi cestami sa bude správať inak než na produkcii.

Kde to najčastejšie padá

Diakritika v databáze. Ak po inštalácii vidíte v texte otázniky namiesto slovenských znakov, máte zle zvolené kódovanie databázy alebo tabuliek. Skontrolujte utf8mb4 na úrovni databázy aj tabuliek. Opraviť sa to dá, ale je to otrava - lepšie je nastaviť to hneď pri vytváraní databázy.

Prázdne heslo roota. Lokálne je to pohodlné, ale nikdy nenechávajte MySQL lokálne dostupné zvonku - ak máte notebook v kaviarni na verejnej wifi a server počúva na všetkých rozhraniach, máte otvorené dvere. V konfiguračnom súbore nastavte bind-address = 127.0.0.1.

PHP verzia mimo rozsahu Joomly. Ak inštalátor zobrazí bielu stránku, prvá vec, ktorú skontrolujte, je verzia PHP. Joomla 5.x na starších nepodporovaných verziách PHP nebeží; konkrétne podporované verzie si overte v oficiálnych technických požiadavkách.

Priečinok s právami na zápis. Pri Linuxe a macOS musia mať priečinky pre dočasné súbory a cache a súbor configuration.php práva na zápis; presný zoznam si overte v dokumentácii Joomly pre vašu verziu. Na Windows to neriešite.

Záloha a cesta späť

Pri lokále je záloha jednoduchá, ale musíte ju mať pred experimentom, nie po ňom:

• Pred inštaláciou doplnku alebo šablóny skopírujte celý priečinok webu (napr. joomla → joomla_zaloha_2026-10-16; názov si zvoľte podľa vlastného systému) a vyexportujte databázu cez phpMyAdmin (hľadajte možnosť exportu, zvyčajne v menu Export).
• Pred testom migrácie urobte to isté a odpojte lokál od produkčnej databázy, ak ste ju niekedy pripájali. Migrácia na produkčných dátach je častý spôsob, ako o dáta prídete.
• Vrátenie späť: zmazať priečinok webu, obnoviť priečinok zo zálohy, importovať SQL do prázdnej databázy. Trvá to minúty, ak ste zálohu urobili - a hodiny, ak nie.

Čo si vybrať

Ak robíte jeden web a chcete čo najmenej učenia: Laragon (Windows) alebo XAMPP (všetky platformy). Ak robíte viac projektov a chcete zhodné prostredie s kolegami: Docker. Na vývoj šablóny a ladenie doplnkov zvyčajne stačí funkčný lokál s rovnakou verziou PHP a MySQL ako produkcia; presná replika produkcie nie je pre tieto účely nevyhnutná. Cache a serverové rozšírenia riešte na stagingu, kde sa viac približuje produkčnému prostrediu.

Pavlov servisný tip: Pred každou inštaláciou doplnku si do lokálu najprv nainštalujte ten istý doplnok na čistej inštalácii Joomly (bez vašich úprav). Ak padne už tam, viete, že problém je v doplnku, nie vo vašom webe - a ušetríte si hodiny hľadania konfliktu v šablóne.

Zdroje

• Joomla! - Technické požiadavky, joomla.org (citované 16. 10. 2026)
• Joomla! - Docker Hub, hub.docker.com/_/joomla (citované 16. 10. 2026)
• Laragon - Dokumentácia, laragon.org (citované 16. 10. 2026)
• XAMPP - Apache Friends, apachefriends.org (citované 16. 10. 2026)