PHP strlen(): Bayt ve Karakter Olarak Dizge Uzunluğu

strlen($string) bir dizgenin uzunluğunu bayt olarak döndürür. Japonca metin, aksanlı harfler ve emoji için istediğiniz şey olan karakterler için mb_strlen($string) kullanın. Düz İngilizce metinde ikisi aynı sayıyı verir.

<?php
echo strlen('Hello'), "\n";         // 5 bytes
echo mb_strlen('Hello'), "\n";      // 5 characters

echo strlen('こんにちは'), "\n";     // 15 bytes
echo mb_strlen('こんにちは'), "\n";  // 5 characters

Boşluklar, noktalama işaretleri ve yeni satırların hepsi sayılır. strlen("a b\n") 4'tür.

UTF-8'de bayt ve karakter

PHP dizgeleri bayt dizileridir ve UTF-8 karakter başına farklı sayıda bayt kullanır: ASCII harfler ve rakamlar için 1, é veya ж gibi harfler için 2, kana, yaygın kanji, Çince karakterler ve € gibi semboller için 3, çoğu emoji ve 𠮷 gibi nadir kanji için 4. strlen() baytları toplar; mb_strlen() karakterleri sayar.

<?php
$samples = ['A', 'é', 'ж', 'あ', '漢', '€', '😀'];

foreach ($samples as $char) {
    printf("%s  strlen=%d  mb_strlen=%d\n", $char, strlen($char), mb_strlen($char));
}

$mixed = 'PHPで文字数';
printf("%s  strlen=%d  mb_strlen=%d\n", $mixed, strlen($mixed), mb_strlen($mixed));

Baytlar önemli olduğunda strlen() kullanın: bayt olarak sınırlı bir veritabanı sütunu, bir dosya boyutu, ikili bir protokol. Bir insanın okuduğu her şey için mb_strlen() kullanın: bir karakter sayacı, "en fazla 20 karakter" kuralı, metni mb_substr() ile kesmek.

Emoji ve birkaç kod noktasından oluşan karakterler

mb_strlen() Unicode kod noktalarını sayar. Okuyucunun tek karakter olarak gördüğü bazı şeyler birleştirilmiş birkaç kod noktasıdır: bir aile emojisi, bir bayrak, bir ten rengi ya da bir harf ile birleşen bir aksan.

<?php
$items = [
    'thumbs up'      => '👍',
    'with skin tone' => '👍🏽',
    'flag of Japan'  => '🇯🇵',
    'family'         => '👨‍👩‍👧',
    'e + accent'     => "e\u{0301}",
];

foreach ($items as $name => $text) {
    printf("%-15s %s  strlen=%2d  mb_strlen=%d\n", $name, $text, strlen($text), mb_strlen($text));
}

Okuyucunun tek karakter olarak gördüklerini (grafem kümeleri) saymak intl eklentisindeki grapheme_strlen() fonksiyonunu gerektirir:

echo grapheme_strlen('👨‍👩‍👧');   // 1
echo grapheme_strlen('🇯🇵');     // 1

Japonca bir formdaki karakter sayacı için mb_strlen() genellikle yeterlidir: her kana ve kanji tek bir kod noktasıdır.

mb_strwidth ile görüntü genişliği

Bir terminalde veya sabit genişlikli bir düzende tam genişlikte bir Japonca karakter iki sütun kaplarken yarım genişlikte bir katakana veya Latin harfi bir sütun kaplar. mb_strwidth() bu genişliği döndürür; Japonca "全角は2文字" kuralları genellikle bunu kasteder.

<?php
foreach (['abc', 'ｱｲｳ', 'アイウ', '日本語', 'PHP入門'] as $s) {
    printf("%s  mb_strlen=%d  mb_strwidth=%d\n", $s, mb_strlen($s), mb_strwidth($s));
}

Bir dizgenin boş olup olmadığını kontrol etme

En açık test '' ile katı bir karşılaştırmadır. strlen($s) === 0 aynı yanıtı verir. empty($s) aynı değildir: birçok formda geçerli bir yanıt olan "0" dizgesi için de true döndürür.

<?php
foreach (['', '0', ' ', 'a'] as $s) {
    printf(
        "%-5s  === '': %-5s  strlen: %d  empty(): %s\n",
        var_export($s, true),
        var_export($s === '', true),
        strlen($s),
        var_export(empty($s), true)
    );
}

Boşluklardan oluşan bir dizge boş değildir. Yalnızca boşlukların hiçbir şey sayılması gerekiyorsa önce trim() içinden geçirin.

strlen(null) ve dizge olmayanlar

strlen() bir dizge bekler. null vermek hâlâ 0 döndürür, ama PHP 8.1'den beri bir kullanımdan kaldırma bildirimi yazdırır:

Deprecated: strlen(): Passing null to parameter #1 ($string) of type string is deprecated in /home/index.php on line 2

Bir dizi TypeError: strlen(): Argument #1 ($string) must be of type string, array given fırlatır.

Değeri önce dönüştürün veya varsayılan verin, örneğin strlen($value ?? ''). Tam sayılar dizgeye çevrilir, bu yüzden strlen(12345) 5'tir. Dizi elemanlarını saymak için count() kullanın.

Kullanıcı girdisinin uzunluğunu doğrulama

Tipik bir kural: kırpıldıktan sonra 3 ile 16 karakter arası bir kullanıcı adı. Japonca bir ismin bayt olarak değil karakter olarak ölçülmesi için mb_strlen() kullanın.

<?php
function checkUsername(string $name): string
{
    $name = trim($name);
    $length = mb_strlen($name);

    if ($length < 3) {
        return "\"$name\" is too short ($length characters, min 3)";
    }
    if ($length > 16) {
        return "\"$name\" is too long ($length characters, max 16)";
    }
    return "\"$name\" is OK ($length characters, " . strlen($name) . ' bytes)';
}

echo checkUsername('ad'), "\n";
echo checkUsername('ada_lovelace'), "\n";
echo checkUsername('やまだたろう'), "\n";
echo checkUsername('a_very_long_username_here'), "\n";

mb_strlen() yerine strlen() ile やまだたろう 18 sayılır ve altı karakter olmasına rağmen çok uzun diye reddedilirdi.