الدالة explode() في PHP: تقسيم نص إلى مصفوفة

تقسّم explode($separator, $string) نصًا عند كل ظهور لـ $separator وتعيد الأجزاء في مصفوفة. تعطي explode(',', 'apple,banana,cherry') المصفوفة ['apple', 'banana', 'cherry'].

<?php
$csv = 'apple,banana,cherry';
$fruits = explode(',', $csv);

print_r($fruits);
echo $fruits[1], "\n";
echo count($fruits), " fruits\n";

يمكن أن يكون الفاصل أي نص، لا محرفًا واحدًا فقط: تعمل explode(' and ', 'tea and milk and sugar') بالطريقة نفسها. والعملية المعاكسة، ضم مصفوفة مرة أخرى في نص، هي implode().

الصيغة والقيمة المعادة

explode(string $separator, string $string, int $limit = PHP_INT_MAX): array

تعيد دائمًا مصفوفة. وإذا لم يظهر الفاصل، تحمل المصفوفة النص كله عنصرًا وحيدًا. ويشمل ذلك النص الفارغ، الذي يعطي مصفوفة فيها نص فارغ واحد، وهو مصدر شائع لأخطاء «حلقتي تعمل مرة واحدة على مُدخل فارغ».

<?php
var_dump(explode(',', 'apple'));   // separator not found
var_dump(explode(',', ''));        // empty input
var_dump(explode(',', 'a,,b,'));   // empty pieces are kept

// If an empty string should mean "no items", check before splitting
$input = '';
$tags = $input === '' ? [] : explode(',', $input);
echo count($tags), "\n";

تحديد عدد الأجزاء

يغيّر الوسيط الثالث، $limit، عدد الأجزاء التي تحصل عليها:

• الحد الموجب يعيد ذلك العدد من الأجزاء على الأكثر. ويحمل الجزء الأخير بقية النص، بما فيها الفواصل.
• الحد السالب يعيد كل الأجزاء ما عدا آخر abs($limit) منها.
• الحد 0 يُعامل على أنه 1.

<?php
$path = 'home/ada/projects/site/index.php';

print_r(explode('/', $path, 2));   // first piece, then the rest
print_r(explode('/', $path, -1));  // everything except the file name
print_r(explode('/', $path, 0));   // treated as 1

الحد الموجب هو الأداة الصحيحة عندما لا يهم إلا الفاصل الأول، مثل سطر key=value قد تحتوي قيمته على = أيضًا: تعطي explode('=', 'query=a=b', 2) المصفوفة ['query', 'a=b']. وتستخدمه الأقسام التالية بهذه الطريقة.

للحصول على الجزء الأخير فقط، خزّن المصفوفة في متغير أولًا: $parts = explode('/', $path); $file = end($parts);. كتابة end(explode('/', $path)) تعيد القيمة الصحيحة مع ذلك، لكن PHP تطبع Notice: Only variables should be passed by reference، لأن end() تأخذ وسيطها بالمرجع.

تقسيم نص عند السطر الجديد

تقسّم explode("\n", $text) عند فواصل الأسطر. استخدم علامتي التنصيص المزدوجتين: داخل علامتي التنصيص المفردتين تكون '\n' شرطة مائلة عكسية يليها الحرف n، لا سطرًا جديدًا. وكثيرًا ما تنهي النصوص القادمة من ملفات Windows أو نماذج HTML أسطرها بـ "\r\n"، فيبقى "\r" زائد في نهاية كل جزء. تقسّم preg_split('/\R/', $text) عند أي نوع من فواصل الأسطر.

<?php
$text = "first line\r\nsecond line\nthird line";

$pieces = explode("\n", $text);
var_dump($pieces[0]);   // still ends with \r

$lines = preg_split('/\R/', $text);
var_dump($lines);

تشذيب الأجزاء وإسقاط الفارغ منها

مُدخلات المستخدم مثل "red, green , ,blue" فيها مسافات حول العناصر وعنصر فارغ في الوسط. مرّر الأجزاء عبر trim() بـ array_map()، ثم احذف النصوص الفارغة بـ array_filter(). تعيد array_values() ترقيم المفاتيح بعد ذلك، لأن array_filter() تحتفظ بالمفاتيح الأصلية.

<?php
$input = 'red, green , ,blue';

$colors = array_map('trim', explode(',', $input));
$colors = array_values(array_filter($colors, fn($c) => $c !== ''));

print_r($colors);

تُبقي دالة الاستدعاء fn($c) => $c !== '' النص "0". أما array_filter($colors) المجردة فتُسقطه، لأن "0" خاطئ منطقيًا.

تحويل نص إلى مصفوفة ترابطية

كثيرًا ما تُخزَّن الإعدادات وملفات تعريف الارتباط والنصوص الشبيهة بالاستعلامات أزواجًا key=value. قسّم مرتين: مرة للأزواج، ومرة لكل زوج بحد 2، مع فك الجزأين إلى متغيرات (تفكيك المصفوفات).

<?php
$settings = 'theme=dark;lang=ja;filter=a=b';

$result = [];
foreach (explode(';', $settings) as $pair) {
    [$key, $value] = explode('=', $pair, 2);
    $result[$key] = $value;
}

print_r($result);
echo $result['lang'], "\n";

الزوج الذي لا يحتوي =، مثل debug، يعطي مصفوفة بعنصر واحد، فيطبع التفكيك Warning: Undefined array key 1. أكمل النتيجة إلى عنصرين لتجنب ذلك: [$key, $value] = explode('=', $pair, 2) + [1 => ''];.

لنص استعلام حقيقي في رابط، تفعل parse_str() ذلك نيابة عنك وتفك أيضًا ترميز %20 و+.

التقسيم بعدة فواصل

تأخذ explode() فاصلًا واحدًا. للتقسيم عند الفواصل أو الفواصل المنقوطة أو المسافات، استخدم preg_split() مع فئة محارف. ويُسقط PREG_SPLIT_NO_EMPTY الأجزاء الفارغة التي ينشئها فاصلان متتاليان.

<?php
$input = 'php, javascript;python  go|rust';

$words = preg_split('/[\s,;|]+/', $input, -1, PREG_SPLIT_NO_EMPTY);
print_r($words);

النصوص اليابانية ونصوص UTF-8 الأخرى

تقارن explode() البايتات، وفي UTF-8 لا يظهر محرف كامل أبدًا داخل بايتات محرف آخر، لذا فإن تقسيم نص ياباني عند فاصل ياباني مثل 、 أو فاصلة كاملة العرض يعمل بشكل صحيح.

<?php
$cities = '東京、大阪、京都';
print_r(explode('、', $cities));

// Split into single characters: mb_str_split counts characters, str_split counts bytes
print_r(mb_str_split('日本語'));

explode مقابل str_split مقابل preg_split

لا تقوم explode() بأي عمل للتعابير النمطية، لذا فهي أسرع من preg_split() وهي التي تختارها كلما كان الفاصل نصًا ثابتًا.

خطأ شائع: فاصل فارغ

الفاصل الفارغ خطأ. منذ PHP 8.0 ترمي explode('', 'abc') الخطأ ValueError بدل إعادة false، ويتوقف السكربت:

PHP Fatal error:  Uncaught ValueError: explode(): Argument #1 ($separator) cannot be empty in /home/index.php:3

لتقسيم نص إلى محارف، استخدم str_split('abc') للنصوص بترميز ASCII أو mb_str_split($s) لأي نص قد يحتوي محارف متعددة البايتات.