Jak nastavit verzi PHP pro doménu a subdoménu

Verze PHP, na které váš web běží, určuje, jaké funkce a jakou syntaxi smí používat. Kód napsaný pro novější PHP nepoběží na starší verzi; obráceně starší kód po upgradu na novější verzi často přestane fungovat kvůli odstraněným funkcím nebo změněné syntaxi. Potřeba změnit verzi PHP přichází typicky ve třech situacích: kompatibilita s CMS nebo frameworkem, postupný upgrade na novější verzi, nebo paralelní provoz více webů s různými požadavky vedle sebe.

V tomto návodu vás provedeme nastavením verze PHP ve všech třech rozhraních, která Váš Hosting nabízí: v Zákaznickém portálu pro webhosting, ve VPS Centru V3 a ve VPS Centru V2. Postup pro subdomény je v každém rozhraní jiný – na webhostingu má celá doména včetně subdomén jednu společnou verzi, ve VPS Centru V3 lze každé subdoméně nastavit vlastní verzi nezávisle, a ve VPS Centru V2 to jde také, ale jen za splnění určitých podmínek.

Rychlý přehled pro pokročilé

Tato část slouží pouze pro ověření pro velmi zkušené uživatele, kteří si chtějí pouze ověřit postup a nepotřebují číst celý článek. Pro všechny ostatní doporučujeme pokračovat další sekcí.

1. Webhosting (Zákaznický portál): Domény > Detail u domény > sekce Nastavení > u řádku PHP klikněte na Změnit verzi. Platí pro celou doménu včetně subdomén.
2. VPS Centrum V3: V Detailu domény klikněte na Nastavení – u domény v sekci Webserver, u subdomény u jejího řádku v tabulce subdomén (případně nejprve + Vytvořit konfiguraci). Dialog > dropdown Verze PHP > Uložit nastavení a provést reload.
3. VPS Centrum V2 – celá doména: Pravý zelený panel > Nastavení > sekce Nastavení verze PHP pro doménu > radio button > Nastavit verzi PHP.
4. VPS Centrum V2 – subdomény: Pouze pokud server běží na Debianu Bookworm a vyšším, máte rootovský přístup a je povolené načítání konfigurací subdomén. Tabulka Subdomény @doména je na stejné stránce pod sekcí PHP pro doménu.

Co je dobré vědět předem

Co budete potřebovat

• Přístup do odpovídajícího rozhraní – pro webhosting Zákaznický portál, pro VPS přihlašovací údaje do VPS Centra (najdete je v aktivačním e-mailu po objednání serveru).
• Informaci o tom, jakou verzi PHP vaše aplikace vyžaduje. U běžných CMS najdete tuto informaci v dokumentaci (WordPress, PrestaShop, Drupal atd.).
• Ideálně způsob, jak otestovat web po změně – buď na testovací subdoméně, na alternativní testovací adrese, nebo (pokud máte VPS Centrum V3) ve staging prostředí.

Časový odhad: přibližně 5 minut na samotnou změnu, k tomu si přičtěte čas na otestování webu.

Jak zjistíte verzi VPS Centra

Verze VPS Centra se zobrazuje v záhlaví rozhraní u loga. Pokud číslo začíná „3.“ (například 3.x.x), používáte VPS Centrum V3. Pokud „2.“ (například 2.x), je to VPS Centrum V2. Rozdíl je v tomto článku zásadní – V3 řeší doménu a subdoménu úplně stejně, V2 nabízí nastavení per subdoménu jen za určitých podmínek.

Skok rovnou k postupu

Návod dál pokrývá tři rozhraní v samostatných sekcích – přejděte rovnou tam, které používáte:

Webhosting (Zákaznický portál) · VPS Centrum V3 · VPS Centrum V2

Nastavení verze PHP na webhostingu (Zákaznický portál)

Na webhostingu se verze PHP nastavuje v Zákaznickém portálu v detailu domény. Jedna verze platí pro celou doménu včetně všech subdomén – přepnout PHP per subdoménu na webhostingu nelze v rozhraní. Pokud potřebujete různé verze PHP pro různé subdomény, řešením je přechod na VPS – ve VPS Centru V3 je per-subdoménové nastavení standardní funkce dostupná bez jakýchkoli podmínek.

1. Přihlaste se do Zákaznického portálu a v levém panelu klikněte na Domény.
2. U domény, které chcete změnit verzi PHP, klikněte na tlačítko Detail.
3. V sekci Nastavení najděte řádek PHP s aktuálně nastavenou verzí a klikněte na Změnit verzi.
4. Ve formuláři, který se zobrazí, vyberte požadovanou verzi a potvrďte volbu.

Po uložení se nová verze projeví okamžitě. Web byste měli po změně otestovat – v případě potíží se vraťte na původní verzi stejným postupem.

Nastavení verze PHP ve VPS Centru V3

VPS Centrum V3 řeší doménu a subdoménu konzistentně – každá má vlastní konfiguraci webserveru včetně vlastní verze PHP. Postup je u obou téměř stejný, liší se jen místem, kde najdete tlačítko Nastavení: u domény v sekci Webserver, u subdomény přímo v jejím řádku v tabulce subdomén.

Pro celou doménu (VPS Centrum V3)

1. Ve VPS Centru klikněte v levém panelu na Domény a v Přehledu domén u potřebné domény na Detail.
2. V sekci Webserver klikněte na tlačítko Nastavení. Otevře se dialog Změnit nastavení webserveru.
3. V dropdownu Verze PHP vyberte požadovanou verzi. Nabídka odpovídá verzím, které jsou na serveru nainstalované.
4. Klikněte na Uložit nastavení a provést reload.

Pro jednotlivé subdomény (VPS Centrum V3)

Subdomény najdete v tabulce v horní části Detailu nadřazené domény. Každá subdoména v ní má vlastní řádek s badge aktuální verze PHP a vlastním tlačítkem Nastavení – kliknutím se otevře stejný dialog jako u domény (jen s názvem dialogu Změnit nastavení subdomény.

1. V Detailu nadřazené domény najděte subdoménu v tabulce subdomén v horní části stránky.
2. U jejího řádku klikněte na tlačítko Nastavení. Otevře se dialog Změnit nastavení subdomény.
3. V dropdownu Verze PHP vyberte požadovanou verzi.
4. Klikněte na Uložit nastavení a provést reload.

Pokud subdoména ještě neexistuje vůbec, vytvoříte ji tlačítkem + Přidat subdoménu v pravém horním rohu Detailu nadřazené domény. Podrobný návod najdete v článku Jak založit subdoménu.

Co platí pro doménu i subdoménu

Po uložení se v pravém horním rohu zobrazí zelené potvrzení a změna se projeví okamžitě – webserver se znovu načte bez jakéhokoliv výpadku, takže váš web během přepnutí zůstane dostupný.

VPS Centrum V3 má vestavěnou ochranu – pokud by nová konfigurace neprošla testem, systém se automaticky vrátí k původnímu nastavení a zobrazí chybu. Riziko, že by web po změně verze PHP přestal být dostupný, je tedy minimální.

Nastavení verze PHP ve VPS Centru V2

VPS Centrum V2 řeší doménu a subdoménu odděleně. Pro celou doménu funguje přepnutí verze PHP vždy, pro jednotlivé subdomény jen za splnění tří podmínek najednou (viz dále).

Pro celou doménu (VPS Centrum V2)

[Screenshot: Stránka „Nastavení domény“ ve VPS Centru V2 se sekcí „Nastavení verze PHP pro doménu“ – seznam radio buttonů s verzemi PHP a tlačítkem „Nastavit verzi PHP“] [Alt: VPS Centrum V2 – nastavení verze PHP pro doménu]

1. Ve VPS Centru v pravém zeleně orámovaném panelu vyberte z dropdownu doménu, které chcete změnit verzi PHP.
2. V tomtéž panelu klikněte na Nastavení. Otevře se stránka Nastavení domény.
3. Na zobrazené stránce najděte sekci Nastavení verze PHP pro doménu (nachází se v záložce Webserver, která je výchozí) a vyberte radio button s požadovanou verzí.
4. Klikněte na Nastavit verzi PHP.

Po uložení se v horní části stránky zobrazí zelený pruh s časem, ve kterém se změna promítne – typicky během cca 1 minuty. Do té doby formulář dál zobrazuje aktivní (původní) verzi – to je očekávané chování, ne chyba. V pravém panelu se navíc objeví sekce Příkazy na zpracování se seznamem úkolů čekajících na restart webserveru.

Pro jednotlivé subdomény (VPS Centrum V2)

Per-subdoménové nastavení verze PHP je ve VPS Centru V2 dostupné, pouze pokud jsou splněny všechny tři podmínky najednou:

• server běží na Debianu Bookworm
• máte rootovský přístup,
• konfigurace webserveru má povolené načítání konfigurací subdomén.

Pokud podmínky splněny jsou, na stejné stránce Nastavení domény se pod sekcí PHP pro celou doménu zobrazí tabulka Subdomény @doména se sloupci Subdoména, PHP a Akce. Pokud podmínky splněny nejsou (typicky na starší distribuci jako Debian Buster), tabulka v UI vůbec není – formulář pro nastavení verze PHP končí u celé domény. V takovém případě postupujte podle řešení problémů níže.

1. Otevřete stránku Nastavení domény stejně jako v předchozí sekci.
2. Pod sekcí PHP pro celou doménu najděte tabulku Subdomény.
3. Pro vytvoření nové subdomény s vlastní verzí PHP zaškrtněte Vytvořit novou subdoménu, vyplňte zobrazený formulář (název subdomény, případně její složku), vyberte z dropdownu PHP požadovanou verzi a klikněte na Vytvořit. U existujících subdomén najdete v jejich řádku dropdown PHP pro změnu verze.

Stejně jako u celé domény se změna projeví při nejbližším naplánovaném restartu webserveru – čas zobrazuje zelený pruh v horní části stránky.

Řešení problémů

Web zobrazuje chybu nebo bílou stránku po změně verze PHP

Příčina: Vaše aplikace není kompatibilní s vybranou verzí PHP – typicky používá funkci, která byla v nové verzi odstraněna, nebo syntaxi, která se mezi verzemi změnila.

Řešení: Vraťte se na původní verzi stejným postupem, kterým jste verzi přepínali. Pro diagnostiku se podívejte do PHP error logu domény – podrobnosti v článku Jak zobrazit chyby v PHP. U produkčního webu doporučujeme změnu verze nejprve otestovat na vývojové subdoméně.

Ve VPS Centru V2 nevidím tabulku Subdomény

Příčina: Není splněna některá z podmínek pro per-subdoménové nastavení – nejčastěji server běží na starší distribuci (Debian Buster), chybí rootovský přístup, nebo není povolené načítání konfigurací subdomén. Vedlejší vodítko: starší distribuce nabízejí v UI menší výběr verzí PHP než aktuální Debian.

Řešení: Zkontrolujte verzi distribuce vašeho serveru. Pokud je to Debian Buster nebo starší, řešením je
migrace na nový server s aktuální distribucí (která zároveň automaticky znamená přechod na VPS Centrum V3, kde je per-subdoménové nastavení standardní funkce). Pokud máte Bookworm a tabulka přesto chybí, kontaktujte
naši podporu – ověříme, zda je v konfiguraci povolené načítání konfigurací subdomén.

Změna verze PHP se ve VPS Centru V2 nepromítla, formulář dál ukazuje původní verzi

Příčina: Ve VPS Centru V2 se uložená změna PHP zařadí do fronty Příkazy na zpracování a aplikuje se až s nejbližším restartem webserveru – typicky během cca 1 minuty. Do té doby formulář Nastavení PHP zobrazuje aktivní (původní) konfiguraci. To je očekávané chování, ne chyba.

Řešení: Počkejte na čas zobrazený v zeleném pruhu v horní části stránky nebo na úkol uvedený v sekci Příkazy na zpracování v pravém panelu. Po dokončení se formulář zaktualizuje na novou verzi. (Ve VPS Centru V3 se změna projeví okamžitě, takže tento dotaz v něm nevzniká.)

V seznamu chybí verze PHP, kterou potřebuji

Příčina: Daná verze není na vašem serveru nainstalovaná. Nabídka verzí se generuje podle toho, co je na serveru reálně k dispozici, a u starších distribucí bývá nabídka užší.

Řešení: Kontaktujte naši podporu s žádostí o doinstalování požadované verze. Pokud váš server běží na starší distribuci a chybí novější verze PHP, řešením je migrace na nový server s aktuální distribucí.

---