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, משנה כמה חלקים מקבלים:

• limit חיובי מחזיר לכל היותר את מספר החלקים הזה. החלק האחרון מחזיק את שארית המחרוזת, כולל המפרידים.
• limit שלילי מחזיר כל חלק חוץ מ-abs($limit) האחרונים.
• 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

limit חיובי הוא הכלי הנכון כשרק המפריד הראשון חשוב, למשל שורת 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);

trim לחלקים והשמטת חלקים ריקים

קלט משתמש כמו "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);

ה-callback fn($c) => $c !== '' שומר על המחרוזת "0". array_filter($colors) בלי callback הייתה משמיטה אותה, כי "0" שקרית.

הפיכת מחרוזת למערך אסוציאטיבי

הגדרות, עוגיות ומחרוזות דמויות שאילתה נשמרות לעיתים קרובות כזוגות key=value. הפעילו explode פעמיים: פעם אחת לזוגות, ופעם לכל זוג עם limit של 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 => ''];.

למחרוזת שאילתה אמיתית של URL, 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() לא עושה שום עבודת regex, ולכן היא מהירה יותר מ-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) לכל דבר שעשוי להכיל תווים מרובי בתים.