عرض مصدر PHP/json decode

{{DISPLAYTITLE:الدالة json_decode()‎ في PHP }}

== الدالة <code>json_decode()‎</code> في PHP ==
(PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0)

تفك الدالة <code>json_decode()‎</code> ترميز سلسلة نصية بصيغة JSON.

=== الوصف ===
<code>mixed json_decode ( string $json [, bool $assoc = FALSE [, int $depth = 512 [, int $options = 0]]] )</code>

تأخذ سلسلة مُرمَّزة بصيغة JSON وتحوِّلها إلى مُتغيِّر PHP.

=== المعاملات ===

==== <code>json</code> ====
[[Http://php.net/manual/en/language.types.string.php|سلسلة]] json التي سيُفكُّ ترميزها.

تعمل هذه الدّالّة مع سلاسل نصّيّة مُرمَّزة بترميز UTF-8 فقط.

'''ملاحظة:''' تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار الأصلي [http://www.faqs.org/rfcs/rfc7159 RFC 7159].

==== <code>assoc</code> ====
عندما تكون قيمته صحيحة <code>TRUE</code>، فستُحوَّل الكائنات المُعادة من الدّالّة إلى [http://php.net/manual/en/language.types.array.php مصفوفات] ترابطية (associative arrays).

==== <code>depth</code> ====
عُمق المُعاوَدة (recursion) المُحدَّد من قبل المستخدم.

==== <code>options</code> ====
خيارات لفك ترميز JSON على شكل قناع بت Bitmask. هناك حاليًّا خياران مدعومان، الأوّل هو JSON_BIGINT_AS_STRING والذي يسمح بقلب الأعداد الصّحيحة الكبيرة إلى سلاسل نصّيّة بدلًا من أعداد ذات فاصلة عائمة float، وهو الخيار الافتراضي، الخيار الثّاني هو JSON_OBJECT_AS_ARRAY وله نفس تأثير تعيين قيمة المُعامِل assoc إلى TRUE.

==== القيم المعادة ====
تُعيد هذه الدّالّة القيمة المُرمَّزة في المُعامِل json إلى نوع مناسب في لغة PHP، تُعاد القيم true و false و null على شكل TRUE و FALSE و NULL على التوالي وبالتّرتيب. تُعاد القيمة NULL في حال تعذّر فك ترميز سلسلة json أو كانت البيانات المُرمَّزة أعمق من حدّ المُعاوَدة.