PHP strlen() : longueur d'une chaîne en octets et caractères

strlen($string) renvoie la longueur d'une chaîne en octets. Pour des caractères, ce qu'il vous faut pour du texte japonais, des lettres accentuées et des emoji, utilisez mb_strlen($string). Pour du texte anglais simple, les deux donnent le même nombre.

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

Les espaces, la ponctuation et les sauts de ligne comptent tous. strlen("a b\n") vaut 4.

Octets ou caractères en UTF-8

Les chaînes PHP sont des suites d'octets, et l'UTF-8 utilise un nombre d'octets différent selon le caractère : 1 pour les lettres et chiffres ASCII, 2 pour des lettres comme é ou ж, 3 pour les kana, les kanji courants, les caractères chinois et des symboles comme €, et 4 pour la plupart des emoji et les kanji rares comme 𠮷. strlen() additionne les octets ; mb_strlen() compte les caractères.

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

Utilisez strlen() quand les octets comptent : une colonne de base de données limitée en octets, une taille de fichier, un protocole binaire. Utilisez mb_strlen() pour tout ce qu'une personne lit : un compteur de caractères, une règle « 20 caractères maximum », la découpe de texte avec mb_substr().

Emoji et caractères formés de plusieurs points de code

mb_strlen() compte des points de code Unicode. Certaines choses qu'un lecteur voit comme un seul caractère sont plusieurs points de code assemblés : un emoji famille, un drapeau, une couleur de peau, ou une lettre plus un accent combinant.

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

Compter ce qu'un lecteur voit comme des caractères uniques (des clusters de graphèmes) demande grapheme_strlen() de l'extension intl :

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

Pour un compteur de caractères sur un formulaire japonais, mb_strlen() suffit en général : chaque kana et chaque kanji est un seul point de code.

Largeur d'affichage avec mb_strwidth

Dans un terminal ou une mise en page à largeur fixe, un caractère japonais pleine chasse occupe deux colonnes alors qu'un katakana demi-chasse ou une lettre latine en occupe une. mb_strwidth() renvoie cette largeur, ce que désignent en général les règles japonaises « 全角は2文字 » (un caractère pleine chasse compte double).

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

Vérifier si une chaîne est vide

Le test le plus clair est une comparaison stricte avec ''. strlen($s) === 0 donne la même réponse. empty($s) n'est pas équivalent : elle renvoie aussi true pour la chaîne "0", une réponse valide dans beaucoup de formulaires.

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

Une chaîne d'espaces n'est pas vide. Passez-la d'abord dans trim() si des espaces seuls doivent compter comme rien.

strlen(null) et les valeurs qui ne sont pas des chaînes

strlen() attend une chaîne. Passer null renvoie toujours 0, mais depuis PHP 8.1 un avis de dépréciation s'affiche :

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

Un tableau lève TypeError: strlen(): Argument #1 ($string) must be of type string, array given.

Convertissez la valeur ou donnez-lui une valeur par défaut d'abord, par exemple strlen($value ?? ''). Les entiers sont convertis en chaînes, donc strlen(12345) vaut 5. Pour compter les éléments d'un tableau, utilisez count().

Valider la longueur d'une saisie utilisateur

Une règle typique : un nom d'utilisateur de 3 à 16 caractères, après trim. Utilisez mb_strlen() pour qu'un nom japonais soit mesuré en caractères, pas en octets.

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

Avec strlen() au lieu de mb_strlen(), やまだたろう compterait 18 et serait refusé comme trop long, alors qu'il fait six caractères.