PHP/define

(PHP 4, PHP 5, PHP 7)

تُعرِّف الدالة define()‎ ثابتًا.

الوصف

 bool define ( string $name , mixed $value [, bool $case_insensitive = FALSE ] )

تُستخدم الدالة define()‎ لتعريف ثابتٍ ما بإعطائه اسمًا معينًا.

المعاملات

name

اسم الثابت.  

value

قيمة الثابت.

سابقًا في PHP 5، كانت القيمة value التي يمكن أن تُسنَد إلى الثابت constant هي قيمةٌ أوليةٌ فقط (الأعداد الصحيحة، والأعداد العشرية، والسلاسل النصية، والقيم المنطقية، والقيمة NULL) ولاحقًا في PHP 7 بات من الممكن إسناد مصفوفة قيمةً للثابت.

case_insensitive

معامل اختياري، إذا ضُبِطَ إلى true فلن يكون الثابت المُعرَّف حساسًا لحالة الأحرف. لاحظ أنَّ السلوك الافتراضي هو أن يكون الثابت حساسًا لحالة الأحرف، أي أنَّ CONSTANT و Constant يمثلان ثابتين لهما قيمتان مختلفتان.

ملاحظة: الثوابت غير الحساسة الأحرف تخزن في حالة الأحرف الصغيرة.

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

تُعاد القيمة TRUE في حال نجاح عملية تعريف الثابت، وتُعاد القيمة FALSE في حال الفشل.

سجل التغييرات

الإصدار	الوصف
7.0.0	أصبح بالإمكان إسناد مصفوفات إلى الثوابت.

أمثلة

المثال 1: تعريف الثوابت

<?php
define("CONSTANT", "Hello world.");
echo CONSTANT; // "Hello world."
echo Constant; // "Constant" وسيظهر تنويه.

define("GREETING", "Hello you.", true);
echo GREETING; // "Hello you."
echo Greeting; // "Hello you."

// تعمل في الإصدار السابع من اللغة
define('ANIMALS', array(
   'dog',
   'cat',
   'bird'
));
echo ANIMALS[1]; // "cat"

?>

انظر أيضًا

• الدالة defined()‎: التحقق إن كان الثابت المعطى لها موجودًا أم لا.
• الدالة constant()‎: إعادة قيمة أحد الثوابت.
• قسم الثوابت في توثيق اللغة.

مصادر

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