Einfache Anführungszeichen
Der einfachste Weg einen String anzugeben, ist ihn mit
einfachen Anführungszeichen (das Zeichen '
) zu
umschließen.
Um ein einfaches Anführungszeichen hierin anzugeben, fügen sie einen
Backslash (\
) vor dem Zeichen ein. Um einen Backslash
als Zeichen anzugeben, verdoppeln Sie ihn (\\
). Alle
anderen Instanzen von Backslash werden als buchstäblicher Backslash
behandelt: Das bedeutet, dass die anderen Escape-Sequenzen, die Sie
vielleicht gewohnt sind, wie \r
oder
\n
, buchstäblich wie angegeben ausgegeben werden und
keine besondere Bedeutung haben.
Hinweis:
Im Gegensatz zu den
doppelten Anführungszeichen- und
Heredoc-Notationen
werden Variablen und
Escape-Sequenzen für Sonderzeichen nicht aufgelöst
(ersetzt), wenn sie in einem mit einfachen Anführungszeichen
umschlossenen String erscheinen.
Heredoc
Eine dritte Möglichkeit, Strings zu begrenzen, stellt die
Heredoc-Syntax dar: <<<
. Nach diesem Operator
wird ein beliebiger Bezeichner angegeben, dann eine neue Zeile. Hiernach
folgt der eigentliche String und abschließend erneut der
Bezeichner, um die Auszeichnung abzuschließen.
Der schließende Bezeichner darf durch Leerzeichen oder Tabulatoren
eingerückt sein, wobei in diesem Fall die Einrückung aus allen Zeilen des
Doc-Strings entfernt wird. Vor PHP 7.3.0 muss der
schließende Bezeichner in der ersten Spalte der Zeile beginnen.
Außerdem muss der schließende Bezeichner den gleichen Benennungsregeln
folgen wie jeder andere Bezeichner in PHP: Er darf nur alphanumerische
Zeichen sowie Unterstriche enthalten und muss mit einem nicht-numerischen
Zeichen oder einem Unterstrich beginnen.
Beispiel #1 Grundlegendes Heredoc-Beispiel ab PHP 7.3.0
<?php
// keine Einrückung
echo <<<END
a
b
c
\n
END;
// vier Leerzeichen Einrückung
echo <<<END
a
b
c
END;
Das oben gezeigte Beispiel erzeugt mit PHP 7.3 folgende Ausgabe:
Wenn der schließende Bezeichner weiter eingerückt ist als alle Zeilen des
Textkörpers, wird ein ParseError ausgelöst:
Beispiel #2 Der schließende Bezeichner darf nicht weiter eingerückt sein, als die Zeilen des Textkörpers
<?php
echo <<<END
a
b
c
END;
Das oben gezeigte Beispiel erzeugt mit PHP 7.3 folgende Ausgabe:
PHP Parse error: Invalid body indentation level (expecting an indentation level of at least 3) in example.php on line 4
Wenn der schließende Bezeichner eingerückt ist, können auch Tabulatoren
verwendet werden, allerdings dürfen Tabulatoren und Leerzeichen in Bezug
auf die Einrückung des schließenden Bezeichners und die Einrückung des
Textkörpers (bis zum schließenden Bezeichner) nicht
miteinander vermischt werden. In jedem dieser Fälle wird ein
ParseError ausgelöst. Diese
Whitespace-Einschränkungen wurden aufgenommen, weil die Vermischung von
Tabulatoren und Leerzeichen für die Einrückung die Lesbarkeit
beeinträchtigt.
Beispiel #3 Unterschiedliche Einrückung für den Bezeichner, der den Textkörper (Leerzeichen) schließt
<?php
// Der gesamte folgende Code funktioniert nicht.
// Unterschiedliche Einrückung für den Bezeichner (Tabulatoren), der den
// Textkörper (Leerzeichen) schließt
{
echo <<<END
a
END;
}
// Vermischung von Leerzeichen und Tabulatoren im Textkörper
{
echo <<<END
a
END;
}
// Vermischung von Leerzeichen und Tabulatoren in der Endmarkierung
{
echo <<<END
a
END;
}
Das oben gezeigte Beispiel erzeugt mit PHP 7.3 folgende Ausgabe:
PHP Parse error: Invalid indentation - tabs and spaces cannot be mixed in example.php line 8
Der schließende Bezeichner für den Textkörper muss nicht von einem
Semikolon oder Zeilenumbruch gefolgt werden. Zum Beispiel ist der folgende
Code ist ab PHP 7.3.0 erlaubt:
Beispiel #4 Fortsetzen eines Ausdrucks nach einem schließenden Bezeichner
<?php
$values = [<<<END
a
b
c
END, 'd e f'];
var_dump($values);
Das oben gezeigte Beispiel erzeugt mit PHP 7.3 folgende Ausgabe:
array(2) {
[0] =>
string(11) "a
b
c"
[1] =>
string(5) "d e f"
}
Warnung
Wenn der schließende Bezeichner am Anfang einer Zeile gefunden wurde,
dann kann er unabhängig davon, ob er Teil eines anderen Wortes war, als
schließender Bezeichner betrachtet werden und führt zu einem
ParseError.
Beispiel #5 Ein schließender Bezeichner im Textkörper der Zeichenkette führt zu einem ParseError
<?php
$values = [<<<END
a
b
END ING
END, 'd e f'];
Das oben gezeigte Beispiel erzeugt mit PHP 7.3 folgende Ausgabe:
PHP Parse error: syntax error, unexpected identifier "ING", expecting "]" in example.php on line 6
Um dieses Problem zu vermeiden, ist es ratsam, die einfache Regel zu
befolgen: etwas, das im Textkörper vorkommt, nicht als
schließenden Bezeichner wählen.
Warnung
Vor PHP 7.3.0 ist es sehr wichtig, darauf zu achten, dass die Zeile mit
dem schließenden Bezeichner keine anderen Zeichen außer einem Semikolon
(;
) enthalten darf. Das heißt insbesondere auch, dass
der Bezeichner nicht eingerückt werden darf und dass
es vor oder nach dem Semikolon auch keine Leerzeichen oder Tabulatoren
geben darf. Zudem muss das erste Zeichen vor dem schließenden Bezeichner
ein Zeilenumbruch sein, so wie er vom Betriebssystem definiert wird. In
UNIX-Systemen, inlusive macOS, ist dies \n
. Auf den
schließenden Bezeichner muss ebenfalls ein Zeilenumbruch folgen.
Wenn diese Regel gebrochen wird und der schließende Bezeichner nicht
valide ist, wird er nicht als Bezeichner angenommen und PHP wird weiter
nach einem solchen schließenden Bezeichner suchen. Wird kein gültiger
schließender Bezeichner vor dem Dateiende gefunden, gibt PHP einen auf
die letzte Zeile der Datei weisenden Parser-Fehler aus.
Beispiel #6 Ungültiges Beispiel vor PHP 7.3.0
<?php
class foo {
public $bar = <<<EOT
bar
EOT;
}
// Identifier must not be indented
?>
Beispiel #7 Gültiges Beispiel, auch vor PHP 7.3.0
<?php
class foo {
public $bar = <<<EOT
bar
EOT;
}
?>
Heredocs, die Variablen enthalten, können nicht für die Initialisierung
von Klasseneigenschaften verwendet werden.
Heredoc-Text verhält sich genau wie ein String in doppelten
Anführungsstrichen, ohne die doppelten Anführungszeichen. Das bedeutet,
dass Anführungszeichen in einem Heredoc nicht maskiert werden müssen, aber
die oben aufgeführten Maskierungscodes können trotzdem verwendet werden.
Variablen werden aufgelöst, aber wenn komplexe Variablen innerhalb eines
Heredocs verwendet werden, ist die gleiche Vorsicht geboten wie bei
Strings.
Beispiel #8 Beispiel für das Notieren von Heredoc-Strings
<?php
$str = <<<EOD
Ein Beispiel für einen String, der sich
unter Verwendung der heredoc-Syntax
über mehrere Zeilen erstreckt.
EOD;
/* Ein komplexeres Beispiel mit Variablen. */
class foo
{
var $foo;
var $bar;
function __construct()
{
$this->foo = 'Foo';
$this->bar = array('Bar1', 'Bar2', 'Bar3');
}
}
$foo = new foo();
$name = 'MeinName';
echo <<<EOT
Mein Name ist "$name". Ich gebe etwas $foo->foo aus.
Jetzt gebe ich etwas {$foo->bar[1]} aus.
Dies sollte ein großes 'A' ausgeben: \x41
EOT;
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Mein Name ist "MeinName". Ich gebe etwas Foo aus.
Jetzt gebe ich etwas Bar2 aus.
Dies sollte ein großes 'A' ausgeben: A
Es ist auch möglich, die Heredoc-Syntax zu verwenden, um Daten an
Funktionsargumente zu übergeben:
Beispiel #9 Beispiel für Heredoc in Argumenten
<?php
var_dump(array(<<<EOD
foobar!
EOD
));
?>
Es ist möglich, statische Variablen und Klasseneigenschaften/Konstanten
mit Hilfe der Heredoc-Syntax zu initialisieren:
Beispiel #10 Verwendung von Heredoc zur Initialisierung von statischen Werten
<?php
// Statische Variablen
function foo()
{
static $bar = <<<LABEL
Hier steht nichts drin...
LABEL;
}
// Klasseneigenschaften/Konstanten
class foo
{
const BAR = <<<FOOBAR
Beispiel für eine Konstante
FOOBAR;
public $baz = <<<FOOBAR
Beispiel für eine Eigenschaft
FOOBAR;
}
?>
Der öffnende Heredoc-Bezeichner kann optional in doppelte
Anführungszeichen gesetzt werden:
Beispiel #11 Verwendung von doppelten Anführungszeichen in Heredoc
<?php
echo <<<"FOOBAR"
Hallo Welt!
FOOBAR;
?>
Nowdoc
Nowdocs sind für Strings in einfachen Anführungszeichen das, was Heredocs
für Strings in doppelten Anführungszeichen sind. Ein Nowdoc wird ähnlich
wie ein Heredoc angegeben, aber es wird
keine String-Interpolation innerhalb eines Nowdocs
durchgeführt. Das Konstrukt ist ideal für die Einbettung von PHP-Code oder
anderen großen Textblöcken ohne maskieren zu müssen. Es hat einige
Eigenschaften mit dem <![CDATA[ ]]>
-Konstrukt in
SGML gemeinsam, indem es einen Textblock deklariert, der nicht geparst
werden soll.
Ein Nowdoc wird mit der gleichen <<<
-Sequenz
identifiziert, die für Heredocs verwendet wird, aber der nachfolgende
Bezeichner wird in einfachen Anführungszeichen eingeschlossen, z. B.
<<<'EOT'
. Alle Regeln für Heredoc-Bezeichner
gelten auch für Nowdoc-Bezeichner, insbesondere die hinsichtlich des
Aussehens des schließenden Bezeichners.
Beispiel #12 Nowdoc-Beispiel für das Notieren von Strings
<?php
echo <<<'EOD'
Ein Beispiel für einen String, der sich über mehrere Zeilen erstreckt
unter Verwendung der Nowdoc-Syntax. Backslashes werden immer als
Buchstaben behandelt,
z. B. \\ und \'.
EOD;
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Ein Beispiel für einen String, der sich über mehrere Zeilen erstreckt
unter Verwendung der Nowdoc-Syntax. Backslashes werden immer als
Buchstaben behandelt,
z. B. \\ und \'.
Beispiel #13 Nowdoc Beispiel für Strings mit Variablen
<?php
class foo
{
public $foo;
public $bar;
function __construct()
{
$this->foo = 'Foo';
$this->bar = array('Bar1', 'Bar2', 'Bar3');
}
}
$foo = new foo();
$name = 'MeinName';
echo <<<'EOT'
Mein Name ist "$name". Ich gebe etwas $foo->foo aus.
Jetzt gebe ich etwas {$foo->bar[1]} aus.
Dies sollte ein großes 'A' ausgeben: \x41
EOT;
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Mein Name ist "$name". Ich gebe etwas $foo->foo aus.
Jetzt gebe ich etwas {$foo->bar[1]} aus.
Dies sollte ein großes 'A' ausgeben: \x41
Beispiel #14 Beispiel für statische Daten
<?php
class foo {
public $bar = <<<'EOT'
bar
EOT;
}
?>
String-Interpolation
Wenn ein string in doppelten Anführungszeichen oder mit
Heredoc angegeben wird, können die
Variablen darin ersetzt werden.
Es gibt zwei Arten von Syntax: eine
einfache und eine
erweiterte.
Die einfache Syntax ist die gebräuchlichste und bequemste. Sie bietet eine
Möglichkeit, eine Variable, einen Array-Wert oder eine
Objekt-Eigenschaft mit minimalem Aufwand in einen
String einzubetten.
Die komplexe Syntax erkennt man an den geschweifte Klammern, die den
Ausdruck umgeben.
Einfache Syntax
Wenn ein Dollarzeichen ($
) erkannt wird, werden die
darauf folgenden Zeichen, die in einem Variablennamen verwendet werden
können, als solche interpretiert und ersetzt.
In ähnlicher Weise kann ein Array-Index oder eine
Objekt-Eigenschaft geparst werden. Bei Array-Indizes
markiert die schließende eckige Klammer (]
) das Ende
des Indexes. Für Objekteigenschaften gelten die gleichen Regeln wie für
einfache Variablen.
Warnung
The ${ expression }
syntax is deprecated as of
PHP 8.2.0, as it can be interpreted as
variable variables:
The
advanced
string interpolation syntax should be used instead.
Hinweis:
If it is not possible to form a valid name the dollar sign remains
as verbatim in the string:
Beispiel #15 Interpolating the value of the first dimension of an array or property
<?php
$juices = array("apple", "orange", "string_key" => "purple");
echo "He drank some $juices[0] juice.";
echo PHP_EOL;
echo "He drank some $juices[1] juice.";
echo PHP_EOL;
echo "He drank some $juices[string_key] juice.";
echo PHP_EOL;
class A {
public $s = "string";
}
$o = new A();
echo "Object value: $o->s.";
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
He drank some apple juice.
He drank some orange juice.
He drank some purple juice.
Object value: string.
Hinweis:
The array key must be unquoted, and it is therefore not possible to
refer to a constant as a key with the basic syntax. Use the
advanced
syntax instead.
Seit PHP 7.1.0 werden auch negative numerische
Indizes unterstützt.
Beispiel #16 Negative numerische Indizes
<?php
$string = 'string';
echo "Das Zeichen an Index -2 ist $string[-2].", PHP_EOL;
$string[-3] = 'o';
echo "Die Änderung des Zeichens an Index -3 auf o ergibt $string.", PHP_EOL;
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Das Zeichen an Index -2 ist n.
Die Änderung des Zeichens an Index -3 auf o ergibt strong.
Für alles, das komplexer ist, muss die
advanced
Syntax verwendet werden.
Erweiterte (geschweifte) Syntax
Diese Syntax wird nicht komplex genannt, weil sie komplex ist, sondern
weil sie die Verwendung komplexer Ausdrücke erlaubt.
Jede skalare Variable, jedes Array-Element oder jede Objekteigenschaft
mit einer String-Darstellung kann über diese Syntax
eingebunden werden. Der Ausdruck wird so geschrieben, wie er auch
außerhalb des Strings erscheinen würde, und dann von
{
und }
umschlossen. Da
{
nicht maskiert werden kann, wird diese Syntax nur
erkannt werden, wenn das $
unmittelbar auf das
{
folgt. Verwenden Sie {\$
, um ein
wörtliches {$
zu erhalten. Einige Beispiele, um es zu
verdeutlichen:
Es ist mit dieser Syntax auch möglich, über Variablen innerhalb von
Strings auf Klasseneigenschaften zuzugreifen.
Hinweis:
Der Wert, auf den von Funktionen, Methodenaufrufen, statischen
Klassenvariablen, und Klassenkonstanten innerhalb von
{$}
zugegriffen wird, wird als der Name einer
Variablen in dem Bereich interpretiert, in dem der String definiert ist.
Die Verwendung von einzelnen geschweiften Klammern
({}
) funktioniert nicht für den Zugriff auf die
Rückgabewerte von Funktionen oder Methoden oder die Werte von
Klassenkonstanten oder statischen Klassenvariablen.
Zugriff auf Strings und Änderung von Zeichen
Auf ein Zeichen in einem String kann zugegriffen und es kann
geändert werden, indem seine Position (von 0 an) hinter dem
String mit Hilfe von Array-Klammern angegeben
wird, z. B. $str[42]. In diesem Fall ist es hilfreich,
sich einen String als ein Array von Zeichen
vorzustellen. Die Funktionen substr() und
substr_replace() können verwendet werden, wenn mehr als
ein Zeichen extrahiert oder ersetzt werden soll.
Hinweis:
Seit PHP 7.1.0 werden auch negative String-Offsets unterstützt. Diese
geben den Offset vom Ende des Strings an. Früher verursachten negative
Offsets beim Lesen eine E_NOTICE
-Meldung aus (was
einen leeren String ergibt) und beim Schreiben eine
E_WARNING
-Meldung (was den String unangetastet
lässt).
Hinweis:
Vor PHP 8.0.0 konnte für den gleichen Zweck auch mit Klammern auf
Strings zugegriffen werden, wie in
$str{42}. Diese Syntax mit geschweiften Klammern ist
seit PHP 7.4.0 veraltet und wird seit PHP 8.0.0 nicht mehr unterstützt.
Warnung
Das Schreiben an einen Offset außerhalb des vorhandenen Bereichs bewirkt,
dass der String bis zu dieser Position mit Leerzeichen aufgefüllt wird.
Nicht-ganzzahlige Offsets werden in einen ganzzahligen Wert umgewandelt.
Bei ungültigen Offset-Typen wird eine E_WARNING
ausgegeben. Nur das erste Zeichen eines zugewiesenen Strings wird
verwendet. Seit PHP 7.1.0 führt die Zuweisung eines leeren Strings zu
einem schwerwiegenden Fehler. Vorher wurde ein NULL-Byte zugewiesen.
Warnung
Intern sind PHP-Strings Byte-Arrays. Folglich ist der Zugriff auf einen
String oder dessen Änderung mit Array-Klammern nicht Multi-Byte-sicher
und sollte nur mit Strings erfolgen, die in einer Ein-Byte-Kodierung wie
ISO-8859-1 vorliegen.
Hinweis:
Seit PHP 7.1.0 führt die Anwendung des leeren Indexoperators auf einen
leeren String zu einem fatalen Fehler. Zuvor wurde der leere String
stillschweigend in ein Array umgewandelt.
Beispiel #17 Einige String-Beispiele
<?php
// Ermitteln des ersten Zeichens eines Strings.
$str = 'Das ist ein Test.';
$first = $str[0];
// Ermitteln des dritten Zeichens eines Strings.
$third = $str[2];
// Ermitteln das letzten Zeichens eines Strings.
$str = 'Das ist immer noch ein Test.';
$last = $str[strlen($str)-1];
// Ändern des letzten Zeichens eines Strings.
$str = 'Look at the sea';
$str[strlen($str)-1] = 'e';
?>
String-Offsets müssen entweder Integer oder Integer-ähnliche Strings sein,
andernfalls wird eine Warnung ausgelöst.
Beispiel #18 Beispiel für unzulässige String-Offsets
<?php
$str = 'abc';
var_dump($str['1']);
var_dump(isset($str['1']));
var_dump($str['1.0']);
var_dump(isset($str['1.0']));
var_dump($str['x']);
var_dump(isset($str['x']));
var_dump($str['1x']);
var_dump(isset($str['1x']));
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
string(1) "b"
bool(true)
Warning: Illegal string offset '1.0' in /tmp/t.php on line 7
string(1) "b"
bool(false)
Warning: Illegal string offset 'x' in /tmp/t.php on line 9
string(1) "a"
bool(false)
string(1) "b"
bool(false)
Hinweis:
Der Zugriff auf Variablen anderer Typen (ohne Arrays oder Objekte, die
entsprechende Schnittstellen implementieren) mit []
oder {}
gibt stillschweigend null
zurück.
Hinweis:
Auf Zeichen innerhalb von String-Literalen kann mit []
oder {}
zugegriffen werden.
Hinweis:
Der Zugriff auf Zeichen innerhalb von String-Literalen mit der
{}
-Syntax ist seit PHP 7.4 veraltet und wurde in PHP
8.0 entfernt.