البدء السريع
ثبّت RTLY-Kit عبر Composer، وخلال خمس دقائق تقريبًا حوّل تاريخًا جلاليًا، وتحقق من رقم وطني إيراني، وتعرّف على استثناءات المكتبة.
كل الأدلة
القائمة الكاملة لأدلة RTLY-Kit مرتبة حسب الموضوع. استخدم المربع أدناه لتصفية القائمة.
لا يوجد دليل يطابق هذا النص.
البدء
التثبيت وتشغيل أول مثال.
التثبيت
المتطلبات والتثبيت عبر Composer أو Docker، وتكامل Carbon وLaravel الاختياري، والإصدارات المدعومة، وكيفية التحقق من التثبيت وإزالة الحزمة بشكل نظيف.
التقاويم
الجلالي والهجري والعبري: الإنشاء والتنسيق والمقارنة والتحويل.
التقويم الجلالي
فئة التاريخ الجلالي (الفارسي، الشمسي الهجري) غير القابلة للتغيير: إنشاء التواريخ وتحليلها، وتنسيقها برموز date في PHP، وإزاحتها وضبطها، ومقارنتها وقياس الفروق بينها، مع نطاق السنوات الدقيق وسلوك الأخطاء.
التقويم الهجري
فئة التاريخ الهجري (الإسلامي) غير القابلة للتغيير، بجدول أشهر أم القرى ونمط حسابي جدولي (Tabular): إنشاء التواريخ وتحليلها وتنسيقها بالعربية أو الفارسية أو الإنجليزية، وإزاحتها ومقارنتها وقياس الفروق بينها.
التقويم العبري
فئة التاريخ العبري (اليهودي) غير القابلة للتغيير، بترقيم ترتيبي للأشهر وآدار الأول والثاني في السنة الكبيسة، وأسماء الأشهر بالإنجليزية والعبرية والفارسية: إنشاء التواريخ وتحليلها وتنسيقها وإزاحتها وقياسها.
التحويل والمقارنة بين التواريخ
العقد المشترك CalendarDate بين Jalali وHijri وHebrew، وكيفية تحويل التاريخ بين التقويمات، وكيف تعمل المقارنة وحساب الفروق عبر التقويمات والمناطق الزمنية.
ماكروات Carbon
تكامل Carbon الاختياري: حوّل أي كائن Carbon إلى الجلالي أو الهجري أو العبري، وأنشئ تواريخ Carbon من مكوّنات التقويم، مع القائمة الدقيقة للماكروات وأنواع القيم المُرجعة والأخطاء.
التحقق من الصحة
الرقم الوطني وشبا والبطاقة المصرفية والجوال والرمز البريدي ولوحة المركبة، بنتائج منظَّمة.
نظرة عامة على أدوات التحقق
كيف تعمل أدوات التحقق الإيرانية الست: عقد Validator المشترك، وكائن Result، ومفاتيح الأخطاء الثابتة، وتطبيع المدخلات وحدود الحجم.
الرقم الوطني
تحقق من الأرقام الوطنية الإيرانية (کد ملی) برقم التحقق mod-11، مع قبول الأرقام الفارسية والعربية، وقراءة تلميح مكان الإصدار بأمان.
شبا والبطاقة المصرفية
تحقق من أرقام شبا (IBAN) بمعيار ISO 7064 mod-97-10 ومن أرقام البطاقات المصرفية بالمجموع الاختباري Luhn، وابحث عن المصرف المُصدِر مع تنبيهات صريحة حول البيانات.
الجوال والرمز البريدي ولوحة المركبة
تحقق من أرقام الجوال الإيرانية بكل صيغ الإدخال الشائعة، ومن الرموز البريدية ولوحات المركبات، مع تلميحات المشغّل والتحليل وحدود واضحة.
الأرقام والنصوص
الأرقام وفاصل الآلاف وتحويل الأعداد إلى كلمات وتطبيع النصوص واكتشاف خصائصها.
الأرقام وتنسيق الأعداد
التحويل بين الأرقام الإنجليزية والفارسية والعربية الهندية، وتنسيق الأعداد بالفواصل الفارسية، وبناء الأعداد الترتيبية الفارسية، مع توضيح كل حد وحالة حافة.
تحويل الأعداد إلى كلمات
كتابة الأعداد الصحيحة بالحروف بالفارسية (حتى 10^21) وبالعربية (حتى 10^27)، وقراءة كلمات الأعداد الفارسية وتحويلها إلى أعداد عبر fromWords().
الأعداد بالحروف العربية
اكتب الأعداد بالعربية الفصحى بالجنس والحالة الإعرابية والحركات الصحيحة حتى 10^27، واكتب الأعداد الترتيبية من 1 إلى 99. كل خيار مع ناتج حقيقي.
أدوات النصوص
تطبيع النصوص الفارسية والعربية، وإصلاح نصف المسافة، والكشف عن اللغة والاتجاه، وبناء المعرّفات النصية الصالحة للروابط، مع السلوك الدقيق وحالات الحافة لكل أداة.
العطل وأوقات الصلاة
العطل الرسمية في إيران وحساب أوقات الصلاة.
العطل الرسمية الإيرانية
ابحث عن العطل الرسمية الإيرانية لأي تاريخ جلالي، واعرض سنة كاملة، واعثر على أيام العمل. تتبع النتائج التواريخ الرسمية المنشورة للسنوات 1380 إلى 1405، وتُقدَّر العطل الإسلامية فيما عدا ذلك.
تقويم العطل القابل للتعديل
استخدم التواريخ الرسمية للعطل الإيرانية، واعرف مصدر كل تاريخ، وصحّح فروق رؤية الهلال بإزاحاتك وبدايات الأشهر وأيام تضيفها أو تحذفها.
أوقات الصلاة
احسب الفجر والشروق والظهر والعصر والمغرب والعشاء لأي موقع بست طرق حساب، مع قواعد لخطوط العرض العالية وضبط يدوي للدقائق، وبيان ما قورن بجداول منشورة.
لارافيل
مزوّد الخدمة وقواعد التحقق والواجهة (Facade) والتحويل (Cast) في Eloquent.
إعداد Laravel
كيف يتكامل RTLY-Kit مع Laravel: الاكتشاف التلقائي للحزمة، وما يسجّله مزوّد الخدمة، وواجهة Jalali، ورسائل التحقق بالفارسية والإنجليزية والعربية التي يمكنك تجاوزها.
قواعد التحقق وتحويل Eloquent
استخدم قواعد التحقق الإيرانية في نماذج Laravel، وخزّن التواريخ الجلالية في نماذج Eloquent عبر JalaliCast، واعرضها في Blade.
المرجع
الدوال المساعدة والأخطاء واستقرار الواجهة البرمجية ودقة البيانات والحدود والترقية.
الدوال المساعدة والدوال العامة
الدوال المساعدة السبع والعشرون ضمن فضاء الأسماء، وطريقة استيرادها، والتفعيل الاختياري Globals::register() الذي يضيف أسماء عامة قصيرة دون أن يستبدل أسماءك.
معالجة الأخطاء
أي الاستدعاءات ترمي استثناءات وأيها لا يرمي أبداً، وتسلسل الاستثناءات، وقيم ErrorCode الثابتة، وكيفية التقاط الإخفاقات وتسجيلها بأمان.
استقرار واجهة API
ما الذي يمكنك الاعتماد عليه، وما هو داخلي، وكيف تُرقَّم الإصدارات قبل 1.0 وبعده، وما إصدارات PHP وLaravel وCarbon المدعومة.
الدقة والبيانات
مصدر كل جدول بيانات مدمج، وما قورن بالمراجع الرسمية وبصفحات عامة، وما يُحسب حسابًا. اقرأها قبل أن تعتمد على النتائج في بيئة الإنتاج.
قياس الأداء
قياس أداء مصغّر وصريح لـ RTLY-Kit مقابل morilog/jalali، مع المنهج كاملًا والتحفظات وأمر من سطر واحد لإعادة التشغيل على جهازك.
الحدود
كل الحدود الصارمة في مكان واحد: نطاقات السنوات المدعومة، وسقوف حجم المُدخَلات، ونطاقات الأعداد بالكلمات، ونطاق أم القرى، وسائر الحدود الرقمية في المكتبة.
استكشاف الأخطاء والأسئلة الشائعة
إجابات عن أكثر الأسئلة تكرارًا: الدوال المساعدة المفقودة، وأرقام أيام الأسبوع، والسنوات النصية، والمناطق الزمنية، وماكروات Carbon، والتحويل في Eloquent، وأوقات الصلاة، والعطل.
دليل الترقية
التغييرات الجذرية قبل الإصدار 1.0 مع الخطوات الدقيقة للانتقال، إضافةً إلى أبرز ما في سجل التغييرات للسلسلة 0.x.
التحقق من الإصدارات
كيف تتحقق بالمجموع الاختباري وبشهادة مصدر البناء من أن أرشيف الإصدار هو الملف الذي بناه سير عمل الإصدار، وما علاقة ذلك بالتثبيت عبر Composer.