PHP echo: طباعة النصوص والمتغيرات وHTML

تطبع echo النصوص. اكتب echo "Hello"; لإخراج نص، وecho "Hello, $name"; لتضمين متغير، وecho $a, $b; لطباعة عدة قيم متتالية. كل ما تطبعه echo يصبح الصفحة التي يعرضها المتصفح، أو النص الذي تراه في الطرفية.

<?php
$name = "Ada";
$lessons = 12;

echo "Hello, $name\n";
echo "You finished " . $lessons . " lessons.\n";
echo "Name: ", $name, ", lessons: ", $lessons, "\n";

يستخدم السطر الأول الاستيفاء (المتغير داخل علامتي التنصيص المزدوجتين)، ويربط السطر الثاني النصوص بالعامل .، ويمرر السطر الثالث ثلاث قيم مفصولة بفواصل. الثلاثة تطبع النوع نفسه من النتائج.

طباعة HTML باستخدام echo

في صفحة الويب، تطبع echo عادةً HTML. يستقبل المتصفح النص ويعرض الوسوم. اضغط Run فيعرض تبويب Page النتيجة المعروضة:

<?php
$title = "Today's specials";
$specials = ["Tomato soup", "Grilled cheese", "Apple pie"];

echo "<h2>$title</h2>";
echo "<ul>";
foreach ($specials as $dish) {
    echo "<li>$dish</li>";
}
echo "</ul>";
echo '<p class="note">Served from 12:00 to 15:00.</p>';

يستخدم السطر الأخير علامات التنصيص المفردة حتى لا تحتاج علامات التنصيص المزدوجة في class="note" إلى تهريب. لا تُستبدل المتغيرات داخل علامات التنصيص المفردة، فاستخدمها للنص الثابت. وإذا جاءت القيمة من زائر (نموذج أو رابط)، فاطبعها عبر htmlspecialchars حتى لا تحقن HTML، وراجع صفحة htmlspecialchars.

وسم echo المختصر <?=

داخل ملف HTML، يكون <?= $value ?> الصيغة المختصرة لـ <?php echo $value; ?>. ويبقي القوالب سهلة القراءة:

<?php
$user = ["name" => "Grace", "points" => 1450, "level" => 7];
?>
<div class="card">
    <h3><?= $user["name"] ?></h3>
    <p>Level <?= $user["level"] ?>, <?= number_format($user["points"]) ?> points</p>
    <p>Next level in <?= 2000 - $user["points"] ?> points</p>
</div>

وسم echo المختصر متاح دائمًا. أما الوسم المختصر الآخر، <? دون php، فيعتمد على إعداد ولا ينبغي استخدامه.

طباعة عدة قيم وأسطر جديدة

لا تضيف echo فاصل سطر. في الطرفية، أضف "\n" (بين علامتي تنصيص مزدوجتين) أو الثابت PHP_EOL. وفي HTML، لا يظهر فاصل السطر في الكود المصدري، فاستخدم <br> أو عناصر منفصلة.

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

echo $first, " ", $last, "\n";      // commas: values printed one after another
echo $first . " " . $last . "\n";   // dots: one joined string, then printed
echo "Line one" . PHP_EOL . "Line two" . PHP_EOL;
echo 'Single quotes print \n as two characters', "\n";

الفواصل والنقاط تعطي المخرجات نفسها. مع الفواصل، تطبع echo كل قيمة بدورها، ومع النقاط تبني PHP أولًا نصًا واحدًا ثم تطبعه. ولفواصل الأسطر صفحة خاصة: السطر الجديد في PHP.

الفرق بين echo وprint

print هي الأخت الأقدم. تطبع قيمة واحدة وتعيد دائمًا 1، وهذا يسمح بظهورها داخل تعبير. أما echo فتأخذ أي عدد من القيم ولا تعيد شيئًا.

<?php
print "Printed with print\n";
echo "Printed with echo\n";

$result = print "print returns ";
echo $result, "\n";

echo "a", "b", "c", "\n";      // echo: many values
// print "a", "b";             // parse error: print takes one value

أما printf فمختلفة: تنسّق القيم باستخدام عناصر نائبة، مثل printf("%05.2f", 3.14159)، وتشرحها صفحة sprintf.

طباعة مصفوفة أو كائن

لا تطبع echo إلا النصوص والقيم التي تتحول إلى نصوص (الأعداد والقيم المنطقية وnull). المصفوفة لا تتحول. تطبع PHP على جهازك تحذيرًا والكلمة Array:

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

لعرض المحتوى، اختر الدالة المناسبة:

<?php
$tags = ["php", "echo", "basics"];

echo implode(", ", $tags), "\n";    // values as one string
print_r($tags);                     // readable structure
echo "\n";
echo json_encode($tags), "\n";      // JSON text
echo "First tag: {$tags[0]}\n";     // one element inside a string

الكائن أكثر صرامة: ما لم يعرّف صنفه __toString()، يوقف echo $object; السكربت بالخطأ Error: Object of class User could not be converted to string. والقيم المنطقية مفاجأة شائعة أيضًا: يطبع echo true; الرقم 1 ولا يطبع echo false; أي شيء. استخدم var_dump($value) عندما تحتاج إلى رؤية النوع والقيمة بدقة.

خطأ شائع: echo مع الأقواس والفواصل

لأن echo تبدو كدالة، يكتب بعضهم echo("a", "b");. هذا خطأ تحليل، لأن الأقواس تحيط بتعبير واحد:

PHP Parse error:  syntax error, unexpected token "," in /home/index.php on line 2

احذف الأقواس (echo "a", "b";) أو اربط القيم (echo("a" . "b");). وينطبق الأمر نفسه على print، التي لا تقبل قيمة ثانية أبدًا، بأقواس أو بدونها.