الفرق بين المراجعتين ل"PHP/json decode"
Kinan-mawed (نقاش | مساهمات) (أنشأ الصفحة ب'== الدالة <code>json_decode()</code> في PHP == (PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0) تفك الدالة <code>json_decode()</code> ترميز سل...') |
Kinan-mawed (نقاش | مساهمات) |
||
| سطر 12: | سطر 12: | ||
==== <code>json</code> ==== | ==== <code>json</code> ==== | ||
| − | سلسلة json التي سيُفكُّ ترميزها. | + | [[Http://php.net/manual/en/language.types.string.php|سلسلة]] json التي سيُفكُّ ترميزها. |
تعمل هذه الدّالّة مع سلاسل نصّيّة مُرمَّزة بترميز UTF-8 فقط. | تعمل هذه الدّالّة مع سلاسل نصّيّة مُرمَّزة بترميز UTF-8 فقط. | ||
| سطر 19: | سطر 19: | ||
==== <code>assoc</code> ==== | ==== <code>assoc</code> ==== | ||
| − | عندما تكون قيمته صحيحة | + | عندما تكون قيمته صحيحة <code>TRUE</code>، فستُحوَّل الكائنات المُعادة من الدّالّة إلى [http://php.net/manual/en/language.types.array.php مصفوفات] ترابطية (associative arrays). |
==== <code>depth</code> ==== | ==== <code>depth</code> ==== | ||
| سطر 26: | سطر 26: | ||
==== <code>options</code> ==== | ==== <code>options</code> ==== | ||
خيارات لفك ترميز JSON على شكل قناع بت Bitmask. هناك حاليًّا خياران مدعومان، الأوّل هو JSON_BIGINT_AS_STRING والذي يسمح بقلب الأعداد الصّحيحة الكبيرة إلى سلاسل نصّيّة بدلًا من أعداد ذات فاصلة عائمة float، وهو الخيار الافتراضي، الخيار الثّاني هو JSON_OBJECT_AS_ARRAY وله نفس تأثير تعيين قيمة المُعامِل assoc إلى TRUE. | خيارات لفك ترميز JSON على شكل قناع بت Bitmask. هناك حاليًّا خياران مدعومان، الأوّل هو JSON_BIGINT_AS_STRING والذي يسمح بقلب الأعداد الصّحيحة الكبيرة إلى سلاسل نصّيّة بدلًا من أعداد ذات فاصلة عائمة float، وهو الخيار الافتراضي، الخيار الثّاني هو JSON_OBJECT_AS_ARRAY وله نفس تأثير تعيين قيمة المُعامِل assoc إلى TRUE. | ||
| + | |||
| + | ==== القيم المعادة ==== | ||
| + | تُعيد هذه الدّالّة القيمة المُرمَّزة في المُعامِل json إلى نوع مناسب في لغة PHP، تُعاد القيم true و false و null على شكل TRUE و FALSE و NULL على التوالي وبالتّرتيب. تُعاد القيمة NULL في حال تعذّر فك ترميز سلسلة json أو كانت البيانات المُرمَّزة أعمق من حدّ المُعاوَدة. | ||
مراجعة 19:51، 9 أبريل 2018
الدالة json_decode() في PHP
(PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0)
تفك الدالة json_decode() ترميز سلسلة نصية بصيغة JSON.
الوصف
mixed json_decode ( string $json [, bool $assoc = FALSE [, int $depth = 512 [, int $options = 0]]] )
تأخذ سلسلة مُرمَّزة بصيغة JSON وتحوِّلها إلى مُتغيِّر PHP.
المعاملات
json
[[1]] json التي سيُفكُّ ترميزها.
تعمل هذه الدّالّة مع سلاسل نصّيّة مُرمَّزة بترميز UTF-8 فقط.
ملاحظة: تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار الأصلي RFC 7159.
assoc
عندما تكون قيمته صحيحة TRUE، فستُحوَّل الكائنات المُعادة من الدّالّة إلى مصفوفات ترابطية (associative arrays).
depth
عُمق المُعاوَدة (recursion) المُحدَّد من قبل المستخدم.
options
خيارات لفك ترميز JSON على شكل قناع بت Bitmask. هناك حاليًّا خياران مدعومان، الأوّل هو JSON_BIGINT_AS_STRING والذي يسمح بقلب الأعداد الصّحيحة الكبيرة إلى سلاسل نصّيّة بدلًا من أعداد ذات فاصلة عائمة float، وهو الخيار الافتراضي، الخيار الثّاني هو JSON_OBJECT_AS_ARRAY وله نفس تأثير تعيين قيمة المُعامِل assoc إلى TRUE.
القيم المعادة
تُعيد هذه الدّالّة القيمة المُرمَّزة في المُعامِل json إلى نوع مناسب في لغة PHP، تُعاد القيم true و false و null على شكل TRUE و FALSE و NULL على التوالي وبالتّرتيب. تُعاد القيمة NULL في حال تعذّر فك ترميز سلسلة json أو كانت البيانات المُرمَّزة أعمق من حدّ المُعاوَدة.