Strona PHP pokazuje kod, pustą stronę albo błąd - przyczyny i naprawa

Plik C:\xampp\htdocs\opony\klienci.php łączy się z bazą opony (z arkusza INF.03-11-25.06-SG) i wypisuje listę klientów. Otwarty pod adresem localhost/opony/klienci.php działa: widać nagłówek i dziewięć nazwisk, w tym „Elżbieta Kościow” z poprawnymi polskimi literami. Najważniejszy fragment pliku:

<?php
$polaczenie = mysqli_connect("localhost", "root", "", "opony");
mysqli_set_charset($polaczenie, "utf8");
$wynik = mysqli_query($polaczenie, "SELECT imie, nazwisko FROM klient");
while ($w = mysqli_fetch_row($wynik)) {
    echo "<li>$w[0] $w[1]</li>";
}
mysqli_close($polaczenie);
?>

Każda kolejna część tutorialu psuje ten plik w jeden sposób i pokazuje, jak wygląda skutek.

Ten sam plik otwarty dwuklikiem w Eksploratorze ma w pasku adresu Plik i ścieżkę C:/xampp/htdocs/... (adres file:///). Przeglądarka czyta plik z dysku z pominięciem serwera, więc PHP nic nie wykonuje i na ekranie jest surowy kod. Rozwiązanie: wpisz adres przez serwer - localhost/opony/klienci.php.

Ten sam kod zapisany jako klienci.html i otwarty przez localhost wygląda inaczej: nagłówek jest, a w miejscu listy stoi fragment w rodzaju $w[0] $w[1]"; } mysqli_close($polaczenie); ?>. Apache wykonuje PHP tylko w plikach .php; w pliku .html przeglądarka traktuje <?php jak nieznany znacznik i pokazuje resztę jako tekst.

Naciśnij Ctrl+U, żeby zobaczyć, co naprawdę przyszło z serwera. Przy pliku .html w źródle jest cały kod PHP, od <?php do ?> - dowód, że serwer go nie wykonał. Przy pliku .php w źródle zobaczysz tylko gotowy HTML (wynik pętli while).

Notatnik przy typie „Dokumenty tekstowe” dopisuje .txt. Plik klienci.php.txt otwarty przez localhost pokazuje kod czcionką maszynową, jak zwykły tekst - serwer wysłał go jako plik tekstowy. W pasku adresu widać pełną nazwę z .txt na końcu.

Komunikat Not Found - The requested URL was not found on this server z podpisem Apache i PHP 8.2.12 oznacza, że serwer działa, ale pod tym adresem nie ma pliku. Tu w adresie jest localhost/opona/... zamiast localhost/opony/.... Sprawdź nazwę folderu w htdocs i nazwę pliku znak po znaku.

Usunięcie średnika na końcu wiersza z mysqli_query(...) daje białą stronę z jednym zdaniem: Parse error: syntax error, unexpected token "while" in C:\xampp\htdocs\opony\srednik.php on line 14. Przy błędzie składni PHP nie wykonuje niczego, nawet HTML-a sprzed <?php. Numer wiersza wskazuje miejsce, w którym parser się zgubił - brakujący średnik jest zwykle wiersz wyżej.

Formularz i skrypt w jednym pliku: $imie = $_POST["imie"]; na górze skryptu. Przy pierwszym wejściu na stronę formularz nie był jeszcze wysłany, więc tablica $_POST jest pusta i PHP 8 wypisuje Warning: Undefined array key "imie" z numerem wiersza, a pod spodem „Dziękujemy, !” z pustym imieniem.

Odczyt danych formularza otocz warunkiem:

if (isset($_POST["imie"])) {
    $imie = $_POST["imie"];
    echo "<p>Dziękujemy, $imie!</p>";
}

Przy pierwszym wejściu strona pokazuje sam formularz, bez ostrzeżenia.

Po wpisaniu imienia i kliknięciu Wyślij warunek jest spełniony i pod formularzem pojawia się „Dziękujemy, Anna!”.

Literówka w nazwie bazy w mysqli_connect (tu opona zamiast opony) kończy skrypt: Fatal error: Uncaught mysqli_sql_exception: Unknown database 'opona'. W PHP 8.1 i nowszym mysqli domyślnie zgłasza wyjątek zamiast cicho zwracać false, więc strona urywa się w miejscu połączenia - HTML poniżej już się nie wyświetla.

Inny częsty powód: serwer bazy nie działa. W panelu XAMPP wiersz MySQL ma szare tło, przycisk Start, a w dzienniku „Status change detected: stopped” (np. po ponownym uruchomieniu komputera).

Skrypt przy zatrzymanym MySQL kończy się komunikatem Fatal error: Uncaught mysqli_sql_exception: Nie można nawiązać połączenia, ponieważ komputer docelowy aktywnie go odmawia. Kliknij Start przy MySQL w panelu XAMPP i odśwież stronę.

Przy zatrzymanym MySQL phpMyAdmin pokazuje czerwone bloki: „Cannot connect: invalid settings”, „mysqli::real_connect(): (HY000/2002)” i „phpMyAdmin próbował połączyć się z serwerem MySQL, a serwer odrzucił połączenie”. To nie jest błąd ustawień - wystarczy uruchomić MySQL i kliknąć Ponów podłączenie.

Strona witaj.html zapisana w UTF-8, ale bez znacznika <meta charset="UTF-8">, pokazuje „zażółć” zamiast „zażółć”. Apache nie wysyła dla plików .html informacji o kodowaniu, więc przeglądarka zgaduje - i zgaduje źle.

Po dopisaniu w sekcji head wiersza <meta charset="UTF-8"> (jako pierwszego) polskie litery wyświetlają się poprawnie. Ten znacznik jest też kryterium w kluczu - np. R.2.2 w INF.03-01-26.06-SG: „W sekcji head znajduje się jawnie podany standard kodowania polskich znaków”.

Sprawdzone w tym XAMPP (PHP 8.2.12, MariaDB 10.4.32): plik .php bez <meta charset> i bez mysqli_set_charset też pokazał „Elżbieta Kościow” poprawnie, bo PHP wysyła nagłówek charset=UTF-8, a połączenie z bazą domyślnie używa UTF-8. Mimo to pisz oba: meta charset jest oceniany w kluczu, a mysqli_set_charset ($polaczenie, "utf8") zabezpiecza przed krzakami na innym serwerze, z inną konfiguracją.