النصوص في PHP: علامات التنصيص والربط والاستيفاء

النص في PHP كتابة بين علامتي تنصيص مفردتين أو مزدوجتين. اربط النصوص بعامل النقطة، $first . ' ' . $last، أو ضع المتغير مباشرة داخل علامتي التنصيص المزدوجتين: "Hello, $name".

<?php
$first = "Ada";
$last = "Lovelace";

// Concatenation with the dot operator
$full = $first . " " . $last;
echo $full . "\n";

// Interpolation: the variable goes inside double quotes
echo "Hello, $first\n";
echo "Your name has " . strlen($full) . " characters\n";

تربط النقطة أي قيمتين في نص جديد. تُحوَّل الأعداد نيابةً عنك، لذا فإن "Total: " . 42 تساوي "Total: 42".

علامات التنصيص المفردة والمزدوجة

تفعل علامات التنصيص المزدوجة أمرين إضافيين: تستبدل المتغيرات بقيمها، وتحوّل تسلسلات الهروب مثل \n (سطر جديد) و\t (مسافة جدولة) إلى المحارف التي تمثلها. أما المفردة فتطبع النص كما كُتب بالضبط، باستثناء \' و\\.

<?php
$name = "Ada";

echo "Hello, $name\n";
echo 'Hello, $name\n';
echo "\n";

echo 'It\'s a single-quoted string' . "\n";
echo "Tab:\t|\n";
echo 'Tab:\t|' . "\n";

استخدم المفردة للنص الثابت والمزدوجة عندما تريد متغيرًا أو \n داخل النص. فرق السرعة بينهما أصغر من أن يُقاس، فاختر ما يجعل السطر أسهل في القراءة.

ربط النصوص بـ . و.=

تضيف .= إلى نهاية متغير نصي. وهي الطريقة المعتادة لبناء نص داخل حلقة، مثل جزء من HTML. شغّل هذا المثال فيفتح المحرر تبويب Page، الذي يعرض القائمة.

<?php
$fruits = ["Apple", "Banana", "Cherry"];

$html = "<ul>";
foreach ($fruits as $fruit) {
    $html .= "<li>" . $fruit . "</li>";
}
$html .= "</ul>";

echo "<p>We have " . count($fruits) . " fruits:</p>";
echo $html;

تهم الأولوية عند خلط . مع العمليات الحسابية. منذ PHP 8، يرتبط + و- بقوة أكبر من .، لذا فإن "Sum: " . 2 + 3 تساوي "Sum: 5". والأقواس توضّح ذلك للقارئ التالي: "Sum: " . (2 + 3).

وضع المتغيرات والمصفوفات والكائنات داخل نص

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

<?php
$user = ["name" => "Grace", "city" => "Arlington"];
$count = 3;
$fruit = "apple";

echo "Name: {$user['name']}\n";
echo "City: $user[city]\n";
echo "I ate {$count} {$fruit}s\n";

$date = new DateTime("2026-03-14");
echo "Pi day: {$date->format('F j')}\n";

// A plain function is not called inside a string
echo "{strtoupper($fruit)}\n";

تعمل الدوال التابعة داخل الأقواس، أما الدوال العادية فلا: يطبع السطر الأخير الأقواس واسم الدالة حول قيمة $fruit. استدعِ الدالة قبل النص، أو استخدم sprintf عندما يحتوي النص على قيم كثيرة.

تغيير حالة الأحرف: strtoupper وstrtolower وucfirst وucwords

<?php
$title = "the quick brown fox";

echo strtoupper($title) . "\n";
echo strtolower("HeLLo WoRLD") . "\n";
echo ucfirst($title) . "\n";
echo ucwords($title) . "\n";
echo lcfirst("Hello") . "\n";

// ucwords with your own word separators
echo ucwords("mary-jane o'neil", " -'") . "\n";

تعمل هذه الدوال بايتًا بايتًا ولا تغيّر إلا الأحرف من a إلى z. وللنصوص ذات الحركات أو الأحرف السيريلية أو اليونانية، استخدم النسخ متعددة البايتات التي تفهم UTF-8:

<?php
$word = "élan";

echo strtoupper($word) . "\n";
echo mb_strtoupper($word) . "\n";
echo mb_convert_case("ΑΘΉΝΑ city", MB_CASE_TITLE) . "\n";

قراءة محارف مفردة وتكرار النصوص

يمكن الوصول إلى النص بالفهرس كالمصفوفة. والإزاحات السالبة تُعد من النهاية. ولعدّ المحارف راجع strlen.

<?php
$word = "PHP strings";

echo $word[0] . "\n";
echo $word[-1] . "\n";
echo substr($word, 4) . "\n";

echo str_repeat("=", 20) . "\n";
echo str_pad("7", 3, "0", STR_PAD_LEFT) . "\n";

خطأ شائع: + بدلًا من .

في JavaScript يربط + النصوص. أما في PHP فالعامل + حسابي دائمًا: تُجمع النصوص الرقمية كأعداد، والنص غير الرقمي يطلق خطأً.

<?php
echo "5" + "5", "\n";  // numbers
echo "5" . "5", "\n";  // text

try {
    echo "Hello" + "World";
} catch (TypeError $e) {
    echo get_class($e) . ": " . $e->getMessage() . "\n";
}

إذا رأيت عددًا حيث توقعت نصًا مربوطًا، أو رأيت Unsupported operand types: string + string، فابحث عن + يجب أن تكون ..