نتائج البحث

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

معالجة الأخطاء (Error Handling) في Laravel

مقدمة عند بدء مشروع Laravel جديد تكون معالجة الأخطاء والاستثناءات مُعدّة لك مُسبقا. تُسجّل كافة الاستثناءات التي يطلقها تطبيقك في الصنف App\Exceptions\Handler ثم تُرجع للمُستخدم. سنتعمّق في هذا الصنف أكثر من خلال هذا التوثيق. الضبط يحدد الخيار debug في ملف إعداداتك config/app.php مقدار المعلومات الفعلية التي تُعرض عن الخطأ للمستخدم. يُعد هذا الاختيار إفتراضيًّا ليحترم قيمة متغيّر البيئة APP_DEBUG التي تُخزّن في ملفك env. . عليك وضع قيمة متغير البيئة APP_DEBUG على true عند التطوير المحلّي. يجب أن توضع هذه ...

الدالة 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()‎ ولم ...

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

(PHP 4 >= 4.0.2, PHP 5, PHP 7) تُعيد الدالة get_resource_type()‎‎‎ نوع المورد المُعطى لها. الوصف string get_resource_type ( resource $handle ) تُعطي هذه الدالة نوع المورد المُعطى لها. المعاملات handle مقبض للمورد المطلوب تقييمه. القيم المعادة عندما يكون المقبض handle عبارة عن مورد، فستُعيد هذه الدالة سلسلة نصّيّة تُمثِّل نوعه. وإن لم تتعرّف هذه الدالة على النّوع تكون القيمة المُعادة هي السلسلة النصّيّة Unknown. إن لم يكن المقبض handle موردًا ستولِّد هذه الدالة خطأً وتُعيد القيمة NULL. سجل التغييرات الإصدار ...

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

(PHP 4, PHP 5, PHP 7) تغلق الدالة fclose()‎ ملفًا مفتوحًا. الوصف bool fclose ( resource $handle ) تغلق هذه الدالة الملف المفتوح الذي يشير إليه المؤشر handle. المعاملات handle مؤشر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE خلاف ذلك. أمثلة المثال 1: استعمال الدالة fclose()‎ <?php $handle = fopen('somefile.txt', 'r'); fclose($handle); ?> انظر أيضًا الدالة fopen()‎: تفتح ملفًا جديدًا ...

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

(PHP 4, PHP 5, PHP 7) تعيد الدالة ftell()‎ الموقع الحالي لمؤشِّر القراءة من أو الكتابة على الملف. الوصف int ftell ( resource $handle ) تعيد هذه الدالة الموقع الحالي لمؤشِّر الملف المُشار إليه باستعمال المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة popen()‎. ستعيد الدالة نتائج غير متوقَّعة عند فتح الملف باستعمال الوضع 'a' (إضافة البيانات إلى الملف فقط). القيم المعادة يُعاد عدد صحيح ...

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

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

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

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تفرِّغ الدالة fflush()‎ ما في مخزن المخرجات في ملف محدَّد. الوصف bool fflush ( resource $handle ) تفرِّغ هذه الدالة جميع المخرجات المخرَّنة في الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم يُغلق بعد باستعمال الدالة fcolse()‎. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE خلاف ذلك. أمثلة ...

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

(PHP 4, PHP 5, PHP 7) تفتح الدالة popen()‎ عمليَّة وتشير إليها بمؤشِّر شبيه بمؤشِّر ملف. الوصف resource popen ( string $command , string $mode ) تفتح هذه الدالة أنبوبًا (pipe) يتصل مع العمليَّة المراد تنفيذها باستعمال الأمر command الفرعي المعطى. المعاملات command الأمر المراد تنفيذه. mode يُحدِّد هذا المعامل نوع الوصول المطلوب إلى المجرى. القيم المعادة يُعاد مؤشِّر ملف مطابق تمامًا للمؤشِّر المعاد بوساطة الدالة fopen()‎ باستثناء أنَّه أحادي الاتجاه (unidirectional) (أي يمكن استعماله إمَّا للقراءة أو للكتابة فقط) ويجب ...

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

(PHP 4, PHP 5, PHP 7) تغلق الدالة pclose()‎ عمليَّة مفتوحة. الوصف int pclose ( resource $handle ) تغلق هذه الدالة العمليَّة التي يشير إليها المؤشِّر handle والمفتوحة باستعمال الدالة popen()‎. المعاملات handle مؤشِّر (pointer) شبيه بمؤشِّر الملف يشير إلى عمليَّة. يجب أن يكون سليمًا، وأُعيد بطريقة صحيحة باستدعاء الدالة popen()‎. القيم المعادة تُعاد الحالة ذاتها التي تعيدها العمليَّة التي كانت تعمل عند إنهائها. إن وُجد خطأ ما، فستُعاد القيمة ‎-1. ملاحظة: إن صُرِّف مفسِّر PHP‎ مع تمرير الخيار ‎--enable-sigchild، فستكون ...

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

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

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

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

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

(PHP 4, PHP 5, PHP 7) تعيد الدالة fstat()‎ معلومات عن ملف باستعمال مؤشِّر ملف مفتوح يشير إليه. الوصف array fstat ( resource $handle ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف المفتوح الذي يشير إليه المورد handle. تشبه هذه الدالة إلى حدٍّ كبير الدالة stat()‎ باستثناء أنَّها تتعامل مع مؤشِّر ملف مفتوح عوضًا عن مسار الملف. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎. القيم المعادة تُعاد ...

الدالة 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 أول وسيط مُمرَّر إلى إلى سلسلة التنسيق. … بقية الوسائط المُمرَّرة ...

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

(PHP 4, PHP 5, PHP 7) تطبع الدالة vfprintf()‎ سلسلةً نصيَّةً بتنسيق معين على مجرى (stream) محدَّد. الوصف int vfprintf ( resource $handle , string $format , array $args ) تطبع هذه الدالة سلسلة نصيَّة بعد أن تنسِّقها وفقًا للتنسيق format إلى المجرى handle المعطى. عمل هذه الدالة شبيه بالدالة fprintf()‎ باستثناء أنَّها تقبل مصفوفةً من المعاملات بدلًا من عدد من المعاملات المتغيِّرة. المعاملات handle إشارة إلى مورد (resource) من نظام الملفات الذي يُنشَأ عادةً باستخدام الدالة fopen()‎‎. format راجع الدالة ...

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

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

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

(PHP 4, PHP 5, PHP 7) تعيد الدالة dir()‎ نسخةً (instance) من الصنف Directory. الوصف Directory dir ( string $directory [, resource $context ] ) تملك هذه الدالة آلية شبه كائنيَّة التوجه لقراءة المجلَّد. سيُفتح المجلد directory المعطى. المعاملات directory مسار المجلَّد المراد فتحه. context ملاحظة: أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم المجرى (stream) للمزيد من الشرح عن المحتوى (context). القيم المعادة تُعاد نسخةٌ من الصنف Directory عند نجاح العمليَّة، أو القيمة NULL إن كان هنالك خطأ في ...

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

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

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

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة feof()‎ من الوصول إلى نهاية ملف (EOF) بتمرير المقبض الذي يشير إلى الملف. الوصف bool feof ( resource $handle ) تتحقَّق هذه الدالة من الوصول إلى نهاية ملف (EOF) بتمرير المقبض handle الذي يشير إلى الملف. المعاملات handle مقبض (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎، ولم يُغلق بعد باستعمال الدالة fclose()‎. القيم المعادة تُعاد القيمة TRUE إن وصل مقبض ...

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

(PHP 4, PHP 5, PHP 7) تطبع الدالة fpassthru()‎ جميع محتويات الملف المتبقِّية على المخزن المؤقت للخرج. الوصف int fpassthru ( resource $handle ) تقرأ هذه الدالة الملف الذي يشير إليه المورد handle من موقع المؤشِّر الحالي وحتى نهاية الملف (EOF) ثمَّ تكتب هذه البيانات المقروءة على المخزن المؤقت للخرج. قد تحتاج إلى استدعاء الدالة rewind()‎ لإعادة موقع المؤشِّر إلى بداية الملف إن أضفت بعض البيانات إلى هذا الملف. إن أردت طباعة كامل محتوى الملف على المخزن المؤقت للخرج دون التعديل ...

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

(PHP 4, PHP 5, PHP 7) تقرأ الدالة fread()‎ من ملف معيَّن بطريقة آمنة ثنائيًّا. الوصف string fread ( resource $handle , int $length ) تقرأ هذه الدالة عددًا محدودًا من البايتات (التي تحدَّدها قيمة المعامل length) من الملف الذي يشير إليه المورد handle. ستتوقَّف عمليَّة القراءة حال تحقُّق أحد الشروط التالية: إكمال قراءة البايتات التي تحدِّدها قيمة المعامل length. الوصول إلى نهاية الملف (EOF). حزمة من البيانات أًصبحت متاحة أو انتهاء مهلة المقبس (socket، وذلك عند القراءة من مجرى شبكة). ...

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

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تحلِّل الدالة fscanf()‎ المدخلات من الملف وفقًا لتنسيق محدَّد. الوصف mixed fscanf ( resource $handle , string $format [, mixed &$... ] ) تشبه هذه الدالة الدالة sscanf()‎ باستثناء أنَّها تأخذ مدخلاتها من الملف الذي يشير إليه المورد handle ثمَّ تُفسِّر هذه المدخلات وفقًا للتنسيق format المُعطى الذي شُرح بالتفصيل في صفحة الدالة sprintf()‎. ملاحظة: أيُّ فراغ أبيض (whitespace) موجود في السلسلة النصيَّة format سيتطابق مع أي محرف فراغ أبيض يُعثر عليه في ...

الدالة 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 (بعد أن تضيف في نهاية ذلك السطر محرف سطر جديد). المعاملات ...

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

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

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

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

الصنف Directory‎ في PHP

(PHP 4, PHP 5, PHP 7) مقدمة تُنشأ نُسخ (instances) الصنف Directory باستدعاء الدالة dir()‎ وليس باستعمال الكلمة المفتاحية new. ملخص الصنف Directory { // الخاصِّيات public string $path ; public resource $handle ; // التوابع public void close ([ resource $dir_handle ] ) public string read ([ resource $dir_handle ] ) public void rewind ([ resource $dir_handle ] ...

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

(PHP 4, PHP 5, PHP 7) تحمي الدالة flock()‎ ملفًا محدَّدًا أثناء إجراء عمليَّة عليه (مثل القراءة منه أو الكتابة عليه) إشارةً إلى أنَّ هذا الملف يُستعمل الآن. الوصف bool flock ( resource $handle , int $operation [, int &$wouldblock ] ) تُتيح لك هذه الدالة قفل أيَّ ملف ومنع الآخرين من القراءة منه أو الكتابة عليه وذلك أثناء إجراء عمليَّة ما على هذا الملف. يمكن استعمال هذه الدالة نظريًا على جميع الأنظمة (من ضمنها أغلب توزيعات لينكس وحتى ويندوز). كان ...

الموارد في PHP

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

الموارد في PHP

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

التعامل مع الدوال في 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()‎ عدد الوسائط ...

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

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

البرمجيّات الوسيطة (Middleware) في Laravel

مقدمة تُوفِّر البرمجيّات الوسيطة آلية ملائمة لفرز الطلبات HTTP التي تدخل تطبيقك. على سبيل المثال، يحتوي Laravel على برمجيّّة وسيطة تتحقق إن كان مستخدم تطبيقك مصادقا عليه (authenticated). في حالة لم يكن مصادقا عليه، تعيد البرمجيّة الوسيطة توجيهه لصفحة تسجيل الدخول. في حالة كان مصادقا عليه، ستسمح البرمجيّة للطلب بالمرور لسائر التطبيق. يمكن طبعا كتابة برمجيّات وسيطة للقيام بمهام متنوعة عديدة عدا تسجيل الدخول. قد تكون برمجيّة CORS وسيطة مسؤولة عن إضافة الترويسات (headers) المناسبة لكل الردود التي يرسلها تطبيقك. ...

الأحداث (Events) في Laravel

مقدمة توفّر أحداث Laravel تطبيق مراقب بسيط  يسمح بالإشتراك والاستماع لعدّة أحداث يطلقها التطبيق. تُخزَّن أصناف الأحداث في الدليل app/Events، في حين توجد المنصتات في app/Listeners. لا تقلق إن لم تجد هذه الدلائل في التطبيق إذ تُصنع حين تولّد أحداثًا و منصتات باستعمال أوامر artisan. الأحداث طريقة ممتازة لفك ارتباط عدّة عناصر من التطبيق حيث يمكن أن يكون لحدث واحد عدّة منصتات منفصلة كليا عن بعضها البعض. مثلًا، قد تريد إرسال إعلان slack للمستخدم كلما شحن طلب. بدل ربط معالجة ...

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

توفِّر هذه الدوال معلوماتٍ إضافيةً عن المتغيرات، راجع صفحة المتغيرات للمزيد من المعلومات عنها. boolval()‎ إعطاء  القيمة المنطقيّة لمتغيّر ما. doubleval()‎ هي اسم بديل (alias) للدالة floatval()‎. floatval()‎ إعطاء قيمة من نوع عدد عشري (float) لمتغيّر ما. get_defined_vars()‎ إعادة مصفوفة تحتوي على كل المتغيّرات المُعرَّفة. get_resource_type()‎ إعادة نوع المورد المُعطى لها. gettype()‎ إعادة نوع المتغيّر. intval()‎ إعادة قيمة من نوع عدد صحيح (integer) لمتغيّر ما. is_array()‎ التّحقّق ما إذا كان المتغيّر مصفوفةً. is_bool()‎ التّحقّق ما إذا كان المتغيّر قيمةً منطقيةً (boolean). is_callable()‎ التّحقّق من القدرة على استدعاء ...

الدالة 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: تحدد وظيفة معالج ...

الأمر Artisan console) Artisan) في Laravel

مقدمة Artisan هي واجهة الأوامر المُرفقة ب Laravel. وهي تُوفّر عددًا من الأوامر المفيدة والتي ستساعدك في بناء التطبيق. لإظهار جميع الأوامر التي يوفّرها Artisan، يمكنك استعمال الأمر list php artisan list يحتوي كل أمر على صفحة مساعدة "help" تعرّف وتوضّح الأمر كما تُقدّم قائمة المعاملات والخيارات لكل أمر. يُستعمل الأمر مسبوقًا بالكلمة help لإظهار صفحة المساعدة: php artisan help migrate Laravel REPL تأتي كل تطبيقات Laravel مُرفَقَةً ب Tinker، وهي REPL مشغّلة بواسطة حُزمة PsySH. يسمح Tinker بالتفاعل مع ...

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

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

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

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

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

(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 إذا ...

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

(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 من داخل صنف ما، ...

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

(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 ...

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

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

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

(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 كمصفوفة مفهرسة. القيم المعادة تُعاد القيمة التي ستُعيدها داة رد ...

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

(PHP 4, PHP 5, PHP 7) تُعطي الدالة unserialize()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ قيمة بلغة PHP انطلاقًا من تمثيل مُخزَّن. الوصف mixed unserialize ( string $str [, array $options ] ) تأخذ الدالة unserialize()‎ متغيّرًا متسلسلًا واحدًا وتُحوِّله مرّة أخرى إلى قيمة PHP. تحذير: لا تُمرِّر مُدخَلات المستخدم غير الموثوقة إلى الدالة unserialize()‎ بغض النظر عن قيم المُعامِل options للأصناف المسموحة allowed_classes. قد ينتج عن فك التّسلسل تحميل وتنفيذ شيفرة ما وذلك نظرًا لاستنساخ الكائنات والتحميل التلقائي، ويُمكِن للمستخدم الضار استغلال ذلك. استخدم صيغة تبادل ...

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

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تُعطي الدالة floatval()‎‎ قيمة من نوع عدد عشري (float) لمتغيّر ما. الوصف float floatval ( mixed $var ) تُعطي قيمة من نوع عدد عشري للمتغيّر var. المعاملات var قد يكون من أي نوع عددي. لا يجب استخدام الدالة floatval()‎ مع الكائنات، وينتج عن فعل ذلك خطأ من مستوى E_NOTICE وإعادة القيمة 1. القيم المعادة قيمة من نوع عدد عشري للمتغير المُعطى. تُعيد المصفوفات الفارغة القيمة 0، والمصفوفات غير الفارغة القيمة 1. تُعيد السّلاسل ...

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

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

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

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chdir()‎ مجلَّد PHP الحالي إلى مجلَّد آخر معطى. الوصف bool chdir ( string $directory ) تغيِّر هذه الدالة مجلَّد PHP الحالي إلى المجلَّد directory المعطى. المعاملات directory المجلَّد الحالي الجديد. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، والقيمة FALSE خلاف ذلك. الأخطاء والاستثناءات سيُصدر خطأ من المستوى E_WARNING عند فشل العمليَّة. أمثلة المثال 1: استعمال الدالة chdir()‎ <?php // معرفة المجلَّد الحالي echo getcwd() . "\n"; chdir('public_html'); // معرفة المجلَّد الحالي بعد تغييره echo getcwd() . "\n"; ?> سيُظهر ...

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

(PHP 5 >= 5.3.0, PHP 7) تُعيد الدالّة get_called_class()‎ اسم صنف الروابط الساكنة المتأخرة (Late Static Binding). الوصف string get_called_class ( void ) تُعيد الدالة get_called_class()‎ اسم الصنف الذي استُدعيت فيه الدالة الساكنة التابعة للصنف. القيم المعادة تُعيد الدالّة get_called_class()‎ اسم الصنف، وتُعيد FALSE إذا استدعيت من خارج نطاق الصنف. أمثلة المثال 1: مثال عن استخدام الدالّة get_called_class()‎ <?php class foo { static public function test() { var_dump(get_called_class()); } } class ...

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

(PHP 4, PHP 5, PHP 7) تُعيد الدالة function_exists()‎ القيمة TRUE إذا كانت الدالّة المُعطاة مُعرّفة. الوصف bool function_exists ( string $function_name ) تتحقق الدالّة function_exists()‎ من وجود الدالة function_name في قائمة الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم. المعاملات function_name سلسلة نصية تُمثِّل اسم الدالة التي نريد التحقق إن كانت موجودةً أم لا. القيم المعادة تُعيد الدالة function_exists()‎ القيمة TRUE إذا كانت الدالّة function_name موجودةً، وتُعيد القيمة FALSE في ما عدا ذلك. ملاحظة: ستُعيد الدالة function_exists()‎ القيمة ...

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

(PHP 4, PHP 5, PHP 7) تُعيِّن الدالة settype()‎‎‎‎‎ نوع المتغيّر. الوصف bool settype ( mixed &$var , string $type ) تُعيِّن نوع المتغيّر var إلى النّوع type. المعاملات var المتغيّر المطلوب تغيير نوعه. type القيم المُمكنة للنوع هي: "boolean" أو "bool": قيمة منطقية. "integer" أو "int": عدد صحيح. "float" أو "double": عدد عشري. "string": سلسلة نصّيّة. "array": مصفوفة. "object": كائن. "null": عَدَم. القيم المعادة تُعيد القيمة TRUE عند النّجاح، أو FALSE عند الفشل. أمثلة المثال 1: مثال على الدالة settype()‎ ...

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

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تتحقق الدالة is_a()‎‎‎‎‎‎ فيما إذا كان الكائن من صنفٍ معيّن أو كان ذاك الصنف واحدًا من الأصناف الآباء له. الوصف bool is_a(object $object string $class_name [,bool $allow_string = FALSE ]) تتحقق الدالة is_a()‎‎‎‎‎‎  فيما إذا كانت الكائن المُعطى  object هو من الصنف class_name أو يملك هذا الصنف كواحد من الأصناف الآباء له. المعاملات object الكائن المُختبر. class_name اسم الصنف. allow_string إذا ضُبِطَت قيمة هذا المعامل إلى القيمة FALSE، فلا يُسمح عندها باستخدام اسم ...

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