Une &string; est une série de caractères, où un caractère est la même chose qu'un octet. De ce fait, PHP ne supporte que les jeux de caractères comportant 256 caractères différents, et, donc, n'a pas de support natif pour l'Unicode. Reportez-vous aux détails sur le type chaîne de caractères pour plus d'informations. Sur les systèmes 32-bit une &string; peut être d'une taille allant jusqu'au plus 2Go (2147483647 octets maximum). Une &string; littérale peut être spécifiée de 4 façons différentes : Guillemets simples Guillemets doubles Syntaxe Heredoc Syntaxe Nowdoc La façon la plus simple de spécifier une &string; est de l'entourer de guillemets simples (le caractère '). Pour spécifier un guillemet simple littéral, il doit être échappé à l'aide d'un antislash (\). Pour spécifier un antislash littéral, doublez-le (\\). Toute les autres instances d'antislash seront traitées comme un antislash littéral : ce qui signifie que les autres séquences auquelles vous êtes éventuellement habitués (comme \r ou \n) s'afficheront telles quelles, sans avoir une quelconque signification particulière. Contrairement aux syntaxes avec double guillemets et heredoc, les variables et les séquences d'échappement pour les caractères spéciaux ne seront pas interprétées lorsqu'elles figurent dans une &string; entourée de guillemets simples. ]]> Si la &string; est entourée de guillemets doubles ("), PHP interprétera les séquences d'échappement suivantes pour les caractères spéciaux : Séquence Signification \n Fin de ligne (LF ou 0x0A (10) en ASCII) \r Retour à la ligne (CR ou 0x0D (13) en ASCII) \t Tabulation horizontale (HT or 0x09 (9) en ASCII) \v Tabulation verticale (VT ou 0x0B (11) en ASCII) \e échappement (ESC or 0x1B (27) en ASCII) \f Saut de page (FF ou 0x0C (12) en ASCII) \\ Antislash \$ Signe dollar \" Guillemet double \[0-7]{1,3} La séquence de caractères correspondant à cette expression rationnelle est un caractère, en notation octale, qui débordera silencieusement pour s'adapter à un octet (e.g. "\400" === "\000") \x[0-9A-Fa-f]{1,2} La séquence de caractères correspondant à cette expression rationnelle est un caractère, en notation hexadécimale \u{[0-9A-Fa-f]+} La séquence de caractères correspondant à l'expression régulière est un point de code Unicode, qui sera la sortie de la chaîne de caractères représentant le codepoint UTF-8 De la même façon que pour les &string; entourées de guillemets simples, l'échappement de tout autre caractère affichera l'antislash. La fonctionnalité la plus intéressante des &string; guillemets doubles est que les noms de variables seront interprétés. Voir la documentation sur l'analyse des chaînes de caractères pour plus de détails. Une troisième façon de délimiter une &string; est la syntaxe Heredoc : <<<. Après cet opérateur, un identifiant est fourni, suivi d'une nouvelle ligne. La &string; en elle-même vient ensuite, suivie du même identifiant pour fermer la notation. L'identifiant de fin peut être indenté par des espaces ou tabulations, au quel cas l'indentation sera retirée de toutes les lignes dans la chaîne de caractères doc. Antérieur à PHP 7.3.0, l'identifiant de fin doit commencer à la première colonne de la ligne. De plus, l'identifiant doit suivre les mêmes règles que n'importe quel autre libellé PHP : il ne doit contenir que des caractères alphanumériques et des soulignés, et doit commencer par un caractère non numérique ou un souligné ("underscore"). &example.outputs.73; Si l'identifiant de fin est indenté plus que n'importe quelle ligne du texte, alors une ParseError sera lancée : &example.outputs.73; Si l'identifiant de fin est indenté, alors les tabulations peuvent aussi être utilisé, néanmoins, les tabulations et les espaces ne doivent pas être mélangé en ce qui concerne l'indentation de l'identifiant et l'indentation du texte (jusqu'à l'identifiant de fin). Dans quelconque de ces cas, une ParseError sera lancée. Ces contraintes sur les caractères d'espacement blanc ont été incluse car le mélange de tabulations et d'espaces pour l'indentation est nuisible à la lisibilité. &example.outputs.73; L'identifiant de fin du corps du texte n'est pas requis d'être suivi d'une point virgule ou une nouvelle ligne. Par example, le code suivant est autorisé à partir de PHP 7.3.0: &example.outputs.73; string(11) "a b c" [1] => string(5) "d e f" } ]]> Si l'identifiant de fin a été trouvé au début d'une ligne, alors peut importe s'il fait partie d'un autre mot, il peut être considéré comme l'identifiant de fin et causer une ParseError. &example.outputs.73; Pour éviter ce problème, il suffit de suivre cette règle simple : ne pas choisir l'identifiant de fin qui apparait dans le corps du texte. Antérieur à PHP 7.3.0, il est très important de noter que la ligne contenant l'identifiant de fin ne doit contenir aucun autre caractère, mis à part un point-virgule (;). Cela signifie en particulier que l'identifiant ne doit pas être indenté, et qu'il ne doit y avoir aucun espace ou tabulation avant ou après le point-virgule. Il est également important de garder à l'esprit que le premier caractère avant l'identifiant de fermeture doit être une nouvelle ligne telle que définie par le système d'exploitation ; sur les systèmes Unix, incluant macOS, il s'agit du caractère \n. Le délimiteur de fermeture doit aussi être suivi d'une nouvelle ligne. Si cette règle n'est pas respectée et que l'identifiant de fermeture n'est pas "propre", il ne sera pas considéré comme identifiant de fermeture, et PHP continuera à en chercher un. Si un identifiant de fermeture "propre" n'est pas trouvé avant la fin du fichier courant, une erreur d'analyse sera émise à la dernière ligne. ]]> ]]> Heredoc contenant des variables ne peuvent être utilisé pour initialiser les propriétés d'une classe. Heredoc se comporte exactement comme une &string; guillemets doubles, sans les guillemets doubles. Cela signifie que les guillemets dans une syntaxe Heredoc n'ont pas besoin d'être échappés, mais que les codes d'échappement listés plus haut peuvent toujours être utilisés. Les variables seront interprétées, mais les mêmes précautions doivent être prises lorsque des variables complexes sont exprimées dans une Heredoc comme avec &string;. foo = 'Foo'; $this->bar = array('Bar1', 'Bar2', 'Bar3'); } } $foo = new foo(); $name = 'MyName'; echo <<foo. Maintenant, j'affiche quelques {$foo->bar[1]}. Et ceci devrait afficher un 'A' majuscule : \x41 EOT; ?> ]]> &example.outputs; Il est aussi possible d'utiliser la syntaxe Heredoc pour passer des données en paramètre à une fonction : Il est possible d'initialiser les variables statiques et les propriétés ou constantes de classes avec la syntaxe Heredoc : ]]> L'identifiant ouvrant Heredoc peut éventuellement être écrit entre guillemets doubles : ]]> Nowdoc est aux chaînes guillemets simples ce qu'Heredoc est aux chaînes guillemets doubles. Un Nowdoc est spécifié de manière similaire à un Heredoc, mais aucune analyse n'est effectuée à l'intérieur d'une Nowdoc. Cette syntaxe est idéale pour embarquer du code PHP ou d'autres larges blocs de texte, sans avoir besoin d'échapper quoi que ce soit. Elle partage quelques fonctionnalités avec la syntaxe SGML <![CDATA[ ]]>, en ce qu'elle déclare un bloc de texte qui ne doit pas être analysé. Nowdoc est identifié avec la même séquence <<< utilisée par Heredoc, mais l'identifiant qui suit est entouré de guillemets simples, comme <<<'EOT'. Toutes les règles concernant les identifiants Heredoc s'appliquent également aux identifiants Nowdoc, et, tout particulièrement, celles concernant la forme de l'identifiant de fin. &example.outputs; foo = 'Foo'; $this->bar = array('Bar1', 'Bar2', 'Bar3'); } } $foo = new foo(); $name = 'MyName'; echo <<<'EOT' Mom nom est "$name". J'affiche quelques $foo->foo. Maintenant, j'affiche quelques {$foo->bar[1]}. Ceci ne devrait pas afficher un 'A' : \x41 EOT; ?> ]]> &example.outputs; foo. Maintenant, j'affiche quelques {$foo->bar[1]}. Ceci ne devrait pas afficher un 'A' : \x41]]> ]]> Lorsqu'une &string; est spécifiée entre guillemets doubles ou en Heredoc, les variables qu'elle contient sont interprétées. Il existe 2 types de syntaxes : une simple et une complexe. La syntaxe simple est la plus commune et la plus pratique. Elle fournit une façon d'embarquer une variable, une valeur de &array;, ou une propriété d'&object; dans une &string; avec un minimum d'effort. La syntaxe complexe se reconnaît à l'utilisation d'accolades autour de l'expression. Si un signe dollar ($) est rencontré, l'analyseur prendra autant de caractères que possible pour former un nom de variable valide. Entourer le nom de la variable avec des accolades, pour spécifier explicitement la fin de celui-ci. ]]> &example.outputs; De la même façon, un index d'un &array; ou une propriété d'un &object; peut être analysé. Avec les indices de tableaux, le crochet fermant (]) marque la fin de l'index. Les mêmes règles sont appliquées aux propriétés d'objets que pour les simples variables. "raisin"); echo "Il a bu du jus de $juices[0].".PHP_EOL; echo "Il a bu du jus de $juices[1].".PHP_EOL; echo "Il a bu du jus de $juices[koolaid1].".PHP_EOL; class people { public $john = "John Smith"; public $jane = "Jane Smith"; public $robert = "Robert Paulsen"; public $smith = "Smith"; } $people = new people(); echo "$people->john a bu du jus de $juices[0].".PHP_EOL; echo "$people->john a dit bonjour à $people->jane.".PHP_EOL; echo "$people->john's wife greeted $people->robert.".PHP_EOL; echo "$people->robert a dit bonjour aux $people->smiths."; // Ne fonctionne pas ?> ]]> &example.outputs; À partir de PHP 7.1.0 les indices numériques négatifs sont aussi supportés. ]]> &example.outputs; Pour tout ce qui est plus complexe, vous devriez utiliser la syntaxe complexe. Cette syntaxe est appelée complexe, non pas parce qu'elle est complexe, mais parce qu'elle permet l'utilisation d'expressions complexes. Toute variable scalaire, élément de tableau ou attribut d'objet représentable en tant que &string; peut être utilisé avec cette syntaxe. L'expression est écrite de la même façon qu'elle apparaitrait à l'extérieur de la &string; et est entouré des caractères { et }. Sachant que { ne peut pas être échappé, cette syntaxe ne sera reconnue que lorsque le $ suit immédiatement {. Utiliser {\$ pour afficher littéralement {$. Voici quelques exemples pour éclaircir ceci : width}00 centimeters broad."; // Fonctionne, les clés entourées de guillemets simples ne fonctionnent qu'avec la syntaxe à accolades echo "This works: {$arr['key']}"; // Fonctionne echo "This works: {$arr[4][3]}"; // Ceci est faux pour la même raison pour laquelle $foo[bar] est faux à l'extérieur d'une chaîne. // En d'autres termes, ceci fonctionnera, mais uniquement parce que PHP cherchera d'abord // une constante nommée foo ; une erreur de niveau E_NOTICE (constante indéfinie) sera émise. echo "This is wrong: {$arr[foo][3]}"; // Fonctionne. Lors de l'utilisation de tableaux multidimensionnels, utilisez toujours // les accolades autour du tableau lorsqu'il se trouve dans la chaîne echo "This works: {$arr['foo'][3]}"; // Fonctionne. echo "This works: " . $arr['foo'][3]; echo "This works too: {$obj->values[3]->name}"; echo "This is the value of the var named $name: {${$name}}"; echo "This is the value of the var named by the return value of getName(): {${getName()}}"; echo "This is the value of the var named by the return value of \$object->getName(): {${$object->getName()}}"; // Ne fonctionne pas, affiche : This is the return value of getName(): {getName()} echo "This is the return value of getName(): {getName()}"; // Ne fonctionne pas, affiche : C:\folder\{fantastic}.txt echo "C:\folder\{$great}.txt" // fonctionne, affiche : C:\folder\fantastic.txt echo "C:\\folder\\{$great}.txt" ?> ]]> Il est également possible d'accéder aux propriétés de classes en utilisant des variables contenues dans des chaînes, en utilisant cette syntaxe. $bar}\n"; echo "{$foo->{$baz[1]}}\n"; ?> ]]> &example.outputs; Les valeurs accédé via les fonctions, méthodes, variables statiques de classes, ainsi que les constantes de classes à l'intérieur de {$} sont interprétée comme le nom d'une variable dans le contexte où la chaîne est définie. L'utilisation de simples accolades ({}) ne fonctionnera pas pour accéder à la valeur retournée par des fonctions, méthodes, ou les valeurs de constantes et de variables statiques de classes. ]]> On peut accéder à, et modifier un, caractère d'une &string; en spécifiant sa position (à partir de 0) après la &string; en utilisant les crochets de &array;, tel que $str[42]. Il convient dans ce cas de voir une &string; comme un &array; de caractères. Les fonctions substr et substr_replace peuvent être utilisées lorsque vous voulez extraire ou remplacer plus d'un caractère. À partir de PHP 7.1.0, les positions négatives dans les chaînes de caractères sont aussi supportées. Cela spécifie la position en partant de la fin de la chaîne de caractères. Auparavant, les index négatif émettait E_NOTICE pour la lecture (donnant une chaîne vide) et E_WARNING pour l'écriture (laissant la chaîne inchangée). Antérieur à PHP 8.0.0, les strings pouvait aussi être accédé en utilisant les accolades, comme ceci $str{42}. La syntaxe avec les accolades a été rendu obsolète en PHP 7.4.0 et n'est plus supportée à partir de PHP 8.0.0. Écrire à une position hors de l'intervalle existant fait que la chaîne est complétée par des espaces jusqu'à cette position. Les positions sont toujours converties en valeur entière. Les types de positions invalides émettent une E_WARNING. Seul le premier caractère d'une chaîne assignée est utilisé. À partir de PHP 7.1.0, assigner une chaîne vide lève une erreur fatale. Auparavant, cela affectait un octet NULL. En interne, les chaînes PHP sont des tableaux d'octets. Ainsi, l'accès ou la modification d'une chaîne en utilisant les crochets d'un tableau n'est pas multioctets, et ne doit être utilisé qu'avec les chaînes dont l'encodage est sur un seul octet, comme ISO-8859-1. À partir de PHP 7.1.0, appliquer un index vide sur une chaîne vide lève une erreur fatale. Auparavant, la chaîne était silencieusement convertie en un tableau. ]]> Les positions d'une chaîne doivent être un entier, ou des chaînes pouvant être converties en entier, sinon, une alerte sera émise. ]]> &example.outputs; Accéder à des variables d'autres types (pas des tableaux ni des objets implémentant les interfaces appropriées) en utilisant [] ou {} retournera silencieusement &null;. Les caractères dans une chaîne de caractères littérales peuvent être accédé en utilisant la syntaxe [] ou {}. Accéder aux caractères dans une chaîne de caractères littérales en utilisant la syntaxe {} a été rendu obsolète en PHP 7.4. Ceci a été supprimée en PHP 8.0. Les &string; peuvent être concaténées en utilisant l'opérateur '.' (point). Il est à noter que l'opérateur '+' (addition) ne fonctionnera pas. Voir opérateurs de chaînes pour plus d'informations. Il existe de nombreuses fonctions utiles pour la manipulation de &string;. Voir la section sur les fonctions de chaînes de caractères pour des fonctions génériques, et à la section sur les expressions rationnelles compatibles Perl pour des fonctionnalités de recherches et remplacements avancés. Il existe également des fonctions pour les URL, et des fonctions pour chiffrer/déchiffrer des chaînes de caractères (Sodium et Hash). Finalement, voir aussi les fonctions "type de caractères". Une valeur peut être convertie en une &string; en utilisant le mot-clé (string) ou la fonction strval. La conversion en &string; est automatiquement effectuée dans le contexte d'une expression où une &string; est nécessaire. Ceci survient notamment lors de l'utilisation des fonctions echo ou print, ou lorsqu'une variable est comparée à une &string;. Les sections sur les types et sur le transtypage expliquent ce qui suit de manière plus détaillée. Voir aussi la fonction settype. Une valeur &boolean; &true; est convertie en la &string; "1". Une valeur &boolean; &false; est convertie en "" (une chaîne vide). Ceci permet les conversions vers et depuis les valeurs &boolean; et &string;. Un &integer; ou un &float; est converti en une &string; représentant le nombre de façon textuelle (y compris l'exposant pour les &float;). Les nombres à virgule flottante peuvent être convertis en utilisant la notation exponentielle (4.1E+6). À partir de PHP 8.0.0, le point décimal est toujours .. Antérieur à PHP 8.0.0, le point décimal est défini dans la locale du script (catégorie LC_NUMERIC). Voir la fonction setlocale. Les &array; sont toujours convertis en la &string; "Array" ; à cause de cela, echo et print ne peuvent pas afficher par eux-même le contenu d'un &array;. Pour afficher un seul élément, il faut utiliser une syntaxe tel que echo $arr['foo']. Voir ci-dessous pour des astuces permettant d'afficher le contenu complet. Pour pouvoir convertir un &object; en &string; la méthode magique __toString doit être utilisée. Les &resource;s sont toujours converties en &string; sous la forme "Resource id #1", où 1 est l'identifiant assigné à la &resource; par PHP lors de l'exécution. Alors qu'il ne faut pas se fier à cette structure, car susceptible d'évoluer, elle sera néanmoins unique pour une ressource donnée durant toute la durée d'exécution du script courant (ie une requête web ou un processus CLI). Pour récupérer le type d'une &resource;, utilisez la fonction get_resource_type. &null; est toujours converti en une chaîne vide. Au vu de tout cela, la conversion d'un &array;, d'un &object;, ou d'une &resource;, en une &string; ne fournit aucune information utile sur sa valeur, mis à part son type. Voir les fonctions print_r et var_dump pour inspecter plus efficacement les contenus de ces types. La plupart des valeurs en PHP peuvent également être converties en &string; afin de les stocker. Cette méthode est appelée "linéarisation", et est effectuée par serialize. Le type &string; en PHP est implémenté sous la forme d'un tableau d'octets accompagné d'un entier indiquant la longueur de la mémoire tampon. Il n'a aucune information sur la traduction octet/caractère, laissant cette tâche au programmeur. Il n'y a aucune limitation sur les valeurs pouvant être présentes dans une chaîne ; en particulier, les octets dont la valeur est 0 (“octets NUL”) sont autorisés à n'importe quel endroit de la chaîne (cependant, quelques fonctions, indiquées dans ce manuel comme n'étant pas “sécurisées au niveau binaire”, peuvent ignorer tous les octets après un octet nul.) La nature même du type "chaîne de caractères" explique qu'il n'existe pas de type “byte” en PHP - les chaînes de caractères jouent ce rôle. Les fonctions qui ne retournent pas de données textuelles - par exemple, des données arbitraires lues depuis un socket réseau - continueront de retourner des chaînes de caractères. PHP ne dictant aucun encodage spécifique pour les chaînes de caractères, on pourrait se demander comment les chaînes littérales sont codés. Par exemple, est-ce que la chaîne "á" équivaut à la chaîne "\xE1" (ISO-8859-1), "\xC3\xA1" (UTF-8, C form), "\x61\xCC\x81" (UTF-8, D form) ou à une autre des représentations possibles ? La réponse est que la chaîne sera encodée suivant l'encodage courant du script. Aussi, si le script est écrit en ISO-8859-1, alors, la chaîne sera encodée en ISO-8859-1 ; et ainsi de suite. Toutefois, ceci n'est pas vrai si Zend Multibyte est activé ; dans ce cas, le script peut être écrit dans n'importe quel encodage (qui sera explicitement déclaré, ou bien détecté), puis sera converti en un encodage interne, qui sera utilisé pour les chaînes littérales. Notez qu'il existe des contraintes sur l'encodage du script (ou sur l'encodage interne, si Zend Multibyte est activé) - cela signifie quasiment toujours que l'encodage utilisé doit être un sur-ensemble compatible d'ASCII, comme UTF-8 ou ISO-8859-1. Notez cependant que les encodages dépendant de l'état, où les mêmes valeurs de l'octet peuvent être utilisées dans des états de décalage initial et non-initial, peuvent être problématiques. Bien évidemment, pour être utiles, les fonctions qui opèrent sur du texte peuvent devoir faire des hypothèses sur la façon dont est encodé la chaîne de caractères. Malheureusement, ces hypothèses ne sont pas les mêmes suivant les fonctions de PHP : Certaines fonctions supposent que la chaîne est encodée en utilisant un (quelconque) encodage à un seul octet, mais n'ont pas besoin d'interpréter ces octets sous la forme de caractères. C'est actuellement le cas, par exemple, pour les fonctions substr, strpos, strlen et strcmp. Une autre façon de voir ces fonctions est qu'elles opèrent sur les mémoires tampons ; autrement dit, qu'elles fonctionnent avec les octets et leurs positions. D'autres fonctions reçoivent l'encodage de la chaîne en paramètre, éventuellement en assumant un encodage par défaut si ce n'est pas le cas. C'est le cas de la fonction htmlentities ainsi que de la majorité des fonctions de l'extension mbstring. D'autres utilisent la locale courante (voir setlocale), mais opèrent octet par octet. C'est le cas de strcasecmp, strtoupper, et ucfirst. Cela signifie qu'elles ne peuvent être utilisées qu'avec les encodages sur un seul octet, et si l'encodage correspond à la locale. Par exemple, strtoupper("á") peut retourner "Á" si la locale est correctement positionnée et si á est encodé sur un seul octet. Si la chaîne est encodée en UTF-8, le résultat correct ne sera pas retourné, et la chaîne résultante pourra être (ou non) corrompue, suivant la locale courante. Enfin, elles peuvent juste supposer que la chaîne utilise un encodage spécifique, généralement UTF-8. C'est le cas de la plupart des fonctions de l'extension intl ainsi que de celles de l'extension PCRE (dans ce dernier cas, uniquement lorsque le modificateur u est utilisé). Bien que ce soit en raison de leur buts spécifiques, la fonction utf8_decode assume un encodage UTF-8 et la fonction utf8_encode pré-suppose un encodage ISO-8859-1. Pour conclure, le fait d'écrire un programme correct en utilisant Unicode dépend de l'utilisation ou non de fonctions qui ne fonctionnent pas en Unicode, et qui corrompront très certainement les données ; il conviendra donc d'utiliser des fonctions qui fonctionnent correctement, générallement depuis les extensions intl et mbstring. Cependant, l'utilisation de fonctions qui peuvent gérer des encodages Unicode n'est que le commencement. Quelques soient les fonctions fournies par le langage, il est essentiel de connaître les spécifications de l'Unicode. Par exemple, un programme qui assume qu'il n'y a que des caractères en majuscule et en minuscule fait une mauvaise hypothèse.