Tablica asocjacyjna w PHP - przykłady, foreach, JSON i formularze

Tablica asocjacyjna w PHP to tablica, w której wartości są przypisane do nazwanych kluczy, a nie tylko do kolejnych numerów indeksów. Dzięki temu można przechowywać dane w bardziej czytelnej formie, np. dane użytkownika, ustawienia strony, produkt w sklepie, konfigurację formularza albo odpowiedź z API. W praktyce tablice asocjacyjne są jednym z najczęściej używanych elementów PHP, szczególnie w CMS-ach, aplikacjach webowych, formularzach, pracy z bazą danych i przetwarzaniu danych JSON. Warto dobrze rozumieć, czym różnią się od zwykłych tablic indeksowanych, jak odczytywać wartości po kluczu, jak dodawać elementy, jak sprawdzać istnienie klucza i jak unikać typowych błędów.

Czym jest tablica asocjacyjna w PHP?

Tablica asocjacyjna w PHP to struktura danych, w której każda wartość ma przypisany klucz. Klucz jest nazwą, pod którą można odczytać daną wartość. W zwykłej tablicy indeksowanej elementy mają najczęściej numery: 0, 1, 2, 3. W tablicy asocjacyjnej elementy mogą mieć klucze opisowe, np. name, email, price, status, role.

Przykład prostej tablicy asocjacyjnej:

<?php

$user = [
    "name" => "Anna",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ",
    "age" => 28,
    "active" => true
];

?>

Taka tablica jest czytelna nawet bez dodatkowego komentarza. Od razu widać, że przechowuje dane użytkownika: imię, e-mail, wiek i informację, czy konto jest aktywne.

W PHP tablica asocjacyjna jest bardzo elastyczna. Wartości mogą być tekstami, liczbami, wartościami logicznymi, null, obiektami, a nawet innymi tablicami. Dlatego tablice asocjacyjne są używane zarówno w prostych skryptach, jak i w większych aplikacjach.

Tablica indeksowana a tablica asocjacyjna - różnice

Najprostsza różnica polega na sposobie odwoływania się do wartości. W tablicy indeksowanej używamy numerów, a w tablicy asocjacyjnej nazwanych kluczy.

Tablica indeksowana:

<?php

$colors = ["czerwony", "zielony", "niebieski"];

echo $colors[0]; // czerwony

?>

Tablica asocjacyjna:

<?php

$product = [
    "name" => "Laptop",
    "price" => 3500,
    "currency" => "PLN"
];

echo $product["name"]; // Laptop

?>

Tablica indeksowana jest dobra, gdy mamy listę podobnych wartości, np. listę kolorów, kategorii, tagów albo identyfikatorów. Tablica asocjacyjna jest lepsza, gdy pojedynczy element ma opisane właściwości, np. produkt ma nazwę, cenę i walutę, a użytkownik ma imię, e-mail i rolę.

Tworzenie tablicy asocjacyjnej w PHP

Najczęściej tablicę asocjacyjną tworzy się za pomocą krótkiej składni z nawiasami kwadratowymi. Starsza składnia array() nadal działa, ale w nowoczesnym kodzie częściej spotyka się zapis [].

Krótka składnia tablicy

<?php

$user = [
    "id" => 10,
    "name" => "Jan",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 "
];

?>

Starsza składnia array()

<?php

$user = array(
    "id" => 10,
    "name" => "Jan",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 "
);

?>

Oba zapisy tworzą tę samą strukturę. W nowych projektach zwykle lepiej stosować krótszy zapis, bo jest bardziej czytelny.

Klucze tekstowe i liczbowe

W PHP kluczem tablicy może być liczba całkowita albo tekst. W tablicach asocjacyjnych najczęściej stosuje się klucze tekstowe.

<?php

$data = [
    "title" => "Artykuł o PHP",
    "views" => 1200,
    "published" => true
];

?>

Warto używać nazw kluczy, które jasno opisują zawartość. Lepiej zapisać "product_name" albo "name" niż skrót typu "n", jeżeli nie wynika on z ustalonego standardu.

Odczyt wartości po kluczu

Wartość z tablicy asocjacyjnej odczytuje się przez podanie nazwy klucza w nawiasach kwadratowych.

<?php

$user = [
    "name" => "Anna",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 "
];

echo $user["name"];  // Anna
echo $user["email"]; // 
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 

?>

Jeżeli spróbujesz odczytać klucz, który nie istnieje, PHP może zgłosić ostrzeżenie typu "Undefined array key". Dlatego w praktyce warto sprawdzać, czy klucz istnieje, szczególnie gdy dane pochodzą od użytkownika, z formularza, API lub bazy danych.

Błędny lub ryzykowny przykład:

<?php

echo $user["phone"];

?>

Jeżeli klucz phone nie istnieje, kod może wygenerować ostrzeżenie.

Bezpieczniejszy przykład z operatorem null coalescing:

<?php

$phone = $user["phone"] ?? "brak telefonu";

echo $phone;

?>

Operator ?? oznacza: użyj wartości z tablicy, jeśli istnieje i nie jest null, a w przeciwnym razie użyj wartości domyślnej.

Dodawanie i zmiana elementów w tablicy asocjacyjnej

Do tablicy asocjacyjnej można łatwo dodać nowy element, przypisując wartość do nowego klucza.

<?php

$user = [
    "name" => "Anna",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 "
];

$user["role"] = "admin";

?>

Po takim przypisaniu tablica zawiera dodatkowy klucz role.

Zmiana istniejącej wartości wygląda tak samo:

<?php

$user["email"] = "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ";

?>

Można też usuwać elementy za pomocą unset():

<?php

unset($user["role"]);

?>

To przydatne np. wtedy, gdy chcemy usunąć z tablicy dane techniczne, hasło, token albo pole, którego nie powinno się zwracać w odpowiedzi API.

Sprawdzanie, czy klucz istnieje

W PHP do sprawdzania kluczy najczęściej używa się isset(), array_key_exists() albo operatora ??. Te rozwiązania są podobne, ale nie identyczne.

isset()

isset() sprawdza, czy zmienna lub element tablicy istnieje i nie ma wartości null.

<?php

$user = [
    "name" => "Anna",
    "phone" => null
];

var_dump(isset($user["name"]));  // true
var_dump(isset($user["phone"])); // false

?>

Klucz phone istnieje, ale ma wartość null, dlatego isset() zwraca false.

array_key_exists()

array_key_exists() sprawdza, czy klucz istnieje w tablicy, nawet jeśli jego wartością jest null.

<?php

$user = [
    "name" => "Anna",
    "phone" => null
];

var_dump(array_key_exists("name", $user));  // true
var_dump(array_key_exists("phone", $user)); // true

?>

To ważna różnica. Jeżeli musisz odróżnić "klucz nie istnieje" od "klucz istnieje, ale ma wartość null", użyj array_key_exists().

Operator ??

W codziennej pracy bardzo wygodny jest operator ??, który pozwala szybko ustawić wartość domyślną.

<?php

$name = $user["name"] ?? "Gość";
$phone = $user["phone"] ?? "brak telefonu";

?>

Pętla foreach i przechodzenie po tablicy asocjacyjnej

Do przechodzenia po tablicach asocjacyjnych najczęściej używa się pętli foreach. Pozwala ona odczytać zarówno klucz, jak i wartość.

<?php

$user = [
    "name" => "Anna",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ",
    "role" => "admin"
];

foreach ($user as $key => $value) {
    echo $key . ": " . $value . "<br>";
}

?>

Wynik może wyglądać tak:

name: Anna
email: 
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 
role: admin

Pętla foreach jest szczególnie przydatna, gdy nie wiemy z góry, ile elementów ma tablica albo chcemy wygenerować HTML na podstawie danych.

Przykład generowania listy parametrów produktu:

<?php

$product = [
    "Nazwa" => "Monitor 27 cali",
    "Rozdzielczość" => "2560x1440",
    "Matryca" => "IPS",
    "Odświeżanie" => "144 Hz"
];

echo "<ul>";

foreach ($product as $label => $value) {
    echo "<li><strong>" . htmlspecialchars($label) . ":</strong> " . htmlspecialchars($value) . "</li>";
}

echo "</ul>";

?>

W tym przykładzie użyto htmlspecialchars(), aby zabezpieczyć dane przed przypadkowym wygenerowaniem niebezpiecznego HTML-a.

Tablice asocjacyjne wielowymiarowe

Tablica asocjacyjna może zawierać inne tablice. Tak powstają tablice wielowymiarowe. W praktyce są bardzo częste, np. przy danych użytkownika z adresem, zamówieniach z produktami albo odpowiedziach API.

Przykład użytkownika z adresem:

<?php

$user = [
    "name" => "Anna",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ",
    "address" => [
        "street" => "Długa 10",
        "city" => "Warszawa",
        "postal_code" => "00-001"
    ]
];

echo $user["address"]["city"]; // Warszawa

?>

Przykład zamówienia z listą produktów:

<?php

$order = [
    "id" => 1001,
    "customer" => [
        "name" => "Jan Kowalski",
        "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 "
    ],
    "items" => [
        [
            "name" => "Klawiatura",
            "price" => 199,
            "quantity" => 1
        ],
        [
            "name" => "Mysz",
            "price" => 99,
            "quantity" => 2
        ]
    ]
];

?>

Taka struktura dobrze opisuje dane zamówienia. Mamy identyfikator zamówienia, klienta oraz listę produktów. Każdy produkt jest osobną tablicą asocjacyjną.

Przykład obliczenia wartości zamówienia:

<?php

$total = 0;

foreach ($order["items"] as $item) {
    $total += $item["price"] * $item["quantity"];
}

echo "Suma: " . $total . " PLN";

?>

Tablica asocjacyjna a JSON

Tablice asocjacyjne w PHP bardzo często łączą się z formatem JSON. Funkcja json_encode() pozwala zamienić tablicę PHP na JSON, a json_decode() pozwala odczytać JSON jako tablicę asocjacyjną.

Zamiana tablicy asocjacyjnej na JSON

<?php

$user = [
    "name" => "Anna",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ",
    "active" => true
];

$json = json_encode($user, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

echo $json;

?>

Wynik:

{
    "name": "Anna",
    "email": "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ",
    "active": true
}

Zamiana JSON na tablicę asocjacyjną

<?php

$json = '{"name":"Anna","email":"
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ","active":true}';

$user = json_decode($json, true);

echo $user["email"];

?>

Drugi argument true w funkcji json_decode() jest bardzo ważny. Dzięki niemu PHP zwraca tablicę asocjacyjną, a nie obiekt.

Formularze, $_POST, $_GET i tablice asocjacyjne

Superglobalne zmienne $_POST, $_GET, $_SESSION, $_COOKIE czy $_SERVER są w PHP tablicami asocjacyjnymi. To bardzo ważne, bo formularze i parametry URL odczytuje się właśnie po nazwach kluczy.

Przykład formularza:

<form method="post" action="/kontakt.php">
    <input type="text" name="name">
    <input type="email" name="email">
    <button type="submit">Wyślij</button>
</form>

Odczyt danych w PHP:

<?php

$name = $_POST["name"] ?? "";
$email = $_POST["email"] ?? "";

?>

Klucze name i email odpowiadają atrybutom name w formularzu HTML. To praktyczny przykład tablicy asocjacyjnej w codziennym użyciu.

Bezpieczniejsza wersja z filtrowaniem:

<?php

$name = trim($_POST["name"] ?? "");
$email = filter_input(INPUT_POST, "email", FILTER_VALIDATE_EMAIL);

if ($name === "" || !$email) {
    echo "Uzupełnij poprawnie formularz.";
    exit;
}

?>

Przy danych z formularza nie wystarczy sprawdzić, czy klucz istnieje. Trzeba jeszcze walidować wartości, bo użytkownik może wysłać dane puste, błędne albo celowo spreparowane.

Baza danych i tablice asocjacyjne

Tablice asocjacyjne są bardzo często używane przy pobieraniu danych z bazy. Jeżeli korzystasz z PDO i trybu PDO::FETCH_ASSOC, wynik zapytania może być tablicą asocjacyjną, w której kluczami są nazwy kolumn.

<?php

$statement = $pdo->query("SELECT id, name, email FROM users");

$users = $statement->fetchAll(PDO::FETCH_ASSOC);

foreach ($users as $user) {
    echo $user["name"] . " - " . $user["email"] . "<br>";
}

?>

Jeżeli w bazie danych istnieją kolumny id, name i email, to można odczytać je w PHP właśnie po takich kluczach.

Przykład pojedynczego rekordu:

<?php

$statement = $pdo->prepare("SELECT id, name, price FROM products WHERE id = :id");
$statement->execute(["id" => 10]);

$product = $statement->fetch(PDO::FETCH_ASSOC);

if ($product) {
    echo $product["name"] . " kosztuje " . $product["price"] . " PLN";
}

?>

W praktyce to jeden z najważniejszych powodów, dla których tablice asocjacyjne są tak często spotykane w PHP. Bardzo dobrze pasują do danych rekordowych: użytkownik, produkt, zamówienie, artykuł, kategoria, komentarz.

Sortowanie tablic asocjacyjnych

Tablice asocjacyjne można sortować na kilka sposobów. Trzeba jednak uważać, bo różne funkcje sortujące inaczej traktują klucze.

Sortowanie po wartościach z zachowaniem kluczy - asort()

<?php

$prices = [
    "monitor" => 900,
    "klawiatura" => 200,
    "mysz" => 100
];

asort($prices);

print_r($prices);

?>

asort() sortuje po wartościach, ale zachowuje przypisanie kluczy.

Sortowanie po kluczach - ksort()

<?php

$user = [
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ",
    "name" => "Anna",
    "age" => 28
];

ksort($user);

print_r($user);

?>

ksort() sortuje tablicę według kluczy. Może się przydać np. przy porządkowaniu danych konfiguracyjnych.

Uwaga na sort()

Funkcja sort() sortuje wartości, ale resetuje klucze numerycznie. Przy tablicach asocjacyjnych często nie jest to pożądane.

Ryzykowny przykład:

<?php

$prices = [
    "monitor" => 900,
    "klawiatura" => 200,
    "mysz" => 100
];

sort($prices);

print_r($prices);

?>

Po użyciu sort() klucze tekstowe zostaną utracone. Jeżeli klucze mają znaczenie, lepiej użyć asort(), arsort(), ksort() albo krsort().

Najczęstsze błędy przy tablicach asocjacyjnych

Tablice asocjacyjne są proste, ale łatwo popełnić błędy, które później powodują ostrzeżenia, błędne dane albo trudne do znalezienia problemy.

Undefined array key

Ten komunikat oznacza, że próbujesz odczytać klucz, którego nie ma w tablicy.

Ryzykownie:

<?php

echo $user["phone"];

?>

Bezpieczniej:

<?php

echo $user["phone"] ?? "brak telefonu";

?>

Literówki w nazwach kluczy

PHP nie wie, że "email" i "emial" miały oznaczać to samo. Literówka w kluczu oznacza inny klucz.

<?php

$user = [
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 "
];

echo $user["emial"] ?? "brak e-maila";

?>

Przy większych projektach warto ograniczać takie błędy przez stałe, klasy DTO, obiekty albo jasno opisane struktury danych.

Mieszanie tablic indeksowanych i asocjacyjnych

PHP pozwala mieszać klucze liczbowe i tekstowe, ale nie zawsze jest to czytelne.

<?php

$data = [
    "name" => "Anna",
    0 => "wartość bez opisu",
    "email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 "
];

?>

Taka struktura może działać, ale jest mniej zrozumiała. Lepiej oddzielać listy od danych opisowych.

Brak walidacji danych z tablicy

To, że wartość znajduje się w tablicy, nie oznacza jeszcze, że jest poprawna. Dotyczy to zwłaszcza $_POST, $_GET i danych z API.

<?php

$age = $_POST["age"] ?? null;

// To nadal może być tekst, pusta wartość albo coś nieoczekiwanego.

?>

Bezpieczniej:

<?php

$age = filter_input(INPUT_POST, "age", FILTER_VALIDATE_INT);

if ($age === false || $age === null) {
    echo "Podaj poprawny wiek.";
    exit;
}

?>

Praktyczne przykłady użycia tablic asocjacyjnych

Tablice asocjacyjne najlepiej zrozumieć na praktycznych przykładach. Poniżej kilka typowych sytuacji, w których taki zapis jest naturalny i czytelny.

Przykład 1: konfiguracja strony

<?php

$config = [
    "site_name" => "Moja strona",
    "admin_email" => "
 Adres poczty elektronicznej jest chroniony przed robotami spamującymi. W przeglądarce musi być włączona obsługa JavaScript, żeby go zobaczyć.
 ",
    "items_per_page" => 10,
    "debug" => false
];

if ($config["debug"]) {
    ini_set("display_errors", "1");
}

?>

Tablica asocjacyjna dobrze nadaje się do prostych ustawień, ponieważ klucze jasno mówią, za co odpowiada dana wartość.

Przykład 2: produkt w sklepie

<?php

$product = [
    "id" => 101,
    "name" => "Biurko drewniane",
    "price" => 799.99,
    "currency" => "PLN",
    "available" => true
];

echo $product["name"] . " - " . $product["price"] . " " . $product["currency"];

?>

Taki zapis jest prosty i czytelny. Od razu wiadomo, które pole oznacza nazwę, a które cenę.

Przykład 3: menu strony

<?php

$menu = [
    "Strona główna" => "/",
    "Oferta" => "/oferta",
    "Blog" => "/blog",
    "Kontakt" => "/kontakt"
];

echo "<nav><ul>";

foreach ($menu as $label => $url) {
    echo "<li><a href=\"" . htmlspecialchars($url) . "\">" . htmlspecialchars($label) . "</a></li>";
}

echo "</ul></nav>";

?>

Kluczem jest nazwa linku, a wartością adres URL. To prosty przykład dynamicznego generowania menu.

Przykład 4: komunikaty błędów formularza

<?php

$errors = [
    "email" => "Podaj poprawny adres e-mail.",
    "password" => "Hasło musi mieć co najmniej 8 znaków."
];

foreach ($errors as $field => $message) {
    echo "<p>" . htmlspecialchars($message) . "</p>";
}

?>

Tablica asocjacyjna pozwala powiązać komunikat z konkretnym polem formularza.

Przykład 5: mapa statusów

<?php

$statusLabels = [
    "new" => "Nowe",
    "paid" => "Opłacone",
    "sent" => "Wysłane",
    "cancelled" => "Anulowane"
];

$orderStatus = "paid";

echo $statusLabels[$orderStatus] ?? "Nieznany status";

?>

To bardzo praktyczny wzorzec. W bazie lub logice aplikacji można trzymać krótkie kody, a użytkownikowi wyświetlać czytelne etykiety.

Przykład 6: grupowanie danych według kategorii

<?php

$articles = [
    ["title" => "PHP podstawy", "category" => "Programowanie"],
    ["title" => "Redirect w PHP", "category" => "Programowanie"],
    ["title" => "Szybkość strony", "category" => "SEO"]
];

$grouped = [];

foreach ($articles as $article) {
    $category = $article["category"];
    $grouped[$category][] = $article["title"];
}

print_r($grouped);

?>

W tym przykładzie kategorie stają się kluczami tablicy, a wartościami są listy tytułów artykułów.

Dobre praktyki przy pracy z tablicami asocjacyjnymi

Tablice asocjacyjne są wygodne, ale przy większym kodzie warto używać ich świadomie. Zbyt swobodna struktura danych może po czasie utrudnić utrzymanie projektu.

• Używaj czytelnych nazw kluczy, np. email, price, created_at.
• Nie odczytuj kluczy bez sprawdzenia, jeśli dane pochodzą z zewnątrz.
• Stosuj ?? dla prostych wartości domyślnych.
• Używaj array_key_exists(), gdy null jest poprawną wartością.
• Nie mieszaj bez potrzeby kluczy liczbowych i tekstowych.
• Przy generowaniu HTML zabezpieczaj dane funkcją htmlspecialchars().
• Nie przechowuj haseł, tokenów i danych poufnych w tablicach wysyłanych do widoku lub API.
• Przy dużych strukturach rozważ obiekty, klasy DTO lub typowane modele.
• Uważaj na sort(), bo może usunąć klucze asocjacyjne.
• Przy JSON pamiętaj o drugim parametrze true w json_decode(), jeśli chcesz dostać tablicę.

Tablica asocjacyjna w PHP - podsumowanie

Tablica asocjacyjna w PHP to jedna z najważniejszych struktur danych w codziennej pracy z tym językiem. Pozwala przechowywać wartości pod nazwanymi kluczami, dzięki czemu kod jest bardziej czytelny niż przy użyciu samych indeksów liczbowych. Zamiast pamiętać, że $user[0] oznacza imię, można użyć $user["name"], co od razu wyjaśnia znaczenie wartości.

Tablice asocjacyjne pojawiają się w konfiguracji, formularzach, sesjach, odpowiedziach API, przetwarzaniu JSON, pobieraniu danych z bazy, generowaniu HTML i prostych strukturach aplikacji. Są bardzo wygodne, ale wymagają ostrożności: trzeba sprawdzać istnienie kluczy, walidować dane zewnętrzne, uważać na sortowanie i nie zakładać, że każda wartość zawsze będzie dostępna.

Najlepiej traktować tablice asocjacyjne jako praktyczne narzędzie do organizowania danych. W małych i średnich strukturach są szybkie, wygodne i czytelne. W większych projektach warto jednak pilnować spójnych nazw kluczy, wartości domyślnych i jasnej struktury, a przy bardziej rozbudowanej logice rozważyć przejście na obiekty lub klasy opisujące dane.

FAQ - tablica asocjacyjna w PHP