نتائج البحث

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

الوحدة GC::Profiler في روبي

يوفر مُنشئ ملفات تعريف جمع البيانات المهملة GC::Profiler الوصول إلى معلومات عن تشغيلات GC بما في ذلك الوقت والطول وحجم مساحة الكائن. اطلع مثلًا على المثال التالي: GC::Profiler.enable require 'rdoc/rdoc' GC::Profiler.report GC::Profiler.disable اطلع أيضًا على صفحات التوابع GC.count و GC.malloc_allocated_size و GC.malloc_allocations. توابع الصنف العام clear يمسح بيانات مُنشئ ملفات تعريف GC. disable يوقف مُنشئ ملفات تعريف GC. enable يبدأ منشئ ملفات تعريف GC. enabled?‎ يتحقق من الحالة الحالية لوضع مُنشئ ملفات تعريف GC. raw_data يعيد مصفوفة من الأنواع Hash تحوي بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى ...

الوحدة GC في روبي

توفر الوحدة GC واجهةً لتحديد ومسح آلية جمع البيانات المهملة (garbage collection) في روبي. تتوفر أيضًا بعض التوابع الأساسية من خلال الوحدة ObjectSpace. يمكن الحصول على المزيد من المعلومات حول تشغيل الوحدة GC من خلال الوحدة GC::Profiler. الثوابت INTERNAL_CONSTANTS OPTS توابع الصنف العامة add_stress_to_class count يعدُّ عدد مرات حدوث الوحدة GC. disable يعطِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. enable يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. latest_gc_info يعيد معلومات حول أحدث ...

التابع GC::Profiler.clear في روبي

يمسح التابع clear بيانات مُنشئ ملفات تعريف GC. البنية العامة GC::Profiler.clear → nil القيمة المعادة تعاد القيمة nil عند اكتمال تنفيذ العملية. انظر أيضا التابع disable: يوقف مُنشئ ملفات تعريف GC. التابع total_time: يعيد إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني. مصادر قسم التابع clear في الصنف GC::Profiler في توثيق روبي الرسمي.

التابع GC::Profiler.enable في روبي

يبدأ التابع enable منشئ ملفات تعريف GC. البنية العامة GC::Profiler.enable → nil القيمة المعادة تعاد القيمة nil عند اكتمال تنفيذ العملية.   انظر أيضا التابع disable: يوقف مُنشئ ملفات تعريف GC. التابع enabled?‎: يتحقق من الحالة الحالية لوضع مُنشئ ملفات تعريف GC. مصادر قسم التابع enable في الصنف GC::Profiler في توثيق روبي الرسمي.

التابع GC::Profiler.disable في روبي

يوقف التابع disable مُنشئ ملفات تعريف GC. البنية العامة GC::Profiler.disable → nil القيمة المعادة تعاد القيمة nil عند اكتمال تنفيذ العملية.  انظر أيضا التابع enable: يبدأ منشئ ملفات تعريف GC. التابع enabled?‎: يتحقق من الحالة الحالية لوضع مُنشئ ملفات تعريف GC. مصادر قسم التابع disable في الصنف GC::Profiler في توثيق روبي الرسمي.

التابع GC::Profiler.report في روبي

يكتب التابع report الناتج ‎::result على المجرى ‎$stdout أو كائن من النوع IO. البنية العامة GC::Profiler.report GC::Profiler.report(io) المعاملات io كائن من النوع IO يراد كتابة الناتج فيه. انظر أيضا التابع result: يعيد تقرير بيانات ملف التعريف. التابع total_time: يعيد إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني. مصادر قسم التابع report في الصنف GC::Profiler في توثيق روبي الرسمي.

التابع GC::Profiler.enabled?‎ في روبي

يتحقق التابع enabled?‎ من الحالة الحالية لوضع مُنشئ ملفات تعريف GC. البنية العامة GC::Profiler.enabled? → true or false القيمة المعادة تعاد القيمة true إن كان مُنشئ ملفات تعريف GC مفعَّلًا. خلا ذلك، تعاد القيمة false. انظر أيضا التابع disable: يوقف مُنشئ ملفات تعريف GC. التابع enable: يبدأ منشئ ملفات تعريف GC. مصادر قسم التابع enabled?‎ في الصنف GC::Profiler في توثيق روبي الرسمي.

التابع GC::Profiler.total_time في روبي

يعيد التابع total_time إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني. البنية العامة GC::Profiler.total_time → float القيمة المعادة يعاد عدد عشري يمثِّل إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني. انظر أيضا التابع report: يكتب الناتج ‎::result على المجرى ‎$stdout أو كائن من النوع IO. التابع result: يعيد تقرير بيانات ملف التعريف. مصادر قسم التابع total_time في الصنف GC::Profiler في توثيق روبي الرسمي.

التابع GC::Profiler.result في روبي

يعيد التابع result تقرير بيانات ملف التعريف. البنية العامة GC::Profiler.result → String القيمة المعادة يعاد تقرير بيانات ملف التعريف مثل: GC 1 invokes. Index Invoke Time(sec) Use Size(byte) Total Size(byte) Total Object GC time(ms) 1 ...

التابع GC::Profiler.raw_data في روبي

يعيد التابع raw_data مصفوفة من الأنواع Hash تحوي بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى الأحدث بواسطة ‎:GC_INVOKE_TIME. إليك مثلًا الشيفرة التالية: [ { :GC_TIME=>1.3000000000000858e-05, :GC_INVOKE_TIME=>0.010634999999999999, :HEAP_USE_SIZE=>289640, :HEAP_TOTAL_SIZE=>588960, :HEAP_TOTAL_OBJECTS=>14724, :GC_IS_MARKED=>false }, # ... ] وتعني المفاتيح الموجودة في الشيفرة ما يلي: ‎:GC_TIME: الوقت Time المنقضي بالثواني لتشغيل GC هذا. ‎:GC_INVOKE_TIME: الوقت Time المنقضي بالثواني ...

التابع GC.stress في روبي

يعيد التابع stress الحالة الحالية لوضع الضغط الذي يخص جامع البيات المهملة GC. البنية العامة stress → integer, true or false القيمة المعادة تعاد الحالة الحالية لوضع الضغط الذي يخص جامع البيات المهملة GC. انظر أيضا التابع stress: يحدِّث عند استدعائه بالشكل stress = flag وضع الضغط الذي يخص جامع البيانات المهملة GC. مصادر قسم التابع stress‎ في الصنف GC في توثيق روبي الرسمي.

التابع GC.stress في روبي

يحدِّث التابع stress عند استدعائه بالشكل stress = flag وضع الضغط الذي يخص جامع البيانات المهملة GC. عند تفعيل وضع الضغط، يُستدعى GC في كل فرصة يراد فيها جمع البيانات المهملة: كافة عمليات حجز الذاكرة والكائنات. سيؤدي تفعيل وضع الضغط إلى خفض الأداء، ويُستعمَل فقط للتنقيح. البنية العامة stress = flag → flag المعاملات flag يمكن أن تكون الراية flag هي القيمة true، أو القيمة false، أو عدد صحيح مُجرى على بِتاته العملية OR تبعًا للرايات: 0x01:: no major GC 0x02:: no ...

التابع GC.count في روبي

يعدُّ التابع count عدد مرات حدوث الوحدة GC. البنية العامة count → Integer القيمة المعادة يعاد عدد صحيح يمثِّل عدد مرات حدوث GC منذ بدء العملية. انظر أيضا التابع enable: يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. التابع malloc_allocations: يعيد عدد عمليات الحجز التي أجريت باستعمالmalloc()‎. مصادر قسم التابع count في الصنف GC في توثيق روبي الرسمي.

التابع GC.stat في روبي

يعيد التابع stat جدول Hash يحتوي على معلومات حول GC. ومن المتوقع أن يعمل هذا التابع فقط علي روبي C. البنية العامة stat → Hash stat(hash) → hash stat(:key) → Numeric القيمة المعادة يعاد جدول Hash يحوي معلومات حول GC. يتضمن الجدول معلومات حول الإحصائيات الداخلية حول GC مثل: { :count=>0, :heap_allocated_pages=>24, :heap_sorted_length=>24, :heap_allocatable_pages=>0, :heap_available_slots=>9783, :heap_live_slots=>7713, :heap_free_slots=>2070, :heap_final_slots=>0, ...

التابع Object.garbage_collect في روبي

يبدأ التابع garbage_collect عملية جمع المهملات (garbage collection)، إلّا إذا عُطِّلت يدويًا. يُعرَّف هذا التابع عبر وسائط الكلمات المفتاحية (keyword arguments) المُعيَّنة افتراضيًا للقيمة true: def GC.start(full_mark: true, immediate_sweep: true); end يمكنك تعيين القيمة false للمعامل full_mark لتنفيذ الوحدة GC الثانوية. ويمكنك تعيين القيمة false للمعامل immediate_sweep لتأجيل الكنس (sweeping، استخدام الكنس الكسول [lazy sweep]). ملاحظة: تعتمد وسائط الكلمات المفتاحية على التطبيق والاصدار المُستخدم من روبي. لا يُضمن أن تبقى متوافقةً مستقبلًا، وقد يتم تجاهلها إذا كان التطبيق الأساسي لا يدعمها. ...

التابع GC.garbage_collect في روبي

يبدأ التابع garbage_collect تجميع البيانات المهملة، ما لم تُعطَّل يدويًا. عُرِّف هذا التابع مع وسائط مسماة قِيَمَها الافتراضية هي true: def GC.start(full_mark: true, immediate_sweep: true); end ملاحظة: تعتمد الوسائط المسماة هذه على التنفيذ والإصدار المستعمل. ولا يُضمن أن تظل متوافقة في المستقبل، ويمكن تجاهلها إذا كان التنفيذ الأساسي لا يدعمها. البنية العامة garbage_collect → nil include GC; garbage_collect → nil garbage_collect(full_mark: true, immediate_sweep: true) → nil المعاملات full_mark استعمل القيمة false مع هذا المعامل لتنفيذ عملية GC ثانوية. القيمة الافتراضية هي: true. immediate_sweep استعمل ...

التابع GC.verify_internal_consistency في روبي

يتحقَّق التابع verify_internal_consistency من الاتساق الداخلي. هذا التابع خاص بالتنفيذ. يتحقق هذا التابع الآن من تناسق الأجيال (generational consistency) إذا كان RGenGC مدعومًا. البنية العامة verify_internal_consistency → nil القيمة المعادة تعاد القيمة nil بعد اكتمال تنفيذ العملية. انظر أيضا التابع latest_gc_info: يعيد معلومات حول أحدث عملية جمعٍ للبيانات المهملة. التابع stat: يعيد جدول Hash يحتوي على معلومات حول GC. ومن المتوقع أن يعمل هذا التابع فقط علي روبي C. مصادر قسم التابع verify_internal_consistency‎ في الصنف GC في توثيق روبي الرسمي.

التابع GC.start في روبي

يبدأ التابع start تجميع البيانات المهملة، ما لم تُعطَّل يدويًا. عُرِّف هذا التابع مع وسائط مسماة قِيَمَها الافتراضية هي true: def GC.start(full_mark: true, immediate_sweep: true); end ملاحظة: تعتمد الوسائط المسماة هذه على التنفيذ والإصدار المستعمل. ولا يُضمن أن تظل متوافقة في المستقبل، ويمكن تجاهلها إذا كان التنفيذ الأساسي لا يدعمها. البنية العامة start → nil start(full_mark: true, immediate_sweep: true) → nil المعاملات full_mark استعمل القيمة false مع هذا المعامل لتنفيذ عملية GC ثانوية. القيمة الافتراضية هي: true. immediate_sweep استعمل القيمة false مع هذا ...

التابع File.split في روبي

يقتطع التابع split مسار الملف المُمرَّر إليه إلى جزأين: أحدهما لمجلد، والآخر للملف ثم يعيدهما في مصفوفة. البنية العامة split(file_name) → array المعاملات file_name اسم أو مسار الملف الذي ستُجرَى عليه العملية. القيمة المعادة تعاد مصفوفة من عنصرين تحوي ناتج اقتطاع المعامل file_name إلى جزأين: أحدهما لمجلد، والآخر لملف. أمثلة مثال على استعمال التابع split: File.split("/home/gumby/.profile") #=> ["/home/gumby", ".profile"] انظر أيضا التابع basename: يعيد آخر مكوِّن من مسار اسم الملف المعطى.  التابع dirname: يعيد جميع مكونات المسار المعطى لملفٍ ...

التابع File.fnmatch في روبي

يتحقق التابع fnmatch من تطابق مسار مع نمط محدَّد. هذا النمط ليس تعبيرًا نظاميًّا بل يتبع قواعد مشابهة لتعميم أسماء الملفات في الصدفة. البنية العامة fnmatch( pattern, path, [flags] ) → (true or false) fnmatch?( pattern, path, [flags] ) → (true or false) المعاملات pattern النمط المراد منه مطابقة المسار path المعطى. يمكن أن يحتوي على المحارف الخاصَّة (metacharacters، أو تدعى محارف الصدفة أيضًا) التالية: المحرف الخاص الوصف * يطابق أي ملف. يمكن أن يُقيَّد بقيم أخرى في النطاق العام (glob). هذا ...

التابع File.fnmatch?‎ في روبي

يتحقق التابع fnmatch?‎ من تطابق مسار مع نمط محدَّد. هذا النمط ليس تعبيرًا نظاميًّا بل يتبع قواعد مشابهة لتعميم أسماء الملفات في الصدفة. البنية العامة fnmatch?( pattern, path, [flags] ) → (true or false) المعاملات pattern النمط المراد منه مطابقة المسار path المعطى. يمكن أن يحتوي على المحارف الخاصَّة (metacharacters، أو تدعى محارف الصدفة أيضًا) التالية: المحرف الخاص الوصف * يطابق أي ملف. يمكن أن يُقيَّد بقيم أخرى في النطاق العام (glob). هذا المحرف يقابل ‎/ * /x‎. في التعابير النظامية. ...

التابع GC.remove_stress_to_class في روبي

البنية العامة remove_stress_to_class(*args) انظر أيضا التابع add_stress_to_class. التابع start: يبدأ تجميع البيانات المهملة، ما لم تُعطَّل يدويًا. مصادر قسم التابع remove_stress_to_class‎ في الصنف GC في توثيق روبي الرسمي.

التابع GC.add_stress_to_class في روبي

البنية العامة add_stress_to_class(*args) انظر أيضا التابع remove_stress_to_class. التابع enable: يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. التابع malloc_allocations: يعيد عدد عمليات الحجز التي أجريت باستعمالmalloc()‎. مصادر قسم التابع add_stress_to_class‎ في الصنف GC في توثيق روبي الرسمي.

التابع GC.malloc_allocated_size في روبي

يعيد التابع malloc_allocated_size حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. ويتوفر هذا التابع فقط إذا بُنيت روبي مع CALC_EXACT_MALLOC_SIZE. البنية العامة malloc_allocated_size → Integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. انظر أيضا التابع malloc_allocations: يعيد عدد عمليات الحجز التي أجريت باستعمال malloc()‎. مصادر قسم التابع malloc_allocated_size‎ في الصنف GC في توثيق روبي الرسمي.

التابع GC.malloc_allocations في روبي

يعيد التابع malloc_allocations عدد عمليات الحجز التي أجريت باستعمال malloc()‎. ويتوفر هذا التابع فقط إذا بُنيت روبي مع CALC_EXACT_MALLOC_SIZE. البنية العامة malloc_allocations → Integer القيمة المعادة يعاد عدد صحيح يمثِّل عمليات الحجز التي أجريت باستعمال malloc()‎. انظر أيضا التابع malloc_allocated_size: يعيد حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. مصادر قسم التابع malloc_allocations‎ في الصنف GC في توثيق روبي الرسمي.

Ruby/Topics

تثبيت روبي توجد طرائق عدَّة لتنزيل وتثبيت روبي على كل منصة وهي: إمَّا استعمال أنظمة مدير الحزم، أو باستعمال المثبِّتات التلقائية، أو باستعمال مدراء روبي. هنالك طريقة أخرى يمكنك بالتأكيد استعمالها لتثبيت روبي وتصريف شيفراتها وهي بنائها من الشيفرة المصدرية مباشرةً. حول روبي يوفر هذا القسم لمحة سريعة عن لغة روبي ونشأتها، وتطورها، ومزاياها التي انفردت بها عن اللغات الأخرى، والتنفيذات المختلفة التي تملكها. البنية العامة بنية اللغة تعد روبي مزيجًا من اللغات البرمجية التالية: Perl، و Smalltalk، و Eiffel، ...

التابع GC.disable في روبي

يعطِّل التابع disable جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. البنية العامة disable → true or false القيمة المعادة تعاد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع disable: GC.disable #=> false GC.disable #=> true انظر أيضا التابع enable: يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. مصادر قسم التابع disable‎ في الصنف GC في توثيق ...

التابع GC.enable في روبي

يفعِّل التابع enable جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. البنية العامة enable → true or false القيمة المعادة تعاد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع enable: GC.disable #=> false GC.enable #=> true GC.enable #=> false انظر أيضا التابع disable: يعطِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. مصادر قسم التابع ...

التابع GC.latest_gc_info في روبي

يعيد التابع latest_gc_info معلومات حول أحدث عملية جمعٍ للبيانات المهملة. البنية العامة latest_gc_info → {:gc_by=>:newobj} latest_gc_info(hash) → hash latest_gc_info(:major_by) → :malloc المعاملات hash كائن من النوع Hash. major_by: القيمة المعادة تعاد معلومات حول أحدث عملية جمعٍ للبيانات المهملة. انظر أيضا التابع enable: يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. التابع malloc_allocated_size: يعيد حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. مصادر قسم التابع latest_gc_info في الصنف GC في توثيق روبي الرسمي.

الدالة ()os.get_exec_path في بايثون

تُعيد الدالة قائمة بالمُجلَّدات التي سيتُم البحث فيها عن الملفات التنفيذيّة عند تشغيل عملية ما. البنية العامة get_exec_path(env=None) المعاملات env قاموس متغيّرات البيئة الذي سيُبحَث فيه عن المتغيّر PATH. تُسنَد القيمة None للوسيط env، ويُستخدَم القاموس os.environ للحصول على متغيّر البيئة PATH افتراضيًا. القيمة المعادة تُعيد الدالة قائمة بالمُجلَّدات التي سيتم البحث فيها عن الملفات التنفيذيّة، كما يحدث في الصدفة (shell)، عند تشغيل عملية ما. أمثلة يعرض المقتطف أدناه مثال عن استخدام الدالة للحصول على مسارات التي سيُبحَث فيها عن ...

الدالة ()os.get_exec_path في بايثون

تُعيد الدالة قائمة بالمُجلَّدات التي سيتُم البحث فيها عن الملفات التنفيذيّة عند تشغيل عملية ما. البنية العامة get_exec_path(env=None) المعاملات env قاموس متغيّرات البيئة الذي سيُبحَث فيه عن المتغيّر PATH. تُسنَد القيمة None للوسيط env، ويُستخدَم القاموس os.environ للحصول على متغيّر البيئة PATH افتراضيًا. القيمة المعادة تُعيد الدالة قائمة بالمُجلَّدات التي سيتم البحث فيها عن الملفات التنفيذيّة، كما يحدث في الصدفة (shell)، عند تشغيل عملية ما. أمثلة يعرض المقتطف أدناه مثال عن استخدام الدالة للحصول على مسارات التي سيُبحَث فيها عن ...

التابع File.extname في روبي

يعيد التابع extname لاحقة الملف المعطى. لاحقة الملف هي جزء من اسمه وتتوضع في مساره بعد آخر نقطة فيه. إن كان المسار هو لملف الملف يبدأ بنقطة (dotfile) أو يبدأ المسار بنقطة، فلن يعامل معها على أنها بداية لاحقة الملف. البنية العامة extname(path) → string المعاملات path مسار الملف المراد استخراج لاحقته. القيمة المعادة تعاد سلسلة نصية تمثِّل لاحقة الملف ذي المسار path، أو تعاد سلسلة نصية فارغة إن كان النقطة آخر المسار path أو لم يكن هنالك لاحقة للملف. أمثلة ...

ملفات تهيئة الصدفة

ملفات الإعدادات على مستوى النظام System-wide Configuration files الملف etc/profile/ تقرأ Bash التعليمات الموجودة في etc/profile/ إن استدعيْت بشكل تفاعلي عبر خيار login-- أو إن استدعيْت كـ sh ، تضبط تلك التعليمات عادة المتغيرات PATH - USER - MAIL - HOSTNAME - HISTSIZE ، وهي متغيرات تابعة للصدفة. كذلك تُضبط قيمة umask في etc/profile/ على بعض الأنظمة، أما في بعضها الآخر فإن هذا الملف يحتوي على موجّهات (pointers) لملفات الإعدادات الأخرى مثل: ملف etc/inputrc/ ، وهو ملف تهيئة على مستوى ...

التوجيه (Routing) في Laravel

التوجيه الأساسي تقبل أغلب مسارات Laravel الأساسيّة مُتغّيرين: رابط URI  و نطاق مغلق Closure مما يُوفّر طريقة بسيطة ومعبّرة جدّا لتعريف المسارات (routes): Route::get('foo', function () { return 'Hello World'; }); ملفات المسار الإفتراضيّة كل مسارات Laravel مُعرّفة في ملفات مساراتك الموجودة في المجلّد routes. يُحمّل إطار العمل كل هذه الملفّات تلقائيًا. يعرّف الملف routes/web.php كل المسارات المُخصّصة لواجهة الويب. مجموعة البرمجيّات الوسيطة web معيّنة على كل المسارات وتوفّر خاصيّات مثل حالة الجلسة (session state) والحماية CSRF. المسارات ...

الواجهات (Views) في Laravel

إنشاء الواجهات ملاحظة: هل تبحث عن مزيد من المعلومات حول كيفية كتابة قوالب Blade؟ ألق نظرة على توثيق Blade الكامل للبدء. تحتوي الواجهات على HTML الذي يُقدّمه تطبيقك وتفصل منطق وحدة التحكّم/منطق التطبيق من منطق عرضك التقديمي (presentation logic). تُخزّن الواجهات في المُجلّد resources/views. قد تشبه الواجهة البسيطة المثال التالي: <! - الواجهات مُخزّنة في resources/views/greeting.blade.php -> <html> <body> <h1>Hello, {{ $name }}</h1> </body> </html> كما ترى، يُوافق المّتغيّر الوسيط ...

وحدة المراقب (Inspector) في Node.js

مؤشر الاستقرار: 1 - تجريبي توفر وحدة المراقب inspector واجهة تطبيقات API للتفاعل مع المراقب V8. ويمكن الوصول إليه باستخدام: const inspector = require('inspector'); inspector.open([port[, host[, wait]]])‎ port من النوع <number>: منفذ الاستماع لاتصالات المراقب. اختياري. القيمة الافتراضية: ما تحدد في واجهة سطر الأوامر CLI. host من النوع <string>: المضيف الذي يجب الاستماع له لإجراء اتصالات المراقب. اختياري. القيمة الافتراضية: ما تحدد في واجهة سطر الأوامر CLI. wait من النوع <boolean>: المنع حتى إتمام اتصال عميل. اختياري. القيمة الافتراضية: false. ...

الاستجابات HTTP في Laravel

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

صدفة Bash وبرامج Bash

تعريف بصدفة Bash Bash هي صدفة نظام جنو التي تتوافق مع صدفة بورن وتزيد عليها بعدة مزايا وخصائص مفيدة من باقي الصدفات، وحين تبدأ الصدفة فإنها تقرأ ملفات إعداداتها التي من أهمها ما يلي: etc/profile/ bash_profile./~ bashrc./~ كذلك تتصرف bash بشكل مختلف حين تكون في وضع تفاعلي، وهي متوافقة مع معايير POSIX وبها وضع محظور. ويمكن تقسيم أوامرها إلى ثلاث مجموعات: دوال الصدفة والأوامر المُضمَّنة والأوامر الموجودة داخل مجلد في نظامك. أيضًا، تدعم bash أوامر مضمَّنة أخرى ليست موجودة داخل ...

ميزات صدفة Bash

صدفة bash هي الصدفة الافتراضية لنظام جنو يوفّر مشروع GNU -إذ يشير الاسم إلى GNU's Not UNIX- أدواتٍ لإدارة النظم الشبيهة بنظام يونكس، وهي نظم التشغيل الحرة والمتوافقة مع معايير يونكس. وإحدى تلك الأدوات هي bash، صَدَفة متوافقة مع صدفة sh الأولى التي كتبها ستيفن بورن، وبها خصائص مفيدة من صدفتي Korn و C -اختصاراتهما ksh و csh على الترتيب-. وقد صُممت لتتوافق مع معيار IEEE POSIX P1003.2/ISO 9 945.2 للصدفات والبرامج.  كما أن بها مزايا محسّنة عن sh سواء ...

التعابير النمطية وأمثلة عن استخدام grep

التعابير النمطية Regular Expressions التعبير النمطي (Regular Expression) هو أسلوب يصف مجموعة من النصوص (strings)، وتُبنى تلك التعابير النمطية بشكل تناظري للتعابير الحسابية (arithmetic expressions) باستخدام عدة معامِلات لدمج التعابير الأصغر. وأصغر وحدة بنائية للتعابير النمطية هي تلك التي تطابق محرفًا واحدًا، ذلك أن أغلب المحارف -بما في ذلك كل الحروف والأرقام- ما هي إلا تعابير نمطية تطابق أنفسها، ويمكن اقتباس أي محرف خاص (metacharacter) له معنىً خاص بسبْقِه بشرطة مائلة خلفية \. المحارف الخاصة للتعابير النمطية يمكن إتْباع التعبير ...

نظرة عامة على Active Storage في ريلز

يغطّي هذا الدليل كيفيّة إرفاق ملفات بنماذج Active Record. ستتعلم بعد قراءة هذا الدليل: كيفية إرفاق ملف أو عدّة ملفّات بسجل (record). كيفيّة حذف ملف مُرفق. كيفيّة الربط بملف مُرفق. كيفيّة استخدام المتغيّرات (variants) لتحويل الصور. كيفيّة إنشاء تمثيل صُوَري (image representation) لملف غير صُوَري، مثل ملف PDF أو فيديو. كيفيّة إرسال تحميلات الملفّات مباشرةً من المتصفّحات إلى خدمة تخزين، دون المرور على خوادم تطبيقك. كيفيّة تنظيف الملفّات المخزّنة أثناء الاختبار. كيفيّة تعريف استخدام (implement) الدعم لخدمات تخزين إضافيّة. ما ...

الواجهات الساكنة (Facades) في Laravel

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

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

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

وحدات التحكّم (Controllers) في Laravel

مقدمة بدلًا من تعريف كامل منطق معالجة طلباتك (request handling logic) على أنّها نطاقات مغلقة (‎(Closures في ملفّات المسارات، قد ترغب في تنظيم هذا السلوك (behavior) باستخدام أصناف ووحدات التحكّم. تستطيع وحدات التحكّم جمع منطق معالجة الطلبات ذي الصلة في صنف واحد. تخزّن وحدات التحكّم في المجلّد app/Http/Controllers. وحدات التحكّم الأساسية تعريف وحدات التحكّم تجد أدناه مثالًا عن وحدة تحكّم بسيطة. لاحظ أن وحدة التحكّم تُوسّع صنف وحدة التحكّم الأساسية المُحتواة في Laravel. يوفّر الصنف الأساسي عددًا من التوابع المفيدة ...

الواجهات البرمجية لتوقيت الأداء (Performance Timing API)

الاستقرار: 1- تجريبي. تقدم الواجهة البرمجية لتوقيت الأداء تطبيقًا لمواصفات W3C Performance Timeline. الغرض من  الواجهة البرمجية (API) هو دعم مجموعة من مقاييس الأداء عالية الدقة. والتي هي نفس واجهات الأداء المُطبّقة في متصفحات الويب الحديثة. const { PerformanceObserver, performance } = require('perf_hooks'); const obs = new PerformanceObserver((items) => { console.log(items.getEntries()[0].duration); performance.clearMarks(); }); obs.observe({ entryTypes: ['measure'] }); performance.mark('A'); doSomeLongRunningProcess(() => { performance.mark('B'); performance.measure('A to B', 'A', 'B'); }); الصنف: Performance أُضيف في الإصدار: 8.5.0. performance.clearMarks([name‎]‎)‎ أُضيفت في الإصدار: 8.5.0 name <string>‎ إذا ...

الجلسات HTTP في Laravel

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

تتبع الأحداث (Trace Events) في Node.js

مؤشر الاستقرار: 1 - تجريبي يوفر تتبع الأحداث آلية لتركيز معلومات التتبع التي  تولدت بواسطة V8، ونواه Node.js، وبرمجية مساحة المستخدم (userspace code). يمكن تفعيل التتبع بواسطة راية سطر الأوامر ‎--trace-event-categories أو باستخدام وحدة trace_events. وتقبل راية ‎‎--‎trace-event-categories قائمة بأسماء الفئات المفصولة بفاصلات. والفئات المتاحة هي:     • node - عنصر نائب (placeholder) فارغ.     • node.async_hooks - يتيح التقاط بيانات التتبع async_hooks المُفصَّلة. أحداث async_hooks لها asyncId فريد وخاصيتا triggerId و triggerAsyncId الخاصة.     • node.bootstrap ...

أمثلة عن الدوال في Bash

إعادة التدوير ستجد برامج كثيرة على نظامك تستخدم الدوال كطريقة منظمة لمعالجة سلسلة ما من الأوامر، ففي بعض أنظمة لينكس مثلًا ستجد الملف التعريفي etc/rc.d/init/functions/ يشار إليه كمصدر في كل شيفرات init النصية. وبهذا الأسلوب لا تحتاج إلى كتابة المهام المتكررة سوى مرة واحدة وبشكل عام أيضًا، مهام مثل تفقد ما إن كانت تعمل إحدى المهام، تشغيل أو إيقاف أحد العفاريت (daemons)، وهلم جرا. ثم إذا دعت الحاجة إلى كتابة تلك المهام مرة أخرى فإنك لا تحتاج سوى إعادة تدوير ...

توليد عناوين URL في Laravel

مقدمة يوفّر Laravel العديد من المساعدين لمساعدتك في إنشاء عناوين URL لتطبيقك. فائدتهم الأساسية تظهر طبعا عند بناء روابط في قوالبك (templates) واستجابات الواجهة البرمجيّة، أو عند توليد ردود إعادة توجيه إلى جزء آخر من تطبيقك. الأساسيات توليد عناوين URL أساسية يمكن استخدام المساعد url لتوليد عناوين URL عشوائية لتطبيقك. سيستخدم العنوان URL المُنشأ تلقائيًا المخطَّط (HTTP أو HTTPS) ويستضيف من الطلب الحالي: $post = App\Post::find(1); echo url("/posts/{$post->id}"); // http://example.com/posts/1 الوصول إلى العنوان URL الحالي سترد النسخة Illuminate\Routing\UrlGenerator إن لم يُوفّر أي ...

التوجيه من الخارج إلى الداخل في ريلز

يغطي هذا الدليل الميزات التي يواجهها المستخدم في عمليات التوجيه في ريلز. بعد قراءة هذا الدليل، ستعرف: كيفية تفسير الشيفرة في config/routes.rb. كيفية بناء المسارات الخاصة بك باستخدام إما أسلوب الحيلة (resourceful style) المفضل أو طريقة المطابقة (match method). كيفية الإعلان عن معاملات المسار الموجه، والتي تمرر إلى إجراءات وحدة التحكم (controller actions). كيفية إنشاء المسارات وعناوين URL تلقائيًا باستخدام مساعدي المسار الموجه. التقنيات المتقدمة مثل إنشاء قيود وتثبيت نقاط نهاية Rack. الغرض من توجيه المسارات في ريلز يتعرف جهاز ...

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