Conversion de type PHP : string en int, intval() et (int)

Pour convertir une valeur vers un autre type, placez le type entre parenthèses devant elle : (int) "42" donne l'entier 42. La forme fonction intval("42") fait la même chose. Un cast n'échoue jamais : un texte qui n'est pas un nombre devient 0, et une chaîne qui commence par des chiffres ne garde que ces chiffres.

<?php
$input = "42";

var_dump((int) $input);
var_dump(intval($input));
var_dump((int) "12abc");   // leading digits only
var_dump((int) "abc");     // not a number at all
var_dump((float) "3.14");
var_dump((string) 99);
var_dump((bool) "0");

Les casts disponibles en PHP sont (int), (float), (string), (bool), (array) et (object). Chacun a aussi une fonction : intval(), floatval(), strval(), boolval().

De string à int : ce que renvoient (int) et intval()

PHP lit les chiffres depuis le début de la chaîne, après avoir ignoré les espaces initiaux, et s'arrête au premier caractère qui ne peut pas faire partie d'un nombre. La notation avec exposant compte comme un nombre, pas un préfixe 0x.

<?php
$samples = ["42", "  42", "-17", "12.7", "1e3", "12abc", "abc", "", "0x1A", "012"];

foreach ($samples as $s) {
    printf("%-8s => %d\n", var_export($s, true), (int) $s);
}

Remarquez que "12.7" devient 12 : convertir en int coupe la partie décimale, cela n'arrondit pas. Ni (int) ni intval() n'affichent de warning ici, quelle que soit l'entrée.

intval() avec une base

intval($value, $base) lit la chaîne dans un autre système de numération. Avec la base 0, PHP regarde le préfixe : 0x pour l'hexadécimal, 0b pour le binaire, un 0 initial pour l'octal.

<?php
var_dump(intval("ff", 16));
var_dump(intval("101", 2));
var_dump(intval("777", 8));
var_dump(intval("0x1A", 0));
var_dump(intval("0b101", 0));
var_dump(intval("012", 0));    // octal because of the leading 0
var_dump(intval("012"));       // base 10 by default

// Converting the other way
echo dechex(255), " ", decbin(5), " ", base_convert("ff", 16, 2), "\n";

De float à int : troncature, pas arrondi

(int) supprime tout ce qui suit le point décimal, vers zéro. Arrondissez d'abord si vous voulez l'entier le plus proche, et faites attention aux parenthèses :

<?php
var_dump((int) 12.99);
var_dump((int) -12.99);
var_dump((int) round(12.5));

// Precedence: the cast applies to (0.1 + 0.7) before * 10
var_dump((int) (0.1 + 0.7) * 10);
var_dump((int) ((0.1 + 0.7) * 10));
var_dump((int) round((0.1 + 0.7) * 10));

La dernière paire est le piège classique des floats : (0.1 + 0.7) * 10 est stocké comme 7.999999..., donc la troncature donne 7. Arrondir d'abord donne 8. La page des fonctions mathématiques couvre round, floor et ceil.

Convertir en bool, en string et en array

En bool, seule une poignée de valeurs deviennent false : 0, 0.0, "", "0", null et []. Tout le reste vaut true, y compris "0.0", " " et "false".

En string, true devient "1", alors que false et null deviennent tous deux "". Les floats perdent un .0 final, et les floats très grands ou très petits utilisent la notation avec exposant.

<?php
foreach (["0", "0.0", " ", "false", [], [0], 0.0, -1, null] as $v) {
    printf("%-10s => %s\n", json_encode($v), var_export((bool) $v, true));
}

echo "---\n";
var_dump((string) true, (string) false, (string) null);
var_dump((string) 3.0, (string) 0.1, (string) 1e25);

echo "---\n";
var_dump((array) "a");     // a scalar becomes a one-element array
var_dump((array) null);    // null becomes an empty array

Convertir un tableau en chaîne ne l'assemble pas. Ceci affiche Tags: Array :

<?php
$tags = ["php", "web"];
echo "Tags: " . $tags;

et PHP ajoute un warning :

Warning: Array to string conversion in /home/index.php on line 3

Utilisez implode(", ", $array) ou json_encode($array) pour transformer un tableau en texte.

Tous les casts en un coup d'œil

Choisissez une valeur pour voir ce que intval, (bool), strval, is_numeric et gettype renvoient. Chaque case a été calculée par PHP 8.3.

Point at or tap a cell to read it as PHP.

$x	intval	bool	strval	is_numeric	gettype
"10"	10	true	'10'	true	'string'
"1abc"	1	true	'1abc'	false	'string'
"abc"	0	true	'abc'	false	'string'
""	0	false	''	false	'string'
" "	0	true	' '	false	'string'
"0"	0	false	'0'	true	'string'
"0.0"	0	true	'0.0'	true	'string'
"1e1"	10	true	'1e1'	true	'string'
"010"	10	true	'010'	true	'string'
1.5	1	true	'1.5'	true	'double'
true	1	true	'1'	false	'boolean'
false	0	false	''	false	'boolean'
null	0	false	''	false	'NULL'
[]	0	false	"Array" + warning	false	'array'
[1, 2]	1	true	"Array" + warning	false	'array'

Every cell computed by PHP 8.3.19.

Chaînes numériques et conversion automatique

Une chaîne numérique est une chaîne qui ressemble à un nombre : "12", "-3.5", "1e3", avec éventuellement des espaces autour. PHP les convertit automatiquement dans les calculs, et is_numeric() vous dit si une chaîne en fait partie.

<?php
foreach (["12", "12.5", "1e3", " 12", "12 ", "12abc", "0x1A", ""] as $s) {
    printf("%-8s is_numeric: %s\n", var_export($s, true), var_export(is_numeric($s), true));
}

echo "---\n";
var_dump("5" * "4");     // both numeric: int
var_dump("5" + 1.5);     // float
var_dump(10 . "");       // int to string with concatenation

"12abc" + 1 donne toujours 13, mais PHP 8 affiche Warning: A non-numeric value encountered, et "abc" + 1 lève une TypeError. Convertissez ou validez avant de calculer sur une saisie utilisateur.

settype() et gettype()

settype() change le type d'une variable sur place et gettype() l'indique. get_debug_type() renvoie les noms plus courts que vous voyez dans les messages d'erreur (int, float, string).

<?php
$value = "42";
echo gettype($value), "\n";

settype($value, "integer");
var_dump($value);
echo gettype($value), " / ", get_debug_type($value), "\n";

$price = "19.90";
settype($price, "float");
var_dump($price);

La plupart du code utilise plutôt un cast ($value = (int) $value;), plus court et tout aussi lisible.

Valider une saisie au lieu de la convertir

(int) ne dit jamais non, donc (int) "abc" devient 0 en silence et (int) "5 apples" devient 5. Pour une saisie de formulaire, utilisez filter_var avec FILTER_VALIDATE_INT : il renvoie l'entier ou false.

<?php
foreach (["42", " 42 ", "42abc", "4.2", "042", "-7", "abc"] as $input) {
    $n = filter_var($input, FILTER_VALIDATE_INT);
    printf("%-8s => %s\n", var_export($input, true), $n === false ? "rejected" : $n);
}

Comparez le résultat avec === false, car 0 est un entier valide et == false le rejetterait. La page filter_var montre les plages de valeurs et les autres validateurs.