تحويل JSON إلى مصفوفة PHP

مثال

المدخل:

{ "app": { "name": "Hyperion", "debug": true, "hosts": ["h1.example.com", "h2.example.com"] } }

الناتج (صيغة مختصرة، علامات اقتباس مفردة):

[
    'app' => [
        'name' => 'Hyperion',
        'debug' => true,
        'hosts' => [
            'h1.example.com',
            'h2.example.com',
        ],
    ],
]

تعيين الأنواع

متى تستخدم المصفوفة الترابطية مقابل المفهرسة

في PHP يوجد نوع واحد من المصفوفات يجمع كلا السلوكين. أما JSON فيميّز بوضوح بين الكائن والمصفوفة، ومن ثم يكون التعيين كالتالي:

• {} → مصفوفة ترابطية (['key' => value]).
• [] → مصفوفة مفهرسة ([value, value]).

يحافظ المولّد دائماً على هذا التمييز؛ وخلط الاثنين في PHP جائز لكنه مربك.

مزالق خاصة بـ PHP

• مفاتيح السلاسل الرقمية. يحوّل PHP القيمة "42" إلى مفتاح صحيح 42 داخل المصفوفة. إذا كان JSON لديك يستخدم سلاسل رقمية كمفاتيح وتحتاج إلى إبقائها سلاسل نصية، فإن التحويل ذهاباً وإياباً عبر array_combine لن يحافظ عليها.
• الأعداد الصحيحة الكبيرة. يمكن لـ JSON أن يحتوي أعداداً صحيحة أكبر من PHP_INT_MAX في الأنظمة ذات 32 بت. ينبّه المولّد عندما يكون ذلك ممكناً.
• UTF-8. سلاسل PHP هي تسلسلات بايتات؛ والمولّد يُخرج UTF-8 حرفياً. تأكد من حفظ ملف .php بترميز UTF-8 دون BOM.

حالات الاستخدام

• ملفات الإعداد. يستخدم كل من Laravel وSymfony إعدادات على هيئة مصفوفات PHP. ونقل إعداد JSON بأسلوب المورّدين يعمل جيداً.
• بيانات الاختبار التجريبية. تكون بيانات PHPUnit التجريبية أنظف كمصفوفات مقارنةً بملفات JSON التي تُحمّل وقت التشغيل.
• البذور (Seeders). غالباً ما تبدأ بذور قواعد البيانات في Laravel كتفريغ JSON ثم تتحول إلى مصفوفات PHP.

أخطاء شائعة

• إعادة تحويل مصفوفات PHP إلى JSON. يعامل json_encode المصفوفة الترابطية ككائن والمصفوفة المفهرسة كمصفوفة. وإذا خلطت بينهما (['key' => 'val', 0 => 'x'])، فستحصل على كائن عند الإخراج. أبقِ المصفوفات ذات الشكل الشبيه بـ JSON على هذا الشكل.
• علامات الاقتباس المزدوجة مع الفواصل العليا. تتطلب سلاسل PHP ذات الاقتباس المفرد تهريب \'؛ وتتطلب السلاسل ذات الاقتباس المزدوج تهريب \\"، وقد تُستوفى المتغيرات عن غير قصد إن لم تنتبه. استخدم الاقتباس المفرد للبيانات.
• نسيان الفواصل الأخيرة. يسمح بها PHP منذ الإصدار 7.3 وتجعل الفروقات (diff) أوضح. يضيفها المولّد افتراضياً.