Pokročilé (FTP, databáze, PHP)

Nejčastější chyby po přechodu na PHP 8 a jak je opravit

Web napsaný pro PHP 5.6 na PHP 8 často nefunguje: místo obsahu se zobrazí bílá stránka, chyba 500 nebo chybové hlášení. Většinu problémů způsobuje jen několik funkcí, které z PHP mezitím zmizely – nejčastěji staré funkce pro práci s databází mysql_*. V tomto článku najdete nejčastější chybová hlášení a ke každému postup opravy s ukázkou kódu.

Všechny upravené ukázky fungují na PHP 5.6 i na PHP 8. Kód tak můžete opravovat postupně ještě na staré verzi a nový PHP si zapnout, až budete hotovi. Program Zdarma přejde na PHP 8.5 automaticky 10. 2. 2027 – podrobnosti najdete v článku Konec PHP 5.6: převod webů na PHP 8.5 k 10. 2. 2027.

Jak zjistit, co na webu nefunguje

  1. Přepněte web na nejnovější nabízenou verzi PHP. Postup popisuje článek Jak změnit verzi PHP.
  2. Zapněte logování PHP chyb a otevřete stránku, která nefunguje. Chyby najdete ve složce .log vedle složky web. Jak na to, popisuje článek Co dělat, když mám ve skriptu chybu?.
  3. V hlášení najdete název souboru a číslo řádku. Začněte vždy první chybou, další mohou být jejím důsledkem.
  4. Před úpravou si soubor stáhněte do počítače, ať se můžete vrátit k původní verzi (viz Jak nahrát web přes FTP nebo Správce souborů a Zálohování na Webzdarma.cz).
  5. Opravený soubor nahrajte zpět a stránku znovu otevřete. Opakujte, dokud se v logu objevují nové chyby.

Pokud web potřebujete rychle zprovoznit a máte ještě PHP 5.6 k dispozici, můžete se na ni mezitím vrátit a opravovat v klidu.

Call to undefined function mysql_connect()

Nejčastější chyba starých webů. Funkce začínající na mysql_ (mysql_connect, mysql_query, mysql_fetch_array a další) byly z PHP odstraněny už ve verzi 7.0. Náhradou je rozšíření mysqli, které funguje velmi podobně. Hlášení může jmenovat kteroukoli z těchto funkcí, například:

Fatal error: Uncaught Error: Call to undefined function mysql_connect()

Nestačí jen přepsat mysql_ na mysqli_. Hlavní rozdíl je v tom, že funkce mysqli potřebují připojení k databázi jako první parametr. Staré funkce si připojení pamatovaly samy.

Připojení k databázi

Původní kód:

$spojeni = mysql_connect('server', 'uzivatel', 'heslo');
mysql_select_db('nazev_databaze', $spojeni);
mysql_query("SET NAMES utf8");

Upravený kód:

$db = mysqli_connect('server', 'uzivatel', 'heslo', 'nazev_databaze');
if (!$db) {
    die('Nepodařilo se připojit k databázi: ' . mysqli_connect_error());
}
mysqli_set_charset($db, 'utf8');

Název databáze se zadává rovnou jako čtvrtý parametr, mysql_select_db už nepotřebujete. Místo SET NAMES použijte mysqli_set_charset. Údaje pro připojení (server, uživatel, heslo, databáze) najdete v administraci v sekci PHP a MySQL – viz Jak nastavit své připojení k SQL serveru?.

Dotazy a čtení výsledků

Původní kód:

$vysledek = mysql_query("SELECT id, nazev FROM clanky");
while ($radek = mysql_fetch_assoc($vysledek)) {
    echo $radek['nazev'];
}
echo mysql_num_rows($vysledek);

Upravený kód:

$vysledek = mysqli_query($db, "SELECT id, nazev FROM clanky");
while ($radek = mysqli_fetch_assoc($vysledek)) {
    echo $radek['nazev'];
}
echo mysqli_num_rows($vysledek);

Přehled náhrad

  • mysql_connect($server, $uzivatel, $heslo) + mysql_select_db($databaze)
    → mysqli_connect($server, $uzivatel, $heslo, $databaze)
  • mysql_query($sql)
    → mysqli_query($db, $sql)
  • mysql_fetch_assoc($vysledek), mysql_fetch_array($vysledek), mysql_fetch_row($vysledek), mysql_fetch_object($vysledek)
    → mysqli_fetch_assoc($vysledek), mysqli_fetch_array($vysledek), mysqli_fetch_row($vysledek), mysqli_fetch_object($vysledek) – jen se přidá písmeno i
  • mysql_num_rows($vysledek)
    → mysqli_num_rows($vysledek)
  • mysql_real_escape_string($text) nebo mysql_escape_string($text)
    → mysqli_real_escape_string($db, $text)
  • mysql_insert_id()
    → mysqli_insert_id($db)
  • mysql_affected_rows()
    → mysqli_affected_rows($db)
  • mysql_error()
    → mysqli_error($db)
  • mysql_set_charset('utf8')
    → mysqli_set_charset($db, 'utf8')
  • mysql_close()
    → mysqli_close($db)
  • mysql_result($vysledek, 0)
    → přímá náhrada neexistuje, použijte $radek = mysqli_fetch_row($vysledek); a hodnotu $radek[0]

Připojení uvnitř funkcí

Pokud web používá databázi uvnitř vlastních funkcí, proměnná $db v nich není vidět a objeví se chyba Undefined variable $db a hned po ní mysqli_query(): Argument #1 ($mysql) must be of type mysqli, null given. Na začátek funkce doplňte řádek global $db;:

function nacti_clanky() {
    global $db;
    return mysqli_query($db, "SELECT * FROM clanky");
}

Připojení k databázi bývá ve starých webech v jednom souboru (například config.php, db.php nebo connect.php), který ostatní soubory načítají přes include. Začněte úpravou tohoto souboru a pak projděte ostatní soubory, kde se funkce mysql_ volají. Soubory, kde se funkce mysql_ volají, najdete vyhledáním textu mysql_ v textovém editoru (viz Nejčastější dotazy).

Bezpečnější dotazy

Když už kód upravujete, je dobré vložit údaje od návštěvníků (z formulářů nebo adresy) do dotazu bezpečně. Starý kód je do SQL často vkládá přímo, a to umožňuje útok zvaný SQL injection. Nejjednodušší je každý text ošetřit funkcí mysqli_real_escape_string a čísla převést na číslo:

$jmeno = mysqli_real_escape_string($db, $_POST['jmeno']);
$id = (int) $_GET['id'];
mysqli_query($db, "SELECT * FROM hoste WHERE jmeno = '$jmeno' AND id = $id");

Ještě bezpečnější jsou připravené dotazy (prepared statements), kde se hodnoty do dotazu vůbec nevkládají:

$dotaz = mysqli_prepare($db, "SELECT nazev FROM clanky WHERE id = ?");
mysqli_stmt_bind_param($dotaz, 'i', $id);
mysqli_stmt_execute($dotaz);
mysqli_stmt_bind_result($dotaz, $nazev);
mysqli_stmt_fetch($dotaz);

Chyba Uncaught mysqli_sql_exception

Od PHP 8.1 mysqli při chybě databáze (špatné heslo, chyba v SQL dotazu, neexistující tabulka) rovnou ukončí skript hlášením Fatal error: Uncaught mysqli_sql_exception, za kterým následuje popis chyby, například Access denied for user. Na PHP 5.6 se stejná chyba často jen tiše přešla. Hlášení tedy obvykle neznamená chybu v úpravě, ale skutečný problém – zkontrolujte přihlašovací údaje nebo SQL dotaz na uvedeném řádku.

Call to undefined function ereg(), eregi(), ereg_replace() nebo split()

Funkce pro regulární výrazy ereg, eregi, ereg_replace, eregi_replace, split a spliti byly odstraněny v PHP 7.0. Nahradíte je funkcemi preg_. Vzor se v nich píše mezi oddělovače, nejčastěji lomítka /…/; písmeno i za koncovým lomítkem vypne rozlišování velkých a malých písmen (náhrada za eregi).

Původní kód:

if (ereg('^[0-9]+$', $cislo)) { ... }
if (eregi('^ahoj', $text)) { ... }
$text = ereg_replace('[^a-z0-9]', '-', $text);
$casti = split(',', $seznam);

Upravený kód:

if (preg_match('/^[0-9]+$/', $cislo)) { ... }
if (preg_match('/^ahoj/i', $text)) { ... }
$text = preg_replace('/[^a-z0-9]/', '-', $text);
$casti = explode(',', $seznam);

Pokud funkce split dělí text podle jednoho znaku, použijte explode. Pokud dělí podle vzoru, použijte preg_split (například preg_split('/[,;]/', $seznam)). Obsahuje-li vzor lomítko, zvolte jiný oddělovač, například #: preg_match('#^/clanky/#', $adresa).

Call to undefined function each()

Funkce each byla odstraněna v PHP 8.0. Nejčastěji se používala v cyklu while pro průchod polem, který nahradí foreach:

Původní kód:

while (list($klic, $hodnota) = each($pole)) {
    echo "$klic: $hodnota";
}

Upravený kód:

foreach ($pole as $klic => $hodnota) {
    echo "$klic: $hodnota";
}

Pokud cyklu předchází reset($pole);, můžete ho odstranit – foreach prochází pole vždy od začátku.

Call to undefined function create_function()

Funkce create_function byla odstraněna v PHP 8.0. Nahraďte ji anonymní funkcí – parametry z prvního řetězce dáte do závorek a kód z druhého řetězce do složených závorek:

Původní kód:

$secti = create_function('$a, $b', 'return $a + $b;');
usort($pole, create_function('$a, $b', 'return $a - $b;'));

Upravený kód:

$secti = function ($a, $b) { return $a + $b; };
usort($pole, function ($a, $b) { return $a - $b; });

Call to undefined function get_magic_quotes_gpc()

Funkce get_magic_quotes_gpc a get_magic_quotes_runtime byly odstraněny v PHP 8.0. Takzvané magic quotes v PHP dávno nejsou a funkce vracela vždy false. Podmínku proto odstraňte a ponechte jen kód, který se prováděl, když funkce vrátila false:

Původní kód:

if (get_magic_quotes_gpc()) {
    $text = stripslashes($_POST['text']);
} else {
    $text = $_POST['text'];
}

Upravený kód:

$text = $_POST['text'];

Parse error: syntax error, unexpected token "{"

Starý kód někdy čte jednotlivé znaky textu pomocí složených závorek, například $text{0}. PHP 8 tento zápis nezná a skript se vůbec nespustí. Složené závorky nahraďte hranatými:

Původní kód:

$prvni = $text{0};

Upravený kód:

$prvni = $text[0];

Hlášení Parse error může mít i jiné příčiny – vždy se podívejte na uvedený řádek a řádky před ním.

Unparenthesized `a ? b : c ? d : e` is not supported

Více podmíněných výrazů (ternárních operátorů) za sebou musí být v PHP 8 v závorkách. Závorky doplňte podle toho, jak se výraz vyhodnocoval dřív – PHP 5.6 ho četlo zleva:

Původní kód:

echo $a ? 'jedna' : $b ? 'dva' : 'tri';

Upravený kód:

echo ($a ? 'jedna' : $b) ? 'dva' : 'tri';

Pokud autor zamýšlel „když a, tak jedna, jinak když b, tak dva“, napište $a ? 'jedna' : ($b ? 'dva' : 'tri'). Výsledek si po úpravě vyzkoušejte.

count(): Argument #1 ($value) must be of type Countable|array

PHP 8 ukončí skript, když funkce count dostane místo pole něco jiného, typicky prázdnou hodnotu null (pole, které se nenaplnilo). Před počítáním ověřte, že jde o pole:

Původní kód:

if (count($polozky) > 0) { ... }

Upravený kód:

if (is_array($polozky) && count($polozky) > 0) { ... }

implode(): Argument #1 ($separator) must be of type string, array given

Funkce implode dříve přijímala parametry v libovolném pořadí. V PHP 8 musí být oddělovač první a pole druhé:

Původní kód:

$seznam = implode($pole, ', ');

Upravený kód:

$seznam = implode(', ', $pole);

Undefined variable $HTTP_POST_VARS

Velmi staré skripty čtou data z formulářů z proměnných jako $HTTP_POST_VARS nebo $HTTP_GET_VARS. Ty v PHP nejsou už od verze 5.4, takže taková část webu nefungovala ani na PHP 5.6. Nahraďte je krátkými názvy:

  • $HTTP_GET_VARS → $_GET
  • $HTTP_POST_VARS → $_POST
  • $HTTP_COOKIE_VARS → $_COOKIE
  • $HTTP_SERVER_VARS → $_SERVER
  • $HTTP_POST_FILES → $_FILES
  • $HTTP_SESSION_VARS → $_SESSION

Konstruktor třídy se nespustí (bez chybového hlášení)

Tato chyba se v logu neobjeví. Ve starém objektovém kódu může být konstruktor zapsaný jako metoda se stejným názvem jako třída. PHP 8 takovou metodu při vytvoření objektu nezavolá, takže objekt zůstane nenastavený a web se chová divně (chybí data, nefunguje přihlášení). Metodu přejmenujte na __construct:

Původní kód:

class Galerie {
    function Galerie($slozka) {
        $this->slozka = $slozka;
    }
}

Upravený kód:

class Galerie {
    function __construct($slozka) {
        $this->slozka = $slozka;
    }
}

Warning, Notice a Deprecated

Ne každé hlášení znamená, že web nefunguje. Hlášení začínající Fatal error nebo Parse error skript zastaví a je potřeba je opravit. Hlášení Warning, Notice a Deprecated jsou jen upozornění, stránka se dál zobrazí:

  • Warning: Undefined array key "id" nebo Warning: Undefined variable $jmeno
    Kód čte hodnotu, která neexistuje (například parametr chybějící v adrese). Na PHP 5.6 šlo o méně závažné upozornění, PHP 8 ho hlásí důrazněji. Opravíte ho kontrolou přes isset: $id = isset($_GET['id']) ? $_GET['id'] : 0;
  • Deprecated: …
    Upozornění, že použitá funkce nebo zápis v některé z dalších verzí PHP skončí. Web teď funguje, ale je dobré to opravit, než přijde další změna verze.

Upozornění se návštěvníkům zobrazují jen tehdy, když máte v sekci PHP a MySQL zapnuté zobrazování chyb. Na hotovém webu ho mějte vypnuté a chyby sledujte v logu.

Web postavený na redakčním systému

Pokud chyba vede do souborů redakčního systému, šablony nebo pluginu (WordPress, Joomla, starší fóra a galerie), neupravujte je ručně. Aktualizujte systém, šablonu i doplňky na novou verzi, která PHP 8 podporuje – úpravy byste při příští aktualizaci stejně ztratili. Pokud se doplněk už nevyvíjí, nahraďte ho jiným. Jak aktualizovat WordPress, popisuje článek Jak aktualizovat WordPress, šablonu a pluginy, postup přechodu WordPressu z PHP 5.6 najdete v článku Konec PHP 5.6: převod webů na PHP 8.5 k 10. 2. 2027.

Nejčastější dotazy

Stačí v celém webu nahradit mysql_ za mysqli_?
Ne. Většina funkcí mysqli potřebuje jako první parametr připojení k databázi ($db) a mysqli_connect přijímá i název databáze. Po hromadném nahrazení proto projděte každé volání a připojení doplňte.

Musím přejít na PDO?
Nemusíte. PDO je jiný způsob práce s databází a vyžaduje větší přepis. Pro úpravu starého webu je mysqli jednodušší, protože se funkcemi podobá původním mysql_.

Opravil jsem chybu a objevila se další. Je to v pořádku?
Ano. PHP zastaví skript u první závažné chyby, další se ukáže, až tu první opravíte. Opakujte postup, dokud v logu nebudou žádné nové chyby typu Fatal error.

Jak najdu všechna místa, která je potřeba upravit?
Stáhněte si web do počítače a v textovém editoru (například Notepad++ nebo Visual Studio Code) vyhledejte ve všech souborech texty mysql_, ereg, split(, each( a create_function. Pak web otestujte na novém PHP a projděte log.

Nechci kód upravovat sám. Co mám dělat?
Stávající kód webu vám můžeme upravit my, aby fungoval na PHP 8.5 i dalších verzích řady PHP 8. Kvůli verzi PHP tak web nebudete muset několik dalších let řešit. Úprava stojí jednotně 2 420 Kč včetně DPH (2 000 Kč bez DPH) a platíte, jen když se povede – až práci převezmete a potvrdíte, že web funguje. Cena zahrnuje jen úpravu stávajícího kódu, ne nový vzhled ani nové funkce. Úpravu objednáte na adrese podpora@webzdarma.cz. Další možnosti najdete v článku Konec PHP 5.6: převod webů na PHP 8.5 k 10. 2. 2027.

← Zpět na Pokročilé (FTP, databáze, PHP)Potřebujete další pomoc?

Projděte si další témata

Prozkoumejte další kategorie nápovědy nebo využijte vyhledávání.

Přejít na nápovědu