الفرق بين المراجعتين ل"PHP/json decode"
Kinan-mawed (نقاش | مساهمات) |
Kinan-mawed (نقاش | مساهمات) |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>json_decode()</code> في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>json_decode()</code> في PHP}}</noinclude> | ||
(PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0) | (PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0) | ||
| + | |||
تفك الدالة <code>json_decode()</code> ترميز سلسلة نصية بصيغة JSON. | تفك الدالة <code>json_decode()</code> ترميز سلسلة نصية بصيغة JSON. | ||
| − | + | == الوصف == | |
| − | < | + | <syntaxhighlight lang="php">mixed json_decode ( string $json [, bool $assoc = FALSE [, int $depth = 512 [, int $options = 0]]] )</syntaxhighlight> |
تأخذ سلسلة مُرمَّزة بصيغة JSON وتحوِّلها إلى مُتغيِّر PHP. | تأخذ سلسلة مُرمَّزة بصيغة JSON وتحوِّلها إلى مُتغيِّر PHP. | ||
| − | + | == المعاملات == | |
| − | + | === <code>json</code> === | |
[[Http://php.net/manual/en/language.types.string.php|سلسلة]] json التي سيُفكُّ ترميزها. | [[Http://php.net/manual/en/language.types.string.php|سلسلة]] json التي سيُفكُّ ترميزها. | ||
| سطر 16: | سطر 17: | ||
'''ملاحظة:''' تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار الأصلي [http://www.faqs.org/rfcs/rfc7159 RFC 7159]. | '''ملاحظة:''' تعتمد 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>TRUE</code>، فستُحوَّل الكائنات المُعادة من الدّالّة إلى [http://php.net/manual/en/language.types.array.php مصفوفات] ترابطية (associative arrays). | ||
| − | + | === <code>depth</code> === | |
عُمق المُعاوَدة (recursion) المُحدَّد من قبل المستخدم. | عُمق المُعاوَدة (recursion) المُحدَّد من قبل المستخدم. | ||
| − | + | === <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 أو كانت البيانات المُرمَّزة أعمق من حدّ المُعاوَدة. | تُعيد هذه الدّالّة القيمة المُرمَّزة في المُعامِل json إلى نوع مناسب في لغة PHP، تُعاد القيم true و false و null على شكل TRUE و FALSE و NULL على التوالي وبالتّرتيب. تُعاد القيمة NULL في حال تعذّر فك ترميز سلسلة json أو كانت البيانات المُرمَّزة أعمق من حدّ المُعاوَدة. | ||
مراجعة 20:15، 9 أبريل 2018
(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 أو كانت البيانات المُرمَّزة أعمق من حدّ المُعاوَدة.