نتائج البحث

اذهب إلى التنقل اذهب إلى البحث

الدالة ob_get_clean()‎ في PHP

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تأخذ الدالة ob_get_clean()‎ محتويات المخزن المؤقت الحالي وتحذف المخزن المؤقت الحالي للإخراج. الوصف string ob_get_clean ( void ) تأخذ الدالة ob_get_clean()‎ محتويات المخزن المؤقت الحالي وتحذف المخزن المؤقت الحالي للإخراج. الدالة ob_get_clean()‎  تنفذ أساسا كلا من ob_get_contents()‎ و ob_end_clean()‎. يجب أن يبدأ المخزن المؤقت للإخراج بالدالة ob_start()‎ وعلامة PHP_OUTPUT_HANDLER_CLEANABLE. القيم المعادة تعيد الدالة ob_get_clean()‎ محتويات المخزن المؤقت للإخراج وتنهي التخزين المؤقت للإخراج. إذا لم يكن التخزين المؤقت للإخراج مفعلا، تعيد الدالة القيمة FALSE. ...

الدالة md5_file()‎ في PHP

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تحسب الدالة md5_file()‎ قيمة md5 لملف معين. الوصف string md5_file (string $filename [, bool $raw_output = FALSE ] ) تحسب الدالة md5_file()‎ قيمة md5 للملف المُحدد بالمعامل filename باستخدام الخوارزمية RSA Data Security, Inc. MD5 Message-Digest Algorithm، القيمة الناتجة هي رقم بالترميز الست عشري مكون من 32 محرفًا. المعاملات filename اسم الملف. raw_output عند تحديده بالقيمة TRUE فستُعيد الدالة بصمة رقمية بالتمثيل الثنائي بطول 16 محرفًا. القيم المعادة تُعيد سلسلة نصية، أو القيمة FALSE ...

الدالة intval()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُعطي الدالة intval()‎‎‎ قيمة من نوع عدد صحيح (integer) لمتغيّر ما. الوصف int intval ( mixed $var [, int $base = 10 ] ) تُعطي قيمة من نوع عدد صحيح للمتغيّر var، وذلك اعتمادًا على مُعامِل الأساس base للتحويل (القيمة الافتراضيّة هي الأساس 10 والتي تُحوِّل للنظام العشري). لا يجب استخدام الدالة intval()‎ مع الكائنات، وينتج عن فعل ذلك خطأ من مستوى E_NOTICE وإعادة القيمة 1. المعاملات var القيمة العدديّة التي ستُحوَّل إلى عدد صحيح. ...

الدالة floor()‎ في PHP

(PHP 4, PHP 5, PHP 7) تقرِّب الدالة floor()‎ العدد الممرَّر إليها إلى أصغر عدد صحيح. الوصف float floor ( float $value ) تعيد هذه الدالة أقرب عدد صحيح (integer) للمعامل value، والتقريب سيكون للأدنى أي أدنى عدد صحيح قريب من ذلك المعامل. المعاملات value القيمة العدديَّة المراد تقريبها. القيم المعادة تقرِّب الدالة المعامل value إلى أصغر عدد صحيح قريب من ذلك المعامل وتعيده. رغم أن نوع العدد المُعاد هو صحيح (integer) إلا أنَّ نوع العدد الذي تعيده الدالة هو عشري ...

البنية print‎ في PHP

(PHP 4, PHP 5, PHP 7) تطبع print‎ سلسلةً نصيةً. الوصف int print ( string $arg ) تُخرِج print‎‎ المعامل arg. ليست print في الواقع دالةً حقيقية إنما هي بنيةٌ من بنى اللغة (language construct)، لذلك لا حاجة لاستخدام الأقواس لتمرير الوسائط إليها. الاختلافان الرئيسيّان مع البنية echo هما أنَّ print لا تقبل إلا معاملًا واحدًا وأنها تعيد القيمة 1 دائمًا. المعاملات arg البيانات المدخلة. القيم المعادة تعيد 1 دائمًا. الأمثلة مثال 1: أمثلة على البنية print <?php print("Hello World"); print "print() also ...

الدالة fprintf()‎ في PHP

(‎(PHP 5, PHP 7 تكتب الدالة ‎fprintf()‎ سلسلةً نصيةً منسقةً إلى مجرى (stream) معيّن. الوصف ‎int fprintf ( resource $handle , string $format [, mixed $args [, mixed $... ]] ) تَكتُب الدالة ‎fprintf()‎ سلسلة نصية منسقة وِفق المعامل format إلى مجرى يُحدَّد من المعامل handle. المعاملات handle مؤشر إلى موارد نظام الملفات، الذي يُنشَأ عادةً عبر الدالة fopen()‎. format اطلع على الدالة sprintf()‎ لتفاصيل أكثر عن المعامل format. args أول وسيط مُمرَّر إلى إلى سلسلة التنسيق. … بقية الوسائط المُمرَّرة ...

الدالة end()‎ في PHP

(PHP 4, PHP 5, PHP 7) تحرك الدالة end()‎ المؤشر الداخلي للمصفوفة إلى آخر عنصر. الوصف mixed end ( array &$array ) تنقل الدالة end()‎ المؤشر الداخلي للمصفوفة array إلى العنصر الأخير فيها وتعيد قيمته. المعاملات array المصفوفة المُدخلة. تُمرر هذه المصفوفة بالمرجعية لأن الدالة تُعدّلها. الأمر الذي يُحتم عليك أن تمرر لها متغيرًا حقيقيًا وليس دالة تُعيد مصفوفة، لأنَّه لا يمكن تمرير غير المتغيرات الفعلية فقط بالمرجعية. القيم المعادة تُعيد الدالة قيمة العنصر الأخير، أو القيمة FALSE إذا كانت المصفوفة ...

الدالة asort()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُرتِّب الدالة asort()‎ عناصر المصفوفة وتحافظ على اقتران الفهارس مع القيم المرتبطة بها. الوصف bool asort ( array &$array [, int $sort_flags = SORT_REGULAR ] ) تُرتّب هذه الدالة عناصر المصفوفة مع الحفاظ على اقتران فهارس عناصر هذه المصفوفة والقيم المرتبطة بها. وتُستخدم هذه الدالة بشكل أساسي عند ترتيب المصفوفات الترابطية والتي يكون ترتيب العناصر الفعلي فيها مهمًا. ملاحظة: إذا تساوت مقارنة عنصرين، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد. المعاملات array ...

الدالة json_last_error_msg()‎ في PHP

(PHP 5 >= 5.5.0, PHP 7) تُعيد الدالة json_last_error_msg()‎ الخطأ النّاتج عن آخر استدعاء للدالة json_encode()‎ أو json_decode()‎ على شكل سلسلة نصّيّة. الوصف string json_last_error_msg ( void ) المعاملات لا تملك هذه الدالة أي مُعامِلات. القيم المعادة تُعيد رسالة الخطأ عند النّجاح، أو "No error" إن لم يحدث أي خطأ، أو FALSE عند الفشل. انظر أيضًا الدالة json_last_error()‎: إعادة آخر خطأ حاصل. مصادر صفحة الدالة json_last_error_msg في توثيق PHP الرسمي.

الدالة tanh()‎ في PHP

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تعيد الدالة tanh()‎ الظل القطعي (hyperbolic tangent) للقيمة المُمرَّرة إليها، وتُمثَّل رياضيًّا بالشكل y = tanh(x)‎‎. الوصف float tanh ( float $arg ) تعيد هذه الدالة قيمة الظل القطعي للمعامل arg، وتساوي تمامًا القيمة sinh(arg)/cosh(arg)‎. المعاملات arg المعامل الذي ستُجرى عليه العمليَّة. القيم المعادة تُعاد قيمة الظل القطعي للمعامل arg. أمثلة المثال 1: استعمال الدالة tan()‎ <?php echo tan(M_PI_4); // 1 ?> انظر أيضًا الدالة tan()‎: تعيد قيمة الظل. الدالة atanh()‎: تعيد قيمة معكوس الظل ...

الدالة exp()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة exp()‎ القيمة ex حيث x هو المعامل الممرَّر إلى الدالة، و e هو ثابت أولر (يدعى أيضًا الثابت النيبيري) وهو أساس اللوغاريتم الطبيعي ويساوي تقريبًا 2.718282. الوصف float exp ( float $arg ) تعيد هذه الدالة‎ القيمة earg حيث arg هو المعامل الممرَّر إليها. المعاملات arg القيمة العدديَّة التي ستُجرى عليها العمليَّة. القيم المعادة تُعاد القيمة earg (أي رفع العدد e إلى القوة arg). أمثلة المثال 1: استعمال الدالة exp()‎ <?php echo exp(12) . ...

الدالة uniqid()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُنشئُ الدالة uniqid()‎ معرفًا فريدًا. الوصف string uniqid ([ string $prefix = "" [, bool $more_entropy = FALSE ]] ) تحصل الدالة uniqid()‎ على معرف فريد مع إمكانية إضافة سابقة له استنادًا إلى الوقت الحالي بالميكروثانية. تحذير: لا تولد الدالة uniqid()‎ قيمًا آمنة مشفرة، ويجب ألا تستخدم لأغراض التشفير. إذا كنت بحاجة إلى قيمة آمنة مشفرة، ففكر في استخدام الدالة random_int()‎ أو الدالة random_bytes()‎ أو الدالة openssl_random_pseudo_bytes()‎ بدلاً منها. تنبيه: لا تضمن الدالة uniqid()‎ تَفَرُّدَ ...

الدالة session_cache_limiter()‎ في PHP

PHP 4 >= 4.0.3, PHP 5, PHP 7)‎) تعيد الدالة session_cache_limiter()‎ أو تضبط محدّد ذاكرة التخزين المؤقتة. الوصف string session_cache_limiter ([ string $cache_limiter ] )‎ تعيد الدالة session_cache_limiter()‎ اسم محدّد ذاكرة التخزين المؤقتة الحالية. يحدّد محدّد ذاكرة التخزين المؤقت أيّة ذاكرة تخزين مؤقتة يتم من خلالها إرسال ترويسات HTTP إلى العميل. تحدّد هذه الترويسات القواعد التي قد يتم تخزين محتوى الصفحة بها مؤقتًا بواسطة العميل ووكلاء وسيطة (intermediate proxies). لا يسمح تعيين محدد ذاكرة التخزين المؤقتة إلى nocache بالتخزين المؤقت للعميل. ...

الدالة sleep()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُأَخِّرُ الدالةُ sleep()‎ تنفيذَ البرنامج. الوصف int sleep ( int $seconds ) تُأَخِّرُ الدالةُ sleep()‎ تنفيذ البرنامج لعدد محدد من الثواني. المعاملات seconds زمن الإيقاف بالثواني. القيم المعادة تعيد الدالة sleep()‎ القيمة 0 عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ. إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة sleep()‎ قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة WAIT_IO_COMPLETION ثابتة داخل ويندوز API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ ...

الدالة ob_get_level()‎ في PHP

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تعيد الدالة ob_get_level()‎ مستوى تداخل آليات التخزين المؤقت للإخراج. الوصف int ob_get_level ( void ) تعيد الدالة ob_get_level()‎ مستوى تداخل آليات التخزين المؤقت للإخراج. القيم المعادة تعيد الدالة ob_get_level()‎ مستوى تداخل معالجات التخزين المؤقت للإخراج أو صفر إذا كان التخزين المؤقت للإخراج غير مفعل. انظر أيضا الدالة ()ob_start: تشغيل المخزن المؤقت للإخراج. الدالة ()ob_get_contents: ترجع محتويات المخزن المؤقت للإخراج. مصادر صفحة الدالة ob_get_level في توثيق PHP الرسمي.

الدالة is_callable()‎ في PHP

(PHP 4 >= 4.0.6, PHP 5, PHP 7) تتحقّق الدالة is_callable()‎‎‎‎‎‎ من القدرة على استدعاء محتوى المتغيّر كدالة. الوصف bool is_callable ( mixed $var [, bool $syntax_only = FALSE [, string &$callable_name ]] ) تتحقّق هذه الدالة من القدرة على استدعاء محتوى المتغيّر كدالة. يُمكِن لهذه الدالة التحقّق من احتواء متغيّر بسيط على اسم صالح لدالة ما، أو احتواء مصفوفة على كائن مُرمَّز بشكل مناسب واسم دالة ما. المعاملات var القيمة المطلوب التّحقّق منها. syntax_only عندما تكون قيمته TRUE تتحقّق الدالة ...

الدالة cosh()‎ في PHP

(PHP 4, PHP 5, PHP 7) الدالة cosh()‎ تعيد التجيب القطعي (Hyperbolic cosine) للقيمة المررَّرة إليها، وتُمثَّل رياضيًّا بالشكل  y = cosh(x)‎ أو y = ch(x)‎. الوصف float cosh ( float $arg ) تعيد هذه الدالة قيمة التجيب القطعي للمعامل arg. تعرَّف هذه الدالة بالشكل (exp(arg) + exp(-arg))/2. المعاملات arg المعامل الذي ستُجرى عليه العمليَّة. القيم المعادة تُعاد قيمة التجيب القطعي للمعامل arg. انظر أيضًا الدالة cos()‎: تعيد قيمة التجيب. الدالة acosh()‎: تعيد قيمة معكوس التجيب القطعي. الدالة sinh()‎: تعيد قيمة ...

الدالة strcspn()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة strcspn()‎ طول الجزء الأولي للمعامل subject الذي لا يماثل المعامل mask. الوصف int strcspn ( string $subject , string $mask [, int $start [, int $length]]) تعيد الدالة strcspn()‎ طول الجزء الأولي من الكلمة المدخلة لها في المعامل subject بشرط ألا تحتوي أي حرف من حروف المعامل mask. إذا استدعيت الدالة بدون المعاملين start و length فستفحص السلسلة النصية subject بالكامل. أما في حالة وجودهما فسيكون عمل الدالة كعمل الدالة substr()‎ فسيتم الفحص ...

الدالة getcwd()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة getcwd()‎ مجلَّد العمل الحالي. الوصف string getcwd ( void ) تعيد هذه الدالة مجلَّد العمل الحالي. القيم المعادة يُعاد مسار مجلَّد العمل الحالي عند نجاح العمليَّة، أو القيمة FALSE عند فشلها. ستعيد الدالة getcwd()‎ في الأنظمة الشبيهة بيونكس القيمة FASLE إن كان أيُّ مجلِّد أبٍ للمجلَّد المُعاد لا يملك أذنًا للقراءة حتى لو كان ذلك المجلَّد -مجلَّد العمل الحالي- يملك ذلك. راجع صفحة الدالة chmod()‎ للمزيد من التفاصيل حول الأذونات. أمثلة المثال 1: ...

الدالة ftruncate()‎ في PHP

(PHP 4, PHP 5, PHP 7) تقلِّص الدالة ftruncate()‎ حجم الملف إلى حجم محدَّد. الوصف bool ftruncate ( resource $handle , int $size ) تقلِّص هذه الدالة حجم الملف الذي يشير إليه المورد handle إلى الحجم size المعطى. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. ملاحظة: يجب أن يُفتح الملف في وضع الكتابة. size الحجم المراد تقليص الملف إليه. ملاحظة: إن كان الحجم size المُعطى أكبر من حجم الملف، فسيُمدَّد حجم الملف إلى الحجم size بإضافة بايتات فارغة (null bytes) إليه. ...

الدالة str_pad()‎ في PHP

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تحشو الدالة str_pad()‎ سلسلة نصية بطولٍ معين باستعمال سلسلة نصية أخرى. الوصف string str_pad ( string $input , int $pad_length [, string $pad_string = " " [, int $pad_type = STR_PAD_RIGHT ]] ) تحشو الدالة str_pad()‎ قيمة المعامل input وتضيفها على اليسار أو اليمين أو على كلي الجانبين حتى تصل إلى الطول المحدد. إذا لم تُوَفَّر قيمة الوسيط الاختياري pad_string، فستحشى السلسلة النصية input بمسافات، وإلا فإنها ستحشى بأحرف من pad_string حتى نهايتها. ...

الدوال المتغيّرة في PHP

تدعم PHP مفهوم الدوال المتغيّرة والذي يعني أنّه في حال إلحاق قوسين إلى نهاية اسم أحد المتغيّرات، فإنّ اللغة ستبحث عن دالة تحمل الاسم ذاته، وستحاول تنفيذها. يمكن الاستفادة من هذه الميزة في الاستدعاءات الخلفية callbacks، وجداول الدوال وما إلى ذلك. لا تعمل الدوال المتغيرة مع البنى التابعة للغة مثل echo و print و unset()‎ و isset()‎ و empty()‎ و include و require وما شابهها، ولاستخدام أيّ من هذه الدوال كدوال متغيرة يمكن الاستعانة بدوالّ تغليف. المثال 1: مثال على ...

التعامل مع المجلدات في PHP

الثوابت المعرَّفة مسبقًا الثوابت المعرَّفة مسبقًا الخاصَّة بهذا الملحق. chdir()‎ تغيِّر مجلَّد PHP الحالي إلى مجلَّد آخر معطى. chroot()‎ تغيِّر مجلَّد الجذر (root directory) الحالي. closedir()‎ تغلق مجلَّدًا مفتوحًا. dir()‎ تعيد نسخةً (instance) من الصنف Directory. getcwd()‎ تعيد مجلَّد العمل الحالي. opendir()‎ تفتح مجلَّدًا محدَّدًا. readdir()‎ تقرأ عنصرًا واحدًا من محتويات المجلَّد وتعيده. rewinddir()‎ ترجع مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. scandir()‎ تعيد أسماء جميع الملفات والمجلَّدات الموجودة في مجلَّد محدَّد. الصنف Directory تُنشأ نُسخ (instances) الصنف Directory باستدعاء ...

الدالة disk_free_space()‎ في PHP

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تعيد الدالة disk_free_space()‎ المساحة المتوافرة (المتاحة) على نظام الملفات أو أحد الأقسام (disk partition). الوصف float disk_free_space ( string $directory ) تعيد هذه الدالة عدد البايتات المتاحة على نظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة directory التي تُمثِّل مسارًا للقسم أو حرفًا للقرص. المعاملات directory مسار القسم أو حرف القرص المراد معرفة مساحته المتاحة. ملاحظة: إن أعُطي اسم ملفٍ عوضًا عن المسار أو حرف القرص، فسيكون سلوك هذه الدالة ...

الدالة session_unset()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُزيل الدالة session_unset()‎ جميع مُتغيرات الجلسة. الوصف bool session_unset ( void ) تُزيل الدالة session_unset()‎ جميع مُتغيرات الجلسة المُسجلة حاليًا.   القيم المعادة تُعيد الدالة القيمة TRUE في حالة نجاحها، أو القيمة FALSE في حالة فشلها. ملاحظات إذا أستعمل المُتغير العام ‎$_SESSION، استعمل unset()‎ لإلغاء تسجيل مُتغير الجلسة، مثال: unset($_SESSION['varname'])‎; تحذير: لا تستعمل الدالة ()session_unsetمع المُتغير العام ‎$_SESSION كُله هكذا unset($_SESSION)‎ حيث قد يسبب هذا عدم تفعيل تسجيل مُتغيرات الجلسة مِن خلال المُتغير العام ‎$_SESSION. مصادر صفحة الدالة session_unset‎ في ...

الدالة strlen()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة strlen()‎ طول سلسلة نصية. الوصف int strlen ( string $string ) تعيد الدالة strlen()‎ طول السلسلة المعطاة. المعاملات string السلسلة النصية التي ستقاس لمعرفة طولها. القيم المعادة طول المعامل string في حالة النجاح، أو القيمة 0 إذا كان المعامل string سلسلةً نصيةً فارغةً. سجل التغييرات الإصدار الوصف 5.3.0 عالجت الإصدارات السابقة المصفوفات على أنها السلسلة النصية Array، مما أدى إلى إعادة طول سلسلة من 5 وإطلاق خطأ من مستوى E_NOTICE. أمثلة المثال 1: ...

الدالة filectime()‎ في PHP

(PHP 4, PHP 5, PHP 7) تجلب الدالة filectime()‎ آخر وقت جرى فيه تعديل مؤشِّر الفهرسة (inode) لملف محدَّد. الوصف int filectime ( string $filename ) تعيد هذه الدالة آخر وقت جرى فيه تعديل مؤشر الفهرسة (inode) للملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد وقت آخر تعديل جرى على الملف filename أو تُعاد القيمة FALSE عند فشل العمليَّة. الوقت الذي يُعاد يكون على شكل بصمة وقت (Unix timestamp). أمثلة المثال 1: استعمال الدالة filectime()‎ <?php $filename ...

الدالة get_defined_functions()‎ في PHP

(PHP 4 >= 4.0.4, PHP 5, PHP 7) تُعيد الدالة get_defined_functions()‎ مصفوفة فيها كل الدوال المعرّفة. الوصف array get_defined_functions ([ bool $exclude_disabled = FALSE ] ) تحصل الدالة get_defined_functions()‎ على مصفوفة بكل الدوال المعرّفة. المعاملات exclude_disabled لتحديد فيما إذا كان يجب استبعاد الدوال المعطّلة من القيمة المعادة. القيم المعادة تُعيد الدالة get_defined_functions()‎ مصفوفة متعددة الأبعاد تحتوي على قائمة بجميع الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم. حيث يمكن الوصول إلى الدوال الداخلية عبر ‎$arr["internal"]‎، ويمكن الوصول إلى الدوال ...

الدالة strrchr()‎ في PHP

(PHP 4, PHP 5, PHP 7) تبحث الدالة strrchr()‎ عن وجود محرف معيَّن في سلسلة نصيَّة ثمَّ تعيد ما بعده. الوصف string strrchr ( string $haystack , mixed $needle ) تعيد هذه الدالة جزءًا من السلسلة النصيَّة haystack الذي يبدأ عند نهاية المحرف needle وينتهي عند نهاية تلك السلسلة النصيَّة. المعاملات haystach السلسلة النصيَّة التي ستبحث الدالة فيها. needle المحرف الذي ستبحث الدالة عنه. إن مُرِّر أكثر من محرف واحد، فستأخذ الدالة المحرف الأول فقط وتستعمله في عملية البحث. يَختلف هذا ...

الدالة rtrim()‎ في PHP

(PHP 4, PHP 5, PHP 7) تزيل الدالة rtrim()‎ المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من نهاية السلسلة النصيَّة المررَّة إليها. الوصف string rtrim ( string $str [, string $character_mask ] ) تعيد هذه الدالة السلسلة النصيَّة str بعد أن تزيل جميع المسافات البيضاء أو المحارف المحدَّدة ضمن المعامل الاختياري character_mask. إن لم يُمرَّر المعامل السابق، فستزيل الدالة المحارف التالية: " ": محرف الفراغ وهو المحرف 32 (0x20) في الجدول ASCII. "‎\t": محرف مسافة الجدولة (tab) ...

الدالة decoct()‎ في PHP

(PHP 4, PHP 5, PHP 7) تحوِّل الدالة decoct()‎ العدد العشري الممرَّر إليها إلى عدد ثماني (octal). الوصف string decoct ( int $number ) تعيد هذه الدالة سلسلة نصيَّة (string) تمثِّل العدد الثماني المقابل للعدد العشري number الممرَّر إليها. أكبر عدد تستطيع الدالة تحويله يتعلق بنوع النظام المستعمل فيما إذا كان 32 بت أو 64 بت. يكون ذلك العدد في أنظمة 32 بت هو 4294967295 الذي يُنتج القيمة  37777777777 في النظام الثماني، بينما يصل في أنظمة 64 بت إلى 9223372036854775807 الذي ...

الدالة is_file()‎ في PHP

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_file()‎ إن كان الملف ملفًّا عاديًّا. الوصف bool is_file ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename ملفًّا عاديًّا. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا وهو ملفٌّ عاديٌّ، أو القيمة FALSE خلاف ذلك أو عند وجود خطأ. ملاحظة: لمَّا كان نوع الأعداد الصحيحة في PHP هو ذات إشارة (signed) وأغلب المنصات تستعمل الأعداد الصحيحة بطول 32 بت، فقد ...

الدالة fnmatch()‎ في PHP

(PHP 4 >= 4.3.0,PHP 5, PHP 7) تتحقَّق الدالة fnmatch()‎ من تطابق اسم ملف محدَّد مع نمط معيّن. الوصف bool fnmatch ( string $pattern , string $string [, int $flags = 0 ] ) تتحقَّق هذه الدالة من تطابق السلسلة النصيَّة string المُمرَّرة مع النمط pattern الذي يمكن أن يُستعمل معه محارف البدل الخاصة (wildcard) المُستخدمة في الصدفة. المعاملات pattern النمط المراد مُطابقته مع السلسلة النصيَّة string. يمكن استعمال محارف الصدفة الخاصة (wildcard ويشار إليها أيضًا meta characters) لإنشاء النمط. string ...

الدالة strncmp()‎ في PHP

(PHP 4, PHP 5, PHP 7) توازن الدالة strncmp()‎ بطريقة آمنة ثنائيًّا (binary safe) بين سلسلتين نصيَّتين لعدد محدَّد من المحارف الأولى. الوصف int strncmp ( string $str1 , string $str2 , int $len ) تشبه هذه الدالة الدالة strcmp()‎ باستثناء أنَّه يمكن تحديد عدد المحارف الأولى التي ستُوازن بين السلسلتين النصيَّتين. ملاحظة: هذه الدالة حساسة لحالة الأحرف. المعاملات str1 السلسلة النصيَّة الأولى. str2 السلسلة النصيَّة الثانية. len عدد المحارف المستعملة في الموازنة. القيم المعادة تُعاد قيمة أصغر من الصفر إن ...

الدالة crypt()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُشفِّر الدالة ‎crypt()‎ سلسلةً نصيةً بطريقة غير قابلة للعكس. الوصف string crypt ( string $str [, string $salt ] ) تُعيد الدالة crypt()‎ هاش (hash) السلسلة النصية بإستعمال خوارزمية Unix DES أو أي خوارزمية أخرى متوفرة بالنظام. على الرغم من أنَّ ضبط المعامل salt في الدالة crypt()‎ هو أمرٌ اختياري، إلا أن عدم ضبط قيمته سيؤدي إلى إنشاء هاش ضعيف للسلسة النصية. تُطلِق نسخ 5.6 للغة PHP وما بعدها الخطأ ‎E_NOTICE عند عدم ضبط المعامل ...

الدالة stat()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة stat()‎ معلومات عن ملف محدَّد. الوصف array stat ( string $filename ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف filename. إن كان الملف filename وصلة رمزيَّة، فستعاد معلومات إحصائيَّة عن الملف ذاته الذي تشير إليه الوصلة وليست عن الوصلة الرمزيَّة تلك. الدالة lstat()‎ مطابقة تمامًا للدالة stat()‎ باستثناء أنَّها تعيد معلومات إحصائيَّة عن الوصلات الرمزيَّة أيضًا. المعاملات filename مسار الملف المراد جلب معلومات عنه. القيم المعادة يوضِّح الجدول التالي تنسيق المصفوفة التي ...

الدالة asin()‎ في PHP

(PHP 4, PHP 5, PHP 7) الدالة asin()‎ تعيد معكوس جيب القيمة المُمرَّرة إليها، وتُمثَّل رياضيًّا بالشكل y = arcsin(x)‎ أو تجدها أحيانًا بالشكل y = sin-1(x)‎. الوصف float asin ( float $arg ) تعيد هذه الدالة قيمة معكوس الجيب للمعامل arg بواحدة الراديان. تعدُّ هذه الدالة asin()‎ متمِّمةً لدالة الجيب sin()‎؛ أي أنَّ جيب معكوس الجيب لعدد ما هو العدد نفسه sin(asin(a)) = a وأيضًا asin(sin(a)) = a. المعاملات arg المعامل الذي ستُجرى عليه العمليَّة. القيم المعادة تُعاد قيمة معكوس ...

الدالة print_r()‎ في PHP

(PHP 4, PHP 5, PHP 7) تطبع الدالة print_r()‎‎‎‎‎‎‎‎‎‎‎‎‎‎ معلومات مقروءة من قبل الإنسان حول متغيّر ما. الوصف mixed print_r ( mixed $expression [, bool $return = FALSE ] ) تعرض الدالة print_r()‎ معلومات حول المتغيّر بطريقة مقروءة من قبل الإنسان. تُظهِر الدوال print_r()‎، و var_dump()‎، و var_export()‎ أيضًا الخصائص المحميّة (protected) والخاصّة (private) للكائنات، ولكنّها لا تُظهِر الأعضاء الثابتة للصنف. المعاملات expression التّعبير المُرَاد طباعته. return نستخدم المُعامِل return إذا كنّا نرغب بالتقاط خرج الدالة print_r()‎. عندما تكون قيمة المُعامِل ...

الدالة fputcsv()‎ في PHP

(PHP 4, PHP 5, PHP 7) تنسِّق الدالة fputcsv()‎ سطرًا واحدًا من البيانات بالصيغة CSV (اختصارًا للعبارة comma-separated values) ثمَّ تكتبه على الملف. الوصف int fputcsv ( resource $handle , array $fields [, string $delimiter = "," [, string $enclosure = '"' [, string $escape_char = "\\" ]]] ) تنسق هذه الدالة سطرًا من البيانات المُمرَّرة عبر المصفوفة fields بالصيغة CSV ثمَّ تكتبها على الملف الذي يشير إليه المورد handle (بعد أن تضيف في نهاية ذلك السطر محرف سطر جديد). المعاملات ...

الدالة is_integer()‎ في PHP

(PHP 4, PHP 5, PHP 7) الدالة is_integer()‎‎ هي اسم بديل (alias) للدالة is_int()‎. الوصف هذه الدالة هي اسم بديل (alias) للدالة is_int()‎. مصادر صفحة الدالة is_integer في توثيق PHP الرسمي.

ثوابت الأصناف في PHP

يمكن تعريف قيم ثابتة لا يمكن تعديلها ولكل صنفٍ على حدة. تختلف الثوابت عن المتغيرات الاعتيادية في عدم استخدام العلامة $ للتصريح عنها أو استخدامها. تمتلك ثوابت الأصناف قابلية رؤية من نوع public. يجب أن تكون القيمة تعبيرًا ثابتًا وليس (على سبيل المثال) متغيرًا أو خاصّية أو استدعاء دالة. يمكن للواجهات interfaces أن تمتلك ثوابت أيضًا. راجع التوثيق الخاص بالواجهات لمشاهدة الأمثلة. منذ الإصدار 5.3.0، أصبح بالإمكان استخدام المتغيرات للإشارة إلى الصنف، ولا يمكن أن يحمل المتغير قيمة تمثّل إحدى ...

الدالة fseek()‎ في PHP

(PHP 4, PHP 5, PHP 7) تحرِّك الدالة fseek()‎ مؤشِّر الملف الحالي إلى موقع محدَّد. الوصف int fseek ( resource $handle , int $offset [, int $whence = SEEK_SET ] ) تغيِّر هذه الدالة دليل موقع المؤشِّر للملف الذي يشير إليه المورد handle. يُحدَّد الموقع الجديد للمؤشِّر، والذي يقاس بالبايت انطلاقًا من بداية الملف، بإضافة قيمة الإزاحة offset إلى الموقع الذي يُحدِّده المعامل whence. يُسمح عمومًا بالانتقال إلى موقعٍ يأتي بعد نهاية الملف (EOF). إن أُضيفت بيانات إلى ذاك الموقع، فإنَّ ...

الدالة str_split()‎ في PHP

(PHP 5, PHP 7) تُحَوِّلُ الدالة str_split()‎ السلسلة النصية إلى مصفوفة. الوصف array str_split ( string $string [, int $split_length = 1 ] ) تُحَوِّلُ الدالة str_split()‎ السلسلة النصية إلى مصفوفة. المعاملات string السلسلة النصية المدخلة. split_length الحد الأقصى لطول القطعة. القيم المعادة إذا حُدِّدَ المعامل الاختياري split_length، فستقسم المصفوفة المعادة إلى أجزاءٍ طولُ كلٍّ واحد منها يساوي قيمة المعامل split_length، وإلا فسيكون طول كل قطعة حرفًا واحدًا. تعاد القيمة FALSE إذا كان المعامل split_length أقل من 1. إذا كان طول ...

الدالة array()‎ في PHP

(PHP 4, PHP 5, PHP 7) تنشئ الدالة array()‎ مصفوفة جديدة. الوصف array array ([ mixed $... ] ) تنشئ هذه الدالة مصفوفة جديدة. للمزيد من المعلومات حول ماهية المصفوفة اقرأ عن النوع array. المعاملات ... يُعرَّف التركيب "الفهرس => القيم" كلًا من الفهرس والقيمة المقابلة وتفصل الفاصلة , بين تلك الأزواج. قد يكون الفهرس من نوع السلاسل النصية أو الأعداد الصحيحة. إذا حُذِفَ الفهرس فسيتولّد فهرس من نوع الأعداد الصحيحة تلقائيًا بدءًا من 0. وإذا كان الفهرس عددًا صحيحًا، فسيكون ...

الدالة disk_total_space()‎ في PHP

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تعيد الدالة disk_total_space()‎ المساحة الكلِّيَّة لنظام الملفات أو أحد الأقسام (disk partition). الوصف float disk_total_space ( string $directory ) تعيد هذه الدالة عدد البايتات الكلِّيَّة لنظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة directory التي تُمثِّل مسارًا للقسم أو حرفًا للقرص. المعاملات directory مسار القسم أو حرف القرص المُراد معرفة مساحته الكلِّيَّة. القيم المعادة يُعاد عدد عشري (float) يمثِّل المساحة الكلِّيَّة بواحدة البايت، أو تُعاد القيمة FALSE عند فشل العمليَّة. ...

الدالة register_shutdown_function()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُسجل الدالة register_shutdown_function()‎ دالة لتُنفّذ عند إنهاء التشغيل. الوصف void register_shutdown_function ( callable $callback [, mixed $parameter [, mixed $... ]] ) تُسجل الدالة register_shutdown_function()‎ دالة رد النداء ليتم تنفيذها بعد الانتهاء من تنفيذ السكربت أو بعد استدعاء الدالة exit()‎. من الممكن إجراء استدعاءات متعددة للدالة register_shutdown_function()‎، وستُستدعى كلٌ منها بالترتيب الذي سُجِّلَت به. فإذا استدعيت الدالة exit()‎ داخل دالة إيقاف تشغيل مُسجلة، فستتوقف المعالجة بالكامل ولن تُستدعى أية دالة إيقاف تشغيل أخرى ...

الدالة bindec()‎ في PHP

(PHP 4, PHP 5, PHP 7) تحوِّل الدالة bindec()‎ العدد الثنائي الممرَّر إليها إلى عدد عشري. الوصف number bindec ( string $binary_string ) تعيد هذه الدالة عددًا عشريًّا مقابلًا للعدد الثنائي binary_string الممرَّر إليها. تحوِّل الدالة العدد الثنائي إلى عدد صحيح (integer) أو إلى عدد عشري (float) عند احتياج حجم أكبر. تعامل الدالة bindec()‎ جميع القيم العدديَّة التي تحولها على أنَّها أعداد عديمة الإشارة (unsigned) إذ لا تأخذ بالحسبان أنَّ البت الأكثر أهمية (MSB)، الواقع على يسار العدد الثنائي binary_string، مخصَّص ...

الدالة get_class_vars()‎‎ في PHP

(PHP 4, PHP 5, PHP 7) تُعيد الدالّة get_class_vars()‎‎‎‎ الخصائص الافتراضية للصنف. الوصف array get_class_vars ( string $class_name ) تُعيد الدالّة get_class_vars()‎‎‎‎ الخصائص الافتراضية للصنف المُمرّر إليها. المعاملات class_name اسم الصف المراد الحصول على الخصائص الافتراضية له. القيم المعادة تُعيد الدالّة get_class_vars()‎‎ مصفوفة ترابطية من الخصائص المصرّح عنها المرئية في النطاق الحالي، مع قيمها الافتراضية. تكون عناصر المصفوفة الناتجة على الشكل التالي: اسم الخاصية => القيمة (varname => value). وتُعيد FALSE في حال وجود خطأ. سجل التغييرات الإصدار الوصف 5.0.3 ستُعيد ...

الدالة key()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُعيد الدالة key()‎‎ مفتاحًا ما من مصفوفة. الوصف mixed key ( array $array ) تُعيد الدالة key()‎‎‎ عنصر الفهرس للموضع الحالي في المصفوفة. المعاملات array المصفوفة المُدخلة. القيم المعادة تُعيد الدالة key()‎‎‎‎ ببساطة مفتاح عنصر المصفوفة الذي يشير المؤشر الداخلي إليه حاليًا. ولا تحرك الدالةُ المؤشرَ بأي طريقة. إذا أشار المؤشر الداخلي خارج نهاية قائمة العناصر أو كانت المصفوفة فارغة، تُعيد الدالة key()‎‎‎ القيمة NULL. سجل التغييرات الإصدار الوصف 7.0.0 تُمرر المصفوفة array الآن دائمًا ...

ترتيب المصفوفات في PHP

تحتوي لغة PHP على الكثير من الدوال التي تتعامل مع ترتيب المصفوفات، وهذه الصفحة تساعد على التفريق بينها. الاختلافات الرئيسية هي: ترتب بعض الدوال المصفوفات بناءً على مفاتيحها (keys)، بينما ترتبها دوالٌ أخرى بناءً على القيم المرتبطة مع كل مفتاح. قد تحافظ بعض الدوال على العلاقة ما بين المفتاح والقيمة المسجلة معه بعد عملية الترتيب. لكن هذا قد يعني أنه في بعض الأحيان سيُعاد ضبط المفاتيح إلى الوضعية الافتراضية العددية (0، 1، 2 …). طريقة الترتيب: هجائيًا من الأصغر إلى ...

الدالة stristr()‎ في PHP

(PHP 4, PHP 5, PHP 7) الدالة stristr()‎ نسخة غير حساس لحالة الأحرف من الدالة strstr()‎. الوصف string stristr ( string $haystack , mixed $needle [, bool $before_needle = FALSE ] ) تبحث الدالة stristr()‎ عن أول ظهور للسلسلة النصيَّة needle في السلسلة النصيَّة haystack ثم تعيد جزءًا من هذه السلسلة والتي تبدأ من بداية المعامل needle -الذي عثر عليه أولًا- وحتى نهاية السلسلة. المعاملات haystack السلسلة النصيَّة التي ستبحث الدالة فيها. needle مجموعة المحارف (السلسلة النصيَّة) التي ستبحث الدالة عنها. ...

الدالة strstr()‎ في PHP

(PHP 4, PHP 5, PHP 7) تبحث الدالة strstr()‎ عن أول ظهور لسلسلة نصيَّة معينة ضمن سلسلة نصيَّة أخرى. الوصف string strstr ( string $haystack , mixed $needle [, bool$before_needle = FALSE ] ) تبحث هذه الدالة عن أول ظهور للسلسلة النصيَّة needle في السلسلة النصيَّة haystack ثم تعيد جزءًا من هذه السلسلة والتي تبدأ من بداية المعامل needle -الذي عثر عليه أولًا- وحتى نهاية السلسلة. ملاحظة: هذه الدالة حسَّاسة لحالة الأحرف. إن أردت البحث دون تحسُّس حالة الأحرف، فاستعمل الدالة ...

الدالة umask()‎ في PHP

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة umask()‎ قيمة القناع umask الحاليَّة. الوصف int umask ([ int $mask ] ) تضبط هذه الدالة قيمة القناع umask في PHP إلى القيمة mask & 0777 ثمَّ تعيد قيمة umask السابقة. عندما تُستعمل PHP كوحدة من وحدات الخادم، فستُستعاد قيمة umask عند انتهاء كلِّ طلب. المعاملات mask قيمة umask الجديدة. القيم المعادة تُعاد قيمة umask الحاليَّة إن لم يُمرَّر أيُّ معامل، أو ستُعاد قيمة umask السابقة خلافًا لذلك. أمثلة المثال 1: استعمال الدالة ...

الدالة stripos()‎ في PHP

(PHP 5, PHP 7) تعثر الدالة stripos()‎ على موضع أوّل مطابقة غير حساسة لحالة الأحرف لسلسلة نصية فرعية في سلسلة نصية أخرى. الوصف int stripos ( string $haystack , string $needle [, int $offset = 0 ] ) تبحث عن الموضع الرقمي لأوّل مطابقة للمعامل needle في سلسلة المعامل haystack النصية. على عكس الدالة stripos()‎، الدالة strpos()‎ غير حساس لحالة الأحرف. المعاملات haystack السلسلة المطلوب البحث فيها. needle لاحظ أن المعامل needle قد يكون سلسلة نصية من حرف واحد أو أكثر. ...

الدالة time_sleep_until()‎‎ في PHP

(PHP 5 >= 5.1.0, PHP 7) تُأَخِّرُ الدالةُ time_sleep_until()‎ تنفيذَ البرنامج حتى الوقت المحدد. الوصف bool time_sleep_until ( float $timestamp ) تُأَخِّرُ الدالةُ time_sleep_until()‎ تنفيذَ البرنامج حتى تحقيق الزمن المضاف للمعامل timestamp. المعاملات timestamp المعامل timestamp هو الزمن الذي ينبغي أن يعمل البرنامج عنده. القيم المعادة تعيد الدالة time_sleep_until()‎ القيمة TRUE عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ. سجل التغييرات الإصدار الوصف 5.3.0 صارتْ الدالةُ time_sleep_until()‎ الآن مُتاحةً على منصات ويندوز. الأخطاء والاستثناءات إذا كان الزمن المحدد للمعامل timestamp ...

الدالة mkdir()‎ في PHP

(PHP 4, PHP 5, PHP 7) تنشئ الدالة mkdir()‎ مجلَّدًا جديدًا. الوصف bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = FALSE [, resource $context ]]] ) تحاول هذه الدالة إنشاء مجلَّد جديد في المسار pathname المُعطى. المعاملات pathname مسار المجلَّد المُراد إنشاؤه. mode أذونات المجلَّد الجديد، وقيمة هذا المعامل الإفتراضيَّة هي 0777 أي أوسع مجال لأذونات الوصول للمجلَّد. للمزيد من المعلومات حول الأذونات، راجع صفحة الدالة chmod()‎. ملاحظة: يُتجاهل المعامل mode على منصات ويندوز. الجدير ...

الدالة current()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة current()‎ العنصر الحالي في مصفوفة. الوصف mixed current ( array $array ) تحتوي كل مصفوفة على مؤشر داخلي يشير إلى العنصر "الحالي"، والذي يشير بدايةً إلى العنصر الأول المدرج في المصفوفة. المعاملات array المصفوفة المُدخلة. القيم المعادة تُعيد الدالة current()‎ ببساطة قيمة عنصر المصفوفة الذي يشير إليه حاليًا المؤشرُ الداخلي. ولا تحرك الدالةُ المؤشرَ بأي طريقة. إذا كان المؤشر الداخلي يشير إلى ما بعد نهاية قائمة العناصر، أو إذا كانت المصفوفة فارغة، فإن ...

الدالة sapi_windows_cp_set()‎ في PHP

(PHP 7 >= 7.1.0) تُعين الدالة sapi_windows_cp_set()‎ جدول الترميز للعملية الحالية. الوصف bool sapi_windows_cp_set ( int $cp ) تُعين الدالة sapi_windows_cp_set()‎ جدول الترميز للعملية الحالية. المعاملات cp معرف جدول الترميز. القيم المعادة تعيد الدالة sapi_windows_cp_set()‎ القيمة TRUE عند النجاح، أو القيمة FALSE عند الفشل. انظر أيضًا الدالة sapi_windows_cp_get()‎: الحصول على جدول الترميز للعملية الحالية. مصادر صفحة الدالة sapi_windows_cp_set في توثيق PHP الرسمي.

معاملات الدوال في PHP

يمكن تمرير المعلومات إلى الدوالّ بواسطة قائمة المعاملات argument list، وهي قائمة من التعابير المفصولة بالعلامة (,)، وتُعالج هذه المعاملات من اليسار إلى اليمين. تدعم اللغة تمرير المعاملات بالقيمة (by value، والطريقة الافتراضية) وبالمرجعية وتدعم كذلك تعيين القيمة الافتراضية للمعاملات، إضافة إلى دعم قوائم المعاملات متغيّرة الأطوال. المثال 1: تمرير المصفوفات إلى الدوال <?php function takes_array($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } ?> تمرير المعاملات بالمرجعية تمرّر معاملات الدوال بصورة افتراضية عن طريق القيمة (بمعنى أنّه لو تغيّرت ...

الدالة session_encode()‎ في PHP

(PHP 4, PHP 5, PHP 7) ترمِّز الدالة session_encode()‎ بيانات الجلسة الحالية على هيئة سلسلة نصية مرمَّزة للجلسة. الوصف string session_encode ( void ) تُعيد الدالة session_encode()‎ سلسلةً نصيةً متسلسلةً (serialized string) بالمُحتويات الحالية للجلسة، وتُخزِّنه في المُتغير العام ‎$_SESSION. تُستخدم طريقة داخلية في PHP افتراضيًا لفك التسلسل، وهي تختلف عن الدالة ()unserialize. طريقة التسلسل المُستخدمة تُحدد بواسطة session.serialize_handler. القيم المعادة تُعيد الدالة مُحتويات الجلسة الحالية مُشفرة. تحذير: يجب استخدام دالة ()session_start لبداية الجلسة أو استئناف جلسة مُسبقة قبل استعمال ...

الدالة arsort()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُرتَّب الدالة ()‎arsort عناصر المصفوفة بترتيب عكسي، وتحافظ على اقتران الفهارس مع القيم المرتبطة بها. الوصف bool arsort ( array &$array [, int $sort_flags = SORT_REGULAR ] ) تُرتّب الدالة ()‎arsort عناصر المصفوفة مع الحفاظ على اقتران فهارس عناصر هذه المصفوفة والقيم المرتبطة بها. وتُستخدم هذه الدالة بشكل أساسي عند ترتيب المصفوفات الترابطية والتي يكون ترتيب العناصر الفعلي فيها مهمًا. ملاحظة: إذا تساوت مقارنة عنصرين، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد. المعاملات ...

الدالة atanh()‎ في PHP

(PHP 4 >= 4.1.0, PHP 5, PHP 7) الدالة atanh()‎ تعيد معكوس الظل القطعي (Inverse hyperbolic tangent) للقيمة المُمرَّرة إليها، وتُمثَّل رياضيًّا بالشكل y = atanh(x)‎ أو تجدها أحيانًا بالشكل y = tanh-1(x)‎. الوصف float atanh ( float $arg ) تعيد هذه الدالة قيمة معكوس الظل القطعي للمعامل arg. بعبارة أخرى، تعيد هذه الدالة القيمة التي ظلُّها القطعي هو المعامل arg؛ أي لو فرضنا أنَّ القيمة المُعادة هي y فيكون tanh(y) = arg. المعاملات arg المعامل الذي ستُجرى عليه العمليَّة. القيم ...

الدالة sqrt()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة sqrt()‎ الجذر التربيعي للقيمة المُمرَّرة إليها‎‎. إن كانت القيمة المررَّة هي x وكانت أكبر أو تساوي الصفر، فستعيد الدالة القيمة y التي تحقِّق المعادلة y2 = x. الوصف float sqrt ( float $arg ) تعيد هذه الدالة الجذر التربيعي للمعامل arg. المعاملات arg القيمة العدديَّة التي ستُجرى عليها العمليَّة. القيم المعادة تُعاد قيمة الجذر التربيعي للمعامل arg. إن كانت قيمة هذا المعامل سالبة، فستُعاد القيمة NAN. أمثلة المثال 1: استعمال الدالة sqrt()‎ <?php //لديك ...

الدالة levenshtein()‎ في PHP

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تقيس الدالة levenshtein()‎ مسافة Levenshtein بين سلسلتين نصيتين. الوصف int levenshtein ( string $str1 , string $str2 ) int levenshtein ( string $str1 , string $str2 , int $cost_ins , int $cost_rep , int $cost_del ) تُقاس مسافة Levenshtein بعدد المحارف الواجب استبدالها أو إضافتها أو حذفها لتحويل السلسلة النصية str1 إلى السلسلة النصية str2. يُعَد تعقيد خوارزمية الدالة levenshtein()‎ من الدرجة (O(m*n، حيث تمثل m و n طول السلسلتين النصيتين str1 و str2 ...

الدالة strspn()‎ في PHP

(PHP 4, PHP 5, PHP 7) تبحث الدالة strspn()‎ عن الجزء الذي تبدأ به السلسلة النصيَّة الممرَّرة والذي تكون جميع محارفه محدَّدة ومعرَّفة مسبقًا ثمَّ تعيد بعدئذٍ طول ذلك الجزء. الوصف int strspn ( string $subject , string $mask [, int $start [, int$length ]] ) تبحث هذه الدالة عن القسم الذي تبدأ به السلسلة النصيَّة subject والذي تتكون جميع محارفه من المحارف mask المعطاة. إن لم يعطَ موقع بداية البحث start والطول الذي ستبحث الدالة فيه length، فستبحث الدالة في ...

المتغير التكراري في PHP

إن المتغير التكراري Iterable هو شبه نوع (نوع زائف، pseudo-type) عُرِّفَ في الإصدار 7.1 من PHP وهو يقبل أية مصفوفة أو كائن يستخدم واجهة Traversable (أي Traversable interface)، كلا النوعين يمكن تكراره باستخدام حلقة foreach ويمكن أن يُستخدم مع تعبير yield داخل دالة مولِّدة (generator). استخدام Iterables يمكن استخدام Iterable كنوع لمعاملات الدالة (function parameter type) للإشارة إلى الدالة تتطلب مجموعةً من القيم، لكن دون أن تهتم لصيغة القيمة لأنها ستُستخدَم مع حلقة foreach، إذا لم تكن القيم مصفوفة أو ...

الدالة compact()‎ في PHP

(PHP 4, PHP 5, PHP 7) تنشئ الدالة compact()‎ مصفوفة تحتوي على متغيرات وقيمها. الوصف array compact ( mixed $varname1 [, mixed $... ] ) تنشئ هذه الدالة مصفوفةً تحتوي على متغيرات وقيمها. لكل من هذه المعاملات، تبحث الدالة compact()‎ عن متغير بهذا الاسم في جدول الرموز (symbol table) الحالي وتضيفه إلى المصفوفة المُخرَجة بحيث يصبح اسم المتغير هو المفتاح وتصبح محتويات المتغير قيمة ذلك المفتاح. باختصار، تعمل هذه الدالة بعكس الدالة extract()‎. وتتخطى الدالة أية سلاسل نصية (string) لم تُضبَط ...

أولوية العوامل في PHP

المقصود بأولوية العوامل هو تحديد مدى "قوة" ربط العامل لتعبيرين مع بعضهما البعض. فعلى سبيل المثال في التعبير: 1‎ + 5 * 3 يكون الجواب 16 وليس 18 لأن لعامل الضرب (*) الأولوية على عامل الجمع (+). يمكن استخدام الأقواس لتحديد الأولوية حسب الحاجة. فمثلًا: ناتج التعبير ‎(1 + 5) * 3 هو 18. عندما تتساوى العوامل في أولويتها فإن الخاصية التجميعية (associativity) هي التي تحدد كيفية تجميع العوامل. فمثلًا خاصية التجميع للعامل "-" يسارية، لذا فإن التعبير ‎1 - ...

التعامل مع الدوال في PHP

تستعمل هذه الدوال للتعامل مع مختلف العمليات التي يمكن إجراؤها على الدوال في لغة PHP. call_user_func_array()‎ تستدعي الدالة call_user_func_array()‎ دالة رد نداء (callback function) مع تمرير مصفوفة من المعاملات إليها. call_user_func()‎ تستدعي الدالة call_user_func()‎ دالةَ رد النداء callback المُمرَّرة في المعامل الأول. forward_static_call_array()‎ تستدعي الدالة forward_static_call_array()‎ دالةً ساكنةً (static) تابعةً لصنف (method) وتمرّر مصفوفة من المعاملات. forward_static_call()‎ تستدعي الدّالة forward_static_call()‎ دالةً ساكنةً (static) تابعةً لصنف (method). func_get_arg()‎ تُعيد الدالّة func_get_arg()‎ وسيطًا من قائمة الوسطاء. func_num_args()‎ تُعيد الدالّة func_num_args()‎ عدد الوسائط ...

الدالة call_user_func()‎ في PHP

(PHP 4, PHP 5, PHP 7) تستدعي الدالة call_user_func()‎ دالةَ رد النداء callback المُمرَّرة في المعامل الأول. الوصف mixed call_user_func ( callable $callback [, mixed $parameter[, mixed $... ]] ) تستدعي الدالة call_user_func()‎ دالةَ رد النداء المُمرَّرة كأوّل معامل مع تمرير المعاملات البقية لهذه الدالة كوسائط لدالة رد النداء. المعاملات callback دالة رد النداء (callback function) التي نريد استدعاءها. parameter صفر أو أكثر من المعاملات التي نريد تمريرها كوسائط إلى دالة رد النداء. لاحظ أن المعاملات المعطية في call_user_func()‎ لا تمرّر ...

الدالة get_declared_interfaces()‎‎‎ في PHP

(PHP 5, PHP 7) تُعيد الدالة get_declared_interfaces()‎‎ مصفوفة  بكل الواجهات (interfaces) المُصرّح عنها. الوصف array get_declared_interfaces ( void ) تحصل الدالة get_declared_interfaces()‎‎ على الواجهات المُصرّح عنها. المعاملات لا تملك الدالة get_declared_interfaces()‎ أيّة معاملات. القيم المعادة تُعيد الدالة get_declared_interfaces()‎‎ مصفوفة بأسماء الواجهات المُصرّح عنها في السكربت الحالي. أمثلة المثال 1: مثال عن استخدام الدالّة get_declared_interfaces()‎ <?php print_r(get_declared_interfaces()); ?> سينتج المثال السابق الناتج الآتي: Array ( [0] => Traversable [1] => IteratorAggregate [2] => Iterator ...

الدالة closedir()‎ في PHP

(PHP 4, PHP 5, PHP 7) تغلق الدالة closedir()‎ مجلَّدًا مفتوحًا. الوصف void closedir ([ resource $dir_handle ] ) تغلق هذه الدالة المجلَّد المفتوح الذي يشير إليه المورد dir_handle. يجب أن يكون المجلَّد قد فُتح مسبقًا باستعمال الدالة opendir()‎. المعاملات dir_handle مورد مقبض المجلَّد المراد إغلاقه، ويشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل أي لم يحدَّد المجلَّد المراد إغلاقه، فسيُغلق آخر مجلَّد فُتح باستعمال الدالة opendir()‎. أمثلة المثال 1: استعمال الدالة closedir()‎ <?php $dir = ...

الدالة file()‎ في PHP

(PHP 4, PHP 5, PHP 7) تقرأ الدالة file()‎ الملف ثمَّ تضع كلَّ محتوياته في مصفوفة. الوصف array file ( string $filename [, int $flags = 0 [, resource $context]] ) تعيد هذه الدالة مصفوفة تضم كلَّ محتويات الملف filename. ملاحظة: يمكنك استعمال الدالة file_get_contents()‎ لجلب كلِّ محتويات الملف ووضعها في سلسلة نصيَّة عوضًا عن مصفوفة. المعاملات filename اسم الملف المراد جلب محتوياته. فائدة: يمكن استعمال عنوان URL عوضًا عن اسم الملف مع المعامل filename شرط أن يُفعَّل الضبط "fopen wrapper". ...

الدالة fgetss()‎ في PHP

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetss()‎ سطرًا واحدًا من ملف معيَّن وتزيل وسوم HTML من النصِّ الذي تقرؤه. الوصف string fgetss ( resource $handle [, int $length [, string$allowable_tags ]] ) تشبه هذه الدالة تمامًا الدالة fgets()‎ باستثناء أنَّها تحاول إزالة بايتات العدم (NULL)، ووسوم HTML، ووسوم PHP التي تعثر عليها أثناء قراءتها للنص. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم ...

الدالة is_nan()‎ في PHP

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تتحقَّق الدالة is_nan()‎ إن كان المعامل الممرَّر إليها ليس عددًا. الوصف bool is_nan ( float $val ) تتحقَّق هذه الدالة إن كانت القيمة val ليست عددًا (not a number) مثل القيمة الناتجة من الدالة acos(1.01)‎. المعاملات val القيمة العدديَّة المراد التحقق منها. القيم المعادة تُعاد القيمة TRUE إن كان المعامل val ليس عددًا، والقيمة FALSE إن كان غير ذلك. أمثلة المثال 1: استعمال الدالة is_nan()‎ <?php // NaN سيعيد الحساب الخطأ في العمليات الرياضية ...

الدالة boolval()‎ في PHP

(PHP 5 >= 5.5.0, PHP 7) تُعطي الدالة boolval()‎ القيمة المنطقيّة لمتغيّر ما. الوصف bool boolval ( mixed $var ) تُعيد القيمة المنطقيّة للمتغيّر var. المعاملات var وهو القيمة العدديّة التي ستُحوَّل إلى قيمة منطقيّة. القيم المعادة القيمة المنطقيّة للمتغيّر var. أمثلة المثال 1: أمثلة على الدالة boolval()‎ <?php echo '0: '.(boolval(0) ? 'true' : 'false')."\n"; echo '42: '.(boolval(42) ? 'true' : 'false')."\n"; echo '0.0: '.(boolval(0.0) ...

الدالة serialize()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُولِّد الدالة serialize()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ تمثيلًا قابلًا للتخزين لقيمة ما. الوصف string serialize ( mixed $value ) تُولِّد‎‎‎‎‎‎‎‎‎‎ تمثيلًا قابلًا للتخزين لقيمة ما. يُفيد هذا في تخزين وتمرير قيم PHP بدون خسارة نوعها وبنيتها. نستخدم الدالة unserialize()‎ لإرجاع السلسلة النصّيّة المتسلسلة إلى قيمة PHP مرّة أخرى. المعاملات value القيمة المطلوب جعلها متسلسلة، تتعامل الدالة serialize()‎ مع كافة الأنواع عدا الموارد، بإمكاننا حتى أن نستخدم serialize()‎ على مصفوفات تحتوي على مراجع تُشير إلى هذه المصفوفة. تُخزَّن المراجع الموجودة ...

الدالة is_string()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُحدِّد الدالة is_string()‎‎‎‎‎‎‎‎‎‎‎‎‎ ما إذا كان المتغيّر سلسلةً نصيّةً. الوصف bool is_string ( mixed $var ) تُحدِّد ما إذا كان المتغيّر المُعطى سلسلةً نصيّةً. المعاملات var القيمة المطلوب التّحقّق منها. القيم المعادة تُعيد القيمة TRUE إن كان المتغيّر سلسلةً نصيّةً، و FALSE فيما عدا ذلك. أمثلة المثال 1: أمثلة على الدالة is_string()‎ <?php $values = array(false, true, null, 'abc', '23', 23, '23.5', 23.5, '', ' ', '0', 0); foreach ($values as $value) { echo ...

الدالة filegroup()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة filegroup()‎ رقم معرِّف المجموعة المالكة (group ID) لملف محدَّد. الوصف int filegroup ( string $filename ) تعيد هذه الدالة رقم معرِّف المجموعة المالكة (GID) للملف filename في الصيغة العدديَّة. استعمل الدالة posix_getgrgif()‎ للحصول على اسم المجموعة بناءً على رقم المعرِّف GID الذي تعيده هذه الدالة. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد رقم معرِّف المجموعة المالكة (GID) للملف filename أو القيمة FALSE عند حصول أي خطأ. استعمل الدالة posix_getgrgif()‎ ...

الدالة is_dir()‎ في PHP

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_dir()‎ إن كان مسار الملف أو المجلَّد المُمرَّر إليها مجلَّدًا أم لا. الوصف bool is_dir ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename هو مجلَّد. المعاملات filename مسار الملف المراد التحقُّق منه. إن كان المعامل filename مسارًا نسبيًّا، فسيُتحقَّق منه نسبةً إلى مجلَّد العمل الحالي. إن كان المعامل filename وصلةً رمزيَّة أو صلبة، فسيُستبين المسار الذي تُشير إليه تلك الوصلة حينئذٍ ويُتحقَّق منه. إن كان الوضع الآمن أو  الخيار ...

الدالة ‎__halt_compiler()‎ في PHP

(PHP 5 >= 5.1.0, PHP 7) توقف الدالة ()halt_compiler‎__  تنفيذ مترجم اللغة. الوصف void __halt_compiler ( void ) توقف الدالة ()halt_compiler‎__ تنفيذ مترجم اللغة. قد يكون هذا مفيدًا لتضمين البيانات في برامج PHP، مثل ملفات التثبيت. يمكن تحديد موضع البايت لبداية البيانات بواسطة الثابت __COMPILER_HALT_OFFSET__ الذي يُعَرَّف فقط إذا كانت الدالة ()halt_compiler‎__  مستعملةً في الملف. القيم المعادة لا تعيد الدالة ()halt_compiler‎__ قيمًا. أمثلة المثال 1: مثال على الدالة ()halt_compiler‎__ <?php // فتح الملف $fp = fopen(__FILE__, 'r'); // نقل مؤشر القراءة إلى مكان بدء ...

الدالة is_writeable()‎ في PHP

(PHP 4, PHP 5, PHP 7) الدالة is_writeable()‎ هي اسم بديل للدالة is_writable()‎. الوصف هذه الدالة هي اسم بديل للدالة is_writable()‎. مصادر صفحة الدالة is_writeable في توثيق PHP الرسمي.

الدالة unregister_tick_function()‎ في PHP

(PHP 4 >= 4.0.3, PHP 5, PHP 7) ُتلغي الدالة unregister_tick_function()‎‎ تسجيل دالة تُنفّذ عند كل tick المقصود بـ tick هو حدث يقع لكل عدد (N) من العبارات التي يمكن تطبيق هذا الموجه عليها. الوصف void unregister_tick_function ( string $function_name ) ُتلغي الدالة unregister_tick_function()‎‎ تسجيل اسم الدالة الممرّر إليها في المعامل function_name وبذلك لا تُنفّذ عند استدعاء tick. المعاملات function_name سلسلة نصية تُمثِّل اسم الدالة. القيم المعادة لا توجد قيم مُعادة. انظر أيضًا الدالة register_tick_function()‎: تسجيل دالة لتنفيذها عند كل tick. مصادر ...

الدالة parse_str()‎ في PHP

(PHP 4, PHP 5, PHP 7) تُحَوِّلُ الدالة parse_str()‎ السلسلة النصية إلى متغيرات. الوصف void parse_str ( string $encoded_string [, array &$result ] ) تُحَوِّلُ الدالة parse_str()‎ المعامل ‎$encoded_string كما لو أنه سلسلة الاستعلام النصية (query string) التي مُرِّرَتْ عبر عنوان URL وتَضَعُ المتغيرات في المجال الحالي (current scope) (أو في مصفوفة إذا وُجِدَ المعامل result). المعاملات encoded_string السلسلة النصية المدخلة. result إذا كان المعامل الثاني result موجودًا، فستُخَزَّن المتغيرات فيه كمصفوفة عناصر بدلاً من ذلك. تحذير: يُعدّ استخدام الدالة parse_str()‎ ...

الدالة strpbrk()‎ في PHP

(PHP 4, PHP 5, PHP 7) تبحث الدالة strpbrk()‎ على مجموعة معيَّنة من المحارف ضمن سلسلة نصيَّة. الوصف string strpbrk ( string $haystack , string $char_list ) تبحث هذه الدالة على مجموعة المحارف char_list ضمن السلسلة النصيَّة haystack. المعاملات haystack السلسلة النصيَّة التي ستبحث الدالة فيها على المحارف char_list. char_list مجموعة المحارف التي ستبحث الدالة عنها، وهي حسَّاسة لحالة الأحرف. القيم المعادة تُعاد سلسلة نصيَّة بدايتها هي المحارف التي تبحث الدالة عنها. إن لم يُعثَر على تلك المحارف فستعُاد القيمة FALSE. ...

الدالة readdir()‎ في PHP

(PHP 4, PHP 5, PHP 7) تقرأ الدالة readdir()‎ عنصرًا واحدًا من محتويات المجلَّد وتعيده. الوصف string readdir ([ resource $dir_handle ] ) تعيد هذه الدالة اسم العنصر التالي الموجود في المجلَّد. تُعاد العناصر بالترتيب الذي خُزَّنت فيه بوساطة نظام الملفات. المعاملات dir_handle مورد مقبض المجلَّد المراد القراءة منه والذي يشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل أي لم يحدَّد المجلَّد، فسيُقرأ من آخر مجلَّد فُتح باستعمال الدالة opendir()‎. القيم المعادة يُعاد اسم عنصر ...

العوامل المنطقية في PHP

المثال الاسم النتيجة ‎$a and $b And TRUE إن كانت قيمة كلا المتغيرين ‎$a و ‎$b هي TRUE. ‎$a or $b Or TRUE إن كانت قيمة أحد المتغيرين ‎$a و ‎ $bهي TRUE. ‎$a xor $b Xor TRUE إن كانت قيمة أحد المتغيرين ‎$a و ‎$b هي TRUE ولكن ليس كلاهما. ‎! $a Not TRUE إن كانت قيمة المتغير ‎$a ليست TRUE. ‎$a && $b And TRUE إن كانت قيمة كلا المتغيرين ‎$a و ‎$b هي TRUE. ‎$a || $b ...

الدالة round()‎ في PHP

(PHP 4, PHP 5, PHP 7) تقرِّب الدالة round()‎ العدد العشري الممرَّر إليها. الوصف float round ( float $val [, int $precision = 0 [, int $mode = PHP_ROUND_HALF_UP ]] ) تعيد هذه الدالة القيمة المقرَّبة للمعامل value بحسب الدقَّة المحدَّدة في المعامل precision (عدد الأرقام بعد الفاصلة). يمكن أن تكون قيمة المعامل precision صفرًا وهي القيمة الافتراضيَّة أو قيمة سالبة. ملاحظة: لا يمكن أن تتعامل PHP مع سلاسل نصيَّة مثل "12,300.2" وتقريبها بطريقة صحيحة. راجع قسم التحويل من السلاسل النصيَّة. ...

الدالة chroot()‎ في PHP

(PHP 4 >= 4.0.5, PHP 5, PHP 7) تغيِّر الدالة chroot()‎ مجلَّد الجذر (root directory) الحالي. الوصف bool chroot ( string $directory ) تغيِّر هذه الدالة مجلَّد الجذر للعمليَّة الحالية إلى المجلَّد directory المعطى، وتغيِّر مجلَّد العمل الحالي إلى /. هذه الدالة متاحةٌ فقط على أنظمة غنو (GNU)، وأنظمة BSD، وعند استعمال CLI أو CGI أو SAPI المضمَّنة. تتطلَّب هذه الدالة أيضًا صلاحيات مدير النظام (المستخدم الجذر، root) لتنفيذ العمليَّة. المعاملات directory مسار المجلَّد المراد تغيير المجلَّد الجذر إليه. القيم المعادة ...

الدالة restore_error_handler()‎ في PHP

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تستعيد الدالة restore_error_handler()‎ معالجة الأخطاء السابقة. الوصف bool restore_error_handler ( void ) تستعيد الدالة restore_error_handler()‎ معالجة الأخطاء السابقة وذلك للعودة إلى معالج الخطأ السابق (الذي يمكن أن يكون مدمجا أو وظيفة معرفة من طرف المستخدم). القيم المعادة تعيد الدالة restore_error_handler()‎ دائما القيمة TRUE. أمثلة المثال 1: استعمال الدالة restore_error_handler()‎ <?php function unserialize_handler($errno, $errstr) {     echo "Invalid serialized value.\n"; } $serialized = 'foo'; set_error_handler('unserialize_handler'); $original = unserialize($serialized); restore_error_handler(); ?> سوف تكون مُخرجات المثال أعلاه قيمة متسلسلة غير صالحة كالتالي Invalid serialized value انظر أيضا الدالة ()error_reporting: تحدد أي أخطاء PHP يبلغ عنها الدالة ()set_error_handler: تحدد وظيفة معالج ...

الدالة session_destroy()‎ في PHP

(PHP 4, PHP 5, PHP 7) تدمر الدالة session_destroy()‎ جميع البيانات المُسجلة في الجلسة. الوصف bool session_destroy ( void ) تُدمر الدالة جميع البيانات المُصاحبة للجلسة الحالية. ولا تقوم بمسح أيًا مِن المُتغيرات العامة (global variables) أو ملفات تعريف الارتباط للدالة. ولاستخدام المُتغيرات مُجددًا، يجب استخدام الدالة ()session_start. ملاحظة:  لست مضطرًا لاستدعاء الدالة session_destroy()‎ في الكود العادي. نظف المصفوفة ‎$_SESSION بدلًا مِن تدمير بيانات الجلسة. لتدمير الجلسة كلها يجب مسح معرّف الجلسة وإذا كان محفوظًا في ملف تعريف الارتباط، يجب مسحه كذلك، ويُمكن استعمال ...

المتغير التكراري في PHP

إن المتغير التكراري Iterable هو شبه نوع (نوع زائف، pseudo-type) عُرِّفَ في الإصدار 7.1 من PHP وهو يقبل أية مصفوفة أو كائن يستخدم واجهة Traversable (أي Traversable interface)، كلا النوعين يمكن تكراره باستخدام حلقة foreach ويمكن أن يُستخدم مع تعبير yield داخل دالة مولِّدة (generator). استخدام Iterables يمكن استخدام Iterable كنوع لمعاملات الدالة (function parameter type) للإشارة إلى الدالة تتطلب مجموعةً من القيم، لكن دون أن تهتم لصيغة القيمة لأنها ستُستخدَم مع حلقة foreach، إذا لم تكن القيم مصفوفة أو ...

الدالة fgets()‎ في PHP

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgets()‎ سطرًا واحدًا من ملف معيَّن. الوصف string fgets ( resource $handle [, int $length ] ) تجلب هذه الدالة سطرًا واحدًا من الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم يُغلق بعد باستعمال الدالة fclose()‎. length إن حُدِّدت قيمة هذا المعامل، فستتوقف عمليَّة القراءة عند البايت length - 1 أو ...

الدالة addslashes()‎ في PHP

(PHP 4, PHP 5, PHP 7) تضيف الدالة addslashes()‎ الخطوط المائلة العكسية (backslashes). الوصف string addslashes (string $str). تُعيد الدالة سلسلةً نصيةً تسبقها خطوط مائلة عكسية (backslashes) قبل المحارف المُراد تهريبها. تتمثل هذه المحارف فيما يلي:   علامات الاقتباس المفردة (') علامات الاقتباس المزدوجة (") الخطوط المائلة العكسية (\) NUL (البايت NUL) تستخدم الدالة addslashes()‎ لتهريب أحد المحارف المذكورة آنفًا داخل كود برمجي بلغة PHP: <?php $str = "O'Reilly?"; eval("echo '" . addslashes($str) . "';"); ?> قبل نسخة 5.4.0  للغة PHP، كانت ميزة magic_quotes_gpc مُفَعلة ...

الدالة is_uploaded_file()‎ في PHP

(PHP 4 >= 4.0.3, PHP 5, PHP 7) تتحقَّق الدالة is_uploaded_file()‎ إن كان الملف مرفوعًا باستعمال HTTP POST. الوصف bool is_uploaded_file ( string $filename ) تعيد هذه الدالة القيمة TRUE إن رُفع الملف الذي يُدعى filename بوساطة HTTP POST، وهذا الأمر مفيد لأنَّه يساعد على التأكُّد من عدم احتيال المستخدمين الخبيثين على السكربت لإجباره على العمل على ملفات لا يُفترض العمل عليها مثل الملف ‎/etc/passwd. هذا النوع من التحقُّق مهمٌّ جدًا إذ يساعد على التأكُّد من عدم وجود أي فرصة تسنح ...

البنية echo في PHP

(PHP 4, PHP 5, PHP 7) تعرض ‎echo سلسلةً نصيةً وحيدة أو عدة سلاسل نصية. الوصف void echo ( string $arg1 [, string $... ] ) تُخرِج echo كل المعاملات، ولا تضيف إليها سطرًا جديدًا بعدها. لا تعدّ echo دالةً بالمعنى الصريح للكلمة إذ تُعد بنيةً من بنى اللُّغة (‎language construct) لذلك فلستَ مجبرًا على إضافة الأقواس لها. على العكس من بنى اللُّغة الأخرى، فإن echo لا تتصرف مثل الدوال لذلك لا يمكن استخدامها في سياق الدوال دائمًا. إذا أردنا استعمال ...

الدالة hypot()‎ في PHP

(PHP 4 >= 4.1.0, PHP 5, PHP 7) تحسب الدالة hypot()‎ طول وتر المثلث قائم الزاوية وتعيده؛ أي أنَّها تعيد قيمة الجذر التربيعي لمجموع مربعي الضلعين القائمتين المعلومتين. الوصف float hypot ( float $x , float $y ) تعيد هذه الدالة طول وتر المثلث قائم الزاوية بعد تمرير طولي ضلعيه القائمتين إليها وهما x و y. القيمة التي تعيدها هذه الدالة مساوية تمامًا لقيمة الدالة sqrt(x * x + y * y)‎ أي الجذر التربيعي لمجموع مربعي المُعاملين x و y. ...

الدالة php_check_syntax()‎ في PHP

(PHP 5 < 5.0.5) تتحقق الدالة php_check_syntax()‎ من بنية PHP (وتنفذ) الملفَّ المحدد. الوصف bool php_check_syntax ( string $filename [, string &$error_message ] ) تُجري الدالةُ php_check_syntax()‎ اختبارَ أدوات lint للتحليل على المعامل filename المحدد للبحث عن أخطاء برمجية. يشبه هذا استخدام php -l من سطر الأوامر فيما عدا أن هذه الدالة ستنفذ (لكن لن تؤدي إلى إظهار مخرجات تنفيذ) المعامل filename المحدد. مثلًا، إذا عُرَّفَتْ دالةٌ في الملف filename، فإن هذه الدالة المحددة ستكون متاحة للملف الذي نَفَّذّ الدالة php_check_syntax()‎، ...

الدالة current()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة current()‎ العنصر الحالي في مصفوفة. الوصف mixed current ( array $array ) تحتوي كل مصفوفة على مؤشر داخلي يشير إلى العنصر "الحالي"، والذي يشير بدايةً إلى العنصر الأول المدرج في المصفوفة. المعاملات array المصفوفة المُدخلة. القيم المعادة تُعيد الدالة current()‎ ببساطة قيمة عنصر المصفوفة الذي يشير إليه حاليًا المؤشرُ الداخلي. ولا تحرك الدالةُ المؤشرَ بأي طريقة. إذا كان المؤشر الداخلي يشير إلى ما بعد نهاية قائمة العناصر، أو إذا كانت المصفوفة فارغة، فإن ...

الدالة substr_replace()‎ في PHP

(PHP 4, PHP 5, PHP 7) تبدِّل الدالة substr_replace()‎ جزءًا معطى مكان جزءٍ موجودٍ ومحدَّدٍ ضمن سلسلة نصيَّة. الوصف mixed substr_replace ( mixed $string , mixed $replacement , mixed$start [, mixed $length ] ) تعيد هذه الدالة السلسلة النصيَّة string بعد أن تبدِّل السلسلة النصيَّة replacement المعطاة مكان الجزء المحدَّد بموقع البداية start وطول المحارف المراد استبدالها length (وهو معامل اختياري). المعاملات string السلسلة النصيَّة التي سيُبحث فيها. يمكن أن يكون هذا العامل مصفوفة وستُطبَّق آنذاك عمليَّة الاستبدال على كلِّ عنصر ...

عرض (500 السابقة | 500 التالية) (20 | 50 | 100 | 250 | 500).