تنزيل setup php - تنزيل كود مصدر setup php

قم بإعداد PHP مع الملحقات المطلوبة وتكوين php.ini ودعم تغطية التعليمات البرمجية وأدوات متنوعة مثل الملحن في GitHub Actions. يمنحك هذا الإجراء واجهة مشتركة بين الأنظمة الأساسية لإعداد بيئة PHP التي تحتاجها لاختبار تطبيقك. ارجع إلى قسم الاستخدام والأمثلة لمعرفة كيفية استخدام هذا.

محتويات

دعم نظام التشغيل/المنصة
- المتسابقون المستضافون على GitHub
- العدائين المستضافين ذاتيا
دعم PHP
دعم ملحق PHP
دعم الأدوات
دعم التغطية
- Xdebug
- PCOV
- تعطيل التغطية
الاستخدام
- المدخلات
- النواتج
- أعلام
- الإعداد الأساسي
- إعداد المصفوفة
- إعداد البناء ليلا
- تصحيح بناء الإعداد
- الإعداد الآمن للخيط
- فرض إعداد التحديث
- إعداد مطول
- إعداد متعدد القوس
- الإعداد المستضاف ذاتيًا
- إعداد الاختبار المحلي
- تكوين جيت
- ملحقات ذاكرة التخزين المؤقت
- تبعيات ملحن ذاكرة التخزين المؤقت
- مصادقة ملحن جيثب
- مصادقة Packagist الخاصة
- المصادقة اليدوية للمؤلف
- مخطوطات PHP المضمنة
- مطابقات المشكلة
- أمثلة
الإصدار
رخصة
المساهمات
دعم هذا المشروع
التبعيات
مزيد من القراءة

دعم نظام التشغيل/المنصة

يتم دعم كل من برامج التشغيل المستضافة self-hosted GitHub-hosted بواسطة setup-php على أنظمة التشغيل/الأنظمة الأساسية التالية.

المتسابقون المستضافون على GitHub

البيئة الافتراضية	تسمية سير العمل YAML	PHP مثبتة مسبقًا
أوبونتو 24.04	`ubuntu-24.04`	`PHP 8.3`
أوبونتو 22.04	`ubuntu-latest` أو `ubuntu-22.04`	`PHP 8.1`
أوبونتو 20.04	`ubuntu-20.04`	`PHP 7.4` إلى `PHP 8.3`
ويندوز سيرفر 2022	`windows-latest` أو `windows-2022`	`PHP 8.3`
ويندوز سيرفر 2019	`windows-2019`	`PHP 8.3`
ماك سيكويا 15.x	`macos-15`	-
ماك سونوما 14.x	`macos-latest` أو `macos-14`	-
ماك فينتورا 13.x	`macos-13`	`PHP 8.3`

العدائين المستضافين ذاتيا

نظام التشغيل المضيف/البيئة الافتراضية	تسمية سير العمل YAML
أوبونتو 24.04	`self-hosted` أو `Linux`
أوبونتو 22.04	`self-hosted` أو `Linux`
أوبونتو 20.04	`self-hosted` أو `Linux`
ديبيان 12	`self-hosted` أو `Linux`
ديبيان 11	`self-hosted` أو `Linux`
ويندوز 7 وأحدث	`self-hosted` أو `Windows`
ويندوز سيرفر 2012 R2 وأحدث	`self-hosted` أو `Windows`
ماك سيكويا 15.x x86_64/arm64	`self-hosted` أو `macOS`
ماك سونوما 14.x x86_64/arm64	`self-hosted` أو `macOS`
ماك فينتورا 13.x x86_64/arm64	`self-hosted` أو `macOS`

ارجع إلى الإعداد المستضاف ذاتيًا لاستخدام الإجراء على المتسابقين المستضافين ذاتيًا.
يتم أيضًا دعم أنظمة التشغيل المستندة إلى إصدارات Ubuntu وDebian المذكورة أعلاه على أساس أفضل جهد.
إذا كان إصدار PHP المطلوب مثبتًا مسبقًا، فسيقوم setup-php بالتبديل إليه، وإلا فإنه يقوم بتثبيت إصدار PHP.

دعم PHP

على جميع أنظمة التشغيل/الأنظمة الأساسية المدعومة، يمكن إعداد إصدارات PHP التالية وفقًا للمشغل.

PHP 5.3 إلى PHP 8.5 على برامج التشغيل المستضافة على GitHub، باستثناء برامج تشغيل macOS ARM64 (macos-14).
PHP 5.6 إلى PHP 8.5 على مشغلات macOS ARM64 المستضافة على GitHub (macos-14).
PHP 5.6 إلى PHP 8.5 على برامج التشغيل ذاتية الاستضافة.

نسخة PHP	استقرار	دعم الإصدار	دعم العداء
`5.3`	`Stable`	`End of life`	`GitHub-hosted`
`5.4`	`Stable`	`End of life`	`GitHub-hosted`
`5.5`	`Stable`	`End of life`	`GitHub-hosted`
`5.6`	`Stable`	`End of life`	`GitHub-hosted` ، `self-hosted`
`7.0`	`Stable`	`End of life`	`GitHub-hosted` ، `self-hosted`
`7.1`	`Stable`	`End of life`	`GitHub-hosted` ، `self-hosted`
`7.2`	`Stable`	`End of life`	`GitHub-hosted` ، `self-hosted`
`7.3`	`Stable`	`End of life`	`GitHub-hosted` ، `self-hosted`
`7.4`	`Stable`	`End of life`	`GitHub-hosted` ، `self-hosted`
`8.0`	`Stable`	`End of life`	`GitHub-hosted` ، `self-hosted`
`8.1`	`Stable`	`Security fixes only`	`GitHub-hosted` ، `self-hosted`
`8.2`	`Stable`	`Active`	`GitHub-hosted` ، `self-hosted`
`8.3`	`Stable`	`Active`	`GitHub-hosted` ، `self-hosted`
`8.4`	`Stable`	`Active`	`GitHub-hosted` ، `self-hosted`
`8.5`	`Nightly`	`In development`	`GitHub-hosted` ، `self-hosted`

ملحوظات:

يؤدي تحديد 8.5 في إدخال php-version إلى تثبيت الإصدار الليلي من PHP 8.5.0-dev . راجع إعداد البناء الليلي لمزيد من المعلومات.
لاستخدام JIT على PHP 8.0 وما فوق، راجع قسم تكوين JIT.

دعم ملحق PHP

يمكن إعداد امتدادات PHP باستخدام مدخلات extensions . يقبل string بتنسيق CSV.

في Ubuntu ، يمكن إعداد الامتدادات المتوفرة كحزمة، والمتاحة على PECL أو مستودع git.

- name : Setup PHP with PECL extension
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : imagick, swoole

في Windows ، يمكن إعداد الملحقات المتوفرة على PECL والتي تحتوي على ملف DLL الثنائي.
في macOS ، يمكن إعداد الملحقات المتوفرة على PECL أو مستودع git.
على Ubuntu و macOS لتجميع وتثبيت ملحق من مستودع git، اتبع هذا الدليل.
تم تمكين الإضافات المثبتة مع PHP إذا تم تحديدها.
يمكن إعداد إصدارات محددة من الامتدادات المتوفرة على PECL عن طريق إضافة اسم الامتداد إلى الإصدار. يعد هذا مفيدًا لتثبيت الإصدارات القديمة من الملحقات التي تدعم إصدارات PHP المنتهية.

- name : Setup PHP with specific version of PECL extension
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 5.4 '
    extensions : swoole-1.9.3

يمكن إعداد الامتدادات ذات الإصدارات التجريبية المتوفرة على PECL عن طريق إضافة اسم الامتداد بحالته، مثل alpha أو beta أو devel أو snapshot .

- name : Setup PHP with pre-release PECL extension
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : xdebug-beta

على Ubuntu و macOS لتجميع وتثبيت ملحق من PECL مع المكتبات أو التكوين المخصص، اتبع هذا الدليل.
يمكن تعطيل الملحقات المشتركة عن طريق وضع بادئة لها بـ : . سيتم أيضًا تعطيل جميع الملحقات التي تعتمد على الامتداد المحدد.

- name : Setup PHP and disable opcache
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : :opcache

يمكن تعطيل كافة الملحقات المشتركة عن طريق تحديد none . عندما لا يتم تحديد none مع الامتدادات الأخرى، يتم رفعه إلى بداية الإدخال. لذا، سيتم تعطيل كافة الامتدادات المشتركة أولاً، ثم ستتم معالجة باقي الامتدادات الموجودة في الإدخال.

ملاحظة: يؤدي هذا إلى تعطيل كافة الملحقات المشتركة الأساسية والجهات الخارجية، وبالتالي يمكن أن يعطل بعض الأدوات التي تحتاج إليها. يتم تمكين الامتدادات المطلوبة مرة أخرى عندما يتم إعداد الأدوات على أساس أفضل جهد. لذلك يوصى بإضافة الامتدادات المطلوبة لأدواتك بعد none في إدخال extensions لتجنب أي مشاكل.

- name : Setup PHP without any shared extensions except mbstring
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : none, mbstring

يمكن إعداد الامتداد intl بإصدار ICU محدد لـ PHP 5.6 وما فوق في سير عمل Ubuntu عن طريق إضافة intl بإصدار ICU . يتم دعم ICU 50.2 والإصدارات الأحدث. ارجع إلى ICU builds للإصدارات المحددة المدعومة.

- name : Setup PHP with intl
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : intl-70.1

يمكن العثور على الملحقات التي يتم تحميلها افتراضيًا بعد تشغيل setup-php على الويكي.
تتمتع هذه الإضافات بدعم مخصص:
- cubrid و pdo_cubrid على Ubuntu .
- event و gearman و geos و relay على Ubuntu و macOS .
- blackfire و couchbase و ioncube و oci8 و pdo_firebird و pdo_oci و pecl_http و phalcon3 و phalcon4 و phalcon5 و zephir_parser على جميع أنظمة التشغيل المدعومة.
افتراضيًا، تترك الامتدادات التي لا يمكن إضافتها أو تعطيلها بأمان رسالة خطأ في السجلات، ولا تتم مقاطعة التنفيذ. لتغيير هذا السلوك، يمكنك تعيين علامة fail-fast على true .

- name : Setup PHP with fail-fast
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : oci8
  env :
    fail-fast : true

دعم الأدوات

يمكن إعداد هذه الأدوات عالميًا باستخدام إدخال tools . يقبل سلسلة بتنسيق CSV.

behat ، blackfire ، blackfire-player ، box ، castor ، churn ، codeception ، composer ، composer-dependency-analyser ، composer-normalize الملحن، composer-require-checker composer-prefetcher composer-unused ، cs2pr ، deployer ، ecs ، flex ، grpc_php_plugin infection parallel-lint pecl phan phing phinx phive php-config php-cs-fixer php-scoper phpcbf phpcpd phpcs phpdoc أو phpDocumentor phpize phplint phpmd phpspec phpstan phpunit phpunit-bridge ، phpunit-polyfills ، pint ، prestissimo ، protoc ، psalm ، rector ، symfony أو symfony-cli ، vapor أو vapor-cli ، wp أو wp-cli

- name : Setup PHP with tools
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : php-cs-fixer, phpunit

بالإضافة إلى الأدوات المذكورة أعلاه، يمكن أيضًا إعداد أي أداة أو حزمة مؤلف عالميًا عن طريق تحديدها vendor/package مطابقة للقائمة الموجودة على Packagist. يقبل هذا التنسيق نفس قيود الإصدار التي يقبلها composer .

- name : Setup PHP with tools
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : vimeo/psalm

لإعداد إصدار معين من الأداة، حدده في النموذج tool:version .
يمكن أن يكون الإصدار بالتنسيق التالي:
- سمفر. على سبيل المثال tool:1.2.3 أو tool:1.2.3-beta1 .
- النسخة الرئيسية. على سبيل المثال tool:1 أو tool:1.x .
- النسخة الرئيسية والثانوية. على سبيل المثال tool:1.2 أو tool:1.2.x .
عند تحديد الإصدار الرئيسي فقط أو الإصدار بتنسيق major.minor ، سيتم إعداد أحدث إصدار تصحيح مطابق للإدخال.
باستثناء الإصدارات الرئيسية من composer ، إذا قمت بتحديد الإصدار major فقط أو الإصدار بتنسيق major.minor لأداة، فيمكنك الحصول على معدل محدود بواسطة واجهة برمجة تطبيقات GitHub. لتجنب ذلك، يوصى بتوفير رمز GitHub OAuth المميز. يمكنك القيام بذلك عن طريق تعيين متغير البيئة GITHUB_TOKEN . تم إهمال متغير البيئة COMPOSER_TOKEN لصالح GITHUB_TOKEN وستتم إزالته في الإصدار الرئيسي التالي.

- name : Setup PHP with tools
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : php-cs-fixer:3.64, phpunit:11.4
  env :
    GITHUB_TOKEN : ${{ secrets.GITHUB_TOKEN }}

يتم إعداد أحدث إصدار ثابت من composer افتراضيًا. يمكنك إعداد إصدار composer المطلوب عن طريق تحديد الإصدار الرئيسي v1 أو v2 ، أو الإصدار بتنسيق major.minor أو semver . بالإضافة إلى ذلك، يمكن أيضًا تحديد snapshot الملحن preview لإعداد الإصدارات المعنية.

- name : Setup PHP with composer v2
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : composer:v2

إذا كنت لا تستخدم الملحن في سير العمل الخاص بك، فيمكنك تحديد tools: none لتخطيها.

- name : Setup PHP without composer
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : none

يتم إعداد الأدوات pear و pecl و phpize و php-config افتراضيًا لجميع إصدارات PHP المدعومة على Linux وmacOS.
يتم إعداد أحدث إصدار من blackfire cli عند تحديد blackfire في إدخال الأدوات. يرجى الرجوع إلى الوثائق الرسمية لاستخدام blackfire مع GitHub Actions.
سيتم تخطي الأدوات prestissimo والجلب composer-prefetcher ما لم يتم تحديد composer:v1 أيضًا في إدخال الأدوات. يوصى بإسقاط prestissimo واستخدام composer v2 .
افتراضيًا، باستثناء أدوات composer التي لا يمكن إعدادها بأمان والتي تترك رسالة خطأ في السجلات، لا تتم مقاطعة التنفيذ. لتغيير هذا السلوك، يمكنك تعيين علامة fail-fast على true .

- name : Setup PHP with fail-fast
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : deployer
  env :
    fail-fast : true

ملحوظات

تعد tools الإدخال مفيدة لإعداد الأدوات التي يتم استخدامها فقط في سير عمل CI، وبالتالي الحفاظ على composer.json الخاص بك مرتبًا.
إذا كنت لا ترغب في استخدام جميع تبعيات التطوير الخاصة بك في سير العمل، فيمكنك تشغيل الملحن باستخدام --no-dev وتثبيت الأدوات المطلوبة باستخدام إدخال tools لتسريع سير عملك.
افتراضيًا، يتم تعيين COMPOSER_NO_INTERACTION على 1 ويتم تعيين COMPOSER_PROCESS_TIMEOUT على 0 . في الواقع، هذا يعني أن أوامر Composer في نصوصك البرمجية لا تحتاج إلى تحديد --no-interaction .
كما تم ضبط COMPOSER_NO_AUDIT على 1 . لذلك، إذا كنت تريد تدقيق تبعياتك بحثًا عن الثغرات الأمنية، فمن المستحسن إضافة خطوة composer audit قبل تثبيتها.
إذا كنت تريد تعيين COMPOSER_PROCESS_TIMEOUT مختلفًا، فيمكنك تعيينه في ملف سير العمل الخاص بك باستخدام الكلمة الأساسية env .

- name : Setup PHP with composer and custom process timeout
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    COMPOSER_PROCESS_TIMEOUT : 300

دعم التغطية

Xdebug

تحديد coverage: xdebug لاستخدام Xdebug وتعطيل PCOV .
يعمل على جميع إصدارات PHP المدعومة.

- name : Setup PHP with Xdebug
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    coverage : xdebug

عند تحديد coverage: xdebug ، يتم إعداد أحدث إصدار من Xdebug المتوافق مع إصدار PHP افتراضيًا.
إذا كنت بحاجة إلى Xdebug 2.x على PHP 7.2 أو 7.3 أو 7.4، فيمكنك تحديد coverage: xdebug2 .

- name : Setup PHP with Xdebug 2.x
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 7.4 '
    coverage : xdebug2

ملاحظة : يتم تمكين Xdebug افتراضيًا في صور Ubuntu GitHub Actions، لذلك إذا كنت لا تستخدمه في سير العمل الخاص بك، فمن المستحسن تعطيله لأن ذلك سيكون له تأثير إيجابي على أداء PHP الخاص بك. يرجى الرجوع إلى قسم تعطيل التغطية للحصول على التفاصيل.

PCOV

تحديد coverage: pcov لاستخدام PCOV وتعطيل Xdebug .
يعمل على PHP 7.1 وإصدارات PHP الأحدث.

إذا كان دليل التعليمات البرمجية المصدر الخاص بك مختلفًا عن src أو lib أو app ، فحدد pcov.directory باستخدام إدخال ini-values .

- name : Setup PHP with PCOV
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    ini-values : pcov.directory=api # optional, see above for usage.
    coverage : pcov

PHPUnit 8.x وما فوق يدعم PCOV خارج الصندوق.
إذا كنت تستخدم PHPUnit 5.x أو 6.x أو 7.x، فأنت بحاجة إلى إعداد pcov/clobber قبل تنفيذ اختباراتك.

- name : Setup PCOV
  run : |
    composer require pcov/clobber
    vendor/bin/pcov clobber

تعطيل التغطية

تحديد coverage: none لتعطيل كل من Xdebug و PCOV .

تعطيل التغطية لهذه الأسباب:

أنت لا تقوم بإنشاء تقارير التغطية أثناء الاختبار.
أنت تستخدم phpdbg لإجراء اختباراتك.
أنت تقوم بتوصيف التعليمات البرمجية الخاصة بك باستخدام blackfire .
أنت تستخدم PHP في وضع JIT. يرجى الرجوع إلى قسم تكوين JIT لمزيد من التفاصيل.

- name : Setup PHP with no coverage driver
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    coverage : none

الاستخدام

المدخلات

تحديد الاستخدام with الكلمة الأساسية

`php-version` (اختياري)

حدد إصدار PHP الذي تريد إعداده.
يقبل string . على سبيل المثال '8.4' .
يقبل lowest لإعداد أقل إصدار PHP مدعوم.
يقبل highest أو latest لإعداد أحدث إصدار PHP مستقر.
يقبل nightly لإعداد بنية ليلية من الفرع الرئيسي لـ PHP.
يقبل التنسيق dx ، حيث d هو الإصدار الرئيسي. على سبيل المثال 5.x و 7.x و 8.x .
راجع دعم PHP لإصدارات PHP المدعومة.
إذا لم يتم تحديده، فإنه يبحث عن ما يلي بالترتيب:
- إدخال php-version-file إذا كان موجودًا
- ملف composer.lock وقيمة platform-overrides.php
- ملف composer.json وقيمة config.platform.php

`php-version-file` (اختياري)

حدد ملفًا بإصدار PHP الذي تريد إعداده.
يقبل string . على سبيل المثال '.phpenv-version' .
راجع دعم PHP لإصدارات PHP المدعومة.
بشكل افتراضي، يتم استخدام ملف .php-version .
إذا لم يتم تحديده ولم يتم العثور على ملف .php-version الافتراضي، فسيتم إعداد أحدث إصدار PHP ثابت.

`extensions` (اختياري)

حدد الامتدادات التي تريد إضافتها أو تعطيلها.
يقبل string بتنسيق CSV. على سبيل المثال mbstring, :opcache .
لا يقبل none لتعطيل كافة الملحقات المشتركة.
الملحقات المشتركة المسبوقة بـ : معطلة.
راجع دعم ملحق PHP لمزيد من المعلومات.

`ini-file` (اختياري)

حدد ملف php.ini الأساسي.
يقبل production أو development أو none .
بشكل افتراضي، يتم استخدام ملف الإنتاج php.ini .

`ini-values` (اختياري)

حدد القيم التي تريد إضافتها إلى php.ini .
يقبل string بتنسيق CSV. على سبيل المثال post_max_size=256M, max_execution_time=180 .
يقبل قيم ini بفواصل إذا كانت ملفوفة بين علامتي اقتباس. على سبيل المثال xdebug.mode="develop,coverage" .

`coverage` (اختياري)

حدد برنامج تشغيل تغطية التعليمات البرمجية الذي تريد إعداده.
يقبل xdebug أو pcov أو none .
راجع دعم التغطية لمزيد من المعلومات.

`tools` (اختياري)

حدد الأدوات التي تريد إعدادها.
يقبل string بتنسيق CSV. على سبيل المثال: phpunit, phpcs
راجع دعم الأدوات للأدوات المدعومة.

النواتج

`php-version`

في GitHub Actions، يمكنك تعيين id لخطوة setup-php ، ويمكنك استخدامه للحصول على المخرجات في خطوة لاحقة.

يوفر إصدار PHP بتنسيق semver.

- name : Setup PHP
  id : setup-php
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '

- name : Print PHP version
  run : echo ${{ steps.setup-php.outputs.php-version }}

أعلام

حدد باستخدام الكلمة الأساسية env

`fail-fast` (اختياري)

حدد وضع علامة على سير العمل على أنه فاشل في حالة فشل إعداد ملحق أو أداة.
يؤدي هذا إلى تغيير الوضع الافتراضي من التحذيرات الرشيقة إلى التحذيرات السريعة الفشل.
بشكل افتراضي، يتم تعيينه على false .
يقبل true false .

`phpts` (اختياري)

حدد لإعداد بنية PHP آمنة لمؤشر الترابط.
يقبل nts للخيوط غير الآمنة و zts أو ts للخيوط الآمنة.
بشكل افتراضي، يتم تعيينه على nts .
راجع الإعداد الآمن للخيط لمزيد من المعلومات.

`update` (اختياري)

حدد تحديث PHP على العداء إلى أحدث إصدار من التصحيح.
يقبل true false .
بشكل افتراضي، يتم تعيينه على false .
راجع فرض إعداد التحديث لمزيد من المعلومات.

انظر أدناه لمزيد من المعلومات.

الإعداد الأساسي

قم بإعداد إصدار PHP معين.

 steps :
- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    extensions : mbstring, intl
    ini-values : post_max_size=256M, max_execution_time=180
    coverage : xdebug
    tools : php-cs-fixer, phpunit

إعداد المصفوفة

قم بإعداد إصدارات PHP متعددة على أنظمة تشغيل متعددة.

 jobs :
  run :
    runs-on : ${{ matrix.operating-system }}
    strategy :
      matrix :
        operating-system : ['ubuntu-latest', 'windows-latest', 'macos-latest']
        php-versions : ['8.2', '8.3', '8.4']
        phpunit-versions : ['latest']
        include :
          - operating-system : ' ubuntu-latest '
            php-versions : ' 8.1 '
            phpunit-versions : 10
    steps :
    - name : Setup PHP
      uses : shivammathur/setup-php@v2
      with :
        php-version : ${{ matrix.php-versions }}
        extensions : mbstring, intl
        ini-values : post_max_size=256M, max_execution_time=180
        coverage : xdebug
        tools : php-cs-fixer, phpunit:${{ matrix.phpunit-versions }}
      env :
        GITHUB_TOKEN : ${{ secrets.GITHUB_TOKEN }}

إعداد البناء ليلا

قم بإعداد إصدار ليلي بقيمة PHP 8.5 .

إصدارات PHP هذه قيد التطوير حاليًا وقد تحتوي على أخطاء وتغييرات معطلة.
قد لا تدعم بعض ملحقات مساحة المستخدم هذا الإصدار حاليًا.

 steps :
- name : Setup nightly PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.5 '
    extensions : mbstring
    ini-values : post_max_size=256M, max_execution_time=180
    coverage : xdebug
    tools : php-cs-fixer, phpunit

تصحيح بناء الإعداد

قم بإعداد نسخة PHP باستخدام رموز التصحيح.

يتم إعداد إصدارات الإنتاج من PHP بدون رموز التصحيح بشكل افتراضي.
يمكنك استخدام متغير بيئة debug لإعداد بناء باستخدام رموز تصحيح الأخطاء لـ PHP 5.6 وما فوق.

ملحوظات

في Linux، تتم إضافة رموز التصحيح كملفات معلومات التصحيح في الدليل /usr/lib/debug/.build-id . تتطابق هذه الملفات مع build-id الموجود في قسم ELF لثنائيات PHP وأدوات تصحيح الأخطاء مثل gdb قادرة على حل الرموز من هذه الملفات.
في نظام التشغيل Windows، تتم إضافة رموز التصحيح كملفات pdb في دليل تثبيت PHP.
في نظام التشغيل macOS، يتم تجميع رموز التصحيح في الثنائيات.

 steps :
- name : Setup PHP with debugging symbols
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    debug : true # specify true or false

الإعداد الآمن للخيط

قم بإعداد TS أو NTS PHP.

يتم إعداد إصدارات NTS بشكل افتراضي.

 jobs :
  run :
    runs-on : [ubuntu-latest, windows-latest, macos-latest]
    name : Setup PHP TS
    steps :
    - name : Setup PHP
      uses : shivammathur/setup-php@v2
      with :
        php-version : ' 8.4 '
      env :
        phpts : ts # specify ts or nts

فرض إعداد التحديث

التحديث إلى أحدث تصحيح لإصدارات PHP.

لا يتم تحديث إصدارات PHP المثبتة مسبقًا إلى أحدث إصدار تصحيح افتراضيًا.
إذا كان ppa:ondrej/php مفقودًا في بيئة Ubuntu GitHub، فسيتم تحديث إصدار PHP إلى أحدث إصدار تصحيح.
يمكنك تحديد متغير بيئة update ليكون true للتحديث إلى الإصدار الأحدث.

- name : Setup PHP with latest versions
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    update : true # specify true or false

إعداد مطول

تصحيح سير العمل الخاص بك

لتصحيح أي مشكلات، يمكنك استخدام العلامة verbose بدلاً من v2 .

- name : Setup PHP with logs
  uses : shivammathur/setup-php@verbose
  with :
    php-version : ' 8.4 '

إعداد متعدد القوس

قم بإعداد PHP على بنيات متعددة على Ubuntu GitHub Runners.

PHP 5.6 إلى PHP 8.4 مدعومة بواسطة setup-php على معماريات متعددة على Ubuntu .
لهذا، يمكنك استخدام صور shivammathur/node كحاويات. تحتوي هذه على Nodejs المتوافقة المثبتة لـ setup-php .
في الوقت الحالي، بالنسبة للإعداد المعتمد على ARM ، ستحتاج إلى مشغلين مستضافين ذاتيًا.

 jobs :
  run :
    runs-on : ubuntu-latest
    container : shivammathur/node:latest-${{ matrix.arch }}
    strategy :
      matrix :
        arch : ["amd64", "i386"]
    steps :
      - name : Install PHP
        uses : shivammathur/setup-php@v2
        with :
          php-version : ' 8.4 '

الإعداد المستضاف ذاتيًا

قم بإعداد PHP على مشغل مستضاف ذاتيًا.

لإعداد مشغل مستضاف ذاتيًا في حاوية، راجع الأدلة التالية وفقًا لنظام التشغيل الأساسي الخاص بك.
- لينكس
- ويندوز
لإعداد المشغل مباشرةً على نظام التشغيل المضيف أو في جهاز افتراضي، اتبع دليل المتطلبات هذا قبل إعداد المشغل المستضاف ذاتيًا.
إذا كان سير عملك يستخدم حاويات الخدمة، فقم بإعداد المشغل على مضيف Linux أو في جهاز Linux الظاهري. لا تدعم GitHub Actions المحاكاة الافتراضية المتداخلة على Linux، لذلك لن تعمل الخدمات في حاوية مرساة.

يوصى بتحديد runner متغير البيئة بالقيمة self-hosted للبيئات ذاتية الاستضافة.

 jobs :
  run :
    runs-on : self-hosted
    strategy :
      matrix :
        php-versions : ['5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3', '8.4']
    name : PHP ${{ matrix.php-versions }}
    steps :
    - name : Setup PHP
      uses : shivammathur/setup-php@v2
      with :
        php-version : ${{ matrix.php-versions }}
      env :
        runner : self-hosted

ملحوظات

لا تقم بإعداد العديد من برامج التشغيل ذاتية الاستضافة على مثيل خادم واحد لأن سير العمل المتوازي سوف يتعارض مع بعضها البعض.
لا تقم بإعداد مشغلين مستضافين ذاتيًا على جانب بيئة التطوير الخاصة بك أو خادم الإنتاج الخاص بك.
تجنب استخدام نفس التصنيفات للعدائين self-hosted والتي يستخدمها العدائون GitHub-hosted .

إعداد الاختبار المحلي

اختبر سير عمل Ubuntu محليًا باستخدام nektos/act .

 jobs :
  run :
    runs-on : ubuntu-latest
    steps :
    - name : Setup PHP
      uses : shivammathur/setup-php@v2
      with :
        php-version : ' 8.4 '

قم بتشغيل سير العمل محليًا act صور shivammathur/node docker.

اختر علامة الصورة التي تطابق خاصية runs-on في سير عملك. على سبيل المثال، إذا كنت تستخدم ubuntu-20.04 في سير عملك، فقم بتشغيل act -P ubuntu-20.04=shivammathur/node:2004 .

 # For runs-on: ubuntu-latest
act -P ubuntu-latest=shivammathur/node:latest

# For runs-on: ubuntu-24.04
act -P ubuntu-24.04=shivammathur/node:2404

# For runs-on: ubuntu-22.04
act -P ubuntu-22.04=shivammathur/node:2204

# For runs-on: ubuntu-20.04
act -P ubuntu-20.04=shivammathur/node:2004

تكوين جيت

تمكين Just-in-time (JIT) على PHP 8.0 وما فوق.

لتمكين JIT، قم بتمكين opcache في وضع cli عن طريق تعيين opcache.enable_cli=1 .
يتعارض JIT مع Xdebug و PCOV والامتدادات الأخرى التي تتجاوز وظيفة zend_execute_ex ، لذا قم بتعيين coverage: none وقم بتعطيل أي امتداد من هذا القبيل إذا تمت إضافته.
افتراضيًا، يتم تعيين opcache.jit=1235 و opcache.jit_buffer_size=256M والتي يمكن تغييرها باستخدام إدخال ini-values .
للحصول على معلومات مفصلة حول التوجيهات ذات الصلة بـ JIT، راجع official PHP documentation .

على سبيل المثال، لتمكين JIT في وضع tracing بحجم مخزن مؤقت يبلغ 64 MB .

- name : Setup PHP with JIT in tracing mode
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    coverage : none
    ini-values : opcache.enable_cli=1, opcache.jit=tracing, opcache.jit_buffer_size=64M

ملحقات ذاكرة التخزين المؤقت

يمكنك تخزين ملحقات PHP مؤقتًا باستخدام shivammathur/cache-extensions وإجراءات GitHub action/cache . تتوفر الملحقات التي يستغرق إعدادها وقتًا طويلاً جدًا عند تخزينها مؤقتًا في عملية سير العمل التالية ويتم تمكينها مباشرةً. وهذا يقلل من وقت تنفيذ سير العمل.
راجع shivammathur/cache-extensions للحصول على التفاصيل.

تبعيات ملحن ذاكرة التخزين المؤقت

إذا كان مشروعك يستخدم الملحن، فيمكنك الاحتفاظ بدليل ذاكرة التخزين المؤقت الداخلي للملحن. يتم تحميل التبعيات المخزنة مؤقتًا مباشرةً بدلاً من تنزيلها أثناء التثبيت. تتوفر الملفات المخزنة مؤقتًا عبر عمليات الفحص وستؤدي إلى تقليل وقت تنفيذ سير العمل.

- name : Get composer cache directory
  id : composer-cache
  run : echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT

- name : Cache dependencies
  uses : actions/cache@v4
  with :
    path : ${{ steps.composer-cache.outputs.dir }}
    key : ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
    restore-keys : ${{ runner.os }}-composer-

- name : Install dependencies
  run : composer install --prefer-dist

ملحوظات

يرجى عدم تخزين دليل vendor مؤقتًا باستخدام action/cache لأن ذلك سيكون له آثار جانبية.
إذا لم تلتزم composer.lock ، فيمكنك استخدام تجزئة composer.json كمفتاح لذاكرة التخزين المؤقت الخاصة بك.

 key : ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}

إذا كنت تدعم نطاقًا من تبعيات composer وتستخدم الخيارات prefer-lowest prefer-stable ، فيمكنك تخزينها في المصفوفة الخاصة بك وإضافتها إلى المفاتيح.

 key : ${{ runner.os }}-composer-${{ matrix.prefer }}-${{ hashFiles('**/composer.lock') }}
restore-keys : ${{ runner.os }}-composer-${{ matrix.prefer }}-

مصادقة ملحن جيثب

إذا كان لديك عدد من مسارات العمل التي تقوم بإعداد أدوات متعددة أو لديك العديد من تبعيات الملحن، فقد تصل إلى حد معدل الملحن في GitHub. وأيضًا، إذا قمت بتحديد الإصدار الرئيسي فقط أو الإصدار بتنسيق major.minor ، فيمكنك الوصول إلى الحد الأقصى للمعدل. لتجنب ذلك، يمكنك تحديد رمز OAuth عن طريق تعيين متغير البيئة GITHUB_TOKEN . يمكنك استخدام سر GITHUB_TOKEN لهذا الغرض.

تم إهمال متغير البيئة COMPOSER_TOKEN لصالح GITHUB_TOKEN وستتم إزالته في الإصدار الرئيسي التالي.

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    GITHUB_TOKEN : ${{ secrets.GITHUB_TOKEN }}

مصادقة Packagist الخاصة

إذا كنت تستخدم Private Packagist لتبعيات الملحن الخاص، فيمكنك تعيين متغير البيئة PACKAGIST_TOKEN للمصادقة.

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    PACKAGIST_TOKEN : ${{ secrets.PACKAGIST_TOKEN }}

المصادقة اليدوية للمؤلف

بالإضافة إلى GitHub أو Private Packagist، إذا كنت تريد مصادقة المستودعات الخاصة المستضافة في مكان آخر، فيمكنك تعيين متغير البيئة COMPOSER_AUTH_JSON باستخدام طرق المصادقة وبيانات الاعتماد بتنسيق json. يرجى الرجوع إلى قسم المصادقة في composer documentation لمزيد من التفاصيل.

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
  env :
    COMPOSER_AUTH_JSON : |
      {
        "http-basic": {
          "example.org": {
            "username": "${{ secrets.EXAMPLE_ORG_USERNAME }}",
            "password": "${{ secrets.EXAMPLE_ORG_PASSWORD }}"
          }
        }
      }

مخطوطات PHP المضمنة

إذا كان عليك تشغيل عدة أسطر من تعليمات PHP البرمجية في سير عملك، فيمكنك القيام بذلك بسهولة دون حفظها في ملف.

ضع الكود في خاصية التشغيل للخطوة وحدد الصدفة كـ php {0} .

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '

- name : Run PHP code
  shell : php {0}
  run : |
    <?php
    $welcome = "Hello, world";
    echo $welcome;

مطابقات المشكلة

أدوات مطابقة المشكلات هي تكوينات json تحدد الأخطاء والتحذيرات في سجلاتك وتظهرها بشكل بارز في واجهة مستخدم إجراءات GitHub من خلال تمييزها وإنشاء تعليقات توضيحية للتعليمات البرمجية.

PHP

قم بإعداد أدوات مطابقة المشكلات لمخرجات PHP الخاصة بك عن طريق إضافة هذه الخطوة بعد خطوة setup-php .

- name : Setup problem matchers for PHP
  run : echo "::add-matcher::${{ runner.tool_cache }}/php.json"

PHPUnit

قم بإعداد مطابقات مشكلة الإعداد لمخرجات PHPUnit الخاصة بك عن طريق إضافة هذه الخطوة بعد خطوة setup-php .

- name : Setup problem matchers for PHPUnit
  run : echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"

PHPStan

يدعم PHPStan الإبلاغ عن الأخطاء في إجراءات GitHub، لذا فهو لا يتطلب أدوات مطابقة للمشاكل.

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : phpstan

- name : Run PHPStan
  run : phpstan analyse src

مزمور

يدعم Psalm الإبلاغ عن الأخطاء في إجراءات GitHub بتنسيق الإخراج github .

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : psalm

- name : Run Psalm
  run : psalm --output-format=github

أدوات مع دعم checkstyle

بالنسبة للأدوات التي تدعم إعداد تقارير checkstyle مثل phpstan و psalm و php-cs-fixer و phpcs يمكنك استخدام cs2pr لإضافة تعليقات توضيحية إلى التعليمات البرمجية الخاصة بك.
للحصول على أمثلة، راجع وثائق cs2pr.

هنا مثال مع phpcs .

- name : Setup PHP
  uses : shivammathur/setup-php@v2
  with :
    php-version : ' 8.4 '
    tools : cs2pr, phpcs

- name : Run phpcs
  run : phpcs -q --report=checkstyle src | cs2pr

أمثلة

أمثلة على استخدام setup-php مع أطر وحزم PHP المختلفة.

الإطار/الحزمة	يعمل على	سير العمل
بلاك فاير	`macOS` ، `ubuntu` `windows`	blackfire.yml
مشغل بلاك فاير	`macOS` ، `ubuntu` `windows`	blackfire-player.yml
CakePHP مع `MySQL` و `Redis`	`ubuntu`	cakephp-mysql.yml
CakePHP مع `PostgreSQL` و `Redis`	`ubuntu`	cakephp-postgres.yml
CakePHP بدون خدمات	`macOS` ، `ubuntu` `windows`	cakephp.yml
CodeIgniter	`macOS` ، `ubuntu` `windows`	codeigniter.yml
لاميناس إم في سي	`macOS` ، `ubuntu` `windows`	laminas-mvc.yml
Laravel مع `MySQL` و `Redis`	`ubuntu`	laravel-mysql.yml
Laravel مع `PostgreSQL` و `Redis`	`ubuntu`	laravel-postgres.yml
لارافيل بدون خدمات	`macOS` ، `ubuntu` `windows`	laravel.yml
التجويف مع `MySQL` و `Redis`	`ubuntu`	التجويف-mysql.yml
التجويف مع `PostgreSQL` و `Redis`	`ubuntu`	lumen-postgres.yml
التجويف دون خدمات	`macOS` ، `ubuntu` `windows`	lumen.yml
فالكون مع `MySQL`	`ubuntu`	falcon-mysql.yml
فالكون مع `PostgreSQL`	`ubuntu`	falcon-postgres.yml
الجذور/الأساس	`ubuntu`	bedrock.yml
جذور/حكيم	`ubuntu`	sage.yml
إطار نحيف	`macOS` ، `ubuntu` `windows`	Slim-framework.yml
سيمفوني مع `MySQL`	`ubuntu`	Symfony-mysql.yml
Symfony مع `PostgreSQL`	`ubuntu`	Symfony-postgres.yml
Symfony بدون خدمات	`macOS` ، `ubuntu` `windows`	Symfony.yml
Yii2 Starter Kit مع `MySQL`	`ubuntu`	yii2-mysql.yml
Yii2 Starter Kit مع `PostgreSQL`	`ubuntu`	yii2-postgres.yml

الإصدار

استخدم علامة v2 كإصدار setup-php . إنها علامة متجددة وتتم مزامنتها مع أحدث الإصدارات الثانوية والإصدارات التصحيحية. مع v2 ستحصل تلقائيًا على إصلاحات الأخطاء وتصحيحات الأمان والميزات الجديدة ودعم أحدث إصدارات PHP.
يمكن أيضًا استخدام إصدارات الإصدار الدلالي. من المستحسن استخدام التابع مع الإصدار الدلالي للحفاظ على الإجراءات في سير العمل الخاص بك محدثة.
يمكن أيضًا استخدام Commit SHA، ولكن لا يوصى به إلا إذا قمت بإعداد الأدوات لتحديثها مع كل إصدار من الإجراء.
سيتم وضع علامة على الإصدار الرئيسي الجديد من الإجراء فقط عندما تكون هناك تغييرات جذرية في واجهة برمجة تطبيقات setup-php، أي المدخلات والمخرجات وعلامات البيئة.
لتصحيح أي مشكلات، يمكن استخدام العلامة verbose مؤقتًا. يقوم بإخراج كافة السجلات ويتم مزامنتها أيضًا مع أحدث الإصدارات.
لا يُنصح بشدة باستخدام الفرع main كإصدار، فقد يؤدي ذلك إلى تعطيل سير عملك بعد الإصدارات الرئيسية نظرًا لحدوث تغييرات معطلة.
إذا كنت تستخدم العلامة v1 أو الإصدار 1.xy ، فيجب عليك التبديل إلى الإصدار v2 لأن v1 لم يعد مدعومًا.

رخصة

النصوص والوثائق في هذا المشروع تخضع لترخيص MIT.
هذا المشروع له تبعيات متعددة. يمكن العثور على تراخيصهم في المستودعات الخاصة بهم.
شعار setup-php هو عمل مشتق من شعار php.net ومرخص بموجب ترخيص CC BY-SA 4.0.

المساهمات

المساهمات هي موضع ترحيب!

راجع دليل المساهمين قبل البدء.
إذا واجهت أي مشكلات أو أردت اقتراح ميزة/تحسين، فابدأ المناقشة هنا.

المساهمين في setup-php والمشاريع الأخرى ذات الصلة

دعم هذا المشروع

يرجى نجمة المشروع ومشاركته. إذا كنت تقوم بالتدوين، فيرجى مشاركة تجربتك في استخدام setup-php .
برجاء التواصل معنا إذا كانت لديك أي أسئلة حول رعاية برنامج setup-php.

يدعم العديد من المستخدمين والمنظمات برنامج setup-php عبر رعاة GitHub.

تقدم هذه الشركات منتجاتها وخدماتها بسخاء للمساعدة في تطوير هذا المشروع.

التبعيات

تبعيات Node.js
آرونباركر/VcRedist
mlocati/powershell-phpmanager
PPA:ondrej/php
shivammathur/cache-extensions
shivammathur/composer-cache
shivammathur/امتدادات البيرة المنزلية
shivammathur/البيرة-php
شيفاماثور/ICU-Intl
shivammathur/php-builder
shivammathur/php-builder-windows
شيفاماثور/php-ubuntu
شيفاماثور/php5-داروين
شيفاماثور/php5-ubuntu

مزيد من القراءة

حول إجراءات جيثب
بناء جملة إجراءات جيثب
إجراءات رهيبة أخرى

يوسع

setup php

محتويات

دعم نظام التشغيل/المنصة

المتسابقون المستضافون على GitHub

العدائين المستضافين ذاتيا

دعم PHP

دعم ملحق PHP

دعم الأدوات

دعم التغطية

Xdebug

PCOV

تعطيل التغطية

الاستخدام

المدخلات

php-version (اختياري)

php-version-file (اختياري)

extensions (اختياري)

ini-file (اختياري)

ini-values (اختياري)

coverage (اختياري)

tools (اختياري)

النواتج

php-version

أعلام

fail-fast (اختياري)

phpts (اختياري)

update (اختياري)

الإعداد الأساسي

إعداد المصفوفة

إعداد البناء ليلا

تصحيح بناء الإعداد

الإعداد الآمن للخيط

فرض إعداد التحديث

إعداد مطول

إعداد متعدد القوس

الإعداد المستضاف ذاتيًا

إعداد الاختبار المحلي

تكوين جيت

ملحقات ذاكرة التخزين المؤقت

تبعيات ملحن ذاكرة التخزين المؤقت

مصادقة ملحن جيثب

مصادقة Packagist الخاصة

المصادقة اليدوية للمؤلف

مخطوطات PHP المضمنة

مطابقات المشكلة

PHP

PHPUnit

PHPStan

مزمور

أدوات مع دعم checkstyle

أمثلة

الإصدار

رخصة

المساهمات

دعم هذا المشروع

التبعيات

مزيد من القراءة

`php-version` (اختياري)

`php-version-file` (اختياري)

`extensions` (اختياري)

`ini-file` (اختياري)

`ini-values` (اختياري)

`coverage` (اختياري)

`tools` (اختياري)

`php-version`

`fail-fast` (اختياري)

`phpts` (اختياري)

`update` (اختياري)