PHP explode(): Memecah String Menjadi Array

explode($separator, $string) memecah string di setiap kemunculan $separator dan mengembalikan potongan-potongannya sebagai array. explode(',', 'apple,banana,cherry') menghasilkan ['apple', 'banana', 'cherry'].

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

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

Pemisahnya bisa berupa string apa pun, bukan hanya satu karakter: explode(' and ', 'tea and milk and sugar') bekerja dengan cara yang sama. Operasi kebalikannya, menggabungkan array kembali menjadi string, adalah implode().

Sintaks dan nilai kembalian

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

Fungsi ini selalu mengembalikan array. Kalau pemisahnya tidak muncul, array itu berisi seluruh string sebagai satu-satunya elemen. Itu berlaku juga untuk string kosong, yang menghasilkan array berisi satu string kosong, sumber umum bug "loop-ku berjalan sekali pada input kosong".

<?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";

Membatasi jumlah potongan

Argumen ketiga, $limit, mengubah berapa banyak potongan yang kamu dapat:

• Limit positif mengembalikan paling banyak sejumlah itu. Potongan terakhir berisi sisa string, termasuk pemisahnya.
• Limit negatif mengembalikan setiap potongan kecuali abs($limit) potongan terakhir.
• Limit 0 diperlakukan sebagai 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 positif adalah alat yang tepat saat hanya pemisah pertama yang penting, misalnya baris key=value yang nilainya mungkin juga mengandung =: explode('=', 'query=a=b', 2) menghasilkan ['query', 'a=b']. Bagian-bagian berikutnya memakainya dengan cara itu.

Untuk mengambil potongan terakhir saja, simpan dulu array-nya ke variabel: $parts = explode('/', $path); $file = end($parts);. Menulis end(explode('/', $path)) tetap mengembalikan nilai yang benar, tetapi PHP mencetak Notice: Only variables should be passed by reference, karena end() menerima argumennya lewat referensi.

Memecah string berdasarkan baris baru

explode("\n", $text) memecah di setiap baris baru. Pakai kutip ganda: di dalam kutip tunggal, '\n' adalah backslash diikuti huruf n, bukan baris baru. Teks dari file Windows atau formulir HTML sering mengakhiri baris dengan "\r\n", yang meninggalkan "\r" di akhir setiap potongan. preg_split('/\R/', $text) memecah di jenis baris baru apa pun.

<?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);

Memangkas potongan dan membuang yang kosong

Input pengguna seperti "red, green , ,blue" punya spasi di sekitar item-itemnya dan sebuah item kosong di tengah. Lewatkan potongan-potongannya ke trim() dengan array_map(), lalu buang string kosong dengan array_filter(). array_values() menomori ulang key-nya sesudahnya, karena array_filter() mempertahankan key aslinya.

<?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 !== '' tetap menyimpan string "0". array_filter($colors) tanpa callback akan membuangnya, karena "0" bernilai falsy.

Mengubah string menjadi array asosiatif

Pengaturan, cookie, dan string mirip query sering disimpan sebagai pasangan key=value. Lakukan explode dua kali: sekali untuk pasangan-pasangannya, sekali untuk setiap pasangan dengan limit 2, lalu bongkar kedua potongannya ke variabel (destructuring array).

<?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";

Pasangan tanpa =, seperti debug, menghasilkan array berisi satu elemen, dan destructuring-nya mencetak Warning: Undefined array key 1. Lengkapi hasilnya menjadi dua elemen untuk menghindarinya: [$key, $value] = explode('=', $pair, 2) + [1 => ''];.

Untuk query string URL sungguhan, parse_str() melakukan ini untukmu dan juga men-decode %20 dan +.

Memecah dengan beberapa pemisah

explode() hanya menerima satu pemisah. Untuk memecah di koma, titik koma, atau spasi, pakai preg_split() dengan character class. PREG_SPLIT_NO_EMPTY membuang potongan kosong yang muncul saat ada dua pemisah berturut-turut.

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

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

Teks Jepang dan teks UTF-8 lainnya

explode() membandingkan byte, dan di UTF-8 sebuah karakter utuh tidak pernah muncul di dalam byte karakter lain, jadi memecah teks Jepang dengan pemisah Jepang seperti 、 atau koma full-width bekerja dengan benar.

<?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 vs str_split vs preg_split

explode() tidak memproses regex, jadi lebih cepat daripada preg_split() dan menjadi pilihan setiap kali pemisahnya berupa string tetap.

Kesalahan umum: pemisah kosong

Pemisah kosong adalah error. Sejak PHP 8.0, explode('', 'abc') melempar ValueError alih-alih mengembalikan false, dan script berhenti:

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

Untuk memecah string menjadi karakter, pakai str_split('abc') untuk teks ASCII atau mb_str_split($s) untuk teks apa pun yang mungkin mengandung karakter multibyte.