Pokud PHP skript nefunguje, zobrazuje prázdnou stránku nebo hlásí chybu, začněte přesným chybovým hlášením. Samotná prázdná stránka nebo kód HTTP 500 ještě neurčují příčinu. Hlášení obvykle pomůže najít soubor, řádek a problém, který je potřeba opravit.
Jak zjistit chybové hlášení
- V administraci služeb v sekci PHP a MySQL dočasně zapněte zobrazování PHP chyb.
- Znovu otevřete problémovou stránku nebo zopakujte úkon, při kterém chyba vzniká.
- Uložte si celé hlášení včetně názvu souboru a čísla řádku. Pokud je hlášení více, začněte první chybou; další mohou být jejím důsledkem.
- Po zjištění chyby zobrazování opět vypněte. Podrobné výpisy mohou návštěvníkům odhalovat cesty k souborům a další údaje o aplikaci.
Pokud se hlášení nezobrazí, může chyby zpracovávat sama aplikace nebo problém vznikat ještě před spuštěním skriptu. Pro hledání chyby využijte také logování popsané níže a dostupné chybové záznamy své aplikace.
Jak zapnout logování a kde najít logy
Chyby můžete zapisovat do souborů, aniž by se zobrazovaly návštěvníkům webu. Logování PHP chyb zapnete v administraci ve stejné sekci PHP a MySQL. Potom zopakujte úkon, při kterém chyba vzniká.
Logy se ukládají do složky .log v kořenovém adresáři uživatele, vedle složky web. Otevřete příslušný soubor a vyhledejte záznamy podle času výskytu chyby.
Nevidíte složku .log?
Pokud přístup přes FTP směřuje pouze do složky web, složku .log nad ní neuvidíte. Upravte jeho nasměrování:
- V administraci otevřete nastavení Správce souborů.
- U volby Nasměrovat FTP do vyberte kořenového adresáře uživatele a změnu uložte.
- Po projevení změny se k FTP znovu připojte. Vedle složky web pak najdete i .log. Soubory samotného webu dál patří do složky web.
Co znamenají častá hlášení
- Parse error / syntax error / unexpected ...
PHP nerozumí zápisu kódu. Zkontrolujte uvedený řádek i řádky před ním, zejména uvozovky, závorky a středníky. Pokud chyba vznikla po změně verze PHP nebo nahrání aplikace, porovnejte požadavky aplikace s používanou verzí PHP. - Cannot modify header information – headers already sent
Skript se pokouší odeslat HTTP hlavičky poté, co už začal odesílat obsah stránky. Přesměrování, nastavení cookies nebo zahájení relace musí proběhnout před výstupem HTML či textu. Hlášení často obsahuje i místo, kde výstup začal; zkontrolujte například mezery mimo PHP značky. - Failed to open stream / Failed opening required
Zkontrolujte, jaký důvod je ve zbytku hlášení. U chybějícího souboru ověřte, zda byl nahrán, zda souhlasí jeho cesta i velikost písmen v názvu. Pokud hlášení mluví o oprávnění nebo open_basedir, řešte uvedené omezení přístupu. - open_basedir restriction in effect
Skript se snaží přistoupit mimo adresáře povolené konfigurací PHP. Samo o sobě to neznamená, že soubor patří jinému uživateli. Častou příčinou může být stará absolutní cesta po přesunu webu. Ověřte cestu a nastavení aplikace pro své aktuální umístění. - Call to undefined function ...
PHP volanou funkci nemá k dispozici. Ověřte její název, načtení vlastního souboru s definicí, případně požadované rozšíření a kompatibilitu s verzí PHP. Kontrolu konfigurace popisuje článek Je na serveru nainstalována knihovna, je povolena funkce?. Pokud jde o funkce mysql_*, ereg, split, each nebo create_function, PHP 8 je už nemá. Náhrady s ukázkami kódu najdete v článku Nejčastější chyby po přechodu na PHP 8 a jak je opravit. - TypeError
Aplikace pracuje s hodnotou jiného typu, než daná funkce nebo vlastnost očekává. Zkontrolujte konkrétní text hlášení a požadavky aplikace či pluginu na verzi PHP. U cizí aplikace předejte hlášení jejímu autorovi. Pokud se chyba objevila po přechodu na PHP 8 (například u funkcí count nebo implode), postup opravy najdete ve stejném článku. - Allowed memory size ... exhausted
Skript narazil na paměťový limit PHP. Prověřte nároky aplikace a operaci, při které chyba vzniká. Řešením může být přechod na vyšší hostingový program s větší pamětí pro PHP. Parametry najdete ve srovnání hostingových programů. Aktuální limit svého webu zjistíte ve výpisu konfigurace podle výše uvedeného návodu.
Jak pokračovat při opravě
Před úpravami si uložte kopii souborů, které budete měnit. Opravujte příčinu uvedenou v hlášení a poté znovu ověřte stejný úkon. Pouhé potlačení hlášení chybu neopraví.
Pokud se chyba týká připojení k MySQL, zkontrolujte údaje podle článku Jak nastavit své připojení k SQL serveru?.
U redakčního systému, šablony nebo pluginu využijte také dokumentaci a podporu autora. Pokud potřebujete ověřit nastavení hostingu, obraťte se na podporu Webzdarma. Přiložte doménu, adresu problémové stránky, čas výskytu, verzi PHP, celé chybové hlášení a informaci, co se před vznikem chyby změnilo. Hesla ani jiné přístupové údaje neposílejte.