WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

json_encode()

Serialisiert einen PHP-Wert als UTF-8-JSON.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

json_encode(mixed $value, int $flags = 0, int $depth = 512): string|false

Serialisiert einen PHP-Wert als UTF-8-JSON. Fortlaufende Schlüssel ab null bilden ein JSON-Array, eine Lücke ergibt ein Objekt mit Textschlüsseln. Ungültiges UTF-8 kann false oder mit JSON_THROW_ON_ERROR eine Ausnahme liefern. depth begrenzt die Verschachtelung. Bei Standardflags zählt die Durchlaufreihenfolge der ganzzahligen Schlüssel 0,1,... und nicht bloß ihre Menge. Die Folge 1,0 ergibt ein Objekt.

Signatur

json_encode(mixed $value, int $flags = 0, int $depth = 512): string|false

Ausgabe des Beispiels

[["a","b"],{"0":"a","2":"b"}]
true
JsonException
{"1":"one","0":"zero"}

Beispiele

<?php
echo json_encode([["a","b"],[0=>"a",2=>"b"]]), PHP_EOL;
echo json_encode(json_encode("\xFF") === false), PHP_EOL;
try { json_encode("\xFF",JSON_THROW_ON_ERROR); } catch(JsonException $e) { echo get_class($e); }
echo PHP_EOL,json_encode([1=>"one",0=>"zero"]);

Ergebnis

[["a","b"],{"0":"a","2":"b"}]
true
JsonException
{"1":"one","0":"zero"}

Quellen