PHP substr(): Bir Dizgenin Bir Parçasını Alma

substr($string, $offset, $length) $string dizgesinin $offset konumunda (0'dan sayılır) başlayan ve $length karakter uzunluğundaki parçasını döndürür. substr('Hello world', 0, 5) "Hello" döndürür. Sona kadar her şeyi almak için $length değerini yazmayın.

<?php
$s = 'Hello world';

echo substr($s, 0, 5), "\n";   // from the start, 5 characters
echo substr($s, 6), "\n";      // from position 6 to the end
echo substr($s, 4, 3), "\n";   // 3 characters from position 4

substr() baytları sayar. İngilizce metinde bu karakterlerle aynıdır, ama Japonca, Çince, emoji veya aksanlı harflerde değildir. Bunlar için aşağıda gösterilen mb_substr() kullanın.

Söz dizimi

substr(string $string, int $offset, ?int $length = null): string

• $offset nereden başlanacağıdır. 0 ilk karakterdir. Negatif bir değer sondan sayar.
• $length kaç bayt alınacağıdır (düz ASCII metinde bir bayt bir karakterdir). Negatif bir değer sondan o kadarını dışarıda bırakır. null (ya da hiç yazmamak) "sona kadar" demektir.

Negatif başlangıç ve uzunluk: sondan çalışma

Negatif bir $offset saymaya dizgenin sonundan başlar, yani -1 son karakterdir. Negatif bir $length sondan o kadar karakter önce durur.

<?php
$file = 'report-2026.pdf';

echo substr($file, -3), "\n";       // last 3 characters
echo substr($file, -8, 4), "\n";    // 4 characters, starting 8 from the end
echo substr($file, 0, -4), "\n";    // everything except the last 4
echo substr($file, 7, -4), "\n";    // from position 7, minus the last 4

substr($s, 0, -1) son karakteri silmenin olağan yoludur, örneğin bir döngünün bıraktığı sondaki virgülü.

İlk veya son karakteri alma

Tek bir bayt için dizgeyi doğrudan da indeksleyebilirsiniz. $s[0] ilk karakterdir ve PHP 7.1'den beri $s[-1] son karakterdir.

<?php
$word = 'banana';

echo substr($word, 0, 1), ' ', $word[0], "\n";    // first character
echo substr($word, -1), ' ', $word[-1], "\n";     // last character
echo substr($word, 1), "\n";                     // drop the first character

Var olmayan bir konumu indekslemek bir uyarı yazdırır, substr() ise yalnızca boş bir dizge döndürür. Dizge boş olabiliyorsa substr() tercih edin.

Aralık dışı: false değil boş dizge

$offset dizgenin sonundan sonraysa substr() PHP 8'de "" döndürür. PHP 7'de false döndürürdü, bu yüzden === false kontrol eden eski kodlar artık çalışmaz.

<?php
var_dump(substr('abc', 5));       // start past the end
var_dump(substr('abc', 1, 100));  // length longer than the rest is fine
var_dump(substr('abc', -10));     // negative offset before the start: from 0

Japonca metin: mb_substr kullanın

UTF-8 kana ve yaygın kanji karakterlerini 3'er baytta saklar (𠮷 gibi nadir kanji ve emoji 4 bayt kaplar). substr() baytları saydığı için substr('こんにちは', 0, 3) yalnızca こ döndürür ve bir karakter sınırına denk gelmeyen bir uzunluk bir karakteri ikiye bölüp bozuk metin üretir. mb_substr() aynı argümanları alır ve karakterleri sayar.

<?php
$greeting = 'こんにちは世界';

echo substr($greeting, 0, 3), "\n";       // 3 bytes = 1 character
echo mb_substr($greeting, 0, 3), "\n";    // 3 characters
echo mb_substr($greeting, -2), "\n";      // last 2 characters

// Cutting at 4 bytes splits a character: the result is not valid UTF-8
var_dump(mb_check_encoding(substr($greeting, 0, 4), 'UTF-8'));

Aynısı emoji ve é gibi aksanlı harfler için de geçerlidir. Karakter sayıları mb_strlen() kullanır; bayt ile karakter farkı için strlen() sayfasına bakın.

Metni üç noktayla kısaltma

Bir liste veya kart için uzun bir başlığı kesmek substr() fonksiyonunun en yaygın gerçek kullanımıdır. Japonca bir başlığın asla bir karakterin ortasından kesilmemesi için mb_substr() kullanın ve ... değerini yalnızca gerçekten bir şeyi kısalttığınızda ekleyin.

<?php
function excerpt(string $text, int $max): string
{
    if (mb_strlen($text) <= $max) {
        return $text;
    }
    return rtrim(mb_substr($text, 0, $max)) . '...';
}

echo excerpt('Short title', 20), "\n";
echo excerpt('A much longer title that will not fit in the card', 20), "\n";
echo excerpt('東京から大阪までの新幹線の旅', 8), "\n";

mb_strimwidth($text, 0, $width, '...') aynısını görüntü genişliğine göre yapar; tam genişlikte bir Japonca karakter 2 sütun, bir Latin harfi 1 sütun sayılır. Sabit genişlikli düzenlere uygundur.

substr_count ile bir alt dizgeyi sayma

substr_count($haystack, $needle) $needle değerinin kaç kez geçtiğini döndürür. Büyük küçük harfe duyarlıdır ve iç içe geçen eşleşmeleri saymaz.

<?php
echo substr_count('banana', 'an'), "\n";
echo substr_count('aaaa', 'aa'), "\n";      // 2, not 3: no overlaps
echo substr_count('Hello hello', 'hello'), "\n";
echo substr_count(strtolower('Hello hello'), 'hello'), "\n";

strpos ile substr: bir karakterden önceki veya sonraki metin

Konumunu önceden bilmediğiniz bir karakterde, örneğin bir e-posta adresindeki @ işaretinde kesmek için substr() fonksiyonunu strpos() ile birleştirin:

<?php
$email = 'ada.lovelace@example.com';
$at = strpos($email, '@');

echo substr($email, 0, $at), "\n";    // before the @
echo substr($email, $at + 1), "\n";   // after the @

// strstr does the same in one call
echo strstr($email, '@', true), "\n";

Sonucunu kullanmadan önce strpos() fonksiyonunun false döndürmediğini kontrol edin: karakter yoksa false uyarı olmadan 0 kabul edilir, bu yüzden substr('nobody', 0, $at) "", substr('nobody', $at + 1) ise "obody" döndürür.