الفرق بين المراجعتين ل"PHP/json encode"
Kinan-mawed (نقاش | مساهمات) (أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>json_encode()</code> في PHP}}</noinclude>') |
Kinan-mawed (نقاش | مساهمات) |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>json_encode()</code> في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>json_encode()</code> في PHP}}</noinclude> | ||
| + | (PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0) | ||
| + | |||
| + | تُعيد الدالة <code>json_encode()</code> الدالة قيمة ما على شكل صيغة JSON. | ||
| + | |||
| + | == الوصف == | ||
| + | <syntaxhighlight lang="php"> | ||
| + | string json_encode ( mixed $value [, int $options = 0 [, int $depth = 512 ]] ) | ||
| + | |||
| + | </syntaxhighlight>تُعيد سلسلة نصّيّة على شكل صيغة JSON للقيمة المُدخلة. | ||
| + | |||
| + | يتأثّر الترميز بالخيارات المُعطاة للمُعامِل <code>options</code> ويعتمد ترميز القيم من نوع عدد ذو فاصلة عائمة (float) على القيمة المُحدَّدة في الإعدادات للخيار <code>[http://php.net/manual/en/ini.core.php#ini.serialize-precision serialize_precision]</code>. | ||
| + | |||
| + | == المعاملات == | ||
| + | |||
| + | === <code>value</code> === | ||
| + | وهي القيمة المطلوب ترميزها، يمكن أن تكون من أي نوع عدا [http://php.net/manual/en/language.types.resource.php الموارد (resource)]. | ||
| + | |||
| + | يجب ترميز جميع بيانات السّلاسل النصّيّة بصيغة UTF-8. | ||
| + | |||
| + | '''مُلاحظة:''' تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار الأصلي [http://www.faqs.org/rfcs/rfc7159 RFC 7159]. | ||
| + | |||
| + | === <code>options</code> === | ||
| + | خيارات على شكل قناع بت Bitmask، وهي <code>JSON_HEX_QUOT</code> و <code>JSON_HEX_TAG</code> و <code>JSON_HEX_AMP</code> و <code>JSON_HEX_APOS</code> و <code>JSON_NUMERIC_CHECK</code> و <code>JSON_PRETTY_PRINT</code> و <code>JSON_UNESCAPED_SLASHES</code> و <code>JSON_FORCE_OBJECT</code> و <code>JSON_PRESERVE_ZERO_FRACTION</code> و <code>JSON_UNESCAPED_UNICODE</code> و <code>JSON_PARTIAL_OUTPUT_ON_ERROR</code>. يُوجد وصف لسلوك كل من هذه الثّوابت على الصّفحة [http://php.net/manual/en/json.constants.php ثوابت JSON]. | ||
مراجعة 21:44، 9 أبريل 2018
(PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0)
تُعيد الدالة json_encode() الدالة قيمة ما على شكل صيغة JSON.
الوصف
string json_encode ( mixed $value [, int $options = 0 [, int $depth = 512 ]] )
تُعيد سلسلة نصّيّة على شكل صيغة JSON للقيمة المُدخلة.
يتأثّر الترميز بالخيارات المُعطاة للمُعامِل options ويعتمد ترميز القيم من نوع عدد ذو فاصلة عائمة (float) على القيمة المُحدَّدة في الإعدادات للخيار serialize_precision.
المعاملات
value
وهي القيمة المطلوب ترميزها، يمكن أن تكون من أي نوع عدا الموارد (resource).
يجب ترميز جميع بيانات السّلاسل النصّيّة بصيغة UTF-8.
مُلاحظة: تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار الأصلي RFC 7159.
options
خيارات على شكل قناع بت Bitmask، وهي JSON_HEX_QUOT و JSON_HEX_TAG و JSON_HEX_AMP و JSON_HEX_APOS و JSON_NUMERIC_CHECK و JSON_PRETTY_PRINT و JSON_UNESCAPED_SLASHES و JSON_FORCE_OBJECT و JSON_PRESERVE_ZERO_FRACTION و JSON_UNESCAPED_UNICODE و JSON_PARTIAL_OUTPUT_ON_ERROR. يُوجد وصف لسلوك كل من هذه الثّوابت على الصّفحة ثوابت JSON.