تحويل الأنواع في PHP: نص إلى عدد بـ intval() و(int)

لتحويل قيمة إلى نوع آخر، ضع النوع بين قوسين قبلها: (int) "42" يعطي العدد الصحيح 42. وتفعل صيغة الدالة intval("42") الشيء نفسه. التحويل لا يفشل أبدًا: النص الذي ليس عددًا يصبح 0، والنص الذي يبدأ بأرقام لا يُبقي إلا تلك الأرقام.

<?php
$input = "42";

var_dump((int) $input);
var_dump(intval($input));
var_dump((int) "12abc");   // leading digits only
var_dump((int) "abc");     // not a number at all
var_dump((float) "3.14");
var_dump((string) 99);
var_dump((bool) "0");

التحويلات الموجودة في PHP هي (int) و(float) و(string) و(bool) و(array) و(object). ولكل منها دالة أيضًا: intval() وfloatval() وstrval() وboolval().

نص إلى عدد صحيح: ما تعيده (int) وintval()

تقرأ PHP الأرقام من بداية النص، بعد تخطي المسافات البيضاء في أوله، وتتوقف عند أول محرف لا يناسب عددًا. صيغة الأس تُعد عددًا، أما البادئة 0x فلا.

<?php
$samples = ["42", "  42", "-17", "12.7", "1e3", "12abc", "abc", "", "0x1A", "012"];

foreach ($samples as $s) {
    printf("%-8s => %d\n", var_export($s, true), (int) $s);
}

لاحظ أن "12.7" تصبح 12: التحويل إلى عدد صحيح يقطع الكسر ولا يقرّب. ولا تطبع (int) ولا intval() أي تحذير هنا، مهما كان المدخل.

intval() مع أساس

تقرأ intval($value, $base) النص بنظام عددي آخر. ومع الأساس 0، تنظر PHP إلى البادئة: 0x للست عشري، و0b للثنائي، و0 في البداية للثماني.

<?php
var_dump(intval("ff", 16));
var_dump(intval("101", 2));
var_dump(intval("777", 8));
var_dump(intval("0x1A", 0));
var_dump(intval("0b101", 0));
var_dump(intval("012", 0));    // octal because of the leading 0
var_dump(intval("012"));       // base 10 by default

// Converting the other way
echo dechex(255), " ", decbin(5), " ", base_convert("ff", 16, 2), "\n";

عدد عشري إلى صحيح: قطع لا تقريب

تحذف (int) كل ما بعد الفاصلة العشرية، باتجاه الصفر. قرّب أولًا إذا أردت أقرب عدد صحيح، وانتبه إلى الأقواس:

<?php
var_dump((int) 12.99);
var_dump((int) -12.99);
var_dump((int) round(12.5));

// Precedence: the cast applies to (0.1 + 0.7) before * 10
var_dump((int) (0.1 + 0.7) * 10);
var_dump((int) ((0.1 + 0.7) * 10));
var_dump((int) round((0.1 + 0.7) * 10));

الزوج الأخير هو فخ الأعداد العشرية الكلاسيكي: تُخزَّن (0.1 + 0.7) * 10 على أنها 7.999999...، فيعطي القطع 7. والتقريب أولًا يعطي 8. تشرح صفحة الرياضيات الدوال round وfloor وceil.

التحويل إلى bool وstring وarray

عند التحويل إلى bool، لا يصبح false إلا عدد قليل من القيم: 0 و0.0 و"" و"0" وnull و[]. وكل ما عداها true، بما في ذلك "0.0" و" " و"false".

وعند التحويل إلى نص، تصبح true النص "1"، بينما تصبح false وnull كلتاهما "". وتحذف الأعداد العشرية .0 الأخيرة، وتستخدم الأعداد الكبيرة جدًا أو الصغيرة جدًا صيغة الأس.

<?php
foreach (["0", "0.0", " ", "false", [], [0], 0.0, -1, null] as $v) {
    printf("%-10s => %s\n", json_encode($v), var_export((bool) $v, true));
}

echo "---\n";
var_dump((string) true, (string) false, (string) null);
var_dump((string) 3.0, (string) 0.1, (string) 1e25);

echo "---\n";
var_dump((array) "a");     // a scalar becomes a one-element array
var_dump((array) null);    // null becomes an empty array

تحويل مصفوفة إلى نص لا يربط عناصرها. هذا يطبع Tags: Array:

<?php
$tags = ["php", "web"];
echo "Tags: " . $tags;

وتضيف PHP تحذيرًا:

Warning: Array to string conversion in /home/index.php on line 3

استخدم implode(", ", $array) أو json_encode($array) لتحويل مصفوفة إلى نص.

كل التحويلات في لمحة

اختر قيمة لترى ما تعيده intval و(bool) وstrval وis_numeric وgettype لها. حُسبت كل خلية بواسطة PHP 8.3.

Point at or tap a cell to read it as PHP.

$x	intval	bool	strval	is_numeric	gettype
"10"	10	true	'10'	true	'string'
"1abc"	1	true	'1abc'	false	'string'
"abc"	0	true	'abc'	false	'string'
""	0	false	''	false	'string'
" "	0	true	' '	false	'string'
"0"	0	false	'0'	true	'string'
"0.0"	0	true	'0.0'	true	'string'
"1e1"	10	true	'1e1'	true	'string'
"010"	10	true	'010'	true	'string'
1.5	1	true	'1.5'	true	'double'
true	1	true	'1'	false	'boolean'
false	0	false	''	false	'boolean'
null	0	false	''	false	'NULL'
[]	0	false	"Array" + warning	false	'array'
[1, 2]	1	true	"Array" + warning	false	'array'

Every cell computed by PHP 8.3.19.

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

النص الرقمي نص يبدو كعدد: "12" و"-3.5" و"1e3"، مع مسافات بيضاء اختيارية حوله. تحوّل PHP هذه النصوص تلقائيًا في العمليات الحسابية، وتخبرك is_numeric() ما إذا كان النص كذلك.

<?php
foreach (["12", "12.5", "1e3", " 12", "12 ", "12abc", "0x1A", ""] as $s) {
    printf("%-8s is_numeric: %s\n", var_export($s, true), var_export(is_numeric($s), true));
}

echo "---\n";
var_dump("5" * "4");     // both numeric: int
var_dump("5" + 1.5);     // float
var_dump(10 . "");       // int to string with concatenation

ما زالت "12abc" + 1 تعطي 13، لكن PHP 8 تطبع Warning: A non-numeric value encountered، وتطلق "abc" + 1 الخطأ TypeError. حوّل أو تحقق قبل إجراء عمليات حسابية على مدخلات المستخدم.

settype() وgettype()

تغيّر settype() نوع المتغير في مكانه، وتبلّغ gettype() عنه. وتعيد get_debug_type() الأسماء الأقصر التي تراها في رسائل الأخطاء (int وfloat وstring).

<?php
$value = "42";
echo gettype($value), "\n";

settype($value, "integer");
var_dump($value);
echo gettype($value), " / ", get_debug_type($value), "\n";

$price = "19.90";
settype($price, "float");
var_dump($price);

يستخدم معظم الكود التحويل الصريح ($value = (int) $value;) بدلًا من ذلك، لأنه أقصر ومعناه واحد.

تحقق من المدخلات بدلًا من تحويلها

لا ترفض (int) أبدًا، لذا تصبح (int) "abc" بصمت 0 وتصبح (int) "5 apples" القيمة 5. لمدخلات النماذج، استخدم filter_var مع FILTER_VALIDATE_INT: تعيد العدد الصحيح أو false.

<?php
foreach (["42", " 42 ", "42abc", "4.2", "042", "-7", "abc"] as $input) {
    $n = filter_var($input, FILTER_VALIDATE_INT);
    printf("%-8s => %s\n", var_export($input, true), $n === false ? "rejected" : $n);
}

قارن النتيجة بـ === false، لأن 0 عدد صحيح صالح و== false سترفضه. تعرض صفحة filter_var النطاقات وأدوات التحقق الأخرى.