عن المشروع

PHP هي لغة برمجة نصية عامة الاستخدام موجّهة نحو تطوير الويب. يحتوي هذا المستودع، php/php-src، على الكود المصدري الرسمي لمفسّر PHP ويُوزَّع بموجب رخصة BSD المعدّلة (BSD-3-Clause). يشير ملف README إلى الدليل الرسمي على php.net/docs للتوثيق. بالنسبة للمستخدمين الذين يفضّلون عدم البناء من المصدر، تتوفر حزم وملفات ثنائية مبنية مسبقًا: ملفات Windows الثنائية تأتي من windows.php.net، وإرشادات التثبيت للأنظمة الأخرى مشمولة في فصل التثبيت بالدليل. يتطلب البناء من المصدر أدوات autoconf وbison وre2c لبناءٍ أدنى؛ بينما يحتاج البناء الافتراضي أيضًا إلى libxml2 وlibsqlite3. يسرد ملف README أوامر تثبيت الحزم لأنظمة Ubuntu وFedora وmacOS عبر Homebrew وmacOS عبر MacPorts. تدفق البناء هو: تشغيل ./buildconf لتوليد configure، ثم تشغيل ./configure (مع --enable-debug الموصى به للتطوير)، ثم make -j4، على أن يكون عدد المهام مطابقًا بشكل مثالي لعدد الأنوية المتاحة كما يبلغ عنه nproc. يُوجَّه مستخدمو Windows إلى دليل بناء منفصل خطوة بخطوة على PHP wiki. يتم التعامل مع الاختبارات عبر مجموعة اختبارات موسّعة مضمّنة تُشغَّل عبر make test بعد تجميع ناجح. تعمل الاختبارات بالتوازي افتراضيًا باستخدام ما يصل إلى 10 معالجات منطقية مكتشفة؛ يمكن تجاوز عدد العمال باستخدام -jN في TEST_PHP_ARGS أو TESTS، ويمكن استهداف أدلة محددة، على سبيل المثال make TESTS=tests/lang/ test. يوفّر موقع qa.php.net مزيدًا من المعلومات حول الاختبار وضمان الجودة. بعد بناء واختبار ناجحين، يقوم make install بتثبيت PHP، وقد يتطلب صلاحيات المستخدم الفائق اعتمادًا على البادئة والصلاحيات. تُضيف الإضافات وظائف تتجاوز الإضافات الأساسية المضمّنة العديدة. تُدرَج الإضافات الإضافية على صفحة PIE Extensions في Packagist ويمكن تثبيتها باستخدام PIE، مثبّت الإضافات الخاص بـ PHP، أو باستخدام PECL المُهمَل. المساهمات مرحّب بها عبر عمل fork للمستودع وفتح طلبات السحب. تتم المناقشات على GitHub ويمكن أيضًا إرسالها إلى القائمة البريدية للمطورين internals@lists.php.net. تتطلب الميزات الجديدة RFC مقبولًا، مع التفاصيل في صفحتي RFC والتصويت في الويكي؛ إصلاحات الأخطاء لا تتطلب RFC. يجب أن تشير رسائل الالتزامات إلى مشكلات GitHub بصيغة GH-NNNNNN أو تذاكر متتبع الأخطاء القديم بصيغة #NNNNNN. يوفّر ملف README روابط إلى مستندات إضافية للمساهمين: CONTRIBUTING.md وCODING_STANDARDS.md والتوثيق الداخلي وقواعد القائمة البريدية وعملية الإصدار. توجد صفحة اعتمادات تسرد المساهمين.