1. ACD. throw przerywa funkcję, reszta bloku try (czyli echo "B") jest pomijana, PHP skacze do catch, a po nim program działa dalej.
2. Brak słowa throw. Samo new Exception(...) tworzy obiekt i go porzuca — program leci dalej i dodaje ujemną nagrodę. Poprawnie: throw new Exception("...");.
3. a) wyjątek, b) zwykła wartość — pusty plik to normalny stan („Brak zadań.”), c) wyjątek — dane uszkodzone, d) zwykła wartość true/false — zły login to nie awaria.
4. Wyjątek przerwałby pętlę i przeskoczył do catch, więc fclose() za pętlą nigdy by się nie wykonało — plik zostałby otwarty. finally wykonuje się zawsze, także po wyjątku.
5. Nie. TypeError należy do rodziny Error, a nie Exception — catch (Exception ...) go nie złapie. To zwykle błąd w kodzie, który poprawiamy, a nie łapiemy.
6. getMessage(). Nie pokazujemy getFile() ani getTraceAsString() — ujawniają ścieżki na serwerze i strukturę kodu.

Po Lekcji 12 TaskQuest bezpiecznie wczytuje zadania z data/zadania.csv i głośno zgłasza awarie. Ale żeby dodać zadanie, Kama nadal musi otworzyć plik CSV w edytorze kodu i ręcznie wpisać wiersz — pilnując średników, cudzysłowów, formatu daty i kolejnego id. Żaden użytkownik prawdziwej aplikacji tak nie pracuje.

Dziś TaskQuest dostaje pierwszy formularz: użytkownik wpisuje zadanie na stronie, klika „Dodaj zadanie”, a PHP sprawdza dane i zapisuje je do pliku. Przy okazji lista zadań nauczy się filtrowania przez adres strony (?filtr=aktywne).

Cel lekcji

Nauczyć TaskQuest:

• odbierać dane z formularza HTML ($_POST) i z adresu strony ($_GET),
• odróżniać pierwsze wejście na stronę od wysłania formularza ($_SERVER['REQUEST_METHOD']),
• bezpiecznie sięgać po dane, których może nie być (operator ??),
• sprawdzać dane od użytkownika po stronie serwera i pokazywać wszystkie błędy naraz,
• dopisywać nowe zadanie do pliku (wczytaj → dodaj → zapisz) z nowym, unikalnym id,
• nie dodawać tego samego zadania dwa razy po odświeżeniu strony (przekierowanie po zapisie),
• świadomie wybierać metodę: GET do czytania, POST do zmieniania danych.

Efekt: na stronie głównej jest link „+ Dodaj zadanie” prowadzący do nowej strony dodaj-zadanie.php. Po poprawnym wypełnieniu formularza zadanie ląduje w data/zadania.csv, użytkownik wraca na stronę główną i widzi komunikat „Zadanie zostało dodane.”. Lista zadań ma trzy widoki: wszystkie, aktywne i wykonane.

Uwaga — co jest, a czego jeszcze nie ma:

• Nie ma logowania ani sesji. Komunikat „Zadanie zostało dodane.” przekazujemy w adresie strony (?dodano=1), a nie „w pamięci” aplikacji — sesje to Lekcja 14.
• Nadal nie używamy htmlspecialchars(). Od dziś tekst wpisany przez użytkownika trafia na stronę, więc to już realny problem bezpieczeństwa — zobaczysz go w Eksperymencie 5, a naprawimy go w lekcji o bezpieczeństwie (22). Aplikacja działa na Twoim komputerze i tylko Ty wpisujesz dane — dlatego na razie możemy to odłożyć.
• Formularz tylko dodaje zadania. Oznaczanie jako wykonane to zadanie końcowe A; edycja i usuwanie — przy bazie danych (Lekcja 19).
• Przesyłanie plików (upload) i pozostałe typy pól (checkbox, radio, select) poznasz w ćwiczeniach z tematu, ale TaskQuest ich dziś nie potrzebuje.
• Dane grywalizacji ($xp, $streak, $dataOstatniejAktywnosci) nadal są symulowane w index.php.

Rozgrzewka — 4 pytania z Lekcji 12

Odpowiedz z pamięci, zanim zaczniesz:

1. W bloku try są trzy linie kodu, a wyjątek poleciał w drugiej. Co stanie się z trzecią linią i dokąd „przeskoczy” PHP?
2. Dlaczego pusty plik z zadaniami nie rzuca wyjątku, a brak pliku — rzuca?
3. Po co w index.php jest $zadania = []; przed blokiem try?
4. Dokończ regułę: „Kto wykrywa problem — …, kto wie, co z problemem zrobić — …”.

1. Wracamy do naszego TaskQuest

Aplikacja czyta zadania z pliku, a funkcja zapiszZadania() istnieje od Lekcji 11 — ale nikt jej jeszcze nie wywołuje ze strony. Dziś wreszcie dostanie swoje miejsce w aplikacji. Wszystkie zmienne i funkcje z Lekcji 12 zostają bez zmian.

Docelowa struktura projektu

taskquest/
├── index.php                        (zmiana: link do formularza, komunikat po dodaniu, filtr GET)
├── dodaj-zadanie.php                NOWY — formularz dodawania zadania + jego obsługa
├── diagnostyka.php                  (zmiana: jedna nowa pozycja na liście wymaganych plików)
├── config/
│   └── config.php                   bez zmian
├── includes/
│   ├── header.php                   (zmiana: klasa .sukces + style formularza)
│   ├── footer.php                   (zmiana: "TaskQuest 1.3")
│   ├── funkcje_grywalizacji.php     bez zmian
│   ├── funkcje_tekstowe.php         bez zmian
│   ├── funkcje_terminow.php         bez zmian
│   ├── funkcje_zadan.php            (zmiana: dwie nowe funkcje na końcu pliku)
│   ├── funkcje_diagnostyczne.php    bez zmian
│   └── funkcje_plikow.php           bez zmian
└── data/
    └── zadania.csv                  (zmieni się jego zawartość — dopiszą się zadania z formularza)

Co gdzie trafi

Ciekawostka: w nowej stronie wrócą nazwy $tytulZadania, $opisZadania i $terminZadania, które usunęliśmy w Lekcji 9 (dane zadań przeniosły się wtedy do kluczy tablicy $zadania). Teraz dostają nowe, konkretne znaczenie: dane nowego zadania wpisane w formularzu, zanim trafią do listy.

Przygotowanie (zrób to teraz)

1. Zrób kopię zapasową całego katalogu taskquest/ z Lekcji 12 — np. jako taskquest_lekcja12/ (obok, nie w środku). Przyda się do testu regresji.
2. Zrób kopię pliku data/zadania.csv poza katalogiem taskquest/ (np. na pulpicie, jako zadania_kopia.csv). Dziś będziemy dopisywać do niego testowe zadania, a na koniec wrócimy do oryginału.
3. Sprawdź, czy index.php pokazuje 5 zadań, a diagnostyka.php — 11 × [OK].

2. Problem w aplikacji

Kama chce dodać zadanie „Powtórka z formularzy” na przyszły piątek, za 30 XP. Dziś musi:

1. otworzyć data/zadania.csv w edytorze,
2. sprawdzić, jakie jest największe id, i wymyślić kolejne,
3. wpisać wiersz, nie gubiąc żadnego średnika i pamiętając o formacie RRRR-MM-DD,
4. odświeżyć stronę i mieć nadzieję, że niczego nie zepsuła (jeśli zepsuła — od Lekcji 12 przynajmniej zobaczy ramkę z numerem linii).

Chcemy, żeby wyglądało to tak:

formularz w przeglądarce ──(kliknięcie "Dodaj zadanie")──► PHP odbiera dane
                                   │
                         czy dane są poprawne?
                      ┌────────────┴────────────┐
                     NIE                        TAK
                      │                          │
      formularz jeszcze raz,            wczytajZadania() → dopisz → zapiszZadania()
       z listą błędów                           │
       i wpisanymi danymi            powrót na stronę główną
                                     + "Zadanie zostało dodane."

Do tego Kama ma już 5 zadań i chciałaby czasem widzieć tylko aktywne. To zupełnie inny rodzaj prośby: niczego nie zmienia w danych, tylko wybiera, co pokazać.

Potrzebujemy więc:

1. sposobu, żeby przeglądarka wysłała dane do skryptu PHP,
2. sposobu, żeby PHP te dane odebrał,
3. sposobu, żeby PHP odróżnił „ktoś dopiero otworzył formularz” od „ktoś go właśnie wysłał”,
4. sprawdzenia danych — przeglądarka potrafi wysłać wszystko,
5. dwóch rodzajów próśb: „pokaż mi” i „zmień dane”.

To właśnie formularze HTML i metody GET oraz POST.

3. Nowy mechanizm PHP: formularze, GET i POST

3.1 Jak przeglądarka rozmawia z PHP

Za każdym razem, gdy wpisujesz adres, klikasz link albo wysyłasz formularz, przeglądarka wysyła do serwera żądanie (ang. request). Serwer uruchamia skrypt PHP od zera, skrypt generuje HTML, a serwer odsyła go jako odpowiedź (ang. response). Potem skrypt się kończy i wszystkie jego zmienne znikają.

PRZEGLĄDARKA                                 SERWER (Apache + PHP)
     │  żądanie: GET /taskquest/index.php          │
     │ ──────────────────────────────────────────► │  uruchamia index.php od początku
     │                                             │  (zmienne powstają...)
     │  odpowiedź: HTML strony                     │
     │ ◄────────────────────────────────────────── │  (...i znikają po zakończeniu)

Każde żądanie ma metodę. Dwie najważniejsze to:

• GET — „daj mi stronę”. Tak działa wpisanie adresu i kliknięcie linku. Dane (jeśli są) jadą w adresie, po znaku ?.
• POST — „przyjmij ode mnie dane”. Dane jadą w treści żądania, nie w adresie.

3.2 Pierwszy formularz — metoda GET

BRUDNOPIS. Utwórz w katalogu taskquest/ plik brudnopis.php — to plik do eksperymentów, nie część aplikacji. Cała sekcja 3 i 4 dzieje się w tym pliku.

<!DOCTYPE html>
<html lang="pl">
<head>
    <meta charset="UTF-8">
    <title>Brudnopis — formularz</title>
</head>
<body>
    <form method="get" action="brudnopis.php">
        <label for="imie">Imię</label>
        <input type="text" id="imie" name="imie">

        <label for="xp">XP</label>
        <input type="number" id="xp" name="xp">

        <button type="submit">Wyślij</button>
    </form>

    <pre><?php var_dump($_GET); ?></pre>
</body>
</html>

Otwórz http://localhost/taskquest/brudnopis.php, wpisz Kama i 50, kliknij „Wyślij”. Zwróć uwagę na trzy rzeczy:

1. Adres zmienił się na brudnopis.php?imie=Kama&xp=50. Dane są widoczne w pasku adresu.
2. var_dump($_GET) pokazuje tablicę asocjacyjną: ["imie"] => "Kama", ["xp"] => "50".
3. xp to string(2) "50", a nie liczba — mimo że pole ma type="number". Z formularza zawsze przychodzą teksty.

Co tu się dzieje:

• method="get" — przeglądarka dokleja dane do adresu,
• action="brudnopis.php" — do którego skryptu wysłać dane (tu: do tego samego pliku),
• atrybut name pola staje się kluczem w tablicy $_GET. Pole bez name w ogóle nie zostanie wysłane (atrybut id służy tylko do połączenia z <label for="...">),
• $_GET to tablica, którą PHP wypełnia sam, zanim uruchomi Twój kod.

Teraz wpisz adres ręcznie, bez formularza: brudnopis.php?imie=Ola&xp=abc&bonus=1. PHP przyjął wszystko — także abc w polu liczbowym i dodatkowy klucz bonus, którego w formularzu nie ma. Zapamiętaj: formularz to tylko jeden ze sposobów wysłania danych. Użytkownik może wysłać, co zechce.

Na koniec otwórz brudnopis.php bez niczego po ?. $_GET jest pustą tablicą: array(0) {}.

3.3 Metoda POST

Zmień w formularzu method="get" na method="post", a var_dump($_GET) na var_dump($_POST). Wyślij formularz jeszcze raz.

• Adres się nie zmienił — nie ma w nim ?imie=....
• Dane są w $_POST, zbudowanej dokładnie tak samo jak $_GET.

Gdzie się podziały? Otwórz narzędzia deweloperskie (F12) → karta Sieć (Network) → wyślij formularz → kliknij żądanie brudnopis.php → karta Ładunek (Payload). Tam są. POST nie jest „tajny” — dane po prostu nie jadą w adresie. Każdy, kto ma dostęp do przeglądarki albo sieci, może je zobaczyć lub zmienić. (Szyfrowanie połączenia zapewnia HTTPS, nie metoda POST.)

Teraz naciśnij F5. Przeglądarka pyta, czy wysłać dane ponownie. Zapamiętaj to okienko — w TaskQuest oznaczałoby drugie takie samo zadanie w pliku. Wrócimy do tego w Kroku 4.

3.4 Pierwsze wejście czy wysłany formularz?

Ten sam plik brudnopis.php jest otwierany na dwa sposoby: najpierw zwykłym wejściem (GET — pusty formularz), potem po kliknięciu przycisku (POST — dane do sprawdzenia). PHP musi je odróżnić. Podmień zawartość brudnopis.php na:

<?php

echo "Metoda: " . $_SERVER['REQUEST_METHOD'] . "<br>";
echo "Imię: " . $_POST['imie'] . "<br>";
?>
<form method="post" action="brudnopis.php">
    <input type="text" name="imie">
    <button type="submit">Wyślij</button>
</form>

Przy pierwszym wejściu zobaczysz Metoda: GET oraz ostrzeżenie Warning: Undefined array key "imie" — przy zwykłym wejściu klucza imie w $_POST nie ma. Po wysłaniu: Metoda: POST i wpisane imię.

Dwa narzędzia, które to porządkują:

1. $_SERVER['REQUEST_METHOD'] — tekst 'GET' albo 'POST'. Kod obsługujący formularz umieszczamy w:

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // formularz został wysłany — dopiero tu sięgamy po $_POST
}

2. Operator ?? — „weź wartość z lewej, a jeśli jej nie ma (klucz nie istnieje albo jest null), weź tę z prawej”:

$imie = $_POST['imie'] ?? '';

To krótszy zapis tego samego, co:

if (isset($_POST['imie'])) {
    $imie = $_POST['imie'];
} else {
    $imie = '';
}

Nawet wewnątrz if (... === 'POST') używamy ?? — bo ktoś może wysłać POST bez jakiegoś pola (np. usunąć je z formularza w F12). Zmień drugą linię na echo "Imię: " . ($_POST['imie'] ?? '(brak)') . "<br>"; i sprawdź pierwsze wejście — ostrzeżenie zniknęło.

3.5 GET czy POST?

Reguła na cały kurs:

GET — gdy tylko czytamy. POST — gdy coś zmieniamy.

3.6 Pola formularza i walidacja w przeglądarce

W formularzu TaskQuest użyjemy czterech rodzajów pól:

Atrybuty required, min, max, maxlength to walidacja w przeglądarce: przeglądarka nie wyśle formularza, dopóki pola nie będą poprawne. To wygoda dla użytkownika (szybka informacja bez przeładowania strony), ale nie ochrona. Obejść ją można na kilka sposobów:

• dopisać do znacznika <form> atrybut novalidate — przeglądarka przestaje sprawdzać pola (użyjemy go w testach),
• usunąć atrybut w narzędziach deweloperskich (F12 → Elementy),
• wysłać dane bez przeglądarki (np. programem curl) albo — przy GET — po prostu wpisać adres.

Dlatego PHP zawsze sprawdza dane sam, nawet jeśli formularz ma required.

3.7 Błąd użytkownika to nie awaria

W Lekcji 12 ustaliliśmy: wyjątek to sygnał „nie potrafię zrobić tego, o co mnie poproszono”, a zły login to zwykła odpowiedź (false), nie awaria. Z formularzem jest tak samo:

Jest też powód praktyczny: wyjątek przerywa sprawdzanie na pierwszym problemie. Użytkownik, który zrobił trzy błędy, poprawiałby je wtedy po jednym, wysyłając formularz trzy razy. Tablica błędów pozwala pokazać wszystkie naraz:

$bledy = [];

if (/* tytuł pusty */) {
    $bledy[] = "Tytuł jest wymagany.";
}

if (/* XP złe */) {
    $bledy[] = "XP musi być z zakresu 1–100.";
}

if (count($bledy) === 0) {
    // wszystko w porządku — można zapisywać
}

Typowe błędy przy formularzach

• Brak atrybutu name w polu — pole nie zostanie wysłane, a w PHP pojawi się Undefined array key.
• Sięganie po $_POST['...'] bez ?? przy pierwszym wejściu na stronę — ostrzeżenie Undefined array key.
• Traktowanie danych z formularza jak liczb — $_POST['xp'] to zawsze tekst. (int) "12abc" daje 12, a (int) "dużo" daje 0 — rzutowanie „po cichu” zamienia śmieci w liczbę.
• Poleganie tylko na required i min/max — przeglądarkę da się ominąć.
• Użycie GET do zmiany danych — link lub odświeżenie strony zmienia dane bez wiedzy użytkownika.
• Wpisanie wartości <textarea> w atrybut value — textarea nie ma atrybutu value, tekst wpisuje się między <textarea> a </textarea>.
• Literówka w nazwie: name="tytul" w HTML, a $_POST['tytuł'] albo $_POST['title'] w PHP — klucze muszą być identyczne.

4. SAMODZIELNIE — formularz, który sprawdza dane

BRUDNOPIS. To ostatnie ćwiczenie w brudnopis.php, zanim zaczniemy zmieniać projekt. Zastąp zawartość pliku kodem, który:

1. wyświetla formularz (metoda POST, wysyłany do brudnopis.php) z dwoma polami: tytul i xp — oba jako type="text" i bez required, żeby przeglądarka niczego nie blokowała i całą pracę musiał wykonać PHP,
2. przy wysłaniu formularza (i tylko wtedy!) sprawdza dane:
   • tytuł (po trim()) nie może być pusty → Tytuł jest wymagany.,
   • XP musi składać się z samych cyfr → XP musi być liczbą całkowitą., a jeśli jest liczbą, musi być z zakresu 1–100 → XP musi być z zakresu 1–100.,
3. gdy są błędy — wypisuje je jako listę <ul>, gdy ich nie ma — wypisuje Przyjęto zadanie: <tytuł> (<xp> XP),
4. po wysłaniu formularz nie jest pusty — pola zawierają to, co wpisał użytkownik (żeby przy błędzie nie musiał pisać wszystkiego od nowa).

Efekt:

Jak sprawdzić: każdy wiersz tabeli. Szczególnie pierwszy — jeśli przy pierwszym wejściu widzisz Warning, sięgasz po $_POST za wcześnie albo bez ??.

<?php

$tytulZadania = '';
$xpZadania = '';
$bledy = [];
$przyjete = false;

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $tytulZadania = trim($_POST['tytul'] ?? '');
    // ... to samo dla xp ...

    // ... sprawdzenia, każde dopisuje komunikat do $bledy ...

    $przyjete = count($bledy) === 0;
}
?>
<!-- HTML: komunikat "Przyjęto" (gdy $przyjete), lista błędów (gdy są), formularz -->
<input type="text" id="tytul" name="tytul" value="<?= $tytulZadania; ?>">

<?php

$tytulZadania = '';
$xpZadania = '';
$bledy = [];
$przyjete = false;

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $tytulZadania = trim($_POST['tytul'] ?? '');
    $xpZadania = trim($_POST['xp'] ?? '');

    if ($tytulZadania === '') {
        $bledy[] = "Tytuł jest wymagany.";
    }

    if (!preg_match('/^\d+$/', $xpZadania)) {
        $bledy[] = "XP musi być liczbą całkowitą.";
    } elseif ((int) $xpZadania < 1 || (int) $xpZadania > 100) {
        $bledy[] = "XP musi być z zakresu 1–100.";
    }

    $przyjete = count($bledy) === 0;
}
?>
<!DOCTYPE html>
<html lang="pl">
<head>
    <meta charset="UTF-8">
    <title>Brudnopis — formularz</title>
</head>
<body>
    <?php if ($przyjete) { ?>
    <p>Przyjęto zadanie: <?= $tytulZadania; ?> (<?= $xpZadania; ?> XP)</p>
    <?php } ?>

    <?php if (count($bledy) > 0) { ?>
    <ul>
        <?php foreach ($bledy as $blad) { ?>
        <li><?= $blad; ?></li>
        <?php } ?>
    </ul>
    <?php } ?>

    <form method="post" action="brudnopis.php">
        <label for="tytul">Tytuł</label>
        <input type="text" id="tytul" name="tytul" value="<?= $tytulZadania; ?>">

        <label for="xp">XP</label>
        <input type="text" id="xp" name="xp" value="<?= $xpZadania; ?>">

        <button type="submit">Sprawdź</button>
    </form>
</body>
</html>

5. Włączamy formularz do TaskQuest — krok po kroku

PROJEKT. Od tego miejsca kończymy pracę w brudnopis.php (zostaw go na razie — przyda się w testach) i zmieniamy pliki prawdziwej aplikacji w katalogu taskquest/. Kolejność: najpierw funkcje (logika bez HTML), potem nowa strona, na końcu połączenie jej ze stroną główną.

Krok 1 — SAMODZIELNIE: walidujNoweZadanie()

Plik projektu: includes/funkcje_zadan.php. Na końcu pliku (pod sortujPoTerminie()) dopisz funkcję:

function walidujNoweZadanie(string $tytulZadania, string $opisZadania, string $terminZadania, string $xpZadania): array

Funkcja dostaje już oczyszczone teksty z formularza i zwraca tablicę komunikatów o błędach. Pusta tablica oznacza: dane są poprawne. Funkcja niczego nie wyświetla i nie rzuca wyjątków (patrz 3.7).

Długość tekstu licz przez mb_strlen() (Lekcja 8) — strlen() policzyłby polskie litery podwójnie.

Do sprawdzenia, czy dzień istnieje, użyj wbudowanej funkcji checkdate($miesiac, $dzien, $rok) — przyjmuje trzy liczby całkowite i zwraca true albo false (np. checkdate(2, 31, 2026) → false). Trzy liczby z tekstu 2026-02-31 wydobędziesz przez explode('-', $terminZadania) i rzutowanie (int). (Jeśli robiłaś/robiłeś zadanie końcowe A z Lekcji 12, znasz już ten pomysł.)

Zauważ: w komunikatach nie powtarzamy tego, co wpisał użytkownik (np. „Termin 2026-02-31 …”). Tekst od użytkownika trafia na stronę tylko tam, gdzie to konieczne — dlaczego to ważne, zobaczysz w Eksperymencie 5.

Jak sprawdzić: w brudnopis.php (podmień zawartość):

<?php

require_once __DIR__ . '/includes/funkcje_zadan.php';

print_r(walidujNoweZadanie('Nauka PHP', '', '2026-10-02', '20'));
print_r(walidujNoweZadanie('', '', '2026-02-31', 'dużo'));

Pierwsze wywołanie: Array ( ). Drugie: trzy komunikaty — o tytule, o kalendarzu i o liczbie całkowitej. Pełny zestaw przypadków jest w Teście 1.

function walidujNoweZadanie(string $tytulZadania, string $opisZadania, string $terminZadania, string $xpZadania): array
{
    $bledy = [];

    if ($tytulZadania === '') {
        $bledy[] = "Tytuł jest wymagany.";
    } elseif (/* za długi */) {
        // ...
    }

    // opis ...

    if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $terminZadania)) {
        // ...
    } else {
        $czesciDaty = explode('-', $terminZadania);   // [0] => rok, [1] => miesiąc, [2] => dzień

        // checkdate(miesiąc, dzień, rok) — uwaga na kolejność!
    }

    // XP ...

    return $bledy;
}

function walidujNoweZadanie(string $tytulZadania, string $opisZadania, string $terminZadania, string $xpZadania): array
{
    $bledy = [];

    if ($tytulZadania === '') {
        $bledy[] = "Tytuł jest wymagany.";
    } elseif (mb_strlen($tytulZadania) > 100) {
        $bledy[] = "Tytuł może mieć najwyżej 100 znaków.";
    }

    if (mb_strlen($opisZadania) > 300) {
        $bledy[] = "Opis może mieć najwyżej 300 znaków.";
    }

    if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $terminZadania)) {
        $bledy[] = "Termin musi być datą w formacie RRRR-MM-DD.";
    } else {
        $czesciDaty = explode('-', $terminZadania);

        if (!checkdate((int) $czesciDaty[1], (int) $czesciDaty[2], (int) $czesciDaty[0])) {
            $bledy[] = "Taki dzień nie istnieje w kalendarzu.";
        }
    }

    if (!preg_match('/^\d+$/', $xpZadania)) {
        $bledy[] = "XP musi być liczbą całkowitą.";
    } elseif ((int) $xpZadania < 1 || (int) $xpZadania > 100) {
        $bledy[] = "XP musi być z zakresu 1–100.";
    }

    return $bledy;
}

Krok 2 — SAMODZIELNIE: nastepneIdZadania()

Plik projektu: includes/funkcje_zadan.php. Nowe zadanie potrzebuje id, którego nie ma jeszcze żadne inne zadanie. Dopisz nową funkcję między sortujPoTerminie() a walidujNoweZadanie() (dla PHP kolejność funkcji w pliku nie ma znaczenia — to tylko porządek dla czytającego):

function nastepneIdZadania(array $zadania): int

Funkcja zwraca największe id na liście + 1. Dla pustej listy zwraca 1.

Zanim zaczniesz, odpowiedz: dlaczego nie count($zadania) + 1? Wyobraź sobie, że Kama ręcznie usunęła z pliku zadanie o id 3. Na liście zostały 1, 2, 4, 5 — ile wynosi count() + 1 i co by się stało?

Jak sprawdzić: w brudnopis.php:

echo nastepneIdZadania([]) . "<br>";                                        // 1
echo nastepneIdZadania([['id' => 1], ['id' => 2], ['id' => 3]]) . "<br>";   // 4
echo nastepneIdZadania([['id' => 3], ['id' => 10], ['id' => 7]]) . "<br>";  // 11

(Funkcja potrzebuje tylko klucza 'id', więc do testu wystarczą takie „okrojone” zadania.)

function nastepneIdZadania(array $zadania): int
{
    $najwiekszeId = 0;

    foreach ($zadania as $zadanie) {
        if ($zadanie['id'] > $najwiekszeId) {
            $najwiekszeId = $zadanie['id'];
        }
    }

    return $najwiekszeId + 1;
}

Krok 3 — SAMODZIELNIE: strona dodaj-zadanie.php

Nowy plik projektu: dodaj-zadanie.php — w katalogu głównym taskquest/, obok index.php. Buduj go w trzech częściach i sprawdzaj po każdej.

3a — szkielet i formularz

Struktura pliku jest taka sama jak index.php (dane i logika na górze, prezentacja na dole):

1. require_once: config/config.php, includes/funkcje_tekstowe.php (będzie potrzebna wyczyscTytul()), includes/funkcje_zadan.php, includes/funkcje_plikow.php,
2. wartości początkowe: $tytulZadania, $opisZadania, $terminZadania, $xpZadania (puste teksty), $bledy (pusta tablica), $bladZapisu (null — tu trafi komunikat wyjątku, jak $bladZadan w index.php),
3. $nazwaStrony = 'Dodaj zadanie — TaskQuest'; i dołączenie header.php,
4. nagłówek <h2>Nowe zadanie</h2>, link powrotny do index.php,
5. formularz: metoda POST, action="dodaj-zadanie.php", pola tytul (text, required, maxlength="100"), opis (textarea, maxlength="300"), termin (date, required), xp (number, min="1", max="100", required), przycisk „Dodaj zadanie”. Każde pole z <label for="..."> i wartością z odpowiedniej zmiennej,
6. dołączenie footer.php.

Sprawdź: otwórz http://localhost/taskquest/dodaj-zadanie.php. Widać nagłówek TaskQuest, formularz i stopkę. Brak ostrzeżeń PHP. Wysłanie formularza na razie nic nie robi (strona po prostu się przeładuje).

3b — odbiór i sprawdzenie danych

Między wartościami początkowymi a prezentacją dodaj blok if ($_SERVER['REQUEST_METHOD'] === 'POST') { ... }, który:

1. odczytuje cztery pola przez ?? i od razu je czyści:
   • tytuł — istniejącą funkcją wyczyscTytul() (Lekcja 8: przycina i zamienia wielokrotne białe znaki na jedną spację),
   • opis — preg_replace('/\s+/', ' ', ...) i trim(): textarea pozwala wpisać kilka linii, a my chcemy mieć opis w jednej linii pliku CSV (pamiętasz ograniczenie numerów linii z Lekcji 12?),
   • termin i XP — trim(),
2. wywołuje walidujNoweZadanie() i zapisuje wynik w $bledy.

W prezentacji, nad formularzem: gdy $bledy nie jest puste — ramka <div class="blad"> z tekstem „Popraw formularz:” i listą <ul> komunikatów.

Sprawdź (na czas sprawdzania dopisz do znacznika <form atrybut novalidate, żeby przeglądarka nie blokowała wysłania — potem go usuń): pusty formularz → trzy komunikaty; tytuł Nauka, termin pusty, XP 500 → dwa komunikaty, a w polu tytułu nadal jest Nauka.

3c — zapis do pliku

Gdy $bledy jest puste, zadanie trzeba dopisać do pliku. zapiszZadania() nadpisuje cały plik (tryb w), więc nie da się „dopisać jednej linii” — trzeba:

wczytajZadania()  →  $zadania[] = nowe zadanie  →  zapiszZadania()

Obie funkcje plikowe mogą rzucić wyjątek, więc cała ta trójka idzie do jednego try, a w catch zapamiętujemy komunikat w $bladZapisu. Nowe zadanie musi mieć dokładnie tę samą strukturę kluczy co pozostałe: id (z nastepneIdZadania()), tytul, opis, termin, wykonane (false — nowe zadanie nie jest wykonane), xp (jako int!).

Po udanym zapisie (na razie) ustaw zmienną $zadanieDodane = true; i wyświetl nad formularzem <p class="sukces">Zadanie zostało dodane.</p>. Gdy $bladZapisu !== null, wyświetl <p class="blad">Nie udało się dodać zadania: ...</p>.

Zastanów się, zanim napiszesz kod: co by się stało, gdyby wczytajZadania() była poza try, a przy awarii odczytu kod przyjąłby $zadania = [] i mimo to wywołał zapiszZadania()? Pomyśl o pliku, w którym jeden wiersz jest uszkodzony.

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $tytulZadania = wyczyscTytul($_POST['tytul'] ?? '');
    $opisZadania = trim(preg_replace('/\s+/', ' ', $_POST['opis'] ?? ''));
    // ... termin i xp ...

    $bledy = walidujNoweZadanie(/* ... */);

    if (count($bledy) === 0) {
        try {
            $zadania = wczytajZadania(PLIK_ZADAN);

            $zadania[] = [
                'id' => /* ... */,
                // ... pozostałe klucze ...
            ];

            zapiszZadania(PLIK_ZADAN, $zadania);
            // ... zadanie dodane ...
        } catch (Exception $wyjatek) {
            // ... komunikat do $bladZapisu ...
        }
    }
}

        <form method="post" action="dodaj-zadanie.php">
            <label for="tytul">Tytuł *</label>
            <input type="text" id="tytul" name="tytul" maxlength="100" required value="<?= $tytulZadania; ?>">

            <label for="opis">Opis</label>
            <textarea id="opis" name="opis" rows="3" maxlength="300"><?= $opisZadania; ?></textarea>

            <!-- termin, xp, przycisk -->
        </form>

<?php

// --- pliki aplikacji ---
require_once __DIR__ . '/config/config.php';
require_once __DIR__ . '/includes/funkcje_tekstowe.php';
require_once __DIR__ . '/includes/funkcje_zadan.php';
require_once __DIR__ . '/includes/funkcje_plikow.php';


// --- dane nowego zadania (na start puste — formularz jeszcze nie został wysłany) ---
$tytulZadania = '';
$opisZadania = '';
$terminZadania = '';
$xpZadania = '';

$bledy = [];
$bladZapisu = null;
$zadanieDodane = false;   // tylko w wersji przejściowej


// --- obsługa wysłanego formularza (POST) ---
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $tytulZadania = wyczyscTytul($_POST['tytul'] ?? '');
    $opisZadania = trim(preg_replace('/\s+/', ' ', $_POST['opis'] ?? ''));
    $terminZadania = trim($_POST['termin'] ?? '');
    $xpZadania = trim($_POST['xp'] ?? '');

    $bledy = walidujNoweZadanie($tytulZadania, $opisZadania, $terminZadania, $xpZadania);

    if (count($bledy) === 0) {
        try {
            $zadania = wczytajZadania(PLIK_ZADAN);

            $zadania[] = [
                'id' => nastepneIdZadania($zadania),
                'tytul' => $tytulZadania,
                'opis' => $opisZadania,
                'termin' => $terminZadania,
                'wykonane' => false,
                'xp' => (int) $xpZadania
            ];

            zapiszZadania(PLIK_ZADAN, $zadania);
            $zadanieDodane = true;   // tylko w wersji przejściowej
        } catch (Exception $wyjatek) {
            $bladZapisu = $wyjatek->getMessage();
        }
    }
}


// --- prezentacja ---
$nazwaStrony = 'Dodaj zadanie — TaskQuest';
require_once __DIR__ . '/includes/header.php';
?>
        <h2>Nowe zadanie</h2>
        <p><a href="index.php">← Wróć do listy zadań</a></p>

        <?php if ($zadanieDodane) { ?>
        <p class="sukces">Zadanie zostało dodane.</p>
        <?php } ?>

        <?php if (count($bledy) > 0) { ?>
        <div class="blad">
            <p>Popraw formularz:</p>
            <ul>
                <?php foreach ($bledy as $blad) { ?>
                <li><?= $blad; ?></li>
                <?php } ?>
            </ul>
        </div>
        <?php } ?>

        <?php if ($bladZapisu !== null) { ?>
        <p class="blad">Nie udało się dodać zadania: <?= $bladZapisu; ?></p>
        <?php } ?>

        <form method="post" action="dodaj-zadanie.php">
            <label for="tytul">Tytuł *</label>
            <input type="text" id="tytul" name="tytul" maxlength="100" required value="<?= $tytulZadania; ?>">

            <label for="opis">Opis</label>
            <textarea id="opis" name="opis" rows="3" maxlength="300"><?= $opisZadania; ?></textarea>

            <label for="termin">Termin *</label>
            <input type="date" id="termin" name="termin" required value="<?= $terminZadania; ?>">

            <label for="xp">Nagroda XP (1–100) *</label>
            <input type="number" id="xp" name="xp" min="1" max="100" required value="<?= $xpZadania; ?>">

            <button type="submit">Dodaj zadanie</button>
        </form>
<?php
require_once __DIR__ . '/includes/footer.php';

Klasa .sukces pojawi się w header.php w Kroku 4 — do tego czasu komunikat będzie po prostu zwykłym akapitem.

Odpowiedź na pytanie: przy uszkodzonym wierszu wczytajZadania() rzuca wyjątek. Gdyby kod mimo to zapisał listę złożoną tylko z nowego zadania, zapiszZadania() (tryb w!) skasowałaby wszystkie dotychczasowe zadania — zamiast jednego uszkodzonego wiersza Kama straciłaby cały plik. Dlatego: nie udało się wczytać → nie zapisujemy niczego.

Sprawdź: dodaj zadanie Powtórka z formularzy, termin za tydzień, 30 XP. Otwórz data/zadania.csv w edytorze — na końcu jest nowy wiersz z id 6 i wykonane = 0. Otwórz index.php — zadanie jest na liście, liczniki pokazują 6 zadań.

Krok 4 — SAMODZIELNIE: odświeżenie nie może dodać zadania drugi raz

Wróć na dodaj-zadanie.php, dodaj jeszcze jedno zadanie, a gdy zobaczysz „Zadanie zostało dodane.”, naciśnij F5 i potwierdź ponowne wysłanie. Otwórz data/zadania.csv: to samo zadanie jest dwa razy, z różnymi id. Przeglądarka po prostu powtórzyła ostatnie żądanie — a ostatnie żądanie to był POST z danymi.

Rozwiązanie to wzorzec POST → przekierowanie → GET (ang. Post/Redirect/Get, w skrócie PRG):

1. przeglądarka: POST dodaj-zadanie.php (dane)
2. PHP: zapisuje zadanie i odpowiada "idź pod adres index.php?dodano=1" (przekierowanie)
3. przeglądarka: GET index.php?dodano=1   ← to jest teraz "ostatnie żądanie"
4. F5 powtarza tylko krok 3 — czyli zwykłe wyświetlenie strony

Przekierowanie robi się tak:

header('Location: index.php?dodano=1');
exit;

• header() wysyła przeglądarce nagłówek odpowiedzi — informację „techniczną”, która idzie przed treścią strony. Nagłówek Location mówi: „tu nic nie ma, idź pod ten adres”.
• exit natychmiast kończy skrypt. Bez niego PHP wykonałby resztę pliku (wygenerowałby cały formularz), którego i tak nikt nie zobaczy.
• Nagłówki muszą być wysłane przed jakąkolwiek treścią strony. U nas logika stoi nad require_once header.php, więc to jest spełnione. Gdyby wcześniej coś zostało wypisane, PHP może zgłosić Warning: Cannot modify header information - headers already sent i przekierowanie nie zadziała. (W XAMPP-ie włączone jest buforowanie wyjścia, więc przy małej ilości tekstu ostrzeżenie może się nie pojawić — ale nie polegaj na tym.)

Skąd index.php ma wiedzieć, że ma pokazać komunikat? Z adresu — dokładnie tak, jak w 3.2 PHP dostał ?imie=Kama. Parametr dodano=1 odczytamy przez $_GET.

Zadanie — zmień cztery pliki:

1. dodaj-zadanie.php: w miejscu $zadanieDodane = true;(to usuń) wstaw przekierowanie na index.php?dodano=1 i exit. Usuń z tego pliku wszystko, co dotyczyło $zadanieDodane (wartość początkową i akapit „Zadanie zostało dodane.”) — komunikat przenosi się na stronę główną.
2. index.php:
   • w bloku wywołań funkcji, po obliczeniu streaka, dodaj nowy blok // --- parametry z adresu strony (GET) --- i w nim zmienną $zadanieDodane — true tylko wtedy, gdy w adresie jest dodano=1,
   • pod <h2>Twoje zadania</h2> dodaj link <p><a href="dodaj-zadanie.php">+ Dodaj zadanie</a></p> oraz — gdy $zadanieDodane — <p class="sukces">Zadanie zostało dodane.</p>. Oba elementy mają być przed konstrukcją if ($bladZadan !== null), żeby link działał także wtedy, gdy wczytanie zadań się nie udało.
3. includes/header.php: dodaj regułę .sukces (zielona odmiana .blad) i trzy proste reguły dla formularza (etykieta w osobnej linii, pola na całą szerokość, odstęp przycisku).
4. includes/footer.php: TaskQuest 1.3.

ROZWIĄZANIE

a) dodaj-zadanie.php — fragment w try:

            zapiszZadania(PLIK_ZADAN, $zadania);

            header('Location: index.php?dodano=1');
            exit;

b) index.php — nowy blok po $streak = aktualizujStreak(...);:

// --- parametry z adresu strony (GET) ---
$zadanieDodane = ($_GET['dodano'] ?? '') === '1';

c) index.php — prezentacja:

        <h2>Twoje zadania</h2>

        <p><a href="dodaj-zadanie.php">+ Dodaj zadanie</a></p>

        <?php if ($zadanieDodane) { ?>
        <p class="sukces">Zadanie zostało dodane.</p>
        <?php } ?>

        <?php if ($bladZadan !== null) { ?>

d) includes/header.php — w <style>, pod .blad:

.sukces { border: 1px solid #080; background: #eaf7ea; color: #060; border-radius: 8px; padding: 8px 16px; }
form label { display: block; margin-top: 12px; }
form input, form textarea { width: 100%; padding: 6px; box-sizing: border-box; }
form button { margin-top: 16px; padding: 8px 16px; }

e) includes/footer.php: <p>TaskQuest 1.3</p>.

Sprawdź: dodaj zadanie. Przeglądarka sama przechodzi na index.php?dodano=1, widać zieloną ramkę i nowe zadanie. Naciśnij F5 — brak pytania o ponowne wysłanie, w pliku nie przybyło zadań. W F12 → Sieć zobaczysz dwa żądania: POST dodaj-zadanie.php ze statusem 302 (przekierowanie) i GET index.php?dodano=1 ze statusem 200.

Uczciwie o ograniczeniu: ramka „Zadanie zostało dodane.” pojawia się po każdym odświeżeniu index.php?dodano=1, a nawet po ręcznym wpisaniu takiego adresu — mimo że nic nie dodano. Adres nie jest dobrym miejscem na jednorazowe komunikaty. Porządnie rozwiążemy to w Lekcji 14 (sesje).

6. Kolejne zadanie — widoki listy przez GET

Formularz dodawania zmienia dane, więc używa POST. Teraz coś, co tylko wybiera, co pokazać — czyli zadanie dla GET.

SAMODZIELNIE — plik projektu: index.php. Nad listą zadań dodaj trzy linki: wszystkie, aktywne, wykonane, prowadzące do index.php?filtr=wszystkie, index.php?filtr=aktywne, index.php?filtr=wykonane. Lista ma pokazywać odpowiednio wszystkie zadania, tylko niewykonane albo tylko wykonane — zawsze posortowane wg terminu. Pod linkami wypisz Widok: <nazwa widoku>.

Wymagania:

1. W bloku // --- parametry z adresu strony (GET) --- odczytaj parametr filtr do zmiennej $filtr. Brak parametru = wszystkie.
2. Każda inna wartość niż aktywne czy wykonane (np. ?filtr=abc, ?filtr=AKTYWNE, ?filtr=) ma dawać widok wszystkie. Parametr z adresu to dane od użytkownika — nie ufamy mu.
3. Do wyboru listy użyj match (znasz go z pobierzTytul()) i zapisz wynik w nowej zmiennej $zadaniaDoWyswietlenia. Brakuje posortowanej listy wykonanych — dodaj $wykonaneWgTerminu obok $aktywneWgTerminu.
4. Pętla foreach wyświetlająca listę ma przechodzić po $zadaniaDoWyswietlenia zamiast po $zadaniaWgTerminu.
5. Gdy w pliku są zadania, ale wybrany widok jest pusty (np. żadne nie jest wykonane) — wypisz Brak zadań w tym widoku.
6. Bez zmian zostają: liczniki, XP do zdobycia, komunikat o awansie i „najpilniejsze zadanie” — one zawsze dotyczą całej listy, niezależnie od widoku.

// --- parametry z adresu strony (GET) ---
$filtr = $_GET['filtr'] ?? 'wszystkie';

if (/* ani aktywne, ani wykonane */) {
    $filtr = 'wszystkie';
}

$zadaniaDoWyswietlenia = match ($filtr) {
    'wszystkie' => /* ... */,
    'aktywne' => /* ... */,
    'wykonane' => /* ... */
};

$zadanieDodane = ($_GET['dodano'] ?? '') === '1';

$wykonaneWgTerminu = sortujPoTerminie($wykonaneZadania);

// --- parametry z adresu strony (GET) ---
$filtr = $_GET['filtr'] ?? 'wszystkie';

if ($filtr !== 'aktywne' && $filtr !== 'wykonane') {
    $filtr = 'wszystkie';
}

$zadaniaDoWyswietlenia = match ($filtr) {
    'wszystkie' => $zadaniaWgTerminu,
    'aktywne' => $aktywneWgTerminu,
    'wykonane' => $wykonaneWgTerminu
};

$zadanieDodane = ($_GET['dodano'] ?? '') === '1';

        echo "<h3>Lista zadań (wg terminu)</h3>";
        echo "<p>Pokaż: <a href=\"index.php?filtr=wszystkie\">wszystkie</a> | "
            . "<a href=\"index.php?filtr=aktywne\">aktywne</a> | "
            . "<a href=\"index.php?filtr=wykonane\">wykonane</a></p>";
        echo "<p>Widok: <strong>$filtr</strong></p>";

        if ($liczbaWszystkich > 0 && count($zadaniaDoWyswietlenia) === 0) {
            echo "<p>Brak zadań w tym widoku.</p>";
        }

        foreach ($zadaniaDoWyswietlenia as $zadanie) {

7. Testy

Test 1 — walidujNoweZadanie() na granicach

BRUDNOPIS. Przewidź wynik każdego przypadku, zanim uruchomisz kod:

<?php

require_once __DIR__ . '/includes/funkcje_zadan.php';

$przypadki = [
    ['Nauka PHP', '', '2026-10-02', '20'],
    ['', '', '2026-10-02', '20'],
    [str_repeat('a', 101), '', '2026-10-02', '20'],
    [str_repeat('ą', 100), '', '2026-10-02', '20'],
    ['Nauka PHP', str_repeat('x', 301), '2026-10-02', '20'],
    ['Nauka PHP', '', '', '20'],
    ['Nauka PHP', '', '02.10.2026', '20'],
    ['Nauka PHP', '', '2026-02-29', '20'],
    ['Nauka PHP', '', '2028-02-29', '20'],
    ['Nauka PHP', '', '2026-13-01', '20'],
    ['Nauka PHP', '', '2026-10-02', '0'],
    ['Nauka PHP', '', '2026-10-02', '1'],
    ['Nauka PHP', '', '2026-10-02', '100'],
    ['Nauka PHP', '', '2026-10-02', '101'],
    ['Nauka PHP', '', '2026-10-02', 'dużo'],
    ['Nauka PHP', '', '2026-10-02', '12abc'],
    ['Nauka PHP', '', '2026-10-02', '-5'],
    ['Nauka PHP', '', '2026-10-02', '7.5'],
    ['', '', '', ''],
];

foreach ($przypadki as $numer => $dane) {
    $bledy = walidujNoweZadanie($dane[0], $dane[1], $dane[2], $dane[3]);
    echo ($numer + 1) . ". " . (count($bledy) === 0 ? "OK" : implode(' | ', $bledy)) . "<br>";
}

implode(' | ', $bledy) skleja elementy tablicy w jeden tekst, wstawiając między nie ' | ' — tylko na potrzeby testu.

Test 2 — nastepneIdZadania()

BRUDNOPIS.

(Do ostatniego przypadku dołącz w brudnopisie także config/config.php i includes/funkcje_plikow.php.)

Test 3 — dodawanie przez stronę

PLIK PROJEKTU dodaj-zadanie.php. Na czas tego testu dopisz do znacznika <form atrybut novalidate (przeglądarka nie będzie blokować wysłania), a po teście usuń go. Przed testem przywróć oryginalny data/zadania.csv z kopii.

Test 4 — dodawanie, gdy plik ma problem

PLIK DANYCH PROJEKTU. Po każdym wierszu przywróć oryginalny data/zadania.csv.

W drugim wierszu tabeli widać, po co odczyt i zapis są w jednym try.

Test 5 — widoki listy (GET)

PLIK PROJEKTU index.php. Na oryginalnym pliku z 5 zadaniami (2 wykonane, 3 aktywne):

W każdym widoku liczniki (Wszystkie: 5 | Wykonane: 2 | Aktywne: 3) i „najpilniejsze zadanie” wyglądają tak samo.

Test 6 — regresja

Uruchom obok siebie taskquest_lekcja12/index.php i nowy taskquest/index.php tego samego dnia (na oryginalnym pliku zadań). Różnice mogą być tylko cztery: link „+ Dodaj zadanie”, linia z linkami widoków, linia Widok: wszystkie i wersja w stopce (1.2 → 1.3). Liczniki, pasek, komunikaty terminów i lista — identyczne. diagnostyka.php pokazuje 12 × [OK]. Test awarii z Lekcji 12 (zmiana nazwy pliku z zadaniami) nadal daje czerwoną ramkę na stronie głównej — a link „+ Dodaj zadanie” jest nad nią.

Sprzątanie

Gdy testy przeszły:

1. usuń brudnopis.php,
2. usuń atrybut novalidate z formularza w dodaj-zadanie.php, jeśli został,
3. przywróć data/zadania.csv z kopii (5 oryginalnych zadań) — albo zostaw zadania, które naprawdę chcesz mieć w TaskQuest,
4. odśwież index.php i diagnostyka.php.

8. Obowiązkowe eksperymenty

Gdzie: wszystkie eksperymenty wykonuj w plikach projektu wskazanych przy każdym z nich. Po każdym przywróć kod do stanu z sekcji 5–6 i oryginalny data/zadania.csv.

Eksperyment 1: przeglądarka to nie strażnik

Plik projektu dodaj-zadanie.php. Bez novalidate spróbuj wysłać pusty formularz — przeglądarka nie pozwala. Teraz otwórz F12 → Elementy, kliknij pole XP i usuń z niego atrybuty min, max i required (dwuklik na atrybucie → usuń tekst). Wpisz 999 i wyślij. Kto zatrzymał złe dane? Co by się stało, gdyby w PHP nie było walidujNoweZadanie()? Sprawdź też, co zrobi strona, gdy w F12 zmienisz type="number" na type="text" i wpiszesz dużo.

Eksperyment 2: formularz wysłany metodą GET

Plik projektu dodaj-zadanie.php. Zmień method="post" na method="get" i dodaj poprawne zadanie. Co widać w pasku adresu? Czy zadanie zostało dodane? Dlaczego nie — który warunek w kodzie nie jest spełniony? Następnie zastanów się: gdyby kod sprawdzał $_GET zamiast $_POST, to czym groziłoby wysłanie komuś linku z takim adresem albo zapisanie go w zakładkach?

Eksperyment 3: match bez listy dozwolonych wartości

Plik projektu index.php. Zakomentuj if, który zamienia nieznany filtr na wszystkie, i otwórz index.php?filtr=abc. Przeczytaj pierwszą linię komunikatu: Fatal error: Uncaught UnhandledMatchError .... Czy to Exception, czy Error (Lekcja 12, sekcja 3.8)? Dlaczego nie ratuje nas żaden try? Dopisz do match przypadek default => $zadaniaWgTerminu i sprawdź jeszcze raz — działa, ale co teraz wypisze linia Widok: ... dla adresu ?filtr=abc? Które rozwiązanie jest lepsze i dlaczego?

Eksperyment 4: (int) zamiast regexa

Plik projektu includes/funkcje_zadan.php. W walidujNoweZadanie() zamień sprawdzenie XP na samo:

    if ((int) $xpZadania < 1 || (int) $xpZadania > 100) {
        $bledy[] = "XP musi być z zakresu 1–100.";
    }

Uruchom Test 1. Które przypadki zmieniły wynik? Co zostanie zapisane w pliku, jeśli ktoś wyśle 12abc? Jaki komunikat dostanie ktoś, kto wpisał dużo — i czy mówi mu prawdę?

Eksperyment 5: tekst użytkownika trafia na stronę (zapowiedź Lekcji 22)

Plik projektu dodaj-zadanie.php (z novalidate).

a) Wpisz tytuł Zadanie "PHP", termin zostaw pusty i wyślij. Formularz wraca z błędem — co jest teraz w polu tytułu? Otwórz F12 → Elementy i spójrz na atrybut value. Dlaczego tekst urwał się na cudzysłowie?

b) Bez novalidate: dodaj poprawne zadanie o tytule <b>Bardzo</b> ważne. Otwórz stronę główną. Jak wygląda tytuł na liście? Przeglądarka potraktowała tekst od użytkownika jak kod HTML. Pogrubienie jest niewinne — ale w to samo miejsce ktoś mógłby wpisać znaczniki, które zmieniają wygląd całej strony albo uruchamiają skrypt. To się nazywa wstrzykiwanie HTML (a w wersji ze skryptem — XSS) i naprawimy to funkcją htmlspecialchars() w Lekcji 22.

Po eksperymencie usuń to zadanie z pliku (przywróć kopię).

Eksperyment 6 (dodatkowy): po co exit?

Plik projektu dodaj-zadanie.php. Usuń exit; spod header(...), a pod header(...) dopisz tymczasowo file_put_contents(__DIR__ . '/po_przekierowaniu.txt', 'wykonano');. Dodaj zadanie. Przekierowanie działa — a czy plik po_przekierowaniu.txt powstał? Co to mówi o tym, co robi header(), a czego nie robi? Przywróć exit; i usuń dopisaną linię oraz plik.

9. ROZWIĄZANIE

function nastepneIdZadania(array $zadania): int
{
    $najwiekszeId = 0;

    foreach ($zadania as $zadanie) {
        if ($zadanie['id'] > $najwiekszeId) {
            $najwiekszeId = $zadanie['id'];
        }
    }

    return $najwiekszeId + 1;
}


function walidujNoweZadanie(string $tytulZadania, string $opisZadania, string $terminZadania, string $xpZadania): array
{
    $bledy = [];

    if ($tytulZadania === '') {
        $bledy[] = "Tytuł jest wymagany.";
    } elseif (mb_strlen($tytulZadania) > 100) {
        $bledy[] = "Tytuł może mieć najwyżej 100 znaków.";
    }

    if (mb_strlen($opisZadania) > 300) {
        $bledy[] = "Opis może mieć najwyżej 300 znaków.";
    }

    if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $terminZadania)) {
        $bledy[] = "Termin musi być datą w formacie RRRR-MM-DD.";
    } else {
        $czesciDaty = explode('-', $terminZadania);

        if (!checkdate((int) $czesciDaty[1], (int) $czesciDaty[2], (int) $czesciDaty[0])) {
            $bledy[] = "Taki dzień nie istnieje w kalendarzu.";
        }
    }

    if (!preg_match('/^\d+$/', $xpZadania)) {
        $bledy[] = "XP musi być liczbą całkowitą.";
    } elseif ((int) $xpZadania < 1 || (int) $xpZadania > 100) {
        $bledy[] = "XP musi być z zakresu 1–100.";
    }

    return $bledy;
}

<?php

// --- pliki aplikacji ---
require_once __DIR__ . '/config/config.php';
require_once __DIR__ . '/includes/funkcje_tekstowe.php';
require_once __DIR__ . '/includes/funkcje_zadan.php';
require_once __DIR__ . '/includes/funkcje_plikow.php';


// --- dane nowego zadania (na start puste — formularz jeszcze nie został wysłany) ---
$tytulZadania = '';
$opisZadania = '';
$terminZadania = '';
$xpZadania = '';

$bledy = [];
$bladZapisu = null;


// --- obsługa wysłanego formularza (POST) ---
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $tytulZadania = wyczyscTytul($_POST['tytul'] ?? '');
    $opisZadania = trim(preg_replace('/\s+/', ' ', $_POST['opis'] ?? ''));
    $terminZadania = trim($_POST['termin'] ?? '');
    $xpZadania = trim($_POST['xp'] ?? '');

    $bledy = walidujNoweZadanie($tytulZadania, $opisZadania, $terminZadania, $xpZadania);

    if (count($bledy) === 0) {
        try {
            $zadania = wczytajZadania(PLIK_ZADAN);

            $zadania[] = [
                'id' => nastepneIdZadania($zadania),
                'tytul' => $tytulZadania,
                'opis' => $opisZadania,
                'termin' => $terminZadania,
                'wykonane' => false,
                'xp' => (int) $xpZadania
            ];

            zapiszZadania(PLIK_ZADAN, $zadania);

            header('Location: index.php?dodano=1');
            exit;
        } catch (Exception $wyjatek) {
            $bladZapisu = $wyjatek->getMessage();
        }
    }
}


// --- prezentacja ---
$nazwaStrony = 'Dodaj zadanie — TaskQuest';
require_once __DIR__ . '/includes/header.php';
?>
        <h2>Nowe zadanie</h2>
        <p><a href="index.php">← Wróć do listy zadań</a></p>

        <?php if (count($bledy) > 0) { ?>
        <div class="blad">
            <p>Popraw formularz:</p>
            <ul>
                <?php foreach ($bledy as $blad) { ?>
                <li><?= $blad; ?></li>
                <?php } ?>
            </ul>
        </div>
        <?php } ?>

        <?php if ($bladZapisu !== null) { ?>
        <p class="blad">Nie udało się dodać zadania: <?= $bladZapisu; ?></p>
        <?php } ?>

        <form method="post" action="dodaj-zadanie.php">
            <label for="tytul">Tytuł *</label>
            <input type="text" id="tytul" name="tytul" maxlength="100" required value="<?= $tytulZadania; ?>">

            <label for="opis">Opis</label>
            <textarea id="opis" name="opis" rows="3" maxlength="300"><?= $opisZadania; ?></textarea>

            <label for="termin">Termin *</label>
            <input type="date" id="termin" name="termin" required value="<?= $terminZadania; ?>">

            <label for="xp">Nagroda XP (1–100) *</label>
            <input type="number" id="xp" name="xp" min="1" max="100" required value="<?= $xpZadania; ?>">

            <button type="submit">Dodaj zadanie</button>
        </form>
<?php
require_once __DIR__ . '/includes/footer.php';

<?php

// --- pliki aplikacji ---
require_once __DIR__ . '/config/config.php';
require_once __DIR__ . '/includes/funkcje_grywalizacji.php';
require_once __DIR__ . '/includes/funkcje_tekstowe.php';
require_once __DIR__ . '/includes/funkcje_terminow.php';
require_once __DIR__ . '/includes/funkcje_zadan.php';
require_once __DIR__ . '/includes/funkcje_plikow.php';


// --- dane użytkownika ---
$imieUzytkownika = "Kama";
$login = "Kama_2026";


// --- dane zadań (z pliku CSV) ---
$zadania = [];
$bladZadan = null;

try {
    $zadania = wczytajZadania(PLIK_ZADAN);
} catch (Exception $wyjatek) {
    $bladZadan = $wyjatek->getMessage();
}


// --- dane grywalizacji (symulowane) ---
$xp = 99;
$streak = 5;
$dataOstatniejAktywnosci = "2026-09-14";


// --- wywołania funkcji: grywalizacja ---
$poziom = obliczPoziom($xp);
$tytul = pobierzTytul($poziom);
$xpWAktualnymPoziomie = obliczXpWAktualnymPoziomie($xp, $poziom);
$procentPostepu = obliczProcentPostepu($xpWAktualnymPoziomie);
$brakujeXp = ileBrakujeXp($xp, $poziom);

//pasek postępu
$liczbaAktywnychSegmentow = (int) ($procentPostepu / 10);
$progNastepnegoPoziomu = $poziom * XP_NA_POZIOM;


// --- wywołania funkcji: lista zadań ---
$wykonaneZadania = pobierzWykonaneZadania($zadania);
$aktywneZadania = pobierzAktywneZadania($zadania);

$liczbaWszystkich = count($zadania);
$liczbaWykonanych = count($wykonaneZadania);
$liczbaAktywnych = count($aktywneZadania);

$xpDoZdobycia = sumujXp($aktywneZadania);

$zadaniaWgTerminu = sortujPoTerminie($zadania);
$aktywneWgTerminu = sortujPoTerminie($aktywneZadania);
$wykonaneWgTerminu = sortujPoTerminie($wykonaneZadania);

// uproszczenie (symulacja): aktywność = wykonane jakiekolwiek zadanie z listy
$zadanieWykonane = $liczbaWykonanych > 0;

$streak = aktualizujStreak($streak, $dataOstatniejAktywnosci, $zadanieWykonane);


// --- parametry z adresu strony (GET) ---
$filtr = $_GET['filtr'] ?? 'wszystkie';

if ($filtr !== 'aktywne' && $filtr !== 'wykonane') {
    $filtr = 'wszystkie';
}

$zadaniaDoWyswietlenia = match ($filtr) {
    'wszystkie' => $zadaniaWgTerminu,
    'aktywne' => $aktywneWgTerminu,
    'wykonane' => $wykonaneWgTerminu
};

$zadanieDodane = ($_GET['dodano'] ?? '') === '1';


// --- prezentacja ---
$nazwaStrony = 'TaskQuest';
require_once __DIR__ . '/includes/header.php';
?>
        <p>Zdobywaj punkty za wykonane zadania!</p>

        <?php
        if (walidujLogin($login)) {
            echo "<p>Login poprawny: $login</p>";
        } else {
            echo "<p>Login jest niepoprawny.</p>";
        }
        ?>

        <h2>Witaj, <?= $imieUzytkownika; ?>!</h2>

        <p>Poziom: <strong><?= $poziom; ?></strong></p>
        <p>Tytuł: <strong><?= $tytul; ?></strong></p>
        <p>Łączne XP: <strong><?= $xp; ?></strong></p>

        <h3>
            <?= "Masz $xpWAktualnymPoziomie XP z " . XP_NA_POZIOM . " XP potrzebnych do poziomu " . ($poziom + 1) . " (" . round($procentPostepu, 2) . "%)"; ?>
        </h3>

        <div class="pasek-xp">
            <?php
            for ($segment = 1; $segment <= 10; $segment++) {
                if ($segment <= $liczbaAktywnychSegmentow) {
                    echo "█";
                } else {
                    echo "░";
                }
            }
            ?>
        </div>

        <p>Kolejny próg: <?= $progNastepnegoPoziomu; ?> XP</p>
        <p>Brakuje XP: <strong><?= $brakujeXp; ?></strong></p>
        <p>Streak: <strong><?= $streak ?></strong></p>

        <h2>Twoje zadania</h2>

        <p><a href="dodaj-zadanie.php">+ Dodaj zadanie</a></p>

        <?php if ($zadanieDodane) { ?>
        <p class="sukces">Zadanie zostało dodane.</p>
        <?php } ?>

        <?php if ($bladZadan !== null) { ?>
        <p class="blad">Nie udało się wczytać zadań: <?= $bladZadan; ?></p>
        <?php } else { ?>

        <p>
            Wszystkie: <strong><?= $liczbaWszystkich; ?></strong> |
            Wykonane: <strong><?= $liczbaWykonanych; ?></strong> |
            Aktywne: <strong><?= $liczbaAktywnych; ?></strong>
        </p>
        <p>XP do zdobycia z aktywnych zadań: <strong><?= $xpDoZdobycia; ?></strong></p>

        <?php
        if ($liczbaWszystkich === 0) {
            echo "<p>Brak zadań.</p>";
        } elseif ($liczbaAktywnych === 0) {
            echo "<p>Wszystkie zadania wykonane — świetna robota!</p>";
        } else {
            if ($xpDoZdobycia >= $brakujeXp) {
                echo "<p class=\"awans\">Wykonując aktywne zadania, awansujesz na poziom " . ($poziom + 1) . "!</p>";
            } else {
                echo "<p>Aktywne zadania nie wystarczą jeszcze na awans — brakuje " . ($brakujeXp - $xpDoZdobycia) . " XP.</p>";
            }

            $najpilniejsze = $aktywneWgTerminu[0];
            echo "<p>Najpilniejsze zadanie: <strong>" . wyczyscTytul($najpilniejsze['tytul']) . "</strong> — "
                . komunikatTerminu($najpilniejsze['termin']) . "</p>";
        }

        echo "<h3>Lista zadań (wg terminu)</h3>";
        echo "<p>Pokaż: <a href=\"index.php?filtr=wszystkie\">wszystkie</a> | "
            . "<a href=\"index.php?filtr=aktywne\">aktywne</a> | "
            . "<a href=\"index.php?filtr=wykonane\">wykonane</a></p>";
        echo "<p>Widok: <strong>$filtr</strong></p>";

        if ($liczbaWszystkich > 0 && count($zadaniaDoWyswietlenia) === 0) {
            echo "<p>Brak zadań w tym widoku.</p>";
        }

        foreach ($zadaniaDoWyswietlenia as $zadanie) {
            $tytulCzysty = wyczyscTytul($zadanie['tytul']);
            $znacznik = $zadanie['wykonane'] ? "[X]" : "[ ]";
            $klasa = $zadanie['wykonane'] ? "zadanie wykonane" : "zadanie";

            echo "<div class=\"$klasa\">";
            echo "<p><strong>$znacznik $tytulCzysty</strong> — {$zadanie['xp']} XP</p>";
            echo "<p>" . skrocOpis($zadanie['opis'], 50) . "</p>";
            echo "<p>Termin: {$zadanie['termin']}";

            if (!$zadanie['wykonane']) {
                echo " — " . komunikatTerminu($zadanie['termin']);
            }

            echo "</p>";

            if (stripos($tytulCzysty, 'PHP') !== false) {
                echo "<p>To zadanie dotyczy PHP.</p>";
            }

            echo "</div>";
        }
        ?>
        <?php } ?>
<?php
require_once __DIR__ . '/includes/footer.php';

<!DOCTYPE html>
<html lang="pl">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title><?= $nazwaStrony; ?></title>
    <style>
        body { font-family: Arial, sans-serif; max-width: 700px; margin: 40px auto; padding: 20px; }
        .panel { border: 1px solid #ccc; padding: 24px; border-radius: 12px; }
        .pasek-xp { display: flex; gap: 4px; margin: 10px 0; }
        .segment { width: 32px; height: 18px; background: #ddd; border-radius: 3px; }
        .segment.aktywny { background: #555; }
        .awans { font-weight: bold; }
        .zadanie { border: 1px solid #ddd; border-radius: 8px; padding: 4px 16px; margin: 10px 0; }
        .zadanie.wykonane { background: #f2f2f2; color: #666; }
        .blad { border: 1px solid #c00; background: #fdecec; color: #900; border-radius: 8px; padding: 8px 16px; }
        .sukces { border: 1px solid #080; background: #eaf7ea; color: #060; border-radius: 8px; padding: 8px 16px; }
        form label { display: block; margin-top: 12px; }
        form input, form textarea { width: 100%; padding: 6px; box-sizing: border-box; }
        form button { margin-top: 16px; padding: 8px 16px; }
    </style>
</head>
<body>
    <div class="panel">
        <h1>TaskQuest</h1>

        <p>TaskQuest 1.3</p>
    </div>
</body>
</html>

10. Co zmieniliśmy w TaskQuest?

Zostaje

$imieUzytkownika, $login
$xp, $poziom, $tytul, $xpWAktualnymPoziomie, $procentPostepu, $brakujeXp,
$liczbaAktywnychSegmentow, $progNastepnegoPoziomu
$streak, $dataOstatniejAktywnosci, $zadanieWykonane
$zadania, $bladZadan, $wykonaneZadania, $aktywneZadania, $liczbaWszystkich, $liczbaWykonanych,
$liczbaAktywnych, $zadaniaWgTerminu, $aktywneWgTerminu, $xpDoZdobycia
$nazwaStrony
define('XP_NA_POZIOM', 100), define('PLIK_ZADAN', ...)

wszystkie funkcje z Lekcji 1–12 — kod bez zmian
struktura tablicy $zadania (klucze: id, tytul, opis, termin, wykonane, xp)
format data/zadania.csv
obsługa awarii wczytania zadań w index.php (try/catch, ramka .blad)

Dochodzi

// index.php
$wykonaneWgTerminu        // sortujPoTerminie($wykonaneZadania)
$filtr                    // widok listy z $_GET['filtr']: 'wszystkie' | 'aktywne' | 'wykonane' (inne wartości → 'wszystkie')
$zadaniaDoWyswietlenia    // lista wybrana przez match ($filtr)
$zadanieDodane            // bool: czy w adresie jest dodano=1

// dodaj-zadanie.php (nowy plik)
$tytulZadania, $opisZadania, $terminZadania, $xpZadania   // dane nowego zadania z formularza (teksty, oczyszczone)
$bledy                    // tablica komunikatów z walidujNoweZadanie()
$bladZapisu               // null albo komunikat wyjątku z wczytajZadania()/zapiszZadania()

// includes/funkcje_zadan.php
nastepneIdZadania()       // największe id + 1 (dla pustej listy 1)
walidujNoweZadanie()      // zwraca tablicę komunikatów o błędach (pusta = dane poprawne)

// includes/header.php
.sukces, form label, form input, form textarea, form button

Nowe narzędzia PHP i HTML: <form method action>, <input type="text|date|number">, <textarea>, <label for>, atrybuty name, required, min, max, maxlength, novalidate; $_GET, $_POST, $_SERVER['REQUEST_METHOD'], operator ??, checkdate(), header('Location: ...') + exit, wzorzec POST → przekierowanie → GET, match na liście dozwolonych wartości.

Zmieniamy

• index.php: link „+ Dodaj zadanie” i komunikat o dodaniu pod <h2>Twoje zadania</h2>; nowy blok „parametry z adresu strony (GET)”; pętla listy przechodzi po $zadaniaDoWyswietlenia zamiast po $zadaniaWgTerminu; nad listą linki widoków, linia Widok: ... i komunikat o pustym widoku,
• includes/header.php: nowe reguły CSS,
• includes/footer.php: TaskQuest 1.3,
• diagnostyka.php: 12 wymaganych plików,
• zapiszZadania() — kod bez zmian, ale pierwszy raz jest wywoływana ze strony aplikacji (w try / catch, razem z wczytajZadania()).

Usuwamy

Nic. Żadna zmienna ani funkcja z Lekcji 12 nie została usunięta. $zadaniaWgTerminu nadal istnieje — jest jedną z list, spośród których wybiera match.

Co nowego potrafi TaskQuest po tej lekcji?

Po Lekcji 13 TaskQuest przyjmuje zadania od użytkownika. Na stronie dodaj-zadanie.php jest formularz, którego dane PHP sprawdza sam (nie ufając przeglądarce), pokazuje wszystkie błędy naraz i nie każe wpisywać wszystkiego od nowa. Poprawne zadanie dostaje unikalne id i jest dopisywane do data/zadania.csv — ale tylko wtedy, gdy plik udało się poprawnie wczytać, więc uszkodzony plik nie zostanie nadpisany. Po zapisie aplikacja przekierowuje na stronę główną, dzięki czemu odświeżenie nie dodaje zadania drugi raz. Lista zadań ma trzy widoki (wszystkie, aktywne, wykonane) wybierane przez adres strony.

Do samodzielnego sprawdzenia

[ ] Nadal rozwijam ten sam projekt TaskQuest (nie zaczynam nowego).
[ ] Potrafię wyjaśnić, czym różni się żądanie GET od POST i gdzie jadą dane w każdym z nich.
[ ] Wiem, że atrybut name pola staje się kluczem w $_GET / $_POST, a wartości zawsze są tekstami.
[ ] Potrafię odróżnić pierwsze wejście od wysłania formularza ($_SERVER['REQUEST_METHOD']).
[ ] Używam ??, żeby nie sięgać po nieistniejące klucze.
[ ] Wiem, dlaczego required/min/max nie zastępują sprawdzania w PHP.
[ ] Wiem, dlaczego błędy w formularzu to tablica komunikatów, a awaria pliku — wyjątek.
[ ] Mam walidujNoweZadanie() i nastepneIdZadania() w funkcje_zadan.php; Test 1 i Test 2 się zgadzają.
[ ] dodaj-zadanie.php zachowuje wpisane dane po błędzie i pokazuje wszystkie błędy naraz.
[ ] Odczyt i zapis są w jednym try — uszkodzony plik nie zostaje nadpisany (Test 4).
[ ] Po dodaniu zadania następuje przekierowanie; F5 nie dodaje zadania drugi raz.
[ ] index.php ma trzy widoki listy; nieznany filtr daje widok "wszystkie" bez błędów (Test 5).
[ ] diagnostyka.php pokazuje 12 razy [OK]; strona główna jak po Lekcji 12 (Test 6).
[ ] Wiem, jaki problem pokazał Eksperyment 5 i w której lekcji go naprawimy.
[ ] Usunęłam/usunąłem brudnopis.php i novalidate; plik zadań ma zawartość, którą chcę zachować.

Pytania kontrolne

1. Wpisujesz w formularzu (metoda GET) Kama w pole z name="imie" i id="pole1". Jak wygląda adres po wysłaniu i jaki klucz pojawi się w $_GET? Co się zmieni, gdy usuniesz z pola atrybut name?

2. Przewidź wynik każdej linii, gdy strona została otwarta zwykłym wejściem (bez formularza i bez niczego w adresie):echo $_SERVER['REQUEST_METHOD'];
echo $_POST['tytul'] ?? 'brak';
echo ($_GET['dodano'] ?? '') === '1' ? 'tak' : 'nie';
var_dump($_POST);
Pole xp ma type="number" i min="1". Podaj dwa sposoby, w jakie użytkownik może mimo to wysłać xp=-50. Która część TaskQuest go zatrzyma?

3. Dlaczego sprawdzamy XP regexem /^\d+$/ przed porównaniem z zakresem? Co zapisałby TaskQuest dla 12abc, a jaki komunikat zobaczyłby użytkownik dla dużo, gdyby regexa nie było?

4. Dlaczego walidujNoweZadanie() zwraca tablicę komunikatów, a nie rzuca wyjątku przy pierwszym błędzie — skoro w sprawdzWierszZadania() wyjątek był dobrym pomysłem?

5. W dodaj-zadanie.php wywołania wczytajZadania() i zapiszZadania() są w jednym bloku try. Opisz krok po kroku, co stałoby się z plikiem zawierającym jeden uszkodzony wiersz, gdyby przy awarii odczytu kod przyjął pustą listę i mimo to zapisał nowe zadanie.

6. Dlaczego nastepneIdZadania() szuka największego id, zamiast liczyć count($zadania) + 1? Podaj przykład listy, dla której te dwa sposoby dają różny wynik.

7. Co się dzieje po kliknięciu „Dodaj zadanie” — wymień po kolei żądania, które widać w F12 → Sieć, z ich metodami i statusami. Dlaczego po tym F5 nie dodaje zadania ponownie?

8. Dlaczego filtr listy zadań przekazujemy przez GET, a dodawanie zadania przez POST? Co mogłoby się stać, gdyby dodawanie działało przez link w stylu dodaj-zadanie.php?tytul=...&xp=...?

9. W index.php wartość $filtr pochodzi od użytkownika, a mimo to wypisujemy ją na stronie bez obaw. Dlaczego jest bezpieczna? Czy to samo można powiedzieć o tytule zadania dodanym przez formularz (Eksperyment 5)?

10. Komunikat „Zadanie zostało dodane.” można wywołać, wpisując ręcznie index.php?dodano=1. Dlaczego? Jakiego mechanizmu brakuje, żeby komunikat był naprawdę jednorazowy?

Zadanie końcowe — rozbuduj TaskQuest samodzielnie

Wybierz jedno (albo oba):

A) „Zrobione!” — oznaczanie zadania jako wykonanego. Przy każdym niewykonanym zadaniu na liście w index.php dodaj mały formularz z jednym przyciskiem „Zrobione” (metoda POST, action="oznacz-wykonane.php") i ukrytym polem <input type="hidden" name="id" value="..."> z id zadania. Utwórz stronę oznacz-wykonane.php, która:

1. przyjmuje tylko żądania POST (dla GET od razu przekierowuje na index.php),
2. sprawdza, czy id składa się z samych cyfr,
3. w try: wczytuje zadania, znajduje zadanie o tym id (pętla foreach z kluczem: foreach ($zadania as $klucz => $zadanie)), ustawia mu 'wykonane' => true przez $zadania[$klucz]['wykonane'] = true;, zapisuje plik i przekierowuje na index.php?wykonano=1,
4. gdy zadania o takim id nie ma albo wystąpi wyjątek — pokazuje czytelny komunikat i link powrotny.

Na stronie głównej dodaj komunikat „Zadanie oznaczone jako wykonane.” (analogicznie do dodano=1). Pytania do przemyślenia: dlaczego przycisk to formularz POST, a nie link oznacz-wykonane.php?id=3? Czy ukryte pole jest naprawdę ukryte przed użytkownikiem (sprawdź w F12)? Co się stanie, gdy ktoś wyśle id nieistniejącego zadania? Nie zmieniaj $xp użytkownika — XP jest nadal symulowane, a przyznawanie nagrody wróci razem z bazą danych.

B) Wyszukiwarka. Nad listą zadań w index.php dodaj formularz wyszukiwania (metoda GET, pole name="szukaj"). Lista ma pokazywać tylko te zadania z bieżącego widoku, których oczyszczony tytuł zawiera wpisane słowo — bez względu na wielkość liter (stripos() znasz z Lekcji 8). Wymagania: puste pole = brak filtrowania; po wyszukaniu słowo zostaje w polu; wyszukiwanie ma działać razem z widokiem (np. aktywne + „PHP”) — podpowiedź: ukryte pole <input type="hidden" name="filtr" value="..."> w formularzu wyszukiwania. Dlaczego tu GET jest lepszy niż POST? Sprawdź: czy adres z wynikami wyszukiwania można zapisać w zakładkach? Uwaga: wpisane słowo wraca na stronę (w polu i ewentualnie w komunikacie) — pamiętaj o Eksperymencie 5.

Nie potrzebujesz niczego, czego nie poznałaś/poznałeś do tej pory.

Most do Lekcji 14

TaskQuest przyjmuje już dane od użytkownika. Ale każda strona nadal działa „w próżni”: skrypt kończy się po wysłaniu odpowiedzi i niczego nie pamięta. Stąd nasze obejścia:

"Zadanie zostało dodane."   →  przekazane w adresie (?dodano=1) — widać je po każdym odświeżeniu i każdy może je "podrobić"
$imieUzytkownika, $login     →  wpisane na sztywno w index.php — TaskQuest nie wie, KTO z niego korzysta
wybrany widok listy          →  znika, gdy wejdziesz na stronę bez ?filtr=...

Potrzebujemy sposobu, żeby aplikacja pamiętała coś między kolejnymi żądaniami tego samego użytkownika — jego login, jednorazowy komunikat, ulubiony widok. To temat Lekcji 14: cookies i sesje.

1. ['filtr' => 'aktywne', 'strona' => '2'] — tablica asocjacyjna, w której obie wartości są tekstami (również '2').
2. (brak). Pole bez atrybutu name w ogóle nie zostaje wysłane, więc klucza tytul w $_POST nie ma; ?? podstawia wartość domyślną.
3. string(0) "". Klucz xp istnieje (pole zostało wysłane, tylko puste), więc ?? się nie uruchamia. Pustkę trzeba sprawdzić osobno, np. trim($_POST['xp'] ?? '') === ''.
4. if (isset($_POST['zgoda'])) (lub if (($_POST['zgoda'] ?? '') === 'tak')). Niezaznaczony checkbox nie wysyła nic, więc odwołanie do $_POST['zgoda'] da Warning: Undefined array key.
5. Nazwa musi być tablicowa: name="gatunek[]" w każdym polu. Wtedy w $_POST['gatunek'] będzie tablica zaznaczonych wartości (a przy braku zaznaczeń — klucza nie będzie wcale).
6. <textarea> nie ma atrybutu value. Wartość wpisuje się między znacznikami: <textarea name="opis" rows="3"><?= $opisZadania ?></textarea>.
7. Dla 12abc (int) da 12 — kod uzna dane za poprawne i zapisze 12 XP, choć użytkownik wpisał śmieci. Dla dużo da 0 — użytkownik zobaczy komunikat o zakresie 1–100, mimo że nie wpisał żadnej liczby. Naprawa: najpierw sprawdzić format regexem preg_match('/^\d+$/', $xp), dopiero potem zakres.
8. $_SERVER['REQUEST_METHOD'] === 'POST'.
9. a) GET — tylko czytanie, adres z wynikami da się zapisać w zakładkach i wysłać; b) POST — zmienia dane w pliku; c) POST — hasło w adresie trafiłoby do historii przeglądarki i logów serwera; d) GET — to wybór, co pokazać, niczego nie zmienia.
10. require_once 'includes/header.php' wypisało już HTML, a nagłówki muszą pójść przed treścią. PHP zgłosi Warning: Cannot modify header information – headers already sent. Przekierowanie musi znaleźć się przed dołączeniem nagłówka strony.
11. Wzorca POST → przekierowanie → GET. Po udanym zapisie: header('Location: index.php?dodano=1'); exit; Ostatnim żądaniem staje się wtedy zwykłe GET, więc F5 tylko wyświetla stronę.
12. Np. dopisać do <form> atrybut novalidate, usunąć min i required w F12 → Elementy, albo wysłać żądanie bez przeglądarki (np. curl). Zatrzyma go dopiero sprawdzenie w PHP (walidujNoweZadanie()).
13. Przykładowe rozwiązanie: <?php $szukane = trim($_GET['szukaj'] ?? ''); if ($szukane !== '') { echo "<p>Szukasz: $szukane</p>"; } else { echo "<p>Wpisz szukane słowo.</p>"; } ?> <form method="get" action="szukaj.php"> <input type="text" name="szukaj" value="<?= $szukane ?>"> <button type="submit">Szukaj</button> </form> Formularz wysyłany metodą GET, więc fraza zostaje w adresie (szukaj.php?szukaj=PHP) i wraca do pola przez value.
14. <form method="post"> — „metoda bezpieczna” to POST, a brak atrybutu action oznacza wysłanie do tego samego pliku (można też napisać action="" albo wprost nazwę pliku, np. action="index.php").