الدالة 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() المفاتيح ولا تضم إلا القيم. للحصول على أزواج key=value، ابنِ كل جزء بـ array_map() على المفاتيح والقيم، ثم اضمم. وتفعل http_build_query() الشيء نفسه لنص استعلام في رابط وترمّز أيضًا المسافات والمحارف الخاصة.

<?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> من أن تصبح وسمًا.

الضم مع «و» قبل العنصر الأخير

تحتاج القائمة المقروءة للبشر عادة إلى «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";