Skip to content

json-last-error.xml Move Available as of to *Availability* column t… #5447

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lacatoire merged 6 commits into from
Aug 27, 2026
Merged

json-last-error.xml Move Available as of to *Availability* column t… #5447

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
ee84c87
json-last-error.xml Move `Available as of` to *Availability* column t…
mmalferov Mar 31, 2026
b0d8847
Update reference/json/functions/json-last-error.xml
mmalferov Apr 26, 2026
6e7f6e6
Apply suggestions from code review
mmalferov Jul 23, 2026
7250fed
Convert JSON error codes table to variablelist
lacatoire Aug 27, 2026
593ab99
Wrap variablelist in para
lacatoire Aug 27, 2026
ffaac21
Fix para -> simpara
lacatoire Aug 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
162 changes: 93 additions & 69 deletions reference/json/functions/json-last-error.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,89 +25,113 @@

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Returns an integer, the value can be one of the following
constants:
</simpara>
<para>
Returns an integer, the value can be one of the following
constants:
<variablelist>
<varlistentry>
<term><constant>JSON_ERROR_NONE</constant></term>
<listitem>
<simpara>No error has occurred</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_DEPTH</constant></term>
<listitem>
<simpara>The maximum stack depth has been exceeded</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_STATE_MISMATCH</constant></term>
<listitem>
<simpara>Invalid or malformed JSON</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_CTRL_CHAR</constant></term>
<listitem>
<simpara>Control character error, possibly incorrectly encoded</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_SYNTAX</constant></term>
<listitem>
<simpara>Syntax error</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_UTF8</constant></term>
<listitem>
<simpara>Malformed UTF-8 characters, possibly incorrectly encoded</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_RECURSION</constant></term>
<listitem>
<simpara>One or more recursive references in the value to be encoded</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_INF_OR_NAN</constant></term>
<listitem>
<simpara>
One or more
<link linkend="language.types.float.nan"><constant>NAN</constant></link>
or <link linkend="function.is-infinite"><constant>INF</constant></link>
values in the value to be encoded
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_UNSUPPORTED_TYPE</constant></term>
<listitem>
<simpara>A value of a type that cannot be encoded was given</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_INVALID_PROPERTY_NAME</constant></term>
<listitem>
<simpara>A property name that cannot be encoded was given</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_UTF16</constant></term>
<listitem>
<simpara>Malformed UTF-16 characters, possibly incorrectly encoded</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>JSON_ERROR_NON_BACKED_ENUM</constant></term>
<listitem>
<simpara>Value contains a non-backed enum which cannot be serialized</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<table>
<title>JSON error codes</title>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Constant</entry>
<entry>Meaning</entry>
<entry>Availability</entry>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry><constant>JSON_ERROR_NONE</constant></entry>
<entry>No error has occurred</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_DEPTH</constant></entry>
<entry>The maximum stack depth has been exceeded</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_STATE_MISMATCH</constant></entry>
<entry>Invalid or malformed JSON</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_CTRL_CHAR</constant></entry>
<entry>Control character error, possibly incorrectly encoded</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_SYNTAX</constant></entry>
<entry>Syntax error</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_UTF8</constant></entry>
<entry>Malformed UTF-8 characters, possibly incorrectly encoded</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_RECURSION</constant></entry>
<entry>One or more recursive references in the value to be encoded</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_INF_OR_NAN</constant></entry>
<entry>8.1.0</entry>
<entry>
One or more
<link linkend="language.types.float.nan"><constant>NAN</constant></link>
or <link linkend="function.is-infinite"><constant>INF</constant></link>
values in the value to be encoded
<constant>JSON_ERROR_NON_BACKED_ENUM</constant> was added.
</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_UNSUPPORTED_TYPE</constant></entry>
<entry>A value of a type that cannot be encoded was given</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_INVALID_PROPERTY_NAME</constant></entry>
<entry>A property name that cannot be encoded was given</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_UTF16</constant></entry>
<entry>Malformed UTF-16 characters, possibly incorrectly encoded</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_NON_BACKED_ENUM</constant></entry>
<entry>Value contains a non-backed enum which cannot be serialized. Available as of PHP 8.1.0.</entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</informaltable>
</refsect1>

<refsect1 role="examples">
Expand Down