نتائج البحث

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

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

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

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

يجلب عناصر DOM المطابقة والمخزنة في كائن jQuery. ‎.get( index )‎ الوصف يعيد هذا التابع عنصرًا واحدًا من العناصر الموجودة في كائن jQuery. ‎.get( index )‎ index فهرس صفري من النوع Number (عدد صحيح) يشير إلى العنصر المراد إعادته. يوفر التابع ‎.get()‎ إمكانية الوصول إلى كل عناصر DOM الموجودة في كل كائن jQuery. إذا كانت قيمة الفهرس index خارج المجال (أي أصغر من عدد العناصر الموجودة ضمن الكائن – أي قيمة سالبة – أو أكبر أو تساوي عدد هذه العناصر)، ...

تجلب الدالة get()‎ مجموعةً (group) ذات فهرس محدد. البنية العامة abstract operator fun get(index: Int): MatchGroup? وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات index عدد صحيح يمثل فهرس المجموعة المراد جلبها. تفهرس المجموعات بدءًا من العدد 1 وحتى عدد المجموعات في التعبير النمطي؛ المجموعة ذات الفهرس 0 تقابل المطابقة الكلية. القيمة المعادة يعاد كائنٌ من النوع MatchGroup إن كانت المجموعة ذات الفهرس index متطابقة، أو تعاد القيمة null خلاف ذلك. انظر أيضًا الدالة MatchGroup()‎: ...

يُستعمَل التعبير ‎#include لتضمين مكتبات خارجية في شيفرتك. هذا يساعد المبرمج على الوصول إلى مجموعة أكبر من مكتبات C القياسية (التي هي مجموعة من الدوال المُنشَأ مسبقًا) والمكتبات التي كُتبَت خصِّيصًا لأردوينو. المرجع الرئيسي لمكتبات C الخاصة بالمتحكم AVR (هو أحد متحكمات Atmel الذي بنيت عليه أردوينو) تجده هنا. البنية العامة #include <library's name> ملاحظة: لا تنسَ إضافة الرمز # لأنَّه ضروري. أمثلة يوضح المثال التالي كيفية تضمين مكتبة تُستعمَل لوضع البيانات في ذاكرة البرنامج (أي الذاكرة flash) بدلًا من الذاكرة ...

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

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

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

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تقرأ الدالة file_get_contents()‎ الملف ثمَّ تضع كلَّ محتوياته في سلسلة نصيَّة. الوصف string file_get_contents ( string $filename [, bool $use_include_path= FALSE [, resource $context [, int $offset = 0 [, int $maxlen ]]]] ) تشبه هذه الدالة إلى حدٍّ كبير الدالة file()‎ باستثناء أنَّها تعيد محتوى الملف في سلسلة نصيَّة. يبدأ ذلك المحتوى عند الموقع offset ويكون بطول maxlen بايت. تعيد هذه الدالة عندما تفشل القيمة FALSE. تعدُّ الدالة file_get_contents()‎ وسيلة مفضَّلة لقراءة ...

ملاحظة قبل البدء: تختلف هذه التقنية عن تقنية تغليف الحقول (Encapsulate Field) من حيث أنّها تُستخدَم لتغليف الحقول الخاصّة (أي المُحدَّدة بالكلمة المفتاحيّة private). المشكلة الوصول المباشر إلى الحقول الخاصّة (private fields) داخل الصنف (class). الحل إنشاء تابعي الوصول getter و setter للحقل الخاصّ ومنع الوصول إليه إلا عبرهما. مثال قبل إعادة التصميم يحتوي الصنف Range على الحقلين low و high من النوع الخاص (private) ونلاحظ الوصول إليهما مباشرةً داخل التابع includes في الشيفرة الآتية: في لغة Java: class Range ...

(PHP 4, PHP 5, PHP 7) تقرأ الدالة readfile()‎ من ملف معيَّن وتُظهر محتواه. الوصف int readfile ( string $filename [, bool $use_include_path = FALSE [, resource $context ]] ) تقرأ هذه الدالة كامل محتوى الملف ثمَّ تكتب محتواه على مخزن الخرج (مجرى الخرج القياسي). المعاملات filename اسم الملف المراد قراءته. use_include_path يمكنك استعمال هذا المعامل الاختياري بتمرير القيمة TRUE إن أردت البحث عن الملف في المسار المُضمَّن include_path أيضًا. context مورد مجرى المحتوى. القيم المعادة يُعاد عدد البايتات التي قُرأت ...

مقدمة يوفّر Laravel تجريدًا قويًا لنظام الملفات بفضل الحزمة Flysystem. يوفّر تضمين أنظمة الملفات في Laravel مشغّلات سهلة الاستعمال للتعامل مع الأنظمة المحلية و Amazon S3 والتخزين السحابي Rackspace، بل من السهل جدًا تغيير خيارات التخزين إذ تبقى وصلة API نفسها مع كل الأنظمة. الضبط يوجد ملف ضبط نظام الملفات في config/filesystems.php. يمكنك في هذا الملف ضبط كل الأقراص "disks". يمثّل كل قرص مشغّل تخزين ومكان تخزين خاص. يحتوي الملف على أمثلة ضبط لكل مشغّل مدعوم. لذا غيّر الملف حسب ...

عناصر <input> ذات النوع file تسمح للمستخدم باختيار ملف أو أكثر لرفعها إلى الخادوم أو تعديلها باستخدام الواجهة البرمجية File. الخاصية value تحتوي الخاصية value في الحقل file على سلسلة نصية (DOMString) التي تُمثِّل المسار إلى الملف (أو الملفات) المختارة. بعض الأمور التي عليك أن تضعها بالحسبان: إذا تم اختيار عدِّة ملفات، فقيمة الخاصية value ستُمثِّل أوّل ملف مختار، لكن يمكن الوصول إلى الملفات الأخرى عبر الخاصية FileList في DOM التابعة للعنصر <input>. إذا لم يتم اختيار ملف بعد، فستكون ...

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

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

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

تقديم ميزة التحميل الزائد في PHP القدرة على إنشاء الخصائص والتوابع بصورة ديناميكية، وتعالج هذه العناصر الديناميكية بواسطة التوابع السحرية (magic methods) التي يمكن استخدامها في الصنف لأداء العديد من الوظائف. تنفّذ توابع التحميل الزائد عند التفاعل مع الخصائص أو التوابع غير المصرّح عنها أو غير المرئية ضمن النطاق الحالي. سيستخدم هذا القسم مصطلحي "خاصية يتعذر الوصول إليها" و"تابع يتعذر الوصول إليه" للإشارة إلى حالة التصريح وقابلية الرؤية هذه. يجب تعريف جميع توابع التحميل الزائد كتوابع من نوع public. ملاحظة: ...

تقديم ميزة التحميل الزائد في PHP القدرة على إنشاء الخصائص والتوابع بصورة ديناميكية، وتعالج هذه العناصر الديناميكية بواسطة التوابع السحرية (magic methods) التي يمكن استخدامها في الصنف لأداء العديد من الوظائف. تنفّذ توابع التحميل الزائد عند التفاعل مع الخصائص أو التوابع غير المصرّح عنها أو غير المرئية ضمن النطاق الحالي. سيستخدم هذا القسم مصطلحي "خاصية يتعذر الوصول إليها" و"تابع يتعذر الوصول إليه" للإشارة إلى حالة التصريح وقابلية الرؤية هذه. يجب تعريف جميع توابع التحميل الزائد كتوابع من نوع public. ملاحظة: ...

مقدمة يزوّدك Laravel بـواجهة برمجيّة سلسة للقيام بطلبات HTTP لتطبيقك وتحليل الناتج. على سبيل المثال، القِ نظرة على الاختبار التالي: <?php namespace Tests\Feature; use Tests\TestCase; use Illuminate\Foundation\Testing\RefreshDatabase; use Illuminate\Foundation\Testing\WithoutMiddleware; class ExampleTest extends TestCase {    /**     * مثال اختبار بسيط.     *     * @return void     */    public function testBasicTest()    {        $response = $this->get('/');        $response->assertStatus(200);    } } ينشئ التابع get طلب GET للتطبيق، بينما يتأكد التابع assertStatus من أنّ الرد المُعاد يحتوي على رمز حالة HTTP المعطى. إضافةً إلى هذا التأكد البسيط، يحتوي Laravel على مجموعة من توابع التأكيد لفحص المعلومات المتعلقة بالرد، كترويسات الرد (response headers)‎، ومحتوى الرد، وبنية ...

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

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

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

مقدّمة توفر الجلسات طريقة لتخزين المعلومات حول المستخدم على عدّة طلبات نظرًا لأن التطبيقات المُعتمدة على HTTP بدون حالة. يأتي Laravel مع مجموعة متنوعة من الخلفيّات (backends) التي يمكن الوصول إليها عبر واجهة برمجية API تعبيرية موحّدة. كما يتضمّن دعم خلفيات شائعة مثل Memcached وRedis وقواعد البيانات خارج الأطر المألوفة. الضبط يُخزّن ملف إعدادات الجلسة في config/session.php. تأكد من مراجعة خياراتك المتاحة في هذا الملف. Laravel مُعد افتراضيًّا لاستخدام برنامج تشغيل (driver) الجلسة file الذي يعمل جيّدًا في العديد من ...

الصنف File هو اختصار لأي كائن ملفٍ قابل للوصول عبر البرنامج ومرتبط عن كثب بالصنف IO. يتضمن الصنف File توابع الوحدة FileTest كتوابع صنفٍ مما يسمح لك باستعمال File.exist?("foo")‎ مثلًا. في شرح توابع الصنف File التالية، تكون بتات الأذونات (permission bits) مجموعة من البتات التي تعتمد على المنصة المستعملة والتي تشير إلى أذونات الملف. في الأنظمة الشبيهة بيونكس، تُعرض الأذونات على شكل مجموعة من ثلاثة ثمانيات (octets)؛ الأولى من أجل المالك، والثانية من أجل المجموعة المالكة، والثالثة تخص الأشخاص الآخرين. ...

(PHP 4, PHP 5, PHP 7) تنشئ  الدالة session_start()‎ جلسة جديدة أو تستكمل جلسة موجودة بالفعل. الوصف bool session_start ([ array $options = array() ]) تنشئ الدالة session_start()‎ جلسة جديدة أو تستكمل الجلسة الحالية بناء على مُعرف الجلسة المُمرر بواسطة الطلبية GET و POST أو عبر ملفات تعريف الارتباط. عند استدعاء الدالة session_start()‎ أو عندما تبدأ الجلسة تلقائيًا، ستستدعي  PHP دوال بدء وقراءة معلومات الجلسة. هذه الدوال ستكون إما دالة مضمَّنة في اللغة (built-in) ، أو بواسطة إضافات PHP (مِثل SQLite أو Memcached); أو يُمكن أن تكون ...

مقدمة تُوفِّر الواجهات الساكنة واجهة "ساكنة" (static) للأصناف المتوافرة في حاوي خدمات تطبيقك. يأتي Laravel مع عدة واجهات تمكنك من استخدام كل خاصيات Laravel تقريبًا. تمثل واجهات Laravel الساكنة "وسطاء ساكنات" (static proxies) للأصناف الأساسية بحاوي الخدمات مما يوفر كل فوائد الصِّيغ (syntax) المقتضبة والمُعبِّرة مع الحفاظ على قابلية الاختبار ومرونة أكبر من الدالات الساكنة التقليدية. كل واجهات Laravel الساكنة مُعرَّفةٌ في مجال الأسماء Illuminate\Support\Facades. يمكننا الوصول لواجهة ساكنة بهذه الطريقة: use Illuminate\Support\Facades\Cache; Route::get('/cache', function () { return ...

تتيح عوامل الأعداد الثنائية تقدير ومعالجة بتات (bits) معينة ضمن العدد الصحيح. مثال الاسم النتيجة ‎$a & $b And و يُعيد 1 مكان كل بت له القيمة 1 في كلٍّ من ‎$a و ‎$b. ‎$a | $b Or أو (الضمنية) يُعيد 1 مكان كل بت له القيمة 1 في ‎$a أو ‎$b أو كلاهما. ‎$a ^ $b Xor أو (غير الضمنية) يُعيد 1 مكان كل بت له القيمة 1  في ‎$a أو ‎$b وليس كلاهما. ‎~ $a Not النفي يعكس ...

تتيح عوامل الأعداد الثنائية تقدير ومعالجة بتات (bits) معينة ضمن العدد الصحيح. مثال الاسم النتيجة ‎$a & $b And و يُعيد 1 مكان كل بت له القيمة 1 في كلٍّ من ‎$a و ‎$b. ‎$a | $b Or أو (الضمنية) يُعيد 1 مكان كل بت له القيمة 1 في ‎$a أو ‎$b أو كلاهما. ‎$a ^ $b Xor أو (غير الضمنية) يُعيد 1 مكان كل بت له القيمة 1  في ‎$a أو ‎$b وليس كلاهما. ‎~ $a Not النفي يعكس ...

سلسلة الكائنات - الكائنات في الجلسات تعيد الدالة serialize()‎‎ سلسلة نصية تتضمّن تمثيلًا لتدفق البايتات لأي قيمة يمكن تخزينها في PHP، ويمكن للدالة unseriazlie()‎ استخدام هذه السلسلة النصية لإعادة إنشاء القيمة الأصلية للمتغيّر. يؤدي تطبيق الدالة serialize()‎ على كائن ما لحفظ جميع المتغيرات الخاصة بذلك الكائن، أما التوابع فلا تحفظ وإنّما يحفظ اسم الصنف فقط. يجب تعريف الصنف الخاص بالكائن حتى يكون بالإمكان تطبيق unserialize()‎ على الكائن، بمعنى أنّه لو كان لديك كائن للصنف A وأجريت عليه عملية السلسلة، فإنّك ...

سلسلة الكائنات - الكائنات في الجلسات تعيد الدالة serialize()‎‎ سلسلة نصية تتضمّن تمثيلًا لتدفق البايتات لأي قيمة يمكن تخزينها في PHP، ويمكن للدالة unseriazlie()‎ استخدام هذه السلسلة النصية لإعادة إنشاء القيمة الأصلية للمتغيّر. يؤدي تطبيق الدالة serialize()‎ على كائن ما لحفظ جميع المتغيرات الخاصة بذلك الكائن، أما التوابع فلا تحفظ وإنّما يحفظ اسم الصنف فقط. يجب تعريف الصنف الخاص بالكائن حتى يكون بالإمكان تطبيق unserialize()‎ على الكائن، بمعنى أنّه لو كان لديك كائن للصنف A وأجريت عليه عملية السلسلة، فإنّك ...

الدالة Array.prototype.includes()‎ تُحدِّد إن كانت المصفوفة تحتوي على عنصر معيّن، وتُعيد true أو false. var array1 = [1, 2, 3]; console.log(array1.includes(2)); // true var pets = ['cat', 'dog', 'bat']; console.log(pets.includes('cat')); // true console.log(pets.includes('at')); // false البنية العامة arr.includes(searchElement[, fromIndex]) searchElement العنصر الذي نريد البحث عنه. fromIndex الفهرس الذي نريد البدء منه في البحث عن searchElement، والقيم السالبة ستؤدي إلى بدء البحث من الفهرس array.length + fromIndex تصاعديًا. القيمة الافتراضية هي 0. القيمة المعادة قيمة منطقية (Boolean). أمثلة أمثلة بسيطة عن الدالة includes [1, 2, ...

تتكون جميع شيفرات PHP من سلسلة من العبارات (statements)، ويمكن للعبارة أن تكون إسنادًا (assignment) أو استدعاءً لدالّة، أو حلقة تكرارية، أو عبارة شرطية أو حتى عبارة لا تقوم بأي عمل على الإطلاق (عبارة فارغة). تنتهي العبارات عادة بالفاصلة المنقوطة (;)، ويمكن تجميع العبارات بإحاطتها بالأقواس المعقوفة ({}) لتصبح مجموعة عبارات (statement-group)، والتي تعدّ بدورها عبارات أيضًا. سنفصل الحديث في هذا الفصل عن أنواع متعددة من العبارات. if بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات ...

مقدمة وجود ملفٍّ باسم ‎tsconfig.json‎ في مجلّدٍ ما إشارةٌ إلى أنّ المجلّد هو جذر (root) مشروع TypeScript. يُحدِّد الملفّ ‎tsconfig.json‎ الملفات الجذر (root files) وخيارات الترجمة المطلوبة لترجمة المشروع. يُترجم المشروع بإحدى الطريقتين التاليتين: عبر استخدام أداة ‎tsc‎ دون أي ملفّات مُدخلَة (input files): في هذه الحالة يبحث المترجم عن الملف ‎tsconfig.json‎ بدءًا من المجلد الحالي ثمّ الصعود للأعلى في سلسلة المجلدات الآباء (parent directory chain). عبر استخدام أداة ‎tsc‎ دون أي ملفّات مُدخلَة وخيار سطر الأوامر ‎--project‎ (أو ‎-p‎ ...

(PHP 4, PHP 5, PHP 7) ترجع الدالة rewinddir()‎ مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. الوصف void rewinddir ([ resource $dir_handle ] ) ترجع هذه الدالة موقع المؤشِّر للمجلَّد الذي يشير إليه المورد dir_handle إلى بداية مجرى المجلَّد. المعاملات dir_handle مورد مقبض المجلَّد الذي يشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل (أي لم يحدَّد المجلَّد)، فسيكون آخر مجلَّد فُتح باستعمال الدالة opendir()‎. القيم المعادة تُعاد القيمة NULL عند نجاح العمليَّة. خلا ذلك، تُعاد ...

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

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

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

مقدمة عندما تكون جاهزًا لنشر تطبيق Laravel على الخادوم الإنتاجي، هناك بعض الأشياء المهمة التي يمكنك القيام بها للتأكد من تشغيل التطبيق بأقصى كفاءة ممكنة. في هذا المستند، سنغطي بعض نقاط البداية الرائعة للتأكد من نشر تطبيق Laravel بشكل صحيح. ضبط الخادوم Nginx إذا كنت تقوم بنشر تطبيقك على خادوم Nginx، فيمكنك استخدام ملف التهيئة التالي كنقطة بداية لتهيئة خادوم الويب الخاص بك. على الأرجح، يجب تخصيص هذا الملف بناءً على تهيئة خادومك. إذا كنت ترغب في المساعدة في إدارة ...

مقدمة بالإضافة لدعم إرسال البريد الإلكتروني، يوفّر Laravel دعمًا لإرسال إشعارات بين قنوات توصيل عديدة من ضمنها البريد الإكتروني، والرسائل القصيرة (عبر Nexmo)، و Slack. يمكن أيضًا حفظ الإشعارات في قاعدة البيانات لإظهارها في واجهة الويب. تكون الإشعارات في العادة على شكل رسائل قصيرة، وغنية بالمعلومات، تنبّه المستخدم لشيءٍ حدث في التطبيق. مثلًا، إن كنت تكتب تطبيق فواتير، يمكنك إرسال تنبيه "تمّ خلاص الفاتورة" للمستخدم عبر بريد إلكتروني أو رسالة قصيرة. إنشاء الإشعارات في Laravel، يُمثَّل كل تنبيه بصنف (موجودٌ ...

الضبط يوفر Laravel واجهة برمجيّة معبّرة وموحّدة لكل التخزين المؤقت. يوجد ملف ضبط التخزين في config/cache.php. في هذا الملف، يمكن تحديد مشغّل التخزين الذي سيُستعمل تلقائيًّا في كامل التطبيق. يدعم Laravel العديد من الواجهات الخلفيّة الشائعة مثل Memcached و Redis من البداية. يحتوي ملف ضبط التخزين أيضًا على خيارات متعدّدة مفصّلة في الملف ذاته لذا تأكد من قراءته جيدا. تلقائيًّا، يستعمل Laravel برنامج التشغيل file للتخزبن المؤقت، يسجل هذا المشغل الكائنات المخزّنة بطريقة متسلسلة في نظام الملفات. بالنسبة للتطبيقات الكبيرة، ...

(PHP 4, PHP 5, PHP 7) تستخدم بنية declare لتعيين موجّهات التنفيذ (execution directives) لكتلة من الشيفرة، وصيغة declare مشابهة لبنى التحكم في تدفق الشيفرة. الوصف declare (directive) statement يتيح الموجه تعيين سلوك كتلة (block). يمكن للغة في الوقت الحاضر أن تتعرف على ثلاثة أنواع من الموجهات فقط: موجه ticks (للمزيد من المعلومات حول موجه ticks انظر أدناه)، وموجه encoding (للمزيد من المعلومات حول موجه encoding انظر أدناه)، وموجه strict_types (للمزيد من المعلومات راجع قسم strict في ...

(PHP 4, PHP 5, PHP 7) تستخدم بنية declare لتعيين موجّهات التنفيذ (execution directives) لكتلة من الشيفرة، وصيغة declare مشابهة لبنى التحكم في تدفق الشيفرة. الوصف declare (directive) statement يتيح الموجه تعيين سلوك كتلة (block). يمكن للغة في الوقت الحاضر أن تتعرف على ثلاثة أنواع من الموجهات فقط: موجه ticks (للمزيد من المعلومات حول موجه ticks انظر أدناه)، وموجه encoding (للمزيد من المعلومات حول موجه encoding انظر أدناه)، وموجه strict_types (للمزيد من المعلومات راجع قسم strict في ...

يتحقق التابع setuid?‎ إن كان البت uid (بت معرِّف المستخدم المالك) مضبوطًا للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة setuid? → true or false القيمة المعادة تعاد القيمة true إن كان البت uid (بت معرِّف المستخدم المالك) مضبوطًا للملف الذي يشير إليه الكائن File::Stat، أو تعاد القيمة false إن لم يكن ذلك البت مضبوطًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع setuid?‎: File.stat("/bin/su").setuid? #=> true انظر أيضًا التابع executable?‎: يتحقق إن كان الملف الذي يشير إليه ...

يتحقق التابع writable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. البنية العامة writable? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع writable?‎: انظر أيضًا التابع readable?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف ...

يشبه التابع executable_real?‎ التابع executable?‎ تمامًا باستثناء أنه يجري عملية التحقق باستعمال المعرِّف الحقيقي لمالك العملية. البنية العامة executable_real? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للتنفيذ أو إن كان نظام التشغيل لا يفرِّق بين الملفات القابلة للتنفيذ من الملفات الغير قابلة للتنفيذ. خلا ذلك، تعاد القيمة false. انظر أيضا التابع executable?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat الذي استدعي معه قابلًا للتنفيذ أو إن كان نظام ...

يعيد التابع ctime وقت آخر تغيير أجري على الملف الذي استدعي معه. يشير وقت التغيير هذا إلى الزمن الذي تغيرت فيه معلومات المجلد حول الملف وليس الملف نفسه. البنية العامة ctime → aTime القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت آخر تغيير جرى للمعلومات حول الملف المعطى. في أنظمة ويندوز (أي أنظمة الملفات NTFS)، يعاد وقت إنشاء الملف وليس وقت التغيير. أمثلة مثال على استعمال التابع ctime: File.stat("testfile").ctime #=> Wed Apr 09 08:53:14 CDT 2003 انظر أيضًا التابع atime: يعيد زمن ...

يعيد التابع gid المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة gid → integer القيمة المعادة يعاد عدد صحيح يمثِّل المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال المعامل gid: File.stat("testfile").gid #=> 500 انظر أيضا التابع uid: يعيد المعرِّف الرقمي للمستخدم المالك للملف الذي يشير إليه الكائن File::Stat المعطى. التابع birthtime: يعيد وقت إنشاء الملف الذي استدعي معه. التابع blocks: يعيد عدد كتل نظام الملفات المحجوزة للملف ...

يتحقق التابع directory?‎ إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون كائنًا من النوع IO. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?‎: File.directory?(".") انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

يعيد التابع dev عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. البنية العامة dev → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع dev: File.stat("testfile").dev #=> 774 انظر أيضًا التابع dev_major: يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، أو يعيد القيمة nil. التابع dev_minor: يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، أو يعيد القيمة nil. التابع rdev: يعيد ...

يعيد التابع mode عددًا صحيحًا يمثِّل بتات الأذونات للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة mode → integer القيمة المعادة يعاد عدد صحيح يمثِّل بتات الأذونات للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع mode: File.chmod(0644, "testfile") #=> 1 s = File.stat("testfile") sprintf("%o", s.mode) #=> "100644" انظر أيضًا التابع ctime: يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه. التابع gid: يعيد المعرِّف الرقمي للمجموعة ...

يتحقق التابع size?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعيد التابع حجم هذا الملف. البنية العامة size? → Integer or nil القيمة المعادة تعاد القيمة nil إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعاد عدد صحيح يمثِّل حجم هذا الملف. انظر أيضًا التابع size: يعيد حجم الملف الذي يشير إليه الكائن File::Stat المعطى. ...

يعيد التابع rdev_major عددًا صحيحًا يمثِّل الجزء الكبير (major part) من rdev، أو يعيد القيمة nil. البنية العامة rdev_major → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجزء الكبير (major part) من rdev، أو تعاد القيمة nil. أمثلة مثال على استعمال التابع rdev_major: File.stat("/dev/fd1").rdev_major #=> 2 File.stat("/dev/tty").rdev_major #=> 5 انظر أيضًا التابع dev_major: يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، أو يعيد القيمة nil. التابع rdev: يعيد عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه ...

يتحقق التابع blockdev?‎ إن كان ملفٌ ما هو جهاز كتلي (block device). البنية العامة blockdev? → true or false القيمة المعادة تعاد القيمة true إن كان الملف المعطى هو جهاز كتلي (block device)، أو تعاد القيمة false إن لم يكن الملف جهازًا كتليًّا أو لم تكن منصة التشغيل تدعم هذه الميزة. أمثلة مثال على استعمال التابع blockdev?‎: File.stat("testfile").blockdev? #=> false File.stat("/dev/hda1").blockdev? #=> true انظر أيضا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). مصادر قسم التابع blockdev?‎ في ...

يعيد التابع rdev عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. البنية العامة rdev → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل نوع الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه، أو تعاد القيمة nil إن كان نظام التشغيل لا يدعم هذه الميزة آنذاك. أمثلة مثال على استعمال التابع rdev: File.stat("/dev/fd1").rdev #=> 513 File.stat("/dev/tty").rdev #=> 1280 انظر أيضًا التابع dev: يعيد عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat ...

يعيد التابع ino رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة ino → integer القيمة المعادة يعاد عدد صحيح يمثِّل رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع ino: File.stat("testfile").ino #=> 1083669 انظر أيضا التابع blksize: يعيد حجم كتلة نظام الملفات الأساسي. التابع ftype: يعرِّف نوع الملف الذي يشير إليه الكائن File::Stat المعطى. التابع gid: يعيد المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. ...

يتحقق التابع sticky?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قد ضُبِط فيه البت اللاصق (sticky bit). البنية العامة sticky? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قد ضُبِط فيه البت اللاصق (sticky bit)، أو تعاد القيمة false إن لم يكن البت مضبوطًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع sticky?‎: File.stat("testfile").sticky? #=> false انظر أيضًا التابع owned?‎: يتحقق إن ...

يتحقق التابع world_writable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى  قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable? → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف الذي يشير إليه الكائن File::Stat المعطى إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالةstat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_writable?‎: m = File.stat("/tmp").world_writable? #=> 511 sprintf("%o", m) ...

يعيد التابع blocks عدد كتل نظام الملفات المحجوزة للملف الذي استدعي معه. البنية العامة blocks → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل عدد كتل نظام الملفات المحجوزة للملف المعطى، أو تعاد القيمة nil إن لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع blocks: File.stat("testfile").blocks #=> 2 انظر أيضا التابع birthtime: يعيد وقت إنشاء الملف الذي استدعي معه. التابع blksize: يعيد حجم كتلة نظام الملفات الأساسي. مصادر قسم التابع blocks في الصنف File::Stat ...

يتحقق التابع executable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat الذي استدعي معه قابلًا للتنفيذ أو إن كان نظام التشغيل لا يفرِّق بين الملفات القابلة للتنفيذ من الملفات الغير قابلة للتنفيذ. تُجرَى عملية التحقق هذه باستعمال المعرِّف الفعلي لمالك العملية. البنية العامة executable? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للتنفيذ أو إن كان نظام التشغيل لا يفرِّق بين الملفات القابلة للتنفيذ من الملفات الغير قابلة للتنفيذ. خلا ...

يتحقق التابع world_readable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى  قابلًا للقراءة من طرف الآخرين. البنية العامة world_readable? → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف الذي يشير إليه الكائن File::Stat المعطى إن كان قابلًا للقراءة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالةstat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_readable?‎: m = File.stat("/etc/passwd").world_readable? #=> 420 sprintf("%o", m) ...

يتحقق التابع file?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى موجودًا وكان ملفًا طبيعيًّا (وليس جهازًا أو أنبوبًا أو مقبسًا ...إلخ.). البنية العامة file? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى موجودًا وكان ملفًا طبيعيًّا (وليس جهازًا أو أنبوبًا أو مقبسًا ...إلخ.). خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع file?‎: File.stat("testfile").file? #=> true انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

توفر الوحدة File::Constants ثوابت متعلقة بالملفات في روبي. جميع ثوابت الملفات المحتملة موثَّقة هنا ولكن ليس بالضرورة أن تكون كلها متاحة على منصتك. إن كانت المنصة الأساسية لا تعرِّف ثابتًا ما، فلن يُعرَّف ثابت روبي المقابل له. قد تجد بعض المعلومات المفيدة في توثيقات المنصة التي تعمل عليها (مثل الدليل man للدالة open(2)‎). الثوابت APPEND الإضافة عند كل عملية كتابة. BINARY تعطيل تحويل الشيفرة السطري. CREAT إنشاء ملف إن لم يكن موجودًا. DIRECT محاولة تصغير ثأتيرات الذاكرة المخبَّأة (cache) للدخل ...

يتحقق التابع pipe?‎ إن كان يدعم نظام التشغيل الحالي الأنابيب وكان الملف الذي يشير إليه الكائن File::Stat المعطى أنبوبًا. البنية العامة pipe? → true or false القيمة المعادة تعاد القيمة true إن كان يدعم نظام التشغيل الحالي الأنابيب وكان الملف الذي يشير إليه الكائن File::Stat المعطى أنبوبًا. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع ...

يتحقق التابع writable_real?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. البنية العامة writable_real? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع chardev?‎: File.stat("testfile").writable_real? #=> true انظر أيضًا التابع readable_real?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى ...

يعيد التابع birthtime وقت إنشاء الملف الذي استدعي معه. إن لم تكن المنصة المستعملة تدعم تسجيل وقت الإنشاء، فسيُرمَى الاستثناء NotImplementedError. البنية العامة birthtime → aTime القيمة المعادة يعاد كائن من النوع Time يمثِّل الزمن الذي أُنشئ فيه الملف المعطى.  أمثلة مثال على استعمال التابع birthtime: File.write("testfile", "foo") sleep 10 File.write("testfile", "bar") sleep 10 File.chmod(0644, "testfile") sleep 10 File.read("testfile") File.stat("testfile").birthtime #=> 2014-02-24 11:19:17 +0900 File.stat("testfile").mtime #=> 2014-02-24 11:19:27 +0900 File.stat("testfile").ctime #=> 2014-02-24 11:19:37 +0900 File.stat("testfile").atime ...

يعيد التابع blksize حجم كتلة نظام الملفات الأساسي. البنية العامة blksize → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل حجم كتلة نظام الملفات الأساسي، أو تعاد القيمة nil إن لم تكن منصة التشغيل تدعم توريد هذه المعلومات. أمثلة مثال على استعمال التابع blksize: File.stat("testfile").blksize #=> 4096 انظر أيضا التابع atime: يعيد زمن آخر وصول إلى الملف الذي استدعي معه. التابع blocks: يعيد عدد كتل نظام الملفات المحجوزة للملف الذي استدعي معه. مصادر قسم التابع blksize في الصنف ...

يتحقق التابع zero?‎ إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). البنية العامة zero? → true or false القيمة المعادة تعاد القيمة true إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع zero?‎: File.stat("testfile").zero? #=> false انظر أيضًا التابع size: يعيد حجم الملف الذي يشير إليه الكائن File::Stat المعطى. التابع size?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat ...

يعيد التابع uid المعرِّف الرقمي للمستخدم المالك للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة uid → integer القيمة المعادة يعاد عدد صحيح يمثِّل المعرِّف الرقمي للمستخدم المالك للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع uid: File.stat("/dev/fd1").rdev_minor #=> 1 File.stat("/dev/tty").rdev_minor #=> 0 انظر أيضًا التابع gid: يعيد المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. التابع ino: يعيد رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. التابع ...

يتحقق التابع chardev?‎ إن كان ملفٌ ما هو جهاز محرفي (character device). البنية العامة chardev? → true or false القيمة المعادة تعاد القيمة true إن كان الملف المعطى هو جهاز محرفي (character device)، أو تعاد القيمة false إن لم يكن الملف جهازًا كتليًّا أو لم تكن منصة التشغيل تدعم هذه الميزة. أمثلة مثال على استعمال التابع chardev?‎: File.stat("/dev/tty").chardev? #=> true انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). مصادر قسم التابع chardev?‎ في الصنف File::Stat في توثيق روبي ...

يتحقق التابع readable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. البنية العامة readable? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع readable?‎: File.stat("testfile").readable? #=> true انظر أيضًا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). ...

يتحقق التابع grpowned?‎ إن كان معرِّف المجموعة المالكة الفعلي للعملية التي استدعت التابع هو نفس معرِّف المجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة grpowned? → true or false القيمة المعادة تعاد القيمة true إن كان معرِّف المجموعة المالكة الفعلي للعملية التي استدعت التابع هو نفس معرِّف المجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. خلا ذلك، تعاد القيمة false. تعاد القيمة false دومًا على أنظمة ويندوز. أمثلة مثال على استعمال التابع grpowned?‎: File.stat("testfile").grpowned? #=> true File.stat("/etc/passwd").grpowned? ...

يعيد التابع dev_major عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، أو يعيد القيمة nil. البنية العامة dev_major → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجزء الكبير (major part) من dev، أو تعاد القيمة nil. أمثلة مثال على استعمال التابع dev_major: File.stat("/dev/fd1").dev_major #=> 2 File.stat("/dev/tty").dev_major #=> 5 انظر أيضًا التابع dev: يعيد عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. التابع dev_minor: يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، ...

التابع Path.is_fileفي بايثون يحدد هذا التابع فيما إذا كان المسار يشير إلى مجلد أو إلى غيره، وذلك باستخدامه للتابع stat ثم تمرير العنصر st_mode إلى التابع S_ISDIR من الوحدة stat، ويمكن رؤية ذلك ضمنالشيفرة المصدرية للمكتبة في السطر التالي: return S_ISREG(self.stat().st_mode) البنية العامة is_file() المعاملات بدون معاملات القيمة المعادة يعيد هذا التابع القيمة المنطقية True إذا كان المسار يشير إلى ملف نظامي(أو إلى اختصار يشير إلى ملف نظامي)، بينما يعيد False في حال كان المسار يشير إلى أي نوع آخر من الملفات. كما أنه يعيد False إذا كان ...

يعيد التابع nlink عدد الوصلات الصلبة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة nlink → integer القيمة المعادة يعاد عدد صحيح يمثِّل عدد الوصلات الصلبة للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع nlink: File.stat("testfile").nlink #=> 1 File.link("testfile", "testfile.bak") #=> 0 File.stat("testfile").nlink #=> 2 انظر أيضًا التابع ftype: يعرِّف نوع الملف ...

يعرِّف التابع ftype نوع الملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة ftype → string القيمة المعادة تعاد سلسلة نصية تحدَّد نوع الملف الذي يشير إليه الكائن File::Stat المعطى. تكون هذه السلسلة النصية المعادة إحدى السلاسل النصية التالية: "file''، أو "directory''، أو "characterSpecial''، أو "blockSpecial''، أو "fifo''، أو "link''، أو "socket''، أو "unknown''. أمثلة مثال على استعمال التابع ftype: File.stat("/dev/tty").ftype #=> "characterSpecial" انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). التابع chardev?‎: يتحقق إن ...

تتضمن كائنات الصنف File::Stat معلومات حول حالة الكائنات File. تُسجَل هذه المعلومات في الوقت الذي يُنشَأ فيه الكائن File::Stat؛ لذا، لن يُحدَّث هذا الكائن بالحالة الجديدة إن أجري أي تعديل على الملف بعد هذه النقطة من الزمن. تعاد الكائنات File::Stat باستدعاء IO.stat، و File.stat، و File.lstat، و File::stat، و File::lstat. تعيد أغلب هذه التوابع قيمًا تتعلق بالمنصة المستعملة، وليست جميع القيم ذات معنًى في كل أنظمة التشغيل. اطلع على التابع Kernel.test. توابع الصنف العامة new ينشئ كائنًا جديدًا من النوع ...

يتحقق التابع owned?‎ إن كان معرِّف مالك الملف الذي يشير إليه الكائن File::Stat المعطى هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. البنية العامة owned? → true or false القيمة المعادة تعاد القيمة true إن كان معرِّف مالك الملف الذي يشير إليه الكائن File::Stat المعطى هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع owned?‎: File.stat("testfile").owned? #=> true File.stat("/etc/passwd").owned? #=> false انظر أيضًا التابع blockdev?‎: ...

يعيد التابع atime زمن آخر وصول إلى الملف الذي استدعي معه. البنية العامة atime → time القيمة المعادة يعاد كائن من النوع Time يمثِّل زمن آخر وصول للملف المعطى. أمثلة مثال على استعمال التابع atime: File.stat("testfile").atime #=> Wed Dec 31 18:00:00 CST 1969 انظر أيضًا التابع ctime: يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه. التابع mtime: يعيد وقت التعديل للملف الذي يشير إليه الكائن File::Stat المعطى. التابع ino: يعيد رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. ...

يتحقق التابع symlink?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى وصلةً رمزيًّةً. لمَّا كان الكائن File::Stat يتبع الوصلات الرمزية تلقائيًّا، فسيعيد التابع symlink?‎ القيمة false دومًا للكائن المعاد من طرف File::Stat. البنية العامة symlink? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى وصلةً رمزيًّةً، أو تعاد القيمة false إن لم يكن الملف وصلةً رمزيةً أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع symlink?‎: File.symlink("testfile", ...

يتحقق التابع readable_real?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. البنية العامة readable_real? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع readable_real?‎: File.stat("testfile").readable_real? #=> true انظر أيضًا التابع executable_real?‎: يشبه التابع executable?‎ تمامًا باستثناء أنه يجري عملية التحقق باستعمال المعرِّف ...

يعيد التابع size حجم الملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف الذي يشير إليه الكائن File::Stat المعطى بالبايت. أمثلة مثال على استعمال التابع size: File.stat("testfile").size #=> 66 انظر أيضًا التابع size?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. التابع zero?‎: يتحقق إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). مصادر قسم التابع size ...

يعيد التابع dev_minor عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، أو يعيد القيمة nil. البنية العامة dev_minor → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجزء الصغير (minor part) من dev، أو تعاد القيمة nil. أمثلة مثال على استعمال التابع dev_minor: File.stat("/dev/fd1").dev_minor #=> 1 File.stat("/dev/tty").dev_minor #=> 0 انظر أيضا التابع dev: يعيد عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. التابع dev_major: يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، ...

يعيد التابع rdev_minor عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من rdev، أو يعيد القيمة nil. البنية العامة rdev_minor → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجزء الصغير (minor part) من rdev، أو تعاد القيمة nil. أمثلة مثال على استعمال التابع rdev_minor: File.stat("/dev/fd1").rdev_minor #=> 1 File.stat("/dev/tty").rdev_minor #=> 0 انظر أيضًا التابع dev_minor: يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، أو يعيد القيمة nil. التابع rdev: يعيد عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه ...

يتحقق التابع socket?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى مقبسًا. البنية العامة socket? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى مقبسًا، أو تعاد القيمة false إن لم يكن الملف مقبسًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع socket?‎: File.stat("testfile").socket? #=> false انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع symlink?‎: يتحقق ...

ينشئ التابع new كائنًا جديدًا من النوع File::Stat لاسم الملف المعطى. سيُرمَى استثناءٌ إلى لم يكن ذلك الملف المعطى موجودًا. البنية العامة File::Stat.new(file_name) → stat المعاملات file_name اسم الملف المراد إنشاء كائن الحالة File::Stat له. القيمة المعادة يعاد كائن جديد من النوع File::Stat للملف file_name. انظر أيضا المعامل <=>: يوازن بين الكائنات File::Stat من ناحية أوقات تعديل كل منها. التابع atime: يعيد زمن آخر وصول إلى الملف الذي استدعي معه. التابع birthtime: يعيد وقت إنشاء الملف الذي استدعي معه. مصادر قسم ...

يولد التابع inspect وصفًا منسقًا بطريقة سهلة القراءة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة inspect → string القيمة المعادة تعاد سلسلة نصية تحوي وصفًا منسقًا بطريقة سهلة القراءة للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع inspect: File.stat("/etc/passwd").inspect #=> "#<File::Stat dev=0xe000005, ino=1078078, mode=0100644, # nlink=1, uid=0, gid=0, rdev=0x0, size=1374, blksize=4096, # blocks=8, atime=Wed Dec 10 10:16:12 CST 2003, # ...

يتحقق التابع setgid?‎ إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة setgid? → true or false القيمة المعادة تعاد القيمة true إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف الذي يشير إليه الكائن File::Stat، أو تعاد القيمة false إن لم يكن ذلك البت مضبوطًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع setgid?‎: File.stat("/usr/sbin/lpc").setgid? #=> true انظر أيضًا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

يعيد التابع mtime وقت التعديل للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة mtime → aTime القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت تعديل للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع mtime: File.stat("testfile").mtime #=> Wed Apr 09 08:53:14 CDT 2003 انظر أيضًا التابع atime: يعيد زمن آخر وصول إلى الملف الذي استدعي معه. التابع ctime: يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه. التابع inspect: يولد وصفًا منسقًا بطريقة سهلة القراءة للملف ...

نماذج HTML‏ (GET و POST) عند إرسال نموذج إلى شيفرة PHP، فإن المعلومات القادمة من ذاك النموذج تصبح متاحةً بصورة تلقائية للشيفرة. وهناك عدد من الطرائق التي يمكن من خلالها الوصول إلى هذه المعلومات. المثال 1: نموذج HTML بسيط <form action="foo.php" method="post"> Name: <input type="text" name="username" /><br /> Email: <input type="text" name="email" /><br /> <input type="submit" name="submit" value="Submit me!" /> </form> منذ الإصدار 5.4.0، أصبح هناك طريقتان للوصول إلى البيانات التابعة ...

نماذج HTML‏ (GET و POST) عند إرسال نموذج إلى شيفرة PHP، فإن المعلومات القادمة من ذاك النموذج تصبح متاحةً بصورة تلقائية للشيفرة. وهناك عدد من الطرائق التي يمكن من خلالها الوصول إلى هذه المعلومات. المثال 1: نموذج HTML بسيط <form action="foo.php" method="post"> Name: <input type="text" name="username" /><br /> Email: <input type="text" name="email" /><br /> <input type="submit" name="submit" value="Submit me!" /> </form> منذ الإصدار 5.4.0، أصبح هناك طريقتان للوصول إلى البيانات التابعة ...

مقدمة يقدم Laravel محرّك قولبةٍ بسيطاً لكن قويٌّ و فعّال هو Blade. على خلاف محرّكات PHP أخرى، لا يمنع Blade المستخدم من استعمال شيفرات PHP في الواجهة، بل إنّه يحوِِّل صفحات Blade إلى شيفرة PHP ويخزِّنها تخزينًا مؤقتًا إلى حين تغييرها. ممّا يعني أنّ Blade لا يتطلب أيّ جهد أو وقت إضافي من التطبيق. تنتهي صفحات Blade بالامتداد blade.php. وتوجد عادة في مجلد resources/views. توريث القوالب تعريف التخطيط إنّ من الفوائد الأساسية لاستخدام Blade هي توريث القوالب (template inheritance) واستخدام ...

مقدمة يقدم Laravel محرّك قولبةٍ بسيطاً لكن قويٌّ و فعّال هو Blade. على خلاف محرّكات PHP أخرى، لا يمنع Blade المستخدم من استعمال شيفرات PHP في الواجهة، بل إنّه يحوِِّل صفحات Blade إلى شيفرة PHP ويخزِّنها تخزينًا مؤقتًا إلى حين تغييرها. ممّا يعني أنّ Blade لا يتطلب أيّ جهد أو وقت إضافي من التطبيق. تنتهي صفحات Blade بالامتداد blade.php. وتوجد عادة في مجلد resources/views. توريث القوالب تعريف التخطيط إنّ من الفوائد الأساسية لاستخدام Blade هي توريث القوالب (template inheritance) واستخدام ...

إنشاء الردود السلاسل النصيّة والمصفوفات يجب على جميع الطرق ووحدات التحكّم رد استجابة لإرسالها مرّة أخرى إلى متصفّح المستخدم. يوفر Laravel عدة طرق مختلفة لإرجاع الردود. أكثر رد أساسي هو رد سلسلة نصيّة من مسار أو جهاز تحكّم. سيُحوّل إطار العمل السلسلة النصيّة إلى استجابة HTTP كاملة تلقائيًا: Route::get('/', function () { return 'Hello World'; }); يمكنك بالإضافة لرد السلاسل من مساراتك ووحدات تحكّمك رد مصفوفات. سيُحوّل إطار العمل تلقائيًا المصفوفة لاستجابة JSON: Route::get('/', function () { ...

(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()‎، ...

(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 مُفَعلة ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى عدد صحيح. البنية العامة getint(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى عدد صحيح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getint('topsecret.server.com', 'Port') 50022 انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. التابع getfloat()‎: تابع مساعد وظيفته تحويل ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى عدد عشري ذي فاصلة عائمة. البنية العامة getfloat(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى عدد عشري ذي فاصلة عائمة. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getfloat('topsecret.server.com', 'php_version') 7.1 انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى قيمة منطقية (بوليانية). البنية العامة getboolean(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى قيمة منطقية (بوليانية). أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getboolean('topsecret.server.com', 'ForwardX11') False >>> config.getboolean('topsecret.server.com', 'Compression') True انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. التابع getint()‎: ...