• Programowanie
  • PHP implode() - jak połączyć tablicę w tekst?

PHP implode() - jak połączyć tablicę w tekst?

Radosław Stępień • 21 listopada 2026
Kod PHP tworzy ciąg znaków "Hello world !" z tablicy za pomocą funkcji implode.

Spis treści

Masz tablicę z tagami i chcesz wyświetlić je jako jeden ciąg, bez przecinka na końcu? W PHP zwykle wystarczy implode(), choć wynik zależy od tego, co znajduje się w tablicy i jaki separator wybierzesz.

implode() łączy wartości tablicy, ale nie jej klucze

  • Składnia: implode($separator, $tablica).
  • Klucze tablicy asocjacyjnej są pomijane, łączone są tylko wartości.
  • Od PHP 8 nie używaj starej kolejności argumentów z tablicą na początku.
  • Zagnieżdżone tablice wymagają wcześniejszego przetworzenia.
  • Lista wartości do SQL nie powinna trafiać do zapytania przez samo sklejanie tekstu.

Separator trafia między elementy, a nie na koniec

Wyobraź sobie etykiety produktu: „PHP”, „backend” i „API”. Chcesz pokazać je w jednym wierszu, oddzielone przecinkiem i spacją? Podaj separator jako pierwszy argument, a tablicę jako drugi:

$tags = ['PHP', 'backend', 'API'];

$tekst = implode(', ', $tags);

echo $tekst;
// PHP, backend, API

Funkcja zwraca string, czyli tekst z wartościami tablicy w ich kolejności, rozdzielonymi wskazanym ciągiem. Separator może mieć kilka znaków, na przykład ' / ', "\n" albo pustą wartość, jeśli elementy mają się stykać.

Uważam, że podawanie separatora jawnie ułatwia czytanie kodu. Bez niego funkcja używa pustego separatora, więc implode(['a', 'b']) zwraca 'ab'. Szczegóły składni i wynik dla pustej tablicy opisuje dokumentacja PHP dla funkcji implode.

W PHP 8 stara kolejność argumentów już nie działa

W starszych przykładach możesz trafić na zapis implode($tablica, ', '). To pułapka, jeśli przenosisz kod do nowszego projektu: od PHP 7.4 taki układ był przestarzały, a od PHP 8.0 nie jest obsługiwany.

// Poprawnie
implode(', ', $tags);

// Nie używaj w PHP 8+
implode($tags, ', ');

Współczesna składnia zaczyna się od separatora, potem przyjmuje tablicę. Przy migracji starego kodu sprawdź szczególnie wywołania z argumentami w odwrotnej kolejności; w przeciwnym razie zamiast tekstu możesz dostać błąd typu.

Istnieje też alias join(), ale zachowuje się tak samo. W nowym kodzie wybrałbym implode(), bo ta nazwa jasno pasuje do popularnego przykładu „tablica na tekst”, a jawny separator od razu pokazuje intencję.

Tablica asocjacyjna oddaje wartości i ignoruje klucze

Przy danych zapisanych jako pary klucz-wartość łatwo oczekiwać, że w wyniku pojawią się obie strony. implode() łączy jednak same wartości:

$user = [
    'imie' => 'Alicja',
    'miasto' => 'Gdańsk',
];

echo implode(', ', $user);
// Alicja, Gdańsk

Jeśli potrzebujesz samych kluczy, przekaż do funkcji wynik array_keys($user). Gdy chcesz zachować pary, najpierw zamień każdą z nich na tekst, a dopiero potem połącz gotowe fragmenty:

$pairs = [];

foreach ($user as $key => $value) {
    $pairs[] = $key . '=' . $value;
}

echo implode('&', $pairs);
// imie=Alicja&miasto=Gdańsk

Ten przykład pokazuje też ograniczenie: łączenie tekstu nie koduje go do adresu URL. Do budowania query stringa użyj narzędzia przeznaczonego do tego celu, na przykład http_build_query(), zamiast ręcznie składać parametry.

Typ wartości w tablicy decyduje, czy wynik będzie czytelny

Najczęstszy kłopot pojawia się wtedy, gdy tablica nie jest płaską listą tekstów. Wartości logiczne i null mogą dać zaskakujący tekst, a tablica wewnątrz tablicy nie zostanie automatycznie spłaszczona. Poniższa tabela pomaga szybko rozpoznać, skąd bierze się wynik:

Sytuacja Prawdopodobny skutek Co zrobić
Pusta tablica Wynikiem jest pusty string. Sprawdź, czy brak elementów jest dopuszczalny w danym miejscu.
Tablica asocjacyjna W tekście znajdą się wartości, bez kluczy. Użyj array_keys(), jeśli potrzebujesz kluczy.
Wartości true, false lub null Konwersja może dać odpowiednio 1 albo pusty fragment. Jawnie zamień wartości na etykiety, na przykład true na 'tak'.
Tablica zagnieżdżona Może pojawić się ostrzeżenie o konwersji tablicy na tekst. Wyciągnij potrzebne pole lub osobno przetwórz elementy wewnętrzne.

Jeśli wartości pochodzą z różnych typów, najpierw przygotuj tablicę z tekstami o ustalonym formacie. Dzięki temu wynik nie zależy od przypadkowej konwersji, a kod jasno określa, co ma się pojawić w interfejsie.

Do listy SQL użyj placeholderów zamiast sklejać zapytanie

Tablica identyfikatorów często pojawia się przy zapytaniu z warunkiem IN. Samo połączenie jej przecinkami może wyglądać wygodnie, ale wstawianie danych do SQL przez konkatenację tworzy ryzyko błędu i podatności. Separator nie zastępuje parametrów zapytania.

Przy PDO utwórz osobny placeholder dla każdej wartości i przekaż wartości do wykonania zapytania:

$ids = [12, 25, 41];

$placeholders = implode(', ', array_fill(0, count($ids), '?'));
$sql = "SELECT * FROM products WHERE id IN ($placeholders)";

$stmt = $pdo->prepare($sql);
$stmt->execute($ids);

W tym układzie implode() łączy wyłącznie znaki ?, a identyfikatory są przekazywane osobno. Dokumentacja PHP opisuje użycie przygotowanych zapytań PDO jako sposób wiązania danych z zapytaniem.

Przed użyciem sprawdź, czy łączysz właściwą warstwę danych

Gdy wynik wygląda źle, sprawdź najpierw trzy rzeczy: kolejność argumentów, typ elementów i to, czy oczekujesz wartości, czy kluczy. implode() sprawdza się przy prostych listach tekstowych; przy danych zagnieżdżonych, adresach URL i zapytaniach SQL potrzebujesz dodatkowego kroku dopasowanego do celu.

W praktyce najczytelniejszy wzorzec to przygotować wartości, jawnie wskazać separator i dopiero wtedy łączyć. Taki kod nie ukrywa konwersji ani przypadkowych założeń, a drobny problem z tablicą łatwiej znaleźć, zanim trafi do widoku lub zapytania.

FAQ - Najczęstsze pytania

Użyj składni implode(', ', $tags), czyli podaj separator jako pierwszy argument, a tablicę jako drugi. Separator trafia między elementy, nie na końcu wyniku. W PHP 8 nie stosuj starej kolejności implode($tags, ', '); pominięcie separatora oznacza użycie pustego ciągu.

Nie. Funkcja łączy wyłącznie wartości, więc dla tablicy z kluczami imie i miasto zwróci na przykład Alicja, Gdańsk. Aby otrzymać same klucze, użyj array_keys(), a do zachowania par klucz-wartość najpierw utwórz tekstowe fragmenty. Przy budowaniu parametrów URL lepiej użyć http_build_query(), ponieważ samo łączenie tekstu nie koduje danych.

Najpierw przygotuj wartości w przewidywalnym formacie tekstowym. true może zostać zamienione na 1, a false i null na pusty fragment. Tablica zagnieżdżona nie zostanie automatycznie spłaszczona i może wywołać ostrzeżenie, dlatego trzeba wyciągnąć potrzebne pole albo osobno przetworzyć elementy wewnętrzne.

Nie wstawiaj identyfikatorów do SQL przez samo sklejanie tekstu. Utwórz osobny znak zapytania dla każdej wartości za pomocą array_fill(0, count($ids), '?'), połącz placeholdery funkcją implode(', ', ...), a następnie wykonaj przygotowane zapytanie PDO i przekaż identyfikatory osobno do execute().

Oceń artykuł

Ocena: 0.00 Liczba głosów: 0

Tagi

php
tablice
pdo
sql
implode
Autor Radosław Stępień
Radosław Stępień
Dziedzina programowania i technologii rozwija się w zawrotnym tempie, co sprawia, że ciągłe śledzenie nowinek i głębokie zrozumienie procesów są kluczowe. Nazywam się Radosław Stępień i od 13 lat aktywnie działam w branży IT, dzieląc się swoją wiedzą i doświadczeniem. Moje zainteresowania skupiają się na praktycznych aspektach tworzenia oprogramowania, analizie trendów technologicznych oraz budowaniu satysfakcjonującej ścieżki kariery w tym dynamicznym sektorze. Staram się przedstawiać złożone zagadnienia w sposób przystępny, opierając się na sprawdzonych informacjach i własnych obserwacjach z wieloletniej pracy. Zależy mi na tym, aby treści, które tworzę, były nie tylko merytoryczne i aktualne, ale przede wszystkim pomocne dla każdego, kto chce zgłębić tajniki IT lub rozwijać się zawodowo.

Udostępnij artykuł

Napisz komentarz