أنواع البيانات في PHP: int وfloat وstring وbool وarray وnull

في PHP ثمانية أنواع تستخدمها يوميًا: int وfloat وstring وbool وarray وobject وnull، إضافة إلى callable للدوال التي تمررها. ليس للمتغير نوع ثابت، بل لقيمته الحالية. تعرض var_dump($x) النوع والقيمة معًا، وتعيد gettype($x) النوع كنص.

<?php
$values = [42, 3.14, "hello", true, [1, 2, 3], null, new stdClass()];

printf("%-8s %-10s %s\n", "gettype", "debug", "value");
foreach ($values as $value) {
    printf("%-8s %-10s %s\n", gettype($value), get_debug_type($value), json_encode($value));
}

العمود الأول هو gettype()، والثاني get_debug_type(). استبدل قيمة بقيمة من عندك وشغّل الكود مرة أخرى. يختلفان في بعض الأسماء: تقول gettype integer وdouble وboolean لأسباب تاريخية، بينما تستخدم get_debug_type أسماء تصريحات الأنواع (int وfloat وbool) وتعطي اسم الصنف للكائن.

أنواع PHP في لمحة

فحص القيم باستخدام var_dump

var_dump هي الأداة لرؤية ما لديك فعلًا. تطبع النوع والقيمة، وللنصوص طولها بالبايت:

<?php
var_dump(10);
var_dump(10.0);
var_dump("10");
var_dump(true);
var_dump(null);
var_dump(["id" => 7, "tags" => ["php", "web"]]);
var_dump("café");   // 5 bytes: é takes two bytes in UTF-8

كانت echo ستطبع 10 للثلاثة الأولى وتخفي الفرق. الطول في string(5) "café" يعدّ البايتات، ولهذا تختلف strlen وmb_strlen في النصوص غير اللاتينية.

الأعداد الصحيحة والعشرية

العدد الصحيح عدد بلا كسور. يمكن أن تستخدم القيم الحرفية الشرطات السفلية لتسهيل القراءة، والصيغ الست عشرية والثمانية والثنائية. والعدد العشري هو أي عدد فيه فاصلة عشرية أو أُس، وكما في كل اللغات يخزّن معظم الكسور العشرية بشكل تقريبي:

<?php
$population = 8_100_000_000;   // underscores are ignored
var_dump($population);
var_dump(0xFF, 0b1010, 0o17);  // hex, binary, octal
var_dump(PHP_INT_MAX);
var_dump(PHP_INT_MAX + 1);     // too big: becomes a float

var_dump(7 / 2);               // / returns a float when needed
var_dump(8 / 2);               // and an int when the result is whole
var_dump(intdiv(7, 2));        // integer division

var_dump(0.1 + 0.2);
var_dump(0.1 + 0.2 == 0.3);
var_dump(abs((0.1 + 0.2) - 0.3) < PHP_FLOAT_EPSILON);

لا تقارن الأعداد العشرية بـ == أبدًا، بل قارن الفرق بهامش صغير، أو قرّب الطرفين أولًا. وللمبالغ المالية، خزّن السنتات الكاملة كأعداد صحيحة.

القيم المنطقية وأي القيم تُعد false

قيمة bool هي true أو false. حيث تتوقع PHP شرطًا (if وwhile و!)، تُحوَّل أي قيمة إلى bool، وتُعد قائمة قصيرة من القيم false: false و0 و0.0 و"" و"0" و[] وnull. وكل ما عداها true. يعرض الجدول كل قيمة مع نوعها وتحويلها إلى bool وما إذا كانت رقمية:

المفاجآت هي "0.0" و" " و"null": الثلاثة نصوص غير فارغة وليست "0"، لذا فهي true، وتنفّذ if ($value) جسمها معها.

المصفوفات والكائنات وnull

تحمل المصفوفة أي مزيج من القيم تحت مفاتيح صحيحة أو نصية. والكائن نسخة من صنف، وstdClass هو الصنف الفارغ في PHP للكائنات السريعة، و(object) يحوّل مصفوفة إلى كائن منه. وتعني null «لا قيمة»:

<?php
$user = ["name" => "Ada", "roles" => ["admin", "editor"]];
echo gettype($user), ": ", $user["name"], "\n";

$point = new stdClass();
$point->x = 3;
$point->y = 4;
echo get_debug_type($point), ": ", $point->x, ",", $point->y, "\n";

$config = (object) ["debug" => true];
echo get_debug_type($config), ": debug is ", var_export($config->debug, true), "\n";

class Product
{
    public function __construct(public string $name, public float $price) {}
}
$p = new Product("Lamp", 25.0);
echo get_debug_type($p), ": {$p->name}\n";

$nothing = null;
var_dump($nothing, is_null($nothing));

فحص النوع بدوال is_*

لكل نوع دالة اختبار تعيد true أو false. تختلف is_numeric عن is_int: فهي تقبل النصوص الرقمية أيضًا، وهذا ما تريده عند فحص مدخلات النماذج.

<?php
$tests = [5, 5.0, "5", "5.5", " 5", "abc", true, null];

printf("%-7s %-6s %-8s %-9s %-10s\n", "value", "is_int", "is_float", "is_string", "is_numeric");
foreach ($tests as $t) {
    printf(
        "%-7s %-6s %-8s %-9s %-10s\n",
        var_export($t, true),
        is_int($t) ? "yes" : "",
        is_float($t) ? "yes" : "",
        is_string($t) ? "yes" : "",
        is_numeric($t) ? "yes" : ""
    );
}

ودوال أخرى: is_bool وis_array وis_object وis_null وis_callable وis_iterable، و$x instanceof ClassName لصنف محدد.

التحويل التلقائي للأنواع والأنواع الصارمة

تحوّل PHP الأنواع تلقائيًا عندما يحتاج عامل إلى نوع آخر. النص الرقمي المستخدم في الحساب يصبح عددًا، و. تحوّل الأعداد إلى نصوص. أما النص غير الرقمي إطلاقًا فلا يمكن جمعه، وتطلق PHP 8 الخطأ TypeError:

<?php
var_dump("10" + 5);        // int(15)
var_dump("1.5" * 2);       // float(3)
var_dump(10 . " items");   // string
var_dump("10" == "1e1");   // both numeric strings: compared as numbers
var_dump(100 == "1e2");

try {
    var_dump("abc" + 1);
} catch (TypeError $e) {
    echo "TypeError: ", $e->getMessage(), "\n";
}

والمعاملات ذات الأنواع تُحوَّل أيضًا، ما لم يبدأ الملف بـ declare(strict_types=1);. عندها يفشل الاستدعاء بنوع بسيط خاطئ بدلًا من تحويله:

<?php
declare(strict_types=1);

function addVat(float $net): float
{
    return $net * 1.2;
}

echo addVat(100), "\n";          // int to float is still allowed

try {
    echo addVat("100"), "\n";    // a string is not converted in strict mode
} catch (TypeError $e) {
    echo "TypeError: ", $e->getMessage(), "\n";
}

للتحويل المقصود، استخدم التحويل الصريح: (int) "42" و(float) "3.5" و(string) 10 و(bool) "0". تشرح صفحة تحويل الأنواع كل تحويل وحالاته الخاصة.

خطأ شائع: مقارنة أنواع مختلفة بـ ==

لأن == تحوّل قبل المقارنة، قد تكون قيمتان من نوعين مختلفين «متساويتين» بطرق تسبب أخطاء، مثل "1e1" == "10" (كلاهما العدد 10) أو null == false. استخدم ===، التي تشترط النوع نفسه أيضًا، ما لم ترد التحويل:

<?php
$pairs = [["1e1", "10"], [null, false], [0, ""], ["abc", 0], [1.0, 1]];

foreach ($pairs as [$a, $b]) {
    $show = var_export($a, true) . " vs " . var_export($b, true);
    printf("%-16s ==  %-6s ===  %s\n", $show, var_export($a == $b, true), var_export($a === $b, true));
}

أصلحت PHP 8 أسوأ حالة: كانت "abc" == 0 تساوي true وأصبحت الآن false، لأن النص غير الرقمي يُقارن كنص. الجداول الكاملة في صفحة عوامل المقارنة.