الدالة strlen() في PHP: طول النص بالبايتات والمحارف

تعيد strlen($string) طول نص بالبايتات. وللمحارف، وهي ما تريده للنصوص اليابانية والحروف ذات العلامات والرموز التعبيرية، استخدم mb_strlen($string). وفي النص الإنجليزي العادي تعطي الدالتان العدد نفسه.

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

تُحسب المسافات وعلامات الترقيم والأسطر الجديدة كلها. strlen("a b\n") تساوي 4.

البايتات مقابل المحارف في UTF-8

نصوص PHP تسلسلات من البايتات، ويستخدم UTF-8 عددًا مختلفًا من البايتات لكل محرف: 1 لحروف ASCII وأرقامها، و2 لحروف مثل é أو ж، و3 للكانا والكانجي الشائع والمحارف الصينية ورموز مثل €، و4 لمعظم الرموز التعبيرية والكانجي النادر مثل 𠮷. تجمع strlen() البايتات؛ وتعدّ mb_strlen() المحارف.

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

استخدم strlen() عندما تهم البايتات: عمود قاعدة بيانات محدود بالبايتات، أو حجم ملف، أو بروتوكول ثنائي. واستخدم mb_strlen() لكل ما يقرؤه إنسان: عدّاد محارف، أو قاعدة «20 محرفًا كحد أقصى»، أو قطع النص بـ mb_substr().

الرموز التعبيرية والمحارف المكوّنة من عدة نقاط ترميز

تعدّ mb_strlen() نقاط ترميز Unicode. وبعض ما يراه القارئ محرفًا واحدًا هو عدة نقاط ترميز مضمومة معًا: رمز عائلة، أو علم، أو لون بشرة، أو حرف مع علامة مركّبة.

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

عدّ ما يراه القارئ محارف مفردة (عناقيد الحروف) يحتاج إلى grapheme_strlen() من امتداد intl:

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

لعدّاد محارف في نموذج ياباني، تكفي mb_strlen() عادة: كل محرف كانا وكانجي نقطة ترميز واحدة.

عرض العرض بـ mb_strwidth

في الطرفية أو في تخطيط ثابت العرض، يأخذ المحرف الياباني كامل العرض عمودين بينما يأخذ حرف الكاتاكانا نصف العرض أو الحرف اللاتيني عمودًا واحدًا. تعيد mb_strwidth() ذلك العرض، وهو ما تعنيه عادة القواعد اليابانية «全角は2文字».

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

التحقق من أن النص فارغ

أوضح اختبار هو المقارنة الصارمة بـ ''. وتعطي strlen($s) === 0 الإجابة نفسها. أما empty($s) فليست مثلها: تعيد أيضًا true للنص "0"، وهو إجابة صحيحة في نماذج كثيرة.

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

النص المكوّن من مسافات ليس فارغًا. مرّره عبر trim() أولًا إذا كان يجب ألا تُحسب المسافات وحدها شيئًا.

strlen(null) والقيم غير النصية

تتوقع strlen() نصًا. تمرير null ما زال يعيد 0، لكن منذ PHP 8.1 يطبع إشعار إهمال:

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

والمصفوفة ترمي TypeError: strlen(): Argument #1 ($string) must be of type string, array given.

حوّل القيمة أو أعطها قيمة افتراضية أولًا، مثل strlen($value ?? ''). وتُحوَّل الأعداد الصحيحة إلى نصوص، لذا تساوي strlen(12345) القيمة 5. ولعدّ عناصر مصفوفة، استخدم count().

التحقق من طول مُدخلات المستخدم

قاعدة نموذجية: اسم مستخدم من 3 إلى 16 محرفًا، بعد التشذيب. استخدم mb_strlen() حتى يُقاس الاسم الياباني بالمحارف لا بالبايتات.

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

مع strlen() مكان mb_strlen()، سيُعدّ やまだたろう بـ 18 ويُرفض لأنه طويل جدًا، مع أنه ستة محارف.