تثبيت PHP على ويندوز وماك ولينكس (التحقق بـ php -v)

لتثبيت PHP، شغّل أمرًا واحدًا حسب نظامك: winget install PHP.PHP.8.3 على ويندوز، أو brew install php على macOS، أو sudo apt install php-cli على Ubuntu وDebian. ثم افتح طرفية جديدة وشغّل php -v. إذا طبع رقم إصدار، فقد ثُبّتت PHP.

php -v

PHP 8.3.19 (cli) (built: Mar 27 2025 11:08:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.19, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.19, Copyright (c), by Zend Technologies

سيختلف الإصدار وتاريخ البناء لديك. وداخل السكربت، تأتي المعلومات نفسها من PHP_VERSION وphpversion(). اضغط Run لترى ما تعرضه PHP في هذه الصفحة:

<?php
echo "PHP version: " . phpversion() . "\n";
echo "Version as a number: " . PHP_VERSION_ID . "\n";
echo "Operating system family: " . PHP_OS_FAMILY . "\n";
echo "Integer size: " . PHP_INT_SIZE * 8 . " bit\n";

تثبيت PHP على ويندوز

أسرع طريقة هي winget، وهو مضمّن في ويندوز 10 و11. افتح PowerShell أو Windows Terminal:

winget install PHP.PHP.8.3

أغلق الطرفية وافتح واحدة جديدة، ثم شغّل php -v. النافذة الجديدة ضرورية لأن الطرفيات تحتفظ بقيمة PATH التي بدأت بها.

وللتثبيت يدويًا بدلًا من ذلك:

1. نزّل ملف zip المسمى "VS16 x64 Non Thread Safe" من windows.php.net/download.
2. فك ضغطه في مسار قصير مثل C:\php.
3. انسخ php.ini-development إلى php.ini في المجلد نفسه.
4. أضف C:\php إلى المتغير Path (قائمة ابدأ، ثم "Edit the system environment variables"، ثم Environment Variables).
5. افتح طرفية جديدة وشغّل php -v.

إذا أردت أيضًا Apache وMySQL في مثبّت واحد، فإن XAMPP وLaragon يجمعانهما مع PHP.

تثبيت PHP على macOS

لم يعد macOS يتضمن PHP. ثبّتها باستخدام Homebrew:

brew install php
php -v

يمنحك brew install php أحدث إصدار. ولتثبيت إصدار محدد، ثبّته باسمه، مثل brew install php@8.3. الصيغ ذات الإصدارات لا تُربط افتراضيًا، فأضفها إلى PATH بالأمر الذي يطبعه Homebrew في نهاية التثبيت. ويحدّثها brew upgrade php لاحقًا.

تثبيت PHP على لينكس

يأتي Ubuntu 24.04 وDebian 13 مع PHP 8.3 أو أحدث في مستودعاتهما الرسمية:

sudo apt update
sudo apt install php-cli php-mbstring php-xml php-curl
php -v

وعلى Fedora وRHEL والأنظمة المشابهة:

sudo dnf install php-cli php-mbstring php-xml
php -v

الإضافات حزم منفصلة باسم php-<name>: على Debian وUbuntu تضيف php-mysql برامج تشغيل MySQL (php-mysqlnd على Fedora)، وتضيف php-intl إضافة intl. وإذا أردت على Ubuntu إصدار PHP أحدث مما توفره توزيعتك، فإن المستودع الشائع ppa:ondrej/php يضم كل الإصدارات المدعومة:

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3-cli

التحقق من إصدار PHP في الكود

كثيرًا ما تحتاج المكتبات إلى إصدار أدنى. تقارن version_compare نصوص الإصدارات بالطريقة التي تقارنها بها PHP، ويعطي PHP_VERSION_ID عددًا صحيحًا بسيطًا (80300 تعني 8.3.0) تسهل مقارنته:

<?php
$required = '8.1.0';

if (version_compare(PHP_VERSION, $required, '>=')) {
    echo "PHP " . PHP_VERSION . " is new enough (need $required)\n";
} else {
    echo "Please upgrade: this code needs PHP $required\n";
}

echo PHP_VERSION_ID >= 80300 ? "8.3 features are available\n" : "Older than 8.3\n";
echo "Major: " . PHP_MAJOR_VERSION . ", minor: " . PHP_MINOR_VERSION . "\n";

معرفة الإضافات المثبتة

كثير من الأخطاء بعد التثبيت الجديد سببها إضافة مفقودة. في الطرفية، يعرض php -m كل إضافة محمّلة. وفي الكود، تتحقق extension_loaded من إضافة واحدة باسمها:

<?php
$needed = ['mbstring', 'json', 'ctype', 'dom'];

foreach ($needed as $ext) {
    $status = extension_loaded($ext) ? 'loaded' : 'MISSING';
    printf("%-10s %s\n", $ext, $status);
}

echo "\nTotal extensions loaded: " . count(get_loaded_extensions()) . "\n";

أضف الأسماء التي يحتاجها مشروعك (مثل pdo_mysql وintl وgd) وشغّل الكود على جهازك لترى ما يجب تثبيته.

العثور على php.ini

إعدادات مثل display_errors وmemory_limit وupload_max_filesize موجودة في php.ini. يطبع الأمر php --ini في الطرفية الملف المحمّل. ومن الكود:

<?php
$ini = php_ini_loaded_file();
echo $ini === false ? "No php.ini loaded, PHP uses its defaults\n" : "Loaded: $ini\n";

echo "memory_limit = " . ini_get('memory_limit') . "\n";
echo "max_execution_time = " . ini_get('max_execution_time') . "\n";

قد يستخدم سطر الأوامر وخادم الويب ملفي php.ini مختلفين، لذا فالإعداد الذي تغيّره لأحدهما لا ينطبق دائمًا على الآخر. تعرض صفحة إظهار الأخطاء الإعدادات التي تستحق التغيير أولًا على جهاز التطوير.

مشكلة شائعة: الطرفية ما زالت تشغّل الإصدار القديم

بعد الترقية، يعرض php -v أحيانًا الإصدار السابق. شغّل which php (macOS ولينكس) أو where php (ويندوز) لترى أي ملف تنفيذي تجده الطرفية أولًا. على macOS يكون غالبًا إصدار Homebrew مثبتًا لكنه غير مربوط، وعلى ويندوز يكون عادةً مجلدًا أقدم يسبقه في Path، مثل المجلد الموجود داخل XAMPP. صحّح الترتيب، وافتح طرفية جديدة، وتحقق مرة أخرى. ثم تابع مع تشغيل ملفات PHP.