Jak otworzyć plik php w przeglądarce?

Chcesz uruchomić swój pierwszy plik PHP w przeglądarce i zamiast strony widzisz sam kod albo edytor? Z tego artykułu dowiesz się, jak krok po kroku uruchomić PHP na lokalnym serwerze. Po przeczytaniu będziesz wiedzieć, gdzie zapisać plik, jak wejść na niego przez localhost i jak rozwiązać typowe błędy.

Dlaczego plik PHP nie otwiera się jak zwykły HTML?

Plik HTML przeglądarka wyświetla od razu, bo rozumie ten język bez żadnych pośredników. W przypadku PHP wszystko wygląda inaczej. Kod PHP musi zostać najpierw przetworzony przez serwer HTTP z zainstalowaną obsługą PHP. Dopiero wynik tego przetwarzania trafia do przeglądarki jako gotowy HTML.

Gdy klikniesz na plik PHP dwa razy w Eksploratorze Windows, system próbuje otworzyć go w skojarzonym programie. Czasem jest to edytor kodu, na przykład Aptana Studio, Notepad++ albo inny edytor tekstu. Przeglądarka w takim trybie w ogóle nie bierze udziału, więc nic nie jest przetwarzane przez serwer. Z tego powodu widzisz albo surowy kod, albo IDE zamiast działającej strony.

Co to jest localhost?

Adres localhost oznacza Twój własny komputer. To tak, jakbyś mówił przeglądarce: „połącz się z serwerem działającym na tym samym urządzeniu”. Jeśli serwer HTTP jest uruchomiony, przeglądarka po wpisaniu http://localhost łączy się z nim i może wyświetlać pliki umieszczone w specjalnym folderze, na przykład w katalogu htdocs w XAMPP.

Gdy wpisujesz w pasku adresu localhost/plik.php, mówisz serwerowi: „znajdź plik o nazwie plik.php w katalogu głównym serwera i go uruchom”. Jeśli plik leży w złym miejscu albo Apache nie działa, nic się nie otwiera albo pojawia się błąd. To najczęstszy powód, dla którego początkujący widzą komunikat o błędzie albo puste okno.

PHP a pliki tekstowe

Wielu początkujących tworzy pierwsze skrypty jako zwykłe pliki tekstowe. To dobry start pod warunkiem, że zapiszesz je z rozszerzeniem .php. Plik typu plik.php.txt nie będzie interpretowany jako skrypt, tylko jako tekst. Przeglądarka wtedy wyświetli albo czysty kod, albo zaproponuje pobranie pliku.

Warto zwrócić uwagę w Notatniku czy innym edytorze, jaki typ pliku wybierasz przy zapisie. Opcja „Wszystkie pliki” i ręczne dopisanie końcówki .php często rozwiązuje problem. Gdy rozszerzenie jest poprawne, a plik leży w katalogu serwera, możesz go bez problemu otworzyć przez localhost.

Jak poprawnie uruchomić XAMPP i Apache?

XAMPP to pakiet, który instaluje w jednym kroku serwer Apache, PHP, a często także MySQL. Początkujący słyszą zwykle prostą poradę: „zainstaluj XAMPP, wejdź do folderu htdocs i zrób tam plik”. To dobry kierunek, ale kilka detali decyduje, czy wszystko zadziała. Błąd przy uruchamianiu Apache to najczęstszy problem na Windows Vista i nowszych systemach.

Po instalacji XAMPP musisz włączyć Panel sterowania XAMPP. W nim znajdują się przyciski START przy Apache i MySQL. Uruchomienie Apache jest obowiązkowe, bo to on przetwarza Twój plik PHP. MySQL przy zwykłym „Hello world” nie jest potrzebny, ale często i tak go włączasz, gdy uczysz się baz danych.

Jak sprawdzić, czy Apache działa?

Po kliknięciu START przy Apache w XAMPP Control Panel pole „Apache” powinno zmienić kolor, a obok pojawi się numer portu, na przykład 80 lub 8080. Jeśli nic się nie zmienia albo status natychmiast wraca do STOP, coś blokuje port serwera. Często jest to Skype, inny serwer WWW lub program od zabezpieczeń.

Najprostszy test polega na wpisaniu w przeglądarce adresu http://localhost. Gdy Apache działa poprawnie i katalog główny jest ustawiony na htdocs, zobaczysz stronę powitalną XAMPP lub listę plików w tym folderze. Brak reakcji, komunikat o błędzie lub okno pobierania pliku wskazują, że serwer nie przetwarza żądań.

Typowe problemy z portem 80

Na Windows Vista i nowszych port 80 bywa zajęty przez inne aplikacje. Jeśli Apache zgłasza błąd przy starcie, Panel sterowania XAMPP często podaje informację o konflikcie portu. W takim przypadku możesz zmienić port nasłuchiwania, na przykład na 8080. Wtedy w przeglądarce wpiszesz http://localhost:8080 zamiast domyślnego adresu.

Innym rozwiązaniem jest wyłączenie programów, które korzystają z portu 80. Należą do nich czasem komunikatory, stare wersje Skype albo inne pakiety serwerowe. Gdy port jest wolny, Apache startuje bez błędów i możesz wrócić do nauki PHP zamiast walki z konfiguracją.

Gdzie zapisać plik PHP, żeby działał w przeglądarce?

Samo stworzenie pliku w dowolnym folderze na dysku nie wystarczy. Serwer Apache widzi tylko te pliki, które znajdują się w jego katalogu głównym. W XAMPP jest to najczęściej folder htdocs w katalogu instalacji, na przykład C:\xampp\htdocs. To tam musisz umieścić swój plik, jeśli chcesz otwierać go przez localhost.

Jeśli zapiszesz plik na Pulpicie albo w „Dokumentach” i klikniesz dwa razy, system otworzy go w skojarzonym programie, nie w przeglądarce połączonej z Apache. Dlatego tak często w pytaniach pojawia się opis: „po kliknięciu otwiera mi się Aptana Studio zamiast strony www”. To normalne zachowanie systemu, bo nie korzystasz wtedy z serwera HTTP.

Jak poprawnie nazwać i umieścić plik?

Załóżmy, że chcesz stworzyć prosty plik testowy. Otwórz edytor i wpisz:

<?php echo „Działa!”; ?>

Zapisz plik jako test.php bez żadnych dodatkowych rozszerzeń. Upewnij się, że trafił do katalogu htdocs w folderze XAMPP. Dopiero potem wejdź w przeglądarkę i wpisz adres http://localhost/test.php. Jeśli wszystko jest poprawnie skonfigurowane, zobaczysz napis „Działa!”.

Struktura katalogów na lokalnym serwerze

W katalogu htdocs możesz tworzyć podfoldery, tak jak na zwykłym dysku. Ścieżka w przeglądarce musi jednak odpowiadać strukturze katalogów. Gdy plik leży w C:\xampp\htdocs\projekty\blog\index.php, adres w przeglądarce powinien wyglądać tak: http://localhost/projekty/blog/index.php. Dzięki temu wiesz, gdzie umieszczać poszczególne skrypty i jak do nich trafić.

Przy większej liczbie plików uporządkowana struktura katalogów bardzo ułatwia pracę. Osobne foldery na projekty, pliki wspólne i testy sprawiają, że nie gubisz się wśród skryptów. To nawyk, który przyda się później, gdy przeniesiesz projekty z localhost na zewnętrzny serwer.

Jak poprawnie otworzyć plik PHP w przeglądarce?

Skoro wiesz już, do czego służy localhost i gdzie umieścić plik, pozostaje jeszcze jedna kwestia: jak go faktycznie otworzyć. Zwykłe dwukrotne kliknięcie nie uruchamia PHP, bo omija serwer. Musisz zawsze wejść w plik przez adres HTTP, nie przez ścieżkę do pliku na dysku.

Innymi słowy, zamiast „C:\xampp\htdocs\plik.php” w pasku adresu musi się pojawić „http://localhost/plik.php”. Ty widzisz prawie to samo, ale dla systemu to zasadnicza różnica. W pierwszym przypadku przeglądarka próbuje otworzyć plik jak dokument. W drugim pyta Apache o wynik działania skryptu.

Krok po kroku – od pliku do strony

Cały proces otwierania pliku PHP w przeglądarce można zapisać jako prostą sekwencję czynności. Jeśli będziesz się ich trzymać, unikniesz większości błędów, które pojawiają się przy pierwszym kontakcie z PHP:

1. Zainstaluj pakiet XAMPP lub inny serwer zawierający Apache i PHP.
2. Uruchom Panel sterowania i włącz moduł Apache przyciskiem START.
3. Utwórz plik z rozszerzeniem .php w katalogu htdocs.
4. Wpisz w przeglądarce adres http://localhost/nazwa_pliku.php.

Gdy któryś z tych kroków pominiesz, strona nie wystartuje. Wtedy warto sprawdzić po kolei, na którym etapie coś poszło nie tak. Najczęściej problemy dotyczą złego folderu, błędnego rozszerzenia pliku albo niedziałającego serwera Apache.

Czego nie robić z plikami PHP?

W nauce PHP równie ważne jak dobre nawyki są te, których warto unikać. Kilka błędnych kroków powtarza się w opisach problemów początkujących tak często, że warto je zebrać w jednym miejscu. Chodzi o sytuacje, gdy pozornie robisz wszystko dobrze, ale drobny detal blokuje efekt.

Do problematycznych działań należą między innymi:

• dwukrotne klikanie pliku PHP w Eksploratorze Windows zamiast wejścia przez localhost,
• zapisywanie plików jako .php.txt albo w innych formatach tekstowych,
• umieszczanie plików poza katalogiem htdocs z nadzieją, że localhost je zobaczy,
• próby otwierania plików PHP bez uruchomionego Apache w XAMPP.

Jak diagnozować typowe błędy przy otwieraniu PHP?

Nawet przy poprawnej instalacji XAMPP i dobrym umieszczeniu pliku błędy nadal mogą się pojawiać. Komunikaty przeglądarki bywają niejasne, ale da się z nich wiele wyczytać. Błędy typu „404 Not Found” czy „Object not found” zwykle oznaczają złą ścieżkę lub nazwę pliku. Z kolei „Unable to connect” wskazuje na niedziałający serwer.

Czytanie treści błędu to pierwszy krok. Drugi to sprawdzenie, czy plik rzeczywiście leży tam, gdzie wskazuje adres. Trzeci – kontrola, czy Apache i PHP są aktywne. W Panelu XAMPP stan modułu powinien być zielony, a log w oknie dolnym nie powinien pokazywać krytycznych błędów startu.

Najczęstsze komunikaty i ich znaczenie

W początkowej fazie nauki pewne komunikaty zaczną powtarzać się bardzo często. Po krótkim czasie zaczniesz je rozpoznawać bez zastanowienia, ale na początku dobrze mieć prostą ściągawkę. Warto wiedzieć, co dokładnie oznaczają i na co wskazują.

Przykładowe komunikaty błędów można powiązać z typowymi problemami:

Gdy pojawia się Parse error, serwer Apache działa poprawnie, ale PHP nie potrafi zinterpretować skryptu. To w gruncie rzeczy dobra wiadomość, bo oznacza, że problem leży już tylko w kodzie. Przeglądarka wyświetla wtedy informację o linii, w której parser się „wyłożył”. Warto zajrzeć dokładnie w to miejsce, przeanalizować średniki i nawiasy, a potem odświeżyć stronę.