PHP/echo

(PHP 4, PHP 5, PHP 7)

تعرض ‎echo سلسلةً نصيةً وحيدة أو عدة سلاسل نصية.

الوصف

void echo ( string $arg1 [, string $... ] )

تُخرِج echo كل المعاملات، ولا تضيف إليها سطرًا جديدًا بعدها.

لا تعدّ echo دالةً بالمعنى الصريح للكلمة إذ تُعد بنيةً من بنى اللُّغة (‎language construct) لذلك فلستَ مجبرًا على إضافة الأقواس لها. على العكس من بنى اللُّغة الأخرى، فإن echo لا تتصرف مثل الدوال لذلك لا يمكن استخدامها في سياق الدوال دائمًا. إذا أردنا استعمال الدالة بأكثر من معامل فلا يتوجب وضع هذه المعاملات ضمن أقواس.

تملك echo شكلًا مختصرًا، إذ يمكن كتابة علامة المساواة = بعد كتابة وسم البداية لشيفرة PHP  مباشرةً. قبل نسخة ‎PHP 5.4.0 كان يتوجب تفعيل خاصية ‎ short_open_tagحتى نتمكن من استعمال خاصية الكتابة المختصرة لها‎.

I have <?=$foo?> foo.

تختلف echo عن نظيرتها print‎ في قبولها لقائمة من المعاملات وأنها لا تُعيد أي قيمة.

المعاملات

arg1

المعامل الذي نسعى لِعَرضه.

…

المعاملات الاختيارية الأخرى التي نرغب بعرضها.

القيم المعادة

لا تُعاد أي قيمة.

أمثلة

المثال 1: مثال بسيط عن echo

<?php
echo "Hello World";

echo "This spans
multiple lines. The newlines will be
output as well";

echo "This spans\nmultiple lines. The newlines will be\noutput as well.";

echo "Escaping characters is done \"Like this\".";
// نستطيع استعمال المعاملات داخل الدالة

$foo = "foobar";
$bar = "barbaz";

echo "foo is $foo"; // foo is foobar

// يمكن استعمال المصفوفات أيضًا
$baz = array("value" => "foo");

echo "this is {$baz['value']} !"; // this is foo !

// يؤدي استعمال علامات الاقتباس المفردة لعرض اسم المعامل وليس قيمته

echo 'foo is $foo'; // foo is $foo

//يمكن استعمال المتغيرات مباشرة في حال عدم استعمال محارف أخرى

echo $foo;          // foobar

echo $foo,$bar;     // foobarbarbaz

//يمكن إدراج السلسلة النصية كمجموعة معاملات مفردة كل واحد على حدى أو كمعامل وحيد بإستخدام خاصية دمج السلاسل النصية

echo 'This ', 'string ', 'was ', 'made ', 'with multiple parameters.', chr(10);

echo 'This ' . 'string ' . 'was ' . 'made ' . 'with concatenation.' . "\n";

echo <<<END
This uses the "here document" syntax to output
multiple lines with $variable interpolation. Note
that the here document terminator must appear on a
line with just a semicolon. no extra whitespace!
END;

// الشيفرة الآتية غير صحيحة لأننا نحاول معاملة
// echo كدالة
($some_var) ? echo 'true' : echo 'false';

// لكن الأمثلة الآتية ستعمل
($some_var) ? print 'true' : print 'false'; // لاحظ أنَّ print هي بنية من بنى اللغة أيضًا
                                           // لكنها تسلك سلوك الدوال
                                           // لذا يمكن استعمالها في السياق السابق

echo $some_var ? 'true': 'false'; // يمكننا تغيير ترتيب التعبير البرمجي
?>

ملاحظات

لمّا كانت ‎echo تعدّ من بنى اللُّغة وليست دالةً بالمعنى الصريح، فلا يمكن استعمالها بواسطة الدوال المتغيرة (variable functions).

تلميحة: تتجلى فائدة استعمال معاملات عدة داخل echo على استعمال خاصية دمج السلاسل النصية (concatenation) في أولوية معامل الربط (المعامل .). إذا مُررت عدة معاملات فلا حاجة لتوضيح الأسبقية عبر إضافة الأقواس:‎

<?php
echo "Sum: ", 1 + 2;
echo "Hello ", isset($name) ? $name : "John Doe", "!";

يملك معامل الربط عند خاصية دمج السلاسل النصية درجة أسبقية عالية مقارنة مع معامل الجمع والمعامل الثلاثي لذلك يجب إدراج الأقواس للحصول على السلوك المُراد.

<?php
echo 'Sum: ' . (1 + 2);
echo 'Hello ' . (isset($name) ? $name : 'John Doe') . '!';

انظر أيضًا

• print: عرض سلسلة نصية.
• printf()‎: عرض سلسلة نصية منسقة.
• flush()‎: تفريغ مخزن مخرج النظام.

مصادر

• صفحة echo‎ في توثيق PHP الرسمي.