Entre comillas simples
La manera más simple de especificar un string es encerrarlo entre comillas
simples (el carácter '
).
Para especificar una comilla simple literal, escápela con una barra invertida
(\
). Para especificar una barra invertida literal, duplíquela
(\\
). Todas las demás apariciones de la barra invertida serán tratadas
como una barra invertida literal : esto significa que las demás secuencias de escape que pueda
conocer, tales como \r
o \n
,
serán emitidas literalmente como se especificó en lugar de tener un significado especial.
Nota:
A diferencia de las comillas dobles
y sintaxis heredoc,
las variables y las secuencias de escape
para los caracteres especiales no serán no expandidas
cuando se encuentren en strings entre comillas simples.
Ejemplo #1 Variantes de sintaxis
<?php
echo 'esto es un string simple', PHP_EOL;
echo 'También puede tener nuevas líneas integradas en
los strings de esta manera, porque es admisible hacerlo.', PHP_EOL;
// Muestra : Arnold dijo una vez : "Volveré"
echo 'Arnold dijo una vez : "Volveré"', PHP_EOL;
// Muestra : ¿Ha eliminado C:\*.* ?
echo '¿Ha eliminado C:\\*.* ?', PHP_EOL;
// Muestra : ¿Ha eliminado C:\*.* ?
echo '¿Ha eliminado C:\*.* ?', PHP_EOL;
// Muestra : Esto no se expandirá : \n una nueva línea
echo 'Esto no se expandirá : \n una nueva línea', PHP_EOL;
// Muestra : Las variables no $s\'expandirán $tampoco
echo 'Las variables no $s\'expandirán $tampoco', PHP_EOL;
?>
Heredoc
Una tercera manera de delimitar los strings es la sintaxis heredoc :
<<<
. Después de este operador, se
proporciona un identificador, luego una nueva línea. El string en sí sigue, luego
el mismo identificador nuevamente para cerrar la cita.
El identificador de cierre puede ser sangrado por espacios o tabulaciones, en cuyo caso
la sangría será eliminada de todas las líneas en el string doc.
Antes de PHP 7.3.0, el identificador de cierre debe
comenzar en la primera columna de la línea.
Además, el identificador de cierre debe seguir las mismas reglas de nomenclatura que cualquier
otra etiqueta en PHP : debe contener solo caracteres alfanuméricos y
guiones bajos, y debe comenzar con un carácter no numérico o un guión bajo.
Ejemplo #2 Ejemplo básico de Heredoc a partir de PHP 7.3.0
<?php
// sin sangría
echo <<<END
a
b
c
\n
END;
// 4 espacios de sangría
echo <<<END
a
b
c
END;
Salida del ejemplo anterior en PHP 7.3:
Si el identificador de cierre está sangrado más que cualquier línea del cuerpo, entonces se levantará un ParseError :
Ejemplo #3 El identificador de cierre no debe estar sangrado más que ninguna línea del cuerpo
<?php
echo <<<END
a
b
c
END;
Salida del ejemplo anterior en PHP 7.3:
Parse error: Invalid body indentation level (expecting an indentation level of at least 3) in example.php on line 4
Si el identificador de cierre está sangrado, también se pueden usar tabulaciones, sin embargo,
las tabulaciones y los espacios no deben mezclarse en cuanto a
la sangría del identificador de cierre y la sangría del cuerpo
(hasta el identificador de cierre). En uno de estos casos, se levantará un ParseError.
Estas restricciones de espacio se han incluido porque mezclar espacios y tabulaciones para la sangría perjudica la legibilidad.
Ejemplo #4 Diferente sangría para el cuerpo (espacios) identificador de cierre
<?php
// Todo el código siguiente no funciona.
// diferente sangría para el cuerpo (espacios) marcador de fin (tabulaciones)
{
echo <<<END
a
END;
}
// mezcla de espacios y tabulaciones en el cuerpo
{
echo <<<END
a
END;
}
// mezcla de espacios y tabulaciones en el marcador de fin
{
echo <<<END
a
END;
}
Salida del ejemplo anterior en PHP 7.3:
Parse error: Invalid indentation - tabs and spaces cannot be mixed in example.php line 8
El identificador de cierre para el string del cuerpo no es requerido para ser
seguido de un punto y coma o un salto de línea. Por ejemplo, el siguiente código
está permitido a partir de PHP 7.3.0 :
Ejemplo #5 Continuación de una expresión después de un identificador de cierre
<?php
$values = [<<<END
a
b
c
END, 'd e f'];
var_dump($values);
Salida del ejemplo anterior en PHP 7.3:
array(2) {
[0] =>
string(11) "a
b
c"
[1] =>
string(5) "d e f"
}
Advertencia
Si el identificador de cierre se encontró al comienzo de una línea, entonces
no importa si formaba parte de otra palabra, puede considerarse
como el identificador de cierre y provocar un ParseError.
Ejemplo #6 El identificador de cierre en el cuerpo del string tiende a provocar un ParseError
<?php
$values = [<<<END
a
b
END ING
END, 'd e f'];
Salida del ejemplo anterior en PHP 7.3:
Parse error: syntax error, unexpected identifier "ING", expecting "]" in example.php on line 5
Para evitar este problema, es seguro seguir la regla simple :
no elegir como identificador de cierre si aparece en el cuerpo
del texto.
Advertencia
Antes de PHP 7.3.0, es muy importante tener en cuenta que la línea que contiene el
identificador de cierre no debe contener ningún otro carácter, excepto un punto y coma
(;
).
Esto significa sobre todo que el identificador
no puede estar sangrado, y no debe haber espacios
o tabulaciones antes o después del punto y coma. También es importante darse cuenta de que
el primer carácter antes del identificador de cierre debe ser un salto de línea tal
como se define por el sistema operativo local. Es \n
en
los sistemas UNIX, incluyendo macOS. El delimitador de cierre también debe ser
seguido de un salto de línea.
Si se infringe esta regla y el identificador de cierre no es "limpio", no se
considerará como un identificador de cierre, y PHP continuará buscando uno. Si no se encuentra un
identificador de cierre adecuado antes del final del archivo
actual, se producirá un error de análisis en la última línea.
Ejemplo #7 Ejemplo no válido, antes de PHP 7.3.0
<?php
class foo {
public $bar = <<<EOT
bar
EOT;
}
// El identificador no debe estar sangrado
?>
Ejemplo #8 Ejemplo válido, incluso antes de PHP 7.3.0
<?php
class foo {
public $bar = <<<EOT
bar
EOT;
}
?>
Los heredocs que contienen variables no pueden usarse para inicializar propiedades de clase.
El texto heredoc se comporta exactamente como un string entre comillas dobles, sin las comillas. Esto significa que las comillas dentro de un heredoc no necesitan ser escapadas, pero los códigos de escape mencionados anteriormente aún pueden ser utilizados. Las variables se expanden, pero se debe tener el mismo cuidado al expresar variables complejas dentro de un heredoc que para los strings.
Ejemplo #9 Ejemplo de cita de string heredoc
<?php
$str = <<<EOD
Ejemplo de string
extendiéndose en varias líneas
usando la sintaxis heredoc.
EOD;
/* Ejemplo más complejo, con variables. */
class foo
{
var $foo;
var $bar;
function __construct()
{
$this->foo = 'Foo';
$this->bar = array('Bar1', 'Bar2', 'Bar3');
}
}
$foo = new foo();
$name = 'MyName';
echo <<<EOT
Mi nombre es "$name". Estoy imprimiendo $foo->foo.
Ahora, imprimo {$foo->bar[1]}.
Esto debería imprimir una 'A' mayúscula : \x41
EOT;
?>
El resultado del ejemplo sería:
Mi nombre es "MyName". Estoy imprimiendo Foo.
Ahora, imprimo Bar2.
Esto debería imprimir una 'A' mayúscula : A
También es posible usar la sintaxis heredoc para pasar datos a los argumentos de función :
Ejemplo #10 Heredoc en los ejemplos de argumentos
<?php
var_dump(array(<<<EOD
foobar!
EOD
));
?>
Es posible inicializar variables estáticas y propiedades/constantes de clase usando la sintaxis heredoc :
Ejemplo #11 Uso de Heredoc para inicializar valores estáticos
<?php
// Variables estáticas
function foo()
{
static $bar = <<<LABEL
Nada aquí...
LABEL;
}
// Propiedades/constantes de clase
class foo
{
const BAR = <<<FOOBAR
Ejemplo de constante
FOOBAR;
public $baz = <<<FOOBAR
Ejemplo de propiedad
FOOBAR;
}
?>
El identificador de apertura del Heredoc puede eventualmente ser
encerrado entre comillas dobles :
Ejemplo #12 Uso de comillas dobles en el Heredoc
<?php
echo <<<"FOOBAR"
¡Hola mundo!
FOOBAR;
?>
Nowdoc
Los nowdocs son para los strings entre comillas simples lo que los heredocs son para los strings entre comillas dobles. Un nowdoc se especifica de manera similar a un heredoc, pero no se realiza ninguna interpolación de string dentro de un nowdoc. La construcción es ideal para integrar código PHP u otros bloques de texto voluminosos sin necesidad de escapar. Comparte algunas características con la construcción SGML
<![CDATA[ ]]>
, en el sentido de que declara un
bloque de texto que no está destinado a ser analizado.
Un nowdoc se identifica por la misma secuencia <<<
utilizada para los heredocs, pero el identificador que sigue está encerrado entre comillas simples, por ejemplo <<<'EOT'
. Todas las reglas para los identificadores heredoc se aplican también a los identificadores nowdoc, en particular las que se refieren a la aparición del identificador de cierre.
Ejemplo #13 Ejemplo de cita de string nowdoc
<?php
echo <<<'EOD'
Ejemplo de string extendiéndose en varias líneas
usando la sintaxis nowdoc. Las barras invertidas siempre se tratan literalmente,
es decir \\ y \'.
EOD;
El resultado del ejemplo sería:
Ejemplo de string extendiéndose en varias líneas
usando la sintaxis nowdoc. Las barras invertidas siempre se tratan literalmente,
es decir \\ y \'.
Ejemplo #14 Ejemplo de cita de string nowdoc con variables
<?php
class foo
{
public $foo;
public $bar;
function __construct()
{
$this->foo = 'Foo';
$this->bar = array('Bar1', 'Bar2', 'Bar3');
}
}
$foo = new foo();
$name = 'MyName';
echo <<<'EOT'
Mi nombre es "$name". Estoy imprimiendo $foo->foo.
Ahora, imprimo {$foo->bar[1]}.
Esto no debería imprimir una 'A' mayúscula : \x41
EOT;
?>
El resultado del ejemplo sería:
Mi nombre es "$name". Estoy imprimiendo $foo->foo.
Ahora, imprimo {$foo->bar[1]}.
Esto no debería imprimir una 'A' mayúscula : \x41
Ejemplo #15 Ejemplo de datos estáticos
<?php
class foo {
public $bar = <<<'EOT'
bar
EOT;
}
?>
Interpolación de strings
Cuando un string se especifica entre comillas dobles o con heredoc,
las variables pueden ser sustituidas en su interior.
Existen dos tipos de sintaxis : una
básica y una
avanzada.
La sintaxis básica es la más común y la más práctica. Ofrece una manera de incorporar una variable, un valor array o una propiedad objeto en un string con un mínimo de esfuerzo.
Sintaxis básica
Si se encuentra un signo de dólar ($
), los caracteres que le siguen y que pueden ser utilizados en un nombre de variable serán interpretados como tales y sustituidos.
Formalmente, la estructura para la sintaxis de sustitución de variable básica es la siguiente :
Ejemplo #16 Interpolación de strings
string-variable::
variable-name (offset-or-property)?
| ${ expression }
offset-or-property::
offset-in-string
| property-in-string
offset-in-string::
[ name ]
| [ variable-name ]
| [ integer-literal ]
property-in-string::
-> name
variable-name::
$ name
name::
[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*
Advertencia
La sintaxis ${ expression }
está deprecada desde
PHP 8.2.0, ya que puede ser interpretada como
variables de variables :
La sintaxis de interpolación de string
avanzada debería usarse en su lugar.
Nota:
Si no es posible formar un nombre válido, el signo de dólar
se mantendrá tal cual en el string :
Ejemplo #17 Interpolación del valor de la primera dimensión de un array o de una propiedad
<?php
$juices = array("manzana", "naranja", "string_key" => "violeta");
echo "Ha bebido un poco de $juices[0] jugo.";
echo PHP_EOL;
echo "Ha bebido un poco de $juices[1] jugo.";
echo PHP_EOL;
echo "Ha bebido un poco de $juices[string_key] jugo.";
echo PHP_EOL;
class A {
public $s = "string";
}
$o = new A();
echo "Valor del objeto : $o->s.";
?>
El resultado del ejemplo sería:
Ha bebido un poco de manzana jugo.
Ha bebido un poco de naranja jugo.
Ha bebido un poco de violeta jugo.
Valor del objeto : string.
Nota:
La clave del array debe estar sin comillas, y por lo tanto no es posible
referenciar una constante como clave con la sintaxis básica. Use la
sintaxis avanzada
en su lugar.
Desde PHP 7.1.0, los índices numéricos negativos también
son soportados.
Ejemplo #18 Índices numéricos negativos
<?php
$string = 'string';
echo "El carácter en el índice -2 es $string[-2].", PHP_EOL;
$string[-3] = 'o';
echo "Cambiar el carácter en el índice -3 a o da $string.", PHP_EOL;
?>
El resultado del ejemplo sería:
El carácter en el índice -2 es n.
Cambiar el carácter en el índice -3 a o da strong.
Para todo lo que es más complejo, la
sintaxis avanzada
debe ser utilizada.
Sintaxis avanzada (sintaxis de llaves)
La sintaxis avanzada permite la interpolación de
variables con accesores arbitrarios.
Cualquier variable escalar, elemento de array o propiedad de objeto
(static o no) con una representación
string puede ser incluida a través de esta sintaxis.
La expresión se escribe de la misma manera que la que aparecería fuera de la
string, luego se encierra entre {
y
}
. Dado que {
no puede ser escapado, esta
sintaxis solo será reconocida cuando el $
siga inmediatamente al
{
. Use {\$
para obtener un
{$
. Aquí hay algunos ejemplos para aclarar :
Ejemplo #19 Sintaxis con llaves
<?php
const DATA_KEY = 'const-key';
$great = 'fantástico';
$arr = [
'1',
'2',
'3',
[41, 42, 43],
'key' => 'Valor indexado',
'const-key' => 'Clave con un signo menos',
'foo' => ['foo1', 'foo2', 'foo3']
];
// No funcionará, muestra : This is { fantastic}
echo "Esto es { $great}";
// Funciona, muestra : This is fantastic
echo "Esto es {$great}";
class Square {
public $width;
public function __construct(int $width) { $this->width = $width; }
}
$square = new Square(5);
// Funciona
echo "Este cuadrado mide {$square->width}00 centímetros de ancho.";
// Funciona, las claves entre comillas solo funcionan con la sintaxis de llaves
echo "Esto funciona : {$arr['key']}";
// Funciona
echo "Esto funciona : {$arr[3][2]}";
echo "Esto funciona : {$arr[DATA_KEY]}";
// Al usar arrays multidimensionales, use siempre llaves alrededor de los arrays
// cuando estén dentro de strings
echo "Esto funciona : {$arr['foo'][2]}";
echo "Esto funciona : {$obj->values[3]->name}";
echo "Esto funciona : {$obj->$staticProp}";
// No funcionará, muestra : C:\directory\{fantastic}.txt
echo "C:\directory\{$great}.txt";
// Funciona, muestra : C:\directory\fantastic.txt
echo "C:\\directory\\{$great}.txt";
?>
Nota:
Dado que esta sintaxis permite expresiones arbitrarias, es posible usar
variables de variables
en la sintaxis avanzada.
Acceso y modificación de string por carácter
Los caracteres en los strings pueden ser accedidos y modificados especificando
el desplazamiento basado en cero del carácter deseado después del
string usando corchetes array, como en
$str[42]. Piense en un string como un
array de caracteres para este propósito. Las funciones
substr() y substr_replace()
pueden ser utilizadas cuando se desea extraer o reemplazar más de un carácter.
Nota:
Desde PHP 7.1.0, los desplazamientos de string negativos también son soportados. Estos especifican
el desplazamiento desde el final del string.
Anteriormente, los desplazamientos negativos emitían E_NOTICE
para la lectura
(produciendo un string vacío) y E_WARNING
para la escritura
(dejando el string intacto).
Nota:
Antes de PHP 8.0.0, los strings también podían ser accedidos usando llaves, como en
$str{42}, para el mismo propósito.
Esta sintaxis de llaves ha sido deprecada desde PHP 7.4.0 y ya no es soportada desde PHP 8.0.0.
Advertencia
Escribir en un desplazamiento fuera de alcance llena el string con espacios.
Los tipos no enteros se convierten en enteros.
Un tipo de desplazamiento ilegal emite E_WARNING
.
Solo se utiliza el primer carácter de un string asignado.
Desde PHP 7.1.0, asignar un string vacío genera un error fatal. Anteriormente,
esto asignaba un byte NULL.
Advertencia
Internamente, los strings PHP son arrays de bytes. En consecuencia, acceder o
modificar un string usando corchetes de array no es seguro para los multi-bytes, y
no debería hacerse más que con strings en codificación de un solo byte como ISO-8859-1.
Nota:
Desde PHP 7.1.0, aplicar el operador de índice vacío a un string vacío genera un error fatal.
Anteriormente, el string vacío se convertía silenciosamente en un array.
Ejemplo #20 Algunos ejemplos de strings
<?php
// Obtener el primer carácter de un string
$str = 'Esto es una prueba.';
$first = $str[0];
var_dump($first);
// Obtener el tercer carácter de un string
$third = $str[2];
var_dump($third);
// Obtener el último carácter de un string.
$str = 'Esto sigue siendo una prueba.';
$last = $str[strlen($str)-1];
var_dump($last);
// Modificar el último carácter de un string
$str = 'Mira el mar';
$str[strlen($str)-1] = 'e';
var_dump($str);
?>
Los desplazamientos de string deben ser enteros o strings que se asemejan a enteros,
de lo contrario se emitirá una advertencia.
Ejemplo #21 Ejemplo de desplazamientos de string ilegales
<?php
$str = 'abc';
foreach ($keys as $keyToTry) {
var_dump(isset($str[$keyToTry]));
try {
var_dump($str[$keyToTry]);
} catch (TypeError $e) {
echo $e->getMessage(), PHP_EOL;
}
echo PHP_EOL;
}
?>
El resultado del ejemplo sería:
bool(true)
string(1) "b"
bool(false)
Cannot access offset of type string on string
bool(false)
Cannot access offset of type string on string
bool(false)
Warning: Illegal string offset "1x" in Standard input code on line 10
string(1) "b"
Nota:
Acceder a variables de otros tipos (con la excepción de arrays o objetos
que implementen las interfaces apropiadas) usando []
o
{}
devuelve silenciosamente null
.
Nota:
Los caracteres en los literales de string pueden ser accedidos
usando []
o {}
.
Nota:
Acceder a caracteres en literales de string usando la
sintaxis {}
ha sido deprecado en PHP 7.4.
Esto ha sido eliminado en PHP 8.0.