Keine Cache-Version
Caching deaktiviert Standardeinstellung für diese Seite:aktiviert (code LNG204)Wenn die Anzeige zu langsam ist, können Sie den Benutzermodus deaktivieren, um die zwischengespeicherte Version anzuzeigen.
json_encode
(PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0)
json_encode — Gibt die JSON-Repräsentation eines Wertes zurück
Beschreibung
Gibt eine Zeichenkette zurück, die die JSON-Darstellung des übergebenen
value beinhaltet.
Die Kodierung wird von den übergebenen options
beeinflusst, und zusätzlich hängt die Kodierung von Float-Werten vom Wert von
serialize_precision ab.
Parameter-Liste
-
value -
Der zu kodierende
value. Kann von jedem Typ außer Ressource sein.Alle Strings müssen in UTF-8 kodiert sein-
Hinweis:
PHP implementiert eine Obermenge von der ursprünglich in » RFC 4627 spezifizierten Version von JSON. Es kodiert und dekodiert auch skalare Typen und
NULL. RFC 4627 unterstützt diese Werte nur wenn sie innerhalb eines Arrays oder Objektes enthalten sind.Obwohl diese Obermenge konsistent zur erweiterten Definition von "JSON-Text" gemäß dem neueren » RFC 7159 (welcher RFC 4627 ersetzen soll) und ECMA-404 ist, kann dies zu Kompatibilitätsproblemen mit älteren JSON-Parsern führen, wenn diese sich strikt an RFC 4627 halten wenn skalare Werte kodiert werden.
-
options -
Bitmaske bestehend aus
JSON_FORCE_OBJECT,JSON_HEX_QUOT,JSON_HEX_TAG,JSON_HEX_AMP,JSON_HEX_APOS,JSON_INVALID_UTF8_IGNORE,JSON_INVALID_UTF8_SUBSTITUTE,JSON_NUMERIC_CHECK,JSON_PARTIAL_OUTPUT_ON_ERROR,JSON_PRESERVE_ZERO_FRACTION,JSON_PRETTY_PRINT,JSON_UNESCAPED_LINE_TERMINATORS,JSON_UNESCAPED_SLASHES,JSON_UNESCAPED_UNICODE,JSON_THROW_ON_ERROR. Das Verhalten dieser Konstanten ist auf der Seite über die JSON Konstanten beschrieben. -
depth -
Setzt die maximale Tiefe. Muss größer sein als Null.
Changelog
| Version | Beschreibung |
|---|---|
| 7.3.0 |
JSON_THROW_ON_ERROR
options wurde hinzugefügt.
|
| 7.2.0 |
JSON_INVALID_UTF8_IGNORE, und
JSON_INVALID_UTF8_SUBSTITUTE
options wurden hinzugefügt.
|
| 7.1.0 | serialize_precision wird nun anstatt precision verwendet, wenn Double-Werte kodiert werden. |
| 5.6.6 |
Die JSON_PRESERVE_ZERO_FRACTION option wurde hinzugefügt.
|
| 5.5.0 |
Der Parameter depth wurde hinzugefügt.
|
| 5.5.0 |
Die JSON_PARTIAL_OUTPUT_ON_ERROR Option wurde hinzugefügt.
|
| 5.5.0 |
Der Rückgabewert im Fehlerfall wurde von der null
Zeichenkette zu FALSE geändert.
|
| 5.4.0 |
JSON_PRETTY_PRINT, JSON_UNESCAPED_SLASHES, und JSON_UNESCAPED_UNICODE für options wurden hinzugefügt.
|
| 5.3.3 |
JSON_NUMERIC_CHECK für options wurde hinzugefügt.
|
| 5.3.0 |
JSON_FORCE_OBJECT,
JSON_HEX_AMP,
JSON_HEX_APOS,
JSON_HEX_QUOT, und
JSON_HEX_TAG,
options wurden hinzugefügt.
|
| 5.3.0 |
Der Parameter options wurde hinzugefügt.
|
Beispiele
Beispiel #1 A json_encode() example
<?php
$arr = array('a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5);
echo json_encode($arr);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
{"a":1,"b":2,"c":3,"d":4,"e":5}
Beispiel #2 Ein json_encode()-Beispiel, das den Einsatz einiger Optionen zeigt
<?php
$a = array('<foo>',"'bar'",'"baz"','&blong&', "\xc3\xa9");
echo "Normal: ", json_encode($a), "\n";
echo "Tags: ", json_encode($a, JSON_HEX_TAG), "\n";
echo "Apos: ", json_encode($a, JSON_HEX_APOS), "\n";
echo "Quot: ", json_encode($a, JSON_HEX_QUOT), "\n";
echo "Amp: ", json_encode($a, JSON_HEX_AMP), "\n";
echo "Unicode: ", json_encode($a, JSON_UNESCAPED_UNICODE), "\n";
echo "All: ", json_encode($a, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP | JSON_UNESCAPED_UNICODE), "\n\n";
$b = array();
echo "Ausgabe eines leeren Arrays als Array: ", json_encode($b), "\n";
echo "Ausgabe eines leeren Arrays als Objekt: ", json_encode($b, JSON_FORCE_OBJECT), "\n\n";
$c = array(array(1,2,3));
echo "Ausgabe eines nichtassoziativen Arrays als Array: ", json_encode($c), "\n";
echo "Ausgabe eines nichtassoziativen Arrays als Objekt: ", json_encode($c, JSON_FORCE_OBJECT), "\n\n";
$d = array('foo' => 'bar', 'baz' => 'long');
echo "Assoziative Arrays werden immer als Objekt ausgegeben: ", json_encode($d), "\n";
echo "Assoziative Arrays werden immer als Objekt ausgegeben: ", json_encode($d, JSON_FORCE_OBJECT), "\n\n";
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Normal: ["<foo>","'bar'","\"baz\"","&blong&","\u00e9"]
Tags: ["\u003Cfoo\u003E","'bar'","\"baz\"","&blong&","\u00e9"]
Apos: ["<foo>","\u0027bar\u0027","\"baz\"","&blong&","\u00e9"]
Quot: ["<foo>","'bar'","\u0022baz\u0022","&blong&","\u00e9"]
Amp: ["<foo>","'bar'","\"baz\"","\u0026blong\u0026","\u00e9"]
Unicode: ["<foo>","'bar'","\"baz\"","&blong&","é"]
All: ["\u003Cfoo\u003E","\u0027bar\u0027","\u0022baz\u0022","\u0026blong\u0026","é"]
Ausgabe eines leeren Arrays als Array: []
Ausgabe eines leeren Arrays als Objekt: {}
Ausgabe eines nichtassoziativen Arrays als Array: [[1,2,3]]
Ausgabe eines nichtassoziativen Arrays als Objekt: {"0":{"0":1,"1":2,"2":3}}
Assoziative Arrays werden immer als Objekt ausgegeben: {"foo":"bar","baz":"long"}
Assoziative Arrays werden immer als Objekt ausgegeben: {"foo":"bar","baz":"long"}
Beispiel #3 JSON_NUMERIC_CHECK-Option-Beispiel
<?php
echo "Zeichenketten, die Zahlen repräsentieren, die automatisch in Zahlen gewandelt wurden".PHP_EOL;
$numbers = array('+123123', '-123123', '1.2e3', '0.00001');
var_dump(
$numbers,
json_encode($numbers, JSON_NUMERIC_CHECK)
);
echo "Zeichenketten, die unsachgemäß formatierte Zahlen enthalten".PHP_EOL;
$strings = array('+a33123456789', 'a123');
var_dump(
$strings,
json_encode($strings, JSON_NUMERIC_CHECK)
);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Zeichenketten, die Zahlen repräsentieren, die automatisch in Zahlen gewandelt wurden
array(4) {
[0]=>
string(7) "+123123"
[1]=>
string(7) "-123123"
[2]=>
string(5) "1.2e3"
[3]=>
string(7) "0.00001"
}
string(28) "[123123,-123123,1200,1.0e-5]"
Zeichenketten, die unsachgemäß formatierte Zahlen enthalten
array(2) {
[0]=>
string(13) "+a33123456789"
[1]=>
string(4) "a123"
}
string(24) "["+a33123456789","a123"]"
Beispiel #4 Beispiel für sequentielle und nicht sequentielle Arrays
<?php
echo "Sequentielles Array".PHP_EOL;
$sequential = array("foo", "bar", "baz", "blong");
var_dump(
$sequential,
json_encode($sequential)
);
echo PHP_EOL."Nicht sequentielles Array".PHP_EOL;
$nonsequential = array(1=>"foo", 2=>"bar", 3=>"baz", 4=>"blong");
var_dump(
$nonsequential,
json_encode($nonsequential)
);
echo PHP_EOL."Sequentielles Array mit einem entfernten Schlüssel".PHP_EOL;
unset($sequential[1]);
var_dump(
$sequential,
json_encode($sequential)
);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Sequentielles Array
array(4) {
[0]=>
string(3) "foo"
[1]=>
string(3) "bar"
[2]=>
string(3) "baz"
[3]=>
string(5) "blong"
}
string(27) "["foo","bar","baz","blong"]"
Nicht sequentielles Array
array(4) {
[1]=>
string(3) "foo"
[2]=>
string(3) "bar"
[3]=>
string(3) "baz"
[4]=>
string(5) "blong"
}
string(43) "{"1":"foo","2":"bar","3":"baz","4":"blong"}"
Sequentielles Array mit einem entfernten Schlüssel
array(3) {
[0]=>
string(3) "foo"
[2]=>
string(3) "baz"
[3]=>
string(5) "blong"
}
string(33) "{"0":"foo","2":"baz","3":"blong"}"
Beispiel #5 JSON_PRESERVE_ZERO_FRACTION-Option-Beispiel
<?php
var_dump(json_encode(12.0, JSON_PRESERVE_ZERO_FRACTION));
var_dump(json_encode(12.0));
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
string(4) "12.0" string(2) "12"
Anmerkungen
Hinweis:
Falls ein Fehler beim kodieren auftritt, kann json_last_error() verwendet werden, um die genaue Ursache des Fehlers festzustellen.
Hinweis:
Wenn ein Array kodiert wird werden alle Schlüssel als Strings kodiert und für alle Schlüssel-Wert-Paare explizit angegeben, wenn die Schlüssel keine kontinuierliche aufsteigende Sequenz sind die bei 0 beginnt.
Hinweis:
Wie der Referenz JSON-Encoder gibt auch json_encode() einen einfachen Wert (also weder ein Objekt noch ein Array) aus, wenn ein string, integer, float oder boolean als Eingabe für
valueübergeben wird. Während die meisten Decoder diese Werte als gültiges JSON akzeptieren könnte es einige geben die dies ablehnen, da die Spezifikationen in diesem Punkt mehrdeutig sind.Um zusammenzufassen: Prüfen Sie immer, ob ihr JSON-Decoder die Ausgabe, die Sie mittels json_encode() erzeugen, verarbeiten kann.
Siehe auch
- JsonSerializable
- json_decode() - Dekodiert eine JSON-Zeichenkette
- json_last_error() - Gibt den letzten aufgetretenen Fehler zurück
- serialize() - Erzeugt eine speicherbare Repräsentation eines Wertes
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-json-encode.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.
