implode() ב-PHP: חיבור איברי מערך למחרוזת

implode($separator, $array) מחברת את ערכי המערך למחרוזת אחת, עם $separator בין כל זוג: implode(', ', ['red', 'green', 'blue']) מחזירה "red, green, blue".

<?php
$colors = ['red', 'green', 'blue'];

echo implode(', ', $colors), "\n";
echo implode(' | ', $colors), "\n";
echo implode('', $colors), "\n";

המפריד נכנס רק בין איברים, אף פעם לא לפני הראשון או אחרי האחרון. זה ההפך של explode(), שמפצלת מחרוזת למערך.

תחביר

implode(string $separator, array $array): string
implode(array $array): string   // separator defaults to ""

המפריד בא ראשון. קוד ישן העביר לפעמים את המערך ראשון, implode($array, ', '). הסדר הזה הוצא משימוש ב-PHP 7.4 והוסר ב-PHP 8.0, שבה הוא זורק TypeError: implode(): Argument #2 ($array) must be of type ?array, string given.

implode מול join

join() היא כינוי של implode(). הן מקבלות אותם ארגומנטים ומחזירות אותה מחרוזת, אז בחרו אחת והישארו עקביים.

<?php
$parts = ['2026', '03', '14'];

echo implode('-', $parts), "\n";
echo join('-', $parts), "\n";
var_dump(implode('-', $parts) === join('-', $parts));

מה קורה למספרים, לבוליאנים ול-null

כל ערך מומר קודם למחרוזת. מספרים מודפסים כמצופה, true הופך ל-"1", ו-false ו-null הופכים למחרוזות ריקות, וזה משאיר שני מפרידים ברצף.

<?php
$values = [10, 2.5, true, false, null, 'end'];
echo implode(', ', $values), "\n";

// Remove null and false before joining
$clean = array_filter($values, fn($v) => $v !== null && $v !== false);
echo implode(', ', $clean), "\n";

echo '[', implode(', ', []), "]\n";   // an empty array gives an empty string

implode למערך אסוציאטיבי

implode() מתעלמת ממפתחות ומחברת רק את הערכים. כדי לקבל זוגות key=value, בנו כל חלק עם array_map() על המפתחות והערכים, ואז חברו. http_build_query() עושה את אותו הדבר למחרוזת שאילתה של URL וגם מקודדת רווחים ותווים מיוחדים.

<?php
$user = ['name' => 'Ada', 'role' => 'admin', 'city' => 'London'];

echo implode(', ', $user), "\n";   // values only

$pairs = array_map(fn($k, $v) => "$k=$v", array_keys($user), $user);
echo implode(', ', $pairs), "\n";

echo http_build_query(['q' => 'php implode', 'page' => 2]), "\n";

אותו דפוס מחבר רק את המפתחות: implode(', ', array_keys($user)). עוד על מפתחות וערכים בעמוד מערכים אסוציאטיביים.

חיבור עם ירידת שורה או בניית רשימת HTML

המפריד יכול להיות כל מחרוזת. "\n" (במירכאות כפולות) שם כל ערך בשורה משלו, וזה שימושי לקבצי טקסט ולפלט בשורת הפקודה. עם תגיות HTML כמפריד, implode() בונה רשימה בשורה אחת. הריצו את הבלוק הבא והלשונית Page תציג את הרשימה.

<?php
$steps = ['Read the input', 'Validate it', 'Save it'];

$items = array_map('htmlspecialchars', $steps);
echo '<ol><li>' . implode('</li><li>', $items) . '</li></ol>';

הפעלת htmlspecialchars() על כל ערך לפני החיבור מונעת מערך כמו <b> להפוך ל-markup.

חיבור עם "and" לפני הפריט האחרון

רשימה קריאה לבני אדם צריכה בדרך כלל "and" לפני האיבר האחרון. הוציאו אותו, חברו את השאר, ואז הוסיפו אותו בחזרה:

<?php
function humanList(array $items): string
{
    if (count($items) <= 1) {
        return implode('', $items);
    }
    $last = array_pop($items);
    return implode(', ', $items) . ' and ' . $last;
}

echo humanList(['PHP']), "\n";
echo humanList(['PHP', 'Python']), "\n";
echo humanList(['PHP', 'Python', 'Go', 'Rust']), "\n";

טעות נפוצה: מערכים מקוננים

implode() עובדת על רמה אחת. איבר שהוא בעצמו מערך מומר למילה Array, ו-PHP מדפיסה אזהרה:

<?php
echo implode(', ', ['red', ['orange', 'yellow']]);

Warning: Array to string conversion in /home/index.php on line 2
red, Array

שטחו קודם את המערכים הפנימיים, או חברו כל אחד בנפרד:

<?php
$groups = [
    'warm' => ['red', 'orange'],
    'cool' => ['blue', 'green'],
];

// Join each inner array, then join the results
$lines = array_map(fn($colors) => implode(', ', $colors), $groups);
echo implode("\n", $lines), "\n";

// Or flatten everything into one list
echo implode(', ', array_merge(...array_values($groups))), "\n";