Plik index.php a dokument HTML

Posługujemy się niekiedy stwierdzeniem, iż plik index.php to zwykły dokument HTML z fragmentami zapisanymi w języku PHP. Tak jest w istocie, bo PHP można wbudować w HTML. Inaczej mówiąc, skrypty PHP są zwykłymi dokumentami HTML, które przełączają się w razie potrzeby w tryb PHP. Jeśli zatem znasz, a zapewne znasz HTML, to zrozumienie budowy pliku index.php nie sprawi Ci kłopotu.

Jest to jednak pewne uproszczenie. Skoro to zwykły plik HTML, to dlaczego nazywa się skryptem PHP, dlaczego ma inne rozszerzenie? Dla pełnej jasności zachowamy w naszym opracowaniu konsekwentnie rozróżnienie dokumentów HTML i skryptów PHP.

Między dokumentem HTML a skryptem PHP jest bowiem drobna, acz znacząca różnica. Skrypty PHP są najpierw interpretowane przez serwer. Gdy serwer napotka w nich fragmenty zapisane w PHP, przetwarza je i wpisuje do dokumentu HTML efekt przetwarzania. Może to być zwykly tekst albo kod HTML. Inaczej mówiąc, plik index.php jest skryptem PHP generującym dokument HTML przesyłany do przeglądarki.

Dokumenty HTML nie są przetwarzane na serwerze. Dokument HTML zawiera instrukcje interpretowane np. przez przeglądarkę internetową, czytnik zawartości, itp. na komputerze lub innym urządzeniu użytkownika.

Struktura dokumentu HTML a struktura pliku index.php

Plik index.php ma jednak wiele wspólnego z dokumentem HTML. Przede wszystkim podobną strukturę, choć obudowaną dodatkowymi elementami. Kod HTML wpisywany jest zwykle tak, jak w każdym innym dokumencie HTML. W miejscach, w których muszą być umieszczone dane, które serwer musi najpierw spreparować, wstawiane są polecenia języka PHP. Ot, cała różnica.

Struktura pliku index.php odpowiada strukturze dokumentu HTML.

Poprawny dokument HTML składa się z deklaracji rodzaju dokumentu i trzech elementów podstawowych:

• elementu html - nadrzędnego, obejmującego wszystkie pozostałe,
• sekcji head - czołówki (albo nagłówka) dokumentu, zawierającej informacje istotne dla przeglądarek i wyszukiwarek internetowych
• sekcji body - głównej części dokumentu, zawierającej instrukcje dla przeglądarek internetowych, informujące je, co i jak ma zostać przedstawione na ekranie monitora czy odczytane przez innego typu urządzenie (np. na ekranie telefonu komórkowego).

Tę podstawową strukturę poszerzają:

• deklaracja typu dokumentu,
• instrukcje XML, jako że posługujemy się następcą HTML, dostosowanym do języka XML - językiem XHTML.

Plik index.php może ponadto zawierać swój nagłówek, swoje, zapisane w sposób zgodny z regułami PHP komentarze.

Łatwe kodowanie

Mimo że plik index.php kodowany jest w języku PHP, znajomość PHP przy projektowaniu szablonów jest niekonieczna, choć może być przydatna. Potrzebne fragmenty kodu znajdziesz w rozpatrywanych przykładach, a poniższe informacje o najczęściej stosowanych instrukcjach i funkcjach pomogą Ci rozumieć, o co w nich chodzi.

Przełączanie się z HTML do PHP

Aby przełączyć się w kodzie HTML do trybu PHP, używamy uniwersalnych znaczników PHP:

<?php ?>

Takie znaczniki będą zawsze poprawnie zinterpretowane. W PHP stosowane są także tzw. krótkie znaczniki otwierające. Ponieważ krótkich znaczników otwierających używa XML, a nasz dokument musi być także zgodny z XML, nie można stosować krótkich znaczników otwierających tryb PHP.

Najczęstsze instrukcje i funkcje PHP

W pliku index.php używamy najczęściej instrukcji PHP w takiej postaci:

1: <php nazwa_funkcji(); ?>
2: <php echo ("fragment dokumentu HTML"); ?>
3: <php if (warunek) { instrukcja; } ?>
4: <php include_once('ścieżka_do_pliku/nazwa_pliku'); ?>

Każda instrukcja obejmowana jest znacznikiem początkowym: <?php i końcowym ?> . Pojedyncze polecenia zawsze kończy średnik. Pierwsza z przytoczonych instrukcji mowi: wykonaj funkcję nazwa_funkcji(). W nawiasach umieszczane są czasem parametry. Drugą można by przetłumaczyć jako: Wypisz fragment dokumentu HTML. Trzecią: Jeśli spełniony jest warunek, to wykonaj instrukcję. Czwartą: wczytaj jeden raz plik nazwa_pliku. Proste?

Włączanie kodu HTML do PHP

Kod HTML w skryptach PHP, a więc i w pliku index.php można ujmować w instrukcje:

<?php echo '<h1 class="contentpagetitle">Tytuł strony</h1> ?> 

Ale nie jest to konieczne! Wystarczy po prostu wpisać:

<h1 class="contentpagetitle">Tytuł strony</h1>

Oznaczanie komentarzy

Komentarze są wielce przydatnymi fragmentami i dla projektantów, i osób przeglądających kod. We fragmentach PHP będziemy korzystać z dwóch sposobów oznaczania komentarzy.

Komentarze wielowierszowe rozpoczynają się parą znaków /* i kończą sie znakami */.

Komentarze jednowierszowe rozpoczynają się znakiem podwójnego ukośnika: //.

---

Uwagi, źródła

Jeżeli masz sugestie odnośnie treści lub chcesz zgłosić poprawki do tego rozdziału, skomentuj go albo umieść wiadomość na forum: Dokumentacja - Propozycje, zmiany, poprawki

Dziękujemy!

Stefan Wajda, Zespół Dokumentacji PCJ