PHP explode(): Bir Dizgeyi Diziye Bölme

explode($separator, $string) bir dizgeyi $separator her geçtiğinde böler ve parçaları bir dizi olarak döndürür. explode(',', 'apple,banana,cherry') ['apple', 'banana', 'cherry'] verir.

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

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

Ayırıcı tek bir karakter değil herhangi bir dizge olabilir: explode(' and ', 'tea and milk and sugar') da aynı şekilde çalışır. Ters işlem, yani bir diziyi yeniden bir dizgede birleştirmek, implode() fonksiyonudur.

Söz dizimi ve dönüş değeri

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

Her zaman bir dizi döndürür. Ayırıcı geçmiyorsa dizi tek elemanı olarak dizgenin tamamını tutar. Buna boş dizge de dahildir: içinde tek bir boş dizge olan bir dizi verir; bu da "döngüm boş girdide bir kez çalışıyor" hatalarının yaygın bir kaynağıdır.

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

Parça sayısını sınırlama

Üçüncü argüman $limit kaç parça alacağınızı değiştirir:

• Pozitif bir limit en fazla o kadar parça döndürür. Son parça ayırıcılar dahil dizgenin geri kalanını tutar.
• Negatif bir limit son abs($limit) parça dışındaki her parçayı döndürür.
• 0 limiti 1 olarak kabul edilir.

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

Yalnızca ilk ayırıcı önemli olduğunda doğru araç pozitif bir limittir, örneğin değerin de = içerebildiği bir key=value satırı: explode('=', 'query=a=b', 2) ['query', 'a=b'] verir. Sonraki bölümler onu bu şekilde kullanır.

Yalnızca son parçayı almak için diziyi önce bir değişkende saklayın: $parts = explode('/', $path); $file = end($parts);. end(explode('/', $path)) yazmak yine doğru değeri döndürür, ama end() argümanını referansla aldığı için PHP Notice: Only variables should be passed by reference yazdırır.

Bir dizgeyi yeni satıra göre bölme

explode("\n", $text) satır sonlarında böler. Çift tırnak kullanın: tek tırnak içinde '\n' yeni satır değil, bir ters eğik çizgi ve ardından n harfidir. Windows dosyalarından veya HTML formlarından gelen metinler satırları çoğu zaman "\r\n" ile bitirir, bu da her parçanın sonunda fazladan bir "\r" bırakır. preg_split('/\R/', $text) her tür satır sonunda böler.

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

Parçaları kırpma ve boş olanları atma

"red, green , ,blue" gibi kullanıcı girdisinde öğelerin etrafında boşluklar ve ortada boş bir öğe vardır. Parçaları array_map() ile trim() içinden geçirin, sonra boş dizgeleri array_filter() ile kaldırın. array_filter() orijinal anahtarları koruduğu için array_values() sonrasında anahtarları yeniden numaralar.

<?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 !== '' geri çağırması "0" dizgesini tutar. Çıplak bir array_filter($colors) onu atardı, çünkü "0" falsy'dir.

Bir dizgeyi ilişkisel diziye çevirme

Ayarlar, çerezler ve sorgu benzeri dizgeler çoğu zaman key=value çiftleri olarak saklanır. İki kez bölün: bir kez çiftler için, bir kez de her çift için 2 limitiyle, iki parçayı değişkenlere açarak (dizi ayrıştırma).

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

İçinde = olmayan debug gibi bir çift tek elemanlı bir dizi verir ve ayrıştırma Warning: Undefined array key 1 yazdırır. Bunu önlemek için sonucu iki elemana tamamlayın: [$key, $value] = explode('=', $pair, 2) + [1 => ''];.

Gerçek bir URL sorgu dizgesi için parse_str() bunu sizin yerinize yapar ve ayrıca %20 ve + karakterlerini çözer.

Birkaç ayırıcıya göre bölme

explode() tek bir ayırıcı alır. Virgüllerde, noktalı virgüllerde veya boşluklarda bölmek için bir karakter sınıfıyla preg_split() kullanın. PREG_SPLIT_NO_EMPTY art arda iki ayırıcının oluşturacağı boş parçaları atar.

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

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

Japonca ve diğer UTF-8 metinler

explode() baytları karşılaştırır ve UTF-8'de tam bir karakter asla başka bir karakterin baytlarının içinde yer almaz, bu yüzden Japonca metni 、 veya tam genişlikte virgül gibi bir Japonca ayırıcıda bölmek doğru çalışır.

<?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 ve preg_split karşılaştırması

explode() hiçbir regex işi yapmaz, bu yüzden preg_split() fonksiyonundan daha hızlıdır ve ayırıcı sabit bir dizge olduğunda başvurulacak araçtır.

Sık yapılan hata: boş ayırıcı

Boş bir ayırıcı bir hatadır. PHP 8.0'dan beri explode('', 'abc') false döndürmek yerine bir ValueError fırlatır ve betik durur:

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

Bir dizgeyi karakterlere bölmek için ASCII metinlerde str_split('abc'), çok baytlı karakter içerebilecek her şeyde mb_str_split($s) kullanın.