نتائج البحث

(PHP 4, PHP 5, PHP 7) تُضمِّن العبارة include_once الملفّ المحدد وتعالجه أثناء تنفيذ الشيفرة. هذه السلوك مشابه لعبارة include والفرق الوحيد هنا هو إن كانت شيفرة ذلك الملف مضمّنة من قبل فإنّها لن تُضمِّنَه مرة أخرى، وترجع include_once القيمة TRUE، وهذا السلوك متوقع من اسم العبارة. يمكن استخدام include_once في الحالات التي يمكن لنفس الملف أن يُضمَّن ويُعالَج لأكثر من مرة خلال مرحلة معيّنة من مراحل تنفيذ الشيفرة، وفي هذه الحالة يمكن تجنب بعض المشاكل مثل إعادة تعريف الدوال ...

(PHP 4, PHP 5, PHP 7) تنهي break تنفيذ حلقات for أو foreach أو while أو do-while أو بنية switch. تأخذ break معاملًا عدديًا اختياريًا يُحدّد من خلاله عدد البنى المتداخلة التي‏ يجب إيقاف تنفيذها. القيمة الافتراضية لهذا المعامل هي 1، والذي يعني إيقاف تنفيذ البنية الحالية فقط. <?php $arr = array('one', 'two', 'three', 'four', 'stop', 'five'); while (list(, $val) = each($arr)) { if ($val == 'stop') { break; /* يمكن أيضًا كتابة /* ...

يكون التعبير عن المتغيرات في PHP باستخدام علامة $ متبوعة باسم المتغير والذي يكون حساسًا لحالة الأحرف. تتبع المتغيرات نفس القواعد المتبّعة للتسمية في PHP. إذ يبدأ اسم المتغير الصحيح بحرف أو بشرطة سفلية متبوعة بعدد غير محدد من الحروف أو الأرقام أو الشرطات السفلية. ولو أردنا استخدام التعابير النمطية (Regular Expression) للتعبير عن اسم المتغير فسيكون كالتالي: '‎‎[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*‎‎'. ملاحظة: في هذا الدليل الحرف هو كل ما يقع ضمن النطاق a-z و A-Z والبايتات من 127 إلى 255 (0x7f-0xff). ملاحظة: ...

(PHP 4, PHP 5, PHP 7) تشبه عبارة switch سلسلةً من عبارات if مطبّقة على نفس التعبير. قد تحتاج في بعض الأحيان إلى مقارنة نفس المتغير (أو التعبير) مع قيم مختلفة (حالات cases)، وتنفيذ شيفرة مختلفة بالاعتماد على ذلك، وهذه هي وظيفة عبارة switch. ملاحظة: بخلاف بعض اللغات البرمجية، يمكن استخدام عبارة continue في switch وهي تعمل عمل العبارة break. إن كنت تستخدم switch داخل حلقة وأردت الانتقال إلى الدورة التالية في الحلقة التكرارية الخارجية، استخدم continue 2. ملاحظة: تؤدي ...

الدوال المعرّفة من طرف المستخدم تتبع أسماء الدوالّ نفس القواعد المتبّعة في اللغة للتسمية. يبدأ الاسم الصحيح للدالة بحرف أو شرطة سفلية، متبوعًا بأيّ عددٍ من الحروف أو الأرقام أو الشرطات السفلية. ويمكن التعبير عن هذه الصيغة باستخدام التعابير النمطية بالصورة التالية: ‎[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*‎. معاملات الدوال يمكن تمرير المعلومات إلى الدوالّ بواسطة قائمة المعاملات argument list، وهي قائمة من التعابير المفصولة بالعلامة (,)، وتُعالج هذه المعاملات من اليسار إلى اليمين. إعادة القيم يمكن إعادة القيم باستخدام عبارة return الاختيارية، ويمكن إعادة أيّ نوع من ...

الثابت هو معرّف (اسم) لقيمة بسيطة، وكما هو واضح من الاسم فإنّ هذه القيمة غير قابلة للتبديل أثناء تنفيذ الشيفرة (باستثناء الثوابت السحرية والتي لا تعدّ ثوابت في الواقع). الثابت حساس لحالة الأحرف ومن الشائع استخدام الأحرف الكبيرة في تسمية الثوابت. تتبع الثوابت نفس القواعد المتّبعة للتسمية في PHP، فاسم الثابت الصحيح يبدأ بحرف أو بشرطة سفلية، متبوعًا بعدد غير محدّد من الأحرف والأرقام والشرطات السفلية. ولو أردنا استخدام التعابير النمطية (Regular Expressions) للتعبير عن اسم المتغير فسيكون كالتالي: [a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]* ...

(PHP 4, PHP 5, PHP 7) تعد حلقات while التكرارية أبسط أنواع الحلقات في PHP، وتعمل بطريقة مماثلة لنظيرتها في لغة C، والصيغة الأساسية لعبارة while هي: while (expr) statement تؤدي عبارة while وظيفةً بسيطةً، وهي تنفيذ العبارة أو العبارات التي تحتضنها بصورة متكررة ما دامت العبارة الشرطية المرتبطة بحلقة while تؤول إلى TRUE. تتحقّق اللغة من قيمة التعبير في بداية كل دورة، لهذا لن يؤدي تغيير القيمة أثناء عملية التنفيذ إلى إيقاف الدورة بل ستكمل الشيفرة ...

يتضمّن الإصدار الخامس من PHP نموذج استثناءات مشابهًا للغات البرمجية الأخرى. يمكن رمي الاستثناء والتقاطه في PHP، ويمكن إحاطة الشيفرة بكتلة try لتسهيل عملية التقاط الاستثناءات المحتملة، ويجب أن ترتبط بكل كتلة try إما كتلة catch أو finally واحدة على الأقل. يجب أن يكون كائن الاستثناء المرمي نسخة من الصنف Exception أو صنفًا متفرعًا منه، ويؤدي رمي كائن لا ينتمي إلى هذا الصنف إلى حدوث خطأ من نوع Fatal. الكتلة catch يمكن استخدام كتل catch متعدّدة لالتقاط أصناف مختلفة من ...

(PHP 4, PHP 5, PHP 7) تعمل عبارة include على تضمين ومعالجة الملف المحدّد. ينطبق التوثيق التالي على عبارة require. تُضمّن الملفات بالاعتماد على المسار المعطى للعبارة، وفي حال عدم تحديد المسار، تأخذ include المسار المحدد في include_path. إن لم يكن الملف موجودًا في include_path ستتحقّق include في المجلّد الذي يحتوي على الشيفرة التي أجرت الاستدعاء وفي مجلد العمل الحالي قبل أن تطلق خطأً. تطلق بنية include تحذيرًا إن لم تتمكن من العثور على الملف، وتختلف في ذلك عن require ...

هذه مجموعة من الدوال المتفرقة في لغة PHP، والتي لا تنتمي إلى التصنيفات الأخرى الموجودة في هذا التوثيق. connection_aborted()‎ تفحص الدالةconnection_aborted()‎ ‎ ما إذا كان العميل غير متصل. connection_status()‎ تحصل الدالةُ connection_status()‎ على bitfield لحالة الاتصال. constant()‎ تعيدُ الدالة constant()‎ قيمة ثابتٍ ما. ob_end_clean()‎ تنظف (تمسح) الدالة ob_end_clean()‎ المخزنَ المؤقت للإخراج وتوقف التخزين المؤقت للإخراج. ob_clean()‎ تنظف (تمسح) الدالة ob_clean()‎ المخزنَ المؤقت للإخراج. die()‎ تكافئ البنيةُ die البنيةَ exit()‎. eval()‎ تُقدِّر البنيةُ eval()‎ قيمة شيفرة PHP المُمثَّلة في سلسلةٍ نصيةٍ. exit()‎ تُخرج البنية exit()‎ رسالةً وتنهي البرنامج الحالي. get_browser()‎ تعيد الدالة get_browser()‎ الميزات التي يدعمها متصفح المستخدم. ...

(PHP 4, PHP 5, PHP 7) تعد حلقات while التكرارية أبسط أنواع الحلقات في PHP، وتعمل بطريقة مماثلة لنظيرتها في لغة C، والصيغة الأساسية لعبارة while هي: while (expr) statement تؤدي عبارة while وظيفةً بسيطةً، وهي تنفيذ العبارة أو العبارات التي تحتضنها بصورة متكررة ما دامت العبارة الشرطية المرتبطة بحلقة while تؤول إلى TRUE. تتحقّق اللغة من قيمة التعبير في بداية كل دورة، لهذا لن يؤدي تغيير القيمة أثناء عملية التنفيذ إلى إيقاف الدورة بل ستكمل الشيفرة ...

تعدّ التعابير إحدى الوحدات البنائية الأكثر أهمية في PHP، ففي هذه اللغة كل ما تكتبه تقريبًا هو عبارة عن تعبير، لذا فإن أبسط وأدقّ تعريف للتعابير هو: "كلّ ما يمتلك قيمة". تعدّ الثوابت والمتغيرات أبسط أشكال التعابير، فعند كتابة ‎$a=5 فإننا نسند '5' إلى ‎$a. ومن الواضح أن '5' تمتلك القيمة 5، أو بعبارة أخرى فإن '5' هي تعبير قيمته 5. (في هذه الحالة '5' هو عدد صحيح ثابت). بعد إجراء عملية الإسناد هذه فإن المتوقع هو أن تكون قيمة ...

(PHP 4, PHP 5, PHP 7) عبارة require_once مطابقة للعبارة require باستثناء أن PHP ستتحقق مما إذا كان الملف مضمّنًا أم لا، وذلك لتجنّب تضمينه (require) مرة أخرى. راجع توثيق include_once للمزيد من المعلومات حول طريقة عمل ‎_once، والفرق بينها وبين الدوال التي لا تلحق بها هذه اللاحقة. مصادر صفحة require_once في توثيق PHP الرسمي.

تعدّ التعابير إحدى الوحدات البنائية الأكثر أهمية في PHP، ففي هذه اللغة كل ما تكتبه تقريبًا هو عبارة عن تعبير، لذا فإن أبسط وأدقّ تعريف للتعابير هو: "كلّ ما يمتلك قيمة". تعدّ الثوابت والمتغيرات أبسط أشكال التعابير، فعند كتابة ‎$a=5 فإننا نسند '5' إلى ‎$a. ومن الواضح أن '5' تمتلك القيمة 5، أو بعبارة أخرى فإن '5' هي تعبير قيمته 5. (في هذه الحالة '5' هو عدد صحيح ثابت). بعد إجراء عملية الإسناد هذه فإن المتوقع هو أن تكون قيمة ...

الضبط كيفية ضبط لغة PHP عبر مختلف أنواع ملفات الضبط، وطرائق تعديلها. بنية اللغة تبيان أنواع وسوم لغة PHP، وطريقة دمجها مع HTML، وشرح بعض خصائصها البنيوية (ومن بينها التعليقات). أنواع البيانات لا يعيّن المبرمج نوع المتغير عادةً، بل تُعيِّنُه لغة PHP أثناء التنفيذ بالاعتماد على محتوى المتغير المستخدم. القيم المنطقية (boolean) القيم المنطقية (boolean) من أبسط الأنواع، فالتعبير المنطقي يُعبِّر عن صحّة تعبيرٍ ما، فإما أن تكون قيمة التعبير صحيحةً TRUE أو خطأً FALSE. الأعداد الصحيحة (integer) العدد الصحيح هو عدد من ...

المورد هو متغير خاص يحمل مرجعيةً إلى مورد خارجي، تُنشَأ الموارد وتُستخدَم باستعمال دوال خاصة، اطلع على الملحق للحصول على قائمة تضم جميع الدوال مع نوع المورد المناسب. اطلع على الدالة get_resource_type()‎ أيضًا. التحويل إلى مورد لا يمكن تحويل القيم من الأنواع الأخرى إلى موارد، فهذه المتغيرات تحمل مقابض (handles) خاصة لفتح الملفات، اتصالات قاعدة البيانات، مناطق الصورة … تحرير الموارد بفضل نظام عدّ المراجع (reference-counting system) الموجود في محرك Zend، ستُكتَشَف الموارد التي لا تمتلك مرجع إليها تلقائيًا، ,وتُحرَّر ...

(PHP 4, PHP 5, PHP 7) تعيد تنفيذ البرنامج إلى الوحدة التي قامت بالاستدعاء، وسيستمر التنفيذ إلى التعبير الذي يلي تعبير الاستدعاء. إذا استدعيت عبارة return داخل الدالة فإنّها ستنهي تنفيذ الدالة على الفور وتعيد معاملها كقيمة لاستدعاء الدالة. تنهي return أيضًا تنفيذ عبارة eval()‎ أو ملف الشيفرة. إن استدعيت عبارة return من النطاق العام (global scope) فإنها تنهي عملية تنفيذ ذلك الملف. وإن كان ملف الشيفرة مضمنًا (included) أو مطلوبًا (required)، فإن التحكّم يعود إلى الملف المستدعي مرة أخرى. ...

(PHP 5 >= 5.1.3, PHP 7) تحصل الدالة sys_getloadavg()‎ على متوسط حِمل النظام. الوصف array sys_getloadavg ( void ) تعيد الدالة sys_getloadavg()‎ ثلاث عينات تمثل متوسط حِمل النظام (عدد العمليات في طابور الانتظار في تشغيل النظام) خلال الدقائق 1 و 5  و 15 الأخيرة على التوالي. القيم المعادة تعيد الدالة sys_getloadavg()‎ مصفوفة مع ثلاث عينات (آخر 1 و 5 و 15 دقيقة). أمثلة المثال 1: مثال على الدالة sys_getloadavg()‎ <?php $load = sys_getloadavg(); if ($load[0] > 0.80) {  header('HTTP/1.1 503 Too ...

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

(PHP 4, PHP 5, PHP 7) تستخلص الدالة var_dump()‎‎‎ معلومات حول المتغيّر. الوصف void var_dump ( mixed $expression [, mixed $... ] ) تعرض هذه الدالة معلومات مُنظَّمة حول واحد أو أكثر من التعابير (expressions) بما في ذلك نوعها وقيمتها. تُستكشف المصفوفات والكائنات بشكل تكراري مع قيم بغرض إظهار البنية. تُعاد كافة خصائص الكائنات المحميّة والخاصّة والعامّة ما لم يعتمد الكائن التابع debugInfo()‎__ (اعتُمِدَ في إصدار PHP 5.6.0). فائدة: كما هو الحال مع أي شيء يُخرِج نتائجه مباشرةً إلى المتصفّح، يُمكِن ...

(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 5 >=5.3.2,  PHP 7) تجلب الدالة realpath_cache_get()‎ محتويات المسار الحقيقي المخزَّنة. الوصف array realpath_cache_get ( void ) تجلب هذه الدالة محتويات المسار الحقيقي المُخزنَّة. القيم لمعادة تُعاد مصفوفة تحتوي على مدخلات المسار الحقيقي المُخزنَّة. قيم مفاتيح تلك المصفوفة هي المدخلات الأساسيَّة للمسار ومحتواها هو مصفوفات تحتوي على عناصر البيانات من ضمنها المسار المستبين (resolved path)، وتاريخ انتهاء الصلاحيَّة، والخيارات الأخرى التي ما تزال مخزَّنة. أمثلة المثال 1: استعمال الدالة realpath_cache_get()‎ <?php var_dump(realpath_cache_get()); ?> سيُظهر المثال السابق نتيجة مشابهة للتالي: array(2) { ["/test"]=> ...

(PHP 4, PHP 5, PHP 7) تُعيد الدالّة func_num_args()‎ عدد الوسائط الممرّرة إلى الدّالة. الوصف int func_num_args ( void ) تحصل الدالّة func_num_args()‎ على عدد الوسائط الممرّرة إلى الدّالة. من الممكن أن تُستخدم الدّالة func_num_args()‎ بالتزامن مع الدالّة func_get_args()‎ والدالّة func_get_arg()‎ للسماح للدالات المعرّفة من قبل المستخدم بقبول قوائم وسطاء متغيرة الطول. القيم المعادة تُعيد الدالّة func_num_args()‎ عدد الوسائط الممرّرة داخل الدالّة الحالية المعرّفة من قبل المستخدم. سجل التغييرات الإصدار الوصف 5.3.0 يمكن الآن استخدام هذه الدالّة في قوائم المعاملات. 5.3.0 إذا ...

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

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

(PHP 4 >= 4.3.2, PHP 5, PHP 7) تُحدث الدالة session_regenerate_id()‎ معرف الجلسة الحالية عن طريق توليد معرف جديد. الوصف bool session_regenerate_id ([ bool $delete_old_session = FALSE ] ) تبدل الدالة session_regenerate_id()‎ معرف الجلسة  الحالية برقم جديد وتُبقي على باقي معلومات الجلسة الحالية. عند تفعيل session.use_trans_sid، يجب أن يبدأ الإخراج بعد استدعاء الدالة()session_regenerate_id، والا سيُستعمل معرف الجلسة القديم. المعاملات delete_old_session سواء قمت بحذف ملف الجلسة المرتبطة أم لا، يجب ألّا تمسح الجلسة القديمة إذا أردت تجنب أو كشف هجمات سرقة الجلسات. القيم المعادة تُعيد الدالة session_regenerate_id()‎ القيمة TRUE ...

(PHP 4, PHP 5, PHP 7) تبحث الدالة preg_replace()‎‎‎ عن تعبير نمطي وتستبدله. الوصف mixed preg_replace ( mixed $pattern , mixed $replacement , mixed $subject [, int $limit = -1 [, int &$count ]] ) تبحث هذه الدالة في الهدف subject عن النمط المطابق pattern وتبدله إلى replacement. المعاملات pattern النمط المراد البحث عنه. ويمكن أن يكون إما سلسلةً نصيةً أو مصفوفةً من السلاسل النصية. وتتوافر أيضًا العديد من مُعدِّلات PCRE. replacement السلسلة النصية البديلة أو مصفوفة السلاسل النصية البديلة. إذا ...

الدوال المجهولة (anonymous functions) التي تُعرَف أيضًا بالمصطلح (closures) تسمح بإنشاء دالة ليس لها اسم محدد. غالبًا ما تستخدم هذه الدوال للحصول على قيمتها كمعاملات استدعاء (راجع callback) ولها استخدامات أخرى. تطبق اللغة الصنف Closure لاستخدام الدوال المجهولة. المثال 1: الدوال المجهولة <?php echo preg_replace_callback('~-([a-z])~', function ($match) { return strtoupper($match[1]); }, 'hello-world'); // outputs helloWorld ?> يمكن استخدام الدوال المجهولة كقيم للمتغيرات، وتحول اللغة مثل هذه التعبيرات إلى نسخ instances من الصنف الداخلي Closure. يمكن إسناد الدالة المجهولة إلى متغير بنفس ...

وراثة الكائنات من المبادئ المعروفة في البرمجة كائنية التوجه وتستخدمه PHP في نموذج الكائنات الخاصّ بها. يؤثّر هذا المبدأ على العلاقة التي تربط بين الأصناف والكائنات. فعلى سبيل المثال، عند توسيع صنف معين، يرث الصنف الفرعي جميع التوابع من نوع public و protected من الصنف الأب، وإن لم يتجاوز (override،أي يعيد تعريف) الصنف الابن هذه التوابع فإنّها ستحافظ على وظيفتها الأصلية. يساعد مبدأ وراثة الكائنات في تعريف الوظائف التي تؤديها التوابع وجعلها أكثر تجريدًا، ويتيح أداء المزيد من الوظائف في ...

أشباه الأنواع هي كلمات مفتاحيَّة مستخدمة في توثيق PHP لتحديد الأنواع أو القيم التي يمكن أن يمتلكها المعامل ولا يمكن استخدامها في الشيفرات البرمجية. مختلط – mixed يعني هذا أن المعامل يقبل العديد من الأنواع -وليس بالضرورة جميعها-. على سبيل المثال الدالة gettype()‎ ستقبل جميع أنواع المتغيرات، في حين أن الدالة str_replace()‎ ستقبل السلاسل النصية والمصفوفات. رقم – Number يشير Number إلى أن المعامل يمكن أن يكون عددًا صحيحًا أو عددًا عشريًا. رد النداء – callback استخدم هذا في التوثيق ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chown()‎ مالك الملف. الوصف bool chown ( string $filename , mixed $user ) تحاول هذه الدالة تغيير مالك الملف filename إلى المالك الجديد user. المستخدم ذو امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير مالك الملف. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. user اسم المالك الجديد أو رقم مُعرِّفه. القيم المعادة تُعاد القيمة TRUE عند نجاح العملية، والقيمة FALSE خلاف ذلك. أمثلة المثال 1: استعمال الدالة ...

(PHP 4, PHP 5, PHP 7) تُعيد الدالة  get_class()‎‎‎‎‎‎‎‎ اسم الصنف لكائن object. الوصف string get_class ([ object $object ] ) تحصل الدالة get_class()‎‎‎‎‎‎‎‎ على اسم الصنف للكائن المُعطى object. المعاملات object اسم الكائن المُختبر. من الممكن أن يُحذف هذا المعامل عندما يتم استخدام الدالة get_class()‎  داخل صنف ما. ملاحظة: لم يعُد التمرير الصريح للقيمة NULL كقيمة للمعامل object مسموحًا بدءًا من الإصدار PHP 7.2.0. ولكن لا يزال المعامل object اختياريًا، وسيعمل استدعاء الدالة get_class()‎  بدون المعامل object من داخل صنف ما، ...

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تعيد الدالة str_word_count()‎ معلومات حول الكلمات المستخدمة في سلسلة نصية. الوصف mixed str_word_count ( string $string [, int $format = 0 [, string $charlist ]] ) تحسب الدالة str_word_count()‎ عدد الكلمات داخل المعامل string. إذا لم يُحَدَّد المعامل الاختياري format، فستكون القيمة المعادة عددًا صحيحًا يمثل عدد الكلمات التي عُثِرَ عليها. في حالة تحديد المعامل format، ستكون القيمة المعادة مصفوفة، يعتمد محتواها على المعامل format. القيمة الممكنة للمعامل format والقيم الناتجة مذكورة أدناه. ...

يقدّم الإصدار الخامس من اللغة الأصناف والتوابع المجرّدة (abstract classes and methods). لا يمكن تهيئة الأصناف المجرّدة، وإذا احتوى الصنف على تابع مجرّد واحدٍ على الأقل فيجب أن يكون الصنف مجردًا أيضًا. تصرّح الأصناف المجرّدة ببساطة عن توقيع التابع (method's signature، أي اسم الدالة وعدد ونوع معاملاتها)، ولا يمكنها تعريف محتويات تلك التوابع (implementation). عندما يرث صنفٌ ما من صنفٍ مجرّد، يجب تعريف جميع التوابع المجرّدة في الصنف الأب ضمن الصنف الابن، إضافة إلى وجوب تعريف هذه الأصناف بنفس مستوى ...

(PHP 4, PHP 5, PHP 7) تمسح الدالة clearstatcache()‎ حالة الملف المُخزَّنة. الوصف void clearstatcache ([ bool $clear_realpath_cache = FALSE [, string$filename ]] ) تُخزِّن PHP المعلومات التي تعيدها بعض الدوال المُستخدمة مثل الدالة stat()‎ والدالة lstat()‎، أو أي دالة من الدوال المذكورة في الأسفل، وذلك من أجل رفع الأداء؛ لكن قد تضطر في بعض الحالات إلى مسح تلك المعلومات المخزَّنة. إن تحققنا من حالة ملفٍ ما عدَّة مرات في سكربت واحد، وكان ذلك الملف عرضةً للحذف أو النقل خلال عمل ...

(PHP 4, PHP 5, PHP 7) تفحص الدالةconnection_aborted()‎ ‎ ما إذا كان العميل غير متصل. الوصف int connection_aborted ( void ) تفحص الدالة connection_aborted()‎‎ ما إذا كان العميل غير متصل. القيم المعادة تعيد الدالة connection_aborted()‎‎ القيمة 1 إذا كان العميل غير متصل، وإلا فهي تعيد القيمة 0. انظر أيضًا الدالة ()connection_status‎ : إعادة bitfield لحالة الاتصال. الدالة ignore_user_abort()‎: تعيين ما إذا كان قطع اتصال العميل يجب أن يُحْبِطُ تنفيذ البرنامج. راجع صفحة «معالجة الاتصالات» للحصول على وصف كامل لمعالجة الاتصال في PHP. ...

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تبحث الدالة glob()‎ عن مسارات محدَّدة لملفات أو مجلَّدات والتي تتطابق مع نمط مُعطى. الوصف array glob ( string $pattern [, int $flags = 0 ] ) تبحث هذه الدالة عن جميع المسارات التي تُطابق النمط pattern وفقًا للقواعد التي تستخدمها المكتبة libc للدالة glob()‎، والتي تشبه نظيرتها المستخدمة من قبل أشهر الصدفات (shells). المعاملات pattern التعبير النمطي المُعطى. الرمز ~ (المَدَّة [tilde]) غير مدعوم، كما أنَّه لا يُجرى أي عملية استبدال للمعاملات. ...

(PHP 4, PHP 5, PHP 7) تُرتب الدالة usort()‎‎ مصفوفة حسب القيم باستخدام دالة مقارنة معرفة من قبل المستخدم. الوصف bool usort ( array &$array , callable $value_compare_func ) تُرتب هذه الدالة مصفوفة حسب القيم باستخدام دالة مقارنة معرفة من قبل المستخدم. ويجب عليك استخدام هذه الدالة إذا كانت المصفوفة التي ترغب في ترتيبها تحتاج إلى الترتيب حسب بعض المعايير غير البسيطة. ملاحظة: إذا تساوت مقارنة عنصرين، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد. ملاحظة: تُعيّن هذه الدالة مفاتيح ...

(PHP 4, PHP 5, PHP 7) تضبط الدالة touch()‎ وقت الوصول والتعديل للملف. الوصف bool touch ( string $filename [, int $time = time() [, int $atime ]] ) تحاول هذه الدالة ضبط وقت الوصول والتعديل للملف ذو المسار filename إلى القيمة time المعطاة. الجدير بالذكر أنَّ وقت الوصول يُعدَّل دومًا بغض النظر عن عدد المعاملات الممرَّرة إلى الدالة. إن لم يكن الملف موجودًا، فسيُنشأ آنذاك. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. time وقت الوصول والتعديل المراد تغييره للملف ...

(PHP 4, PHP 5, PHP 7) تحصل الدالة get_object_vars()‎‎‎ على خصائص (properties) الكائن المُعطى. الوصف array get_object_vars ( object $object ) تحصل الدالة get_object_vars()‎‎‎ على الخصائص غير الساكنة التي يمكن الوصول إليها للكائن المُعطى وفقًا للنطاق. المعاملات object الكائن الذي نريد الحصول على خصائصه. القيم المعادة تُعيد الدالة get_object_vars()‎‎‎ مصفوفة ترابطية لخصائص كائن مُعرّفة غير ساكنة قابلة للوصول لكائن مُحدد object في نطاق. إذا لم تُسند قيمة إلى خاصيةٍ ما، فستُعيد الدالة get_object_vars()‎ القيمة NULL. سجل التغييرات الإصدار الوصف 5.3.0 ...

غالبًا ما ترد العبارة التالية كثيرًا عند الحديث عن البرمجة كائنية التوجّه في PHP 5: "تمرّر الكائنات بالمرجعية بصورة افتراضية". هذه العبارة ليست صحيحة تمامًا، وسيصحّح هذا القسم هذه الفكرة العامة بالاستعانة ببعض الأمثلة. المرجع في PHP هو اختصار يتيح لمتغيرين مختلفين الكتابة إلى القيمة ذاتها. ومنذ الإصدار الخامس من اللغة، لم يعد متغير الكائن يتضمّن الكائن نفسه كقيمة على الإطلاق، بل يتضمّن فقط معرّفًا للكائن يتيح الوصول إلى الكائن الحقيقي. وعند تمرير الكائن كمعامل أو إعادته أو إسناده إلى ...

(PHP 4, PHP 5, PHP 7) تبحث الدالة strpos()‎ عن أول ظهور لمحارف معينَّة في سلسلة نصيَّة ثمَّ تعيد ترتيب موقعها في تلك السلسلة. الوصف int strpos ( string $haystack , mixed $needle [, int $offset = 0 ] ) تبحث هذه الدالة على أول ظهور للمحارف needle ضمن السلسلة النصيَّة haystack ثمَّ تعيد رقم موقعها في تلك السلسلة. المعاملات haystach السلسلة النصيَّة التي ستبحث الدالة فيها. needle مجموعة المحارف التي ستبحث الدالة عنها. إن لم تكن تلك المحارف سلسلةً نصيَّةً، ...

(PHP 4, PHP 5, PHP 7) تتحقّق الدالة is_float()‎‎‎‎‎‎‎ إذا ما كان المتغيّر عددًا عشريًّا. الوصف bool is_float ( mixed $var ) تجد إذا ما كان نوع المتغيّر المُعطى عددًا عشريًّا. ملاحظة: لمعرفة إذا ما كان المتغيّر عددًا أو سلسلةً نصّيّةً (كما في حقول الإدخال [form input] إذ يكون سلسلة نصّيّة دومًا)، فاستخدم الدالة is_numeric()‎. المعاملات var القيمة المطلوب التّحقّق منها. القيم المعادة تُعيد القيمة TRUE إن كان المتغيّر عددًا عشريًّا، و FALSE فيما عدا ذلك. أمثلة المثال 1: أمثلة على ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة abs()‎ القيمة المطلقة للعدد المُمرَّر إليها. أي إذا كان لدينا المتغير x، فتمثل هذه الدالة القيمة المطلقة له |x|. الوصف number abs ( mixed $number ) تعيد هذه الدالة القيمة المطلقة للمعامل number (أي العدد المُمرَّر إليها). المعاملات number القيمة العدديَّة التي نريد الحصول على قيمتها المطلقة. القيم المعادة تُعاد القيمة المطلقة للقيمة العددية الممرَّرة إلى الدالة مكان المعامل number. إن كان ذلك العدد هو عدد عشري (float)، فإنَّ القيمة المعادة هي عدد ...

المثال الاسم النتيجة ‎$a + $b الاندماج اندماج ‎$a و ‎$b. ‎$a == $b المساواة TRUE إن كان ‎$a و ‎$b يمتلكان نفس أزواج مفتاح/قيمة. ‎$a === $b التطابق TRUE إن كان ‎$a و ‎$b يمتلكان نفس أزواج مفتاح/قيمة وبنفس الترتيب ومن نفس النوع. ‎$a != $b عدم المساواة TRUE إن كان ‎$a و ‎$b غير متساويين. ‎$a <> $b عدم المساواة TRUE إن كان ‎$a و ‎$b غير متساويين. ‎$a !== $b عدم التطابق TRUE إن كان ‎$a و ‎$b غير ...

(PHP 4, PHP 5, PHP 7) تشغل/توقف الدالة ob_implicit_flush()‎ الإفراغ الضمني (الآلي). الوصف void ob_implicit_flush ([ int $flag = 1 ])‎ تشغل أو توقف الدالة ob_implicit_flush()‎ الإفراغ الضمني (الآلي). تنتج عن الإفراغ الضمني (الآلي) عملية إفراغ بعد كل استدعاء للإخراج, وبذلك لن تكون هنالك حاجة لاستدعاء الإفراغ الصريح. المعامل flag تأخذ القيمة  1 لتشغيل الإفراغ الضمني, و القيمة 0 لما عدا ذلك. القيم المعادة لا تعيد الدالة ob_implicit_flush()‎ أي قيمة. انظر أيضا الدالة ()flush: تفرع المخزن المؤقت للإخراج الدالة ()ob_start: تشغيل المخزن ...

(PHP 4, PHP 5, PHP 7) تبحث الدالة min()‎ عن أصغر قيمة من بين القيم الممرَّرة إليها ثمَّ تعيدها. الوصف mixed min ( array $values ) mixed min ( mixed $value1 , mixed $value2 [, mixed $... ] ) إن مُرِّر إلى هذه الدالة معاملٌ وحيدٌ وكان هذا المعامل مصفوفةً، فستعيد أصغر قيمة من قيم عناصر تلك المصفوفة. أمَّا إن مرِّر إلى الدالة قيمتان عدديتان أو أكثر، فستعيد القيمة الأصغر من تلك القيم الممرَّرة إليها. ملاحظة: ستُوازن القيم ذات الأنواع المختلفة وفقًا ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة tempnam()‎ ملفًا ذو اسم فريد من نوعه. الوصف string tempnam ( string $dir , string $prefix ) تنشئ هذه الدالة ملفًا ذو اسم مميَّز في مجلَّد محدَّد، وتكون أذوناته مضبوطة إلى القيمة 0600. إن لم يكن ذاك المجلَّد موجودًا أو كان موجودًا ولكنَّه غير قابل للكتابة، فقد تنشئ الدالة الملف في المجلَّد المؤقَّت الإفتراضي للنظام المستعمل ثمَّ تعيد مساره كاملًا والذي يتضمن اسمه أيضًا. المعاملات dir المجلَّد المراد إنشاء الملف المؤقَّت ضمنه. prefix ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة file_exists()‎ من وجود ملف أو مجلَّد محدَّد. الوصف bool file_exists ( string $filename ) تتحقَّق هذه الدالة إن كان الملف أو المجلَّد filename موجودًا أو لا. المعاملات filename مسار الملف أو المجلَّد المُراد التحقُّق من وجوده. استعمل على ويندوز المسار ‎//computername/share/filename أو ‎\\computername\share\filename للتحقُّق من الملفات المُشاركة على الشبكة. القيم المعادة تُعاد القيمة TRUE إن كان الملف أو المجلَّد المحدَّد بوساطة المعامل filename موجودًا، وتُعاد القيمة FALSE إن لم يكن. ملاحظة: ستعيد هذه ...

(PHP 4 >= 4.0.4, PHP 5, PHP 7) تستدعي الدالة call_user_func_array()‎ دالة رد نداء (callback function) مع تمرير مصفوفة من المعاملات إليها. الوصف mixed call_user_func_array ( callable $callback , array $param_arr ) تستدعي الدالة call_user_func_array()‎ دالة رد النداء المُمرَّرة إليها من خلال المعامل الأول callback مع المعاملات الموجودة في المصفوفة param_arr. المعاملات callback دالة رد النداء (callback function) التي نريد استدعاءها. param_arr المُعاملات التي  ستمرَّر إلى دالة رد النداء callback كمصفوفة مفهرسة. القيم المعادة تُعاد القيمة التي ستُعيدها داة رد ...