Jonglage de type

PHP ne requis pas une définition de type explicite dans les déclarations de variables. Dans ce cas, le type d'une variable est déterminé en fonction de la valeur qu'elle a stocké. C'est-à-dire, si une string est assigné à la variable $var, alors $var est de type string. Si après une valeur int est assigné à $var, elle sera de type int.

PHP peut tenter de convertir le type d'une valeur en une autre automatiquement dans certains contextes. Les différents contextes qui existent sont :

  • Numérique
  • String
  • Logique
  • Intégral et string
  • Comparatif
  • Fonction

Note: Quand une valeur à besoin d'être interpréter comme un type différent, la valeur elle-même ne change pas de type.

Pour forcer une variable a être évaluer comme un type particulier, voir la section sur le casting de type. Pour changer le type d'une variable, voir la fonction settype().

Contextes numériques

Ceci est le contexte lors de l'utilisation d' opérateur arithmétique.

Dans ce contexte si un des opérandes est un float (ou pas interprétable comme int), les deux opérandes sont interprétés comme des floats, et le résultat sera un float. Sinon, les opérandes sont interprétés comme des ints, et le résultat sera aussi un int. À partir de PHP 8.0.0, si un des opérandes ne peut être interprétés une TypeError est lancée.

Contextes string

Ceci est le contexte lors de l'utilisation de echo, print, l'interpolation de chaînes de caractères, ou l' opérateur de concaténation pour les chaînes de caractères.

Dans ce contexte la valeur sera interprété comme une string.

Contextes logiques

Ceci est le contexte lors de l'utilisation de déclarations conditionnelles, l'opérateur ternaire, ou un opérateur logique.

Dans ce contexte la valeur sera interprété comme un bool.

Contextes intégraux et string

Ceci est le contexte lors de l'utilisation d'un opérateur bit à bit.

Dans ce contexte si tous les opérandes sont de type string alors le résultat sera aussi une string. Sinon, les opérandes seront interprétés comme des ints, et le résultat sera aussi un int. À partir de PHP 8.0.0, si un des opérandes ne peut être interprétés une TypeError est lancée.

Contextes comparatifs

Ceci est le contexte lors de l'utilisation d'un opérateur de comparaison.

Les conversions de types qui se produisent dans ce contexte sont expliqués dans le tableau Comparaison avec plusieurs types.

Contextes de fonctions

Ceci est le contexte quand une valeur est passé à un paramètre ou propriété typé ou retourné depuis une fonction qui déclare un type de retour.

Dans ce contexte, quand le mode de typage coercitif est actif (par défaut), seul les valeurs scalaires peuvent être convertie en une autre valeur scalaire. Pour les déclarations de types simples le comportement est le suivant :

  • Type de déclaration bool : valeur est interprété comme bool. Type de déclaration int : valeur est interprété comme int si la conversion est bien-définie. C.-à-d. si la chaîne est numeric. Type de déclaration float : valeur est interprété comme float si la conversion est bien-définie. C.-à-d. si la chaîne est numeric. Type de déclaration string : valeur est interprété comme string.
Si la déclaration de type est une union, voir la section à propos du Typage coercitif avec les types d'union.

Avertissement

Les fonctions internes convertissent automatiquement null en type scalaire, ce comportement est OBSOLÈTE à partir de PHP 8.1.0.

Cast de type

Le casting de type convertie la valeur à un type donnée en écrivant le type entre parenthèse avant la valeur à convertir.

<?php
$foo 
10;   // $foo is an integer
$bar = (bool) $foo;   // $bar is a boolean
?>

Les casts permis sont :

  • (int) - cast en int
  • (bool) - cast en bool
  • (float) - cast en float
  • (string) - cast en string
  • (array) - cast en array
  • (object) - cast en object
  • (unset) - cast en NULL

Note:

(integer) est un alias du cast (int). (boolean) est un alias du cast (bool). (binary) est un alias du cast (string). (double) et (real) sont des alias du cast (float). Ces casts n'utilisent pas le nom de type canonique est ne sont pas recommandé.

Avertissement

L'alias de cast (real) est obsolète à partir de PHP 8.0.0.

Avertissement

Le cast (unset) a été rendu obsolète à partir de PHP 7.2.0. À noter que le cast (unset) est identique à assigner la valeur NULL à une variable ou un appel. Le cast (unset) est supprimé à partir de PHP 8.0.0.

Attention

Le cast (binary) et le préfixe b existe uniquement pour la compatibilité ascendante. Actuellement (binary) et (string) sont identique, mais ceci peut changer et ne devrait pas être invoqué.

Note:

Les espaces blancs sont ignoré à l'intérieur des parenthèses d'un cast. Ansi, les deux casts suivant sont équivalents :

<?php
$foo 
= (int) $bar;
$foo = ( int ) $bar;
?>

Cast de strings littérales et variables en strings binaires :

<?php
$binary 
= (binary) $string;
$binary b"binary string";
?>

Note: Au lieu de cast une variable en une string, il est également possible d'entourer la variable de guillemets doubles.

<?php
$foo 
10;            // $foo is an integer
$str "$foo";        // $str is a string
$fst = (string) $foo// $fst is also a string

// This prints out that "they are the same"
if ($fst === $str) {
    echo 
"they are the same";
}
?>

Il n'est pas forcément évident ce qui se produira exactement lors d'un casting entre certains types. Pour plus d'informations, voir ces sections :

Note: Comme PHP prend en charge l'indexation dans les strings via des positions en utilisant la même syntaxe que l'indexation des array, l'exemple suivant est valable pour toutes les versions de PHP :

De plus, puisque PHP supporte l'indexation des chaînes de caractères via des positions en utilisant la même syntaxe que pour les tableaux, l'exemple suivant est vrai pour toutes les versions de PHP :

<?php
$a    
'car'// $a est une chaîne de caractères
$a[0] = 'b';   // $a est toujours une chaîne de caractères
echo $a;       // bar
?>
Voir la section sur l'accès aux chaînes par caractères pour plus d'informations.