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.
