Currency Converter PHP Symfony Framework

محول العملة PHP Symfony Framework

ملخص

هذا المشروع هو تطبيق محول العملة مصمم مع PHP باستخدام Symfony Framework و MySQL. يتيح التطبيق للمستخدمين تحويل مبلغ من عملة واحدة إلى مختلف العملات الأخرى. ويشمل ميزات مثل التحكم في الوصول المستند إلى IP ، ومصادقة المستخدم ، وعمليات CRUD لإدارة المستخدمين و IPS.

تم تصميم المهمة لاختبار مهارات PHP و MVC ، مع التركيز على وظائف الخلفية والهندسة المعمارية للنظام. يدعم التطبيق أيضًا ميزات اختيارية مثل إعادة تعيين كلمة المرور ولوحة معلومات المسؤول للمستخدم

سمات

• تحويل العملة : تحويل مبلغ محدد من عملة واحدة إلى عملات أخرى متعددة.
• استيراد سعر الصرف : أحضر أسعار الصرف من الواجهة الخلفية وتحميلها في النموذج.
• مصادقة المستخدم : تأمين تسجيل الدخول مع اسم المستخدم/كلمة المرور والقيود المستندة إلى IP.
• تذكرني : خيار للمستخدمين للبقاء على تسجيل الدخول عبر الجلسات.
• إدارة العرض القائمة على الأدوار : طرق عرض وميزات مختلفة تعتمد على أدوار المستخدم (المسؤول ، المستخدم).
• نسيت كلمة المرور : يمكن للمستخدمين إعادة تعيين كلمات المرور الخاصة بهم.
• لوحة معلومات المشرف : يمكن للمسؤولين إدارة المستخدمين.
• استيراد سعر الصرف : أحضر أسعار الصرف من الواجهة الخلفية وتحميلها في النموذج.
• التسجيل : سجل أنشطة وأخطاء باستخدام مونولوج Symfony لتصحيح الأخطاء والمراقبة.

التقنيات المستخدمة

• Symfony 5.4 : PHP Framework لبناء تطبيقات الويب القوية.
• MySQL : نظام إدارة قاعدة البيانات العلائقية.
• Bootstrap : Frontend Framework للتصميم الأساسي.
• PHP : لغة البرمجة النصية من جانب الخادم.
• GIT : نظام التحكم في الإصدار.

ابدء

المتطلبات الأساسية

• PHP 7.4+
• MySQL 5.7+
• الملحن (مدير التبعية لـ PHP)
• XAMPP (اختياري: للتنمية المحلية)

تثبيت

1. استنساخ المستودع

   git clone https://github.com/SLoharkar/Currency-Converter-PHP-Symfony-Framework.git
   cd Currency-Converter-PHP-Symfony-Framework

2. تثبيت التبعيات

   تأكد من تثبيت الملحن وتشغيله:

   composer install

3. تكوين متغيرات البيئة

   انسخ ملف .env.test لإعداد متغيرات البيئة الخاصة بك:

   cp .env.test .env

   انسخ ملف .env وقم بإعداد اتصال قاعدة البيانات الخاص بك وسر التطبيق:

    DATABASE_URL = " mysql://db_user:[email protected]:3306/db_name "
   APP_SECRET = " your_random_app_secret_key "

4. تحديث التبعيات الملحن

   بعد إعداد متغيرات البيئة ، يمكنك تحديث تبعيات الملحن للتأكد من أن لديك أحدث الإصدارات:

   composer update

5. استيراد مخطط قاعدة البيانات والبيانات الأولية

   استيراد ملف .sql

   استخدم MySQL Workbench أو PhpmyAdmin أو Xampp لتشغيل ملف xampp.sql :

   • افتح MySQL Workbench أو phpmyadmin.
   • قم بإنشاء قاعدة بيانات جديدة إذا لم تقم بذلك بالفعل.
   • استيراد ملف xampp.sql في قاعدة البيانات الجديدة.

6. تشغيل التطبيق

   يمكنك تشغيل تطبيق Symfony باستخدام خادم PHP المدمج. استخدم الأمر التالي:

   php -S localhost:3000 -t public

   استبدل localhost بعنوان IP الخاص بك إذا كنت ترغب في الوصول إلى التطبيق من جهاز آخر على شبكتك.

7. الوصول إلى التطبيق

   افتح متصفح الويب الخاص بك وانتقل إلى http: // localhost: 3000 (أو استبدل localhost بعنوان IP الخاص بك إن أمكن).

الاستخدام

مصادقة المستخدم

• تسجيل الدخول : قم بزيارة /login للوصول إلى صفحة تسجيل الدخول.
• التسجيل : قم بزيارة /register لإنشاء حساب مستخدم جديد.
• نسيت كلمة المرور : إذا تم تمكينها ، قم بزيارة /forgot_password لإعادة تعيين كلمة المرور الخاصة بك.

تحويل العملة

• يقوم التطبيق تلقائيًا بإحضار معدلات العملة الحية من Floatrates.
• حدد عملة "من" من القائمة المنسدلة.
• أدخل المبلغ المراد تحويله.
• انقر فوق الزر "تحويل" للاطلاع على جدول التحويل بمعدلات حية.

وجهات النظر القائمة على الأدوار

• مسؤل :

  • لوحة القيادة : /admin/dashboard - إدارة عمليات المستخدمين مثل التحديث وحذف المستخدمين.

• مستخدم :

  • الصفحة الرئيسية : / - الصفحة الرئيسية للتطبيق.
  • محول العملة : /user/currency-converter - إجراء تحويلات العملة.

تسجيل مع مونولوج

يستخدم التطبيق مونولوج لأنشطة التسجيل والأخطاء. يتم تخزين السجلات في var/log/ directory.

تكوين المونولوج

تم تكوين المونولوج في config/packages/monolog.yaml :

• موقع ملف السجل : تتم كتابة السجلات إلى var/log/ .

• مستويات السجل : يقوم التطبيق بتسجيل رسائل المستويات المختلفة:

  • **debug** : معلومات تصحيح مفصلة.
  • **info** : معلومات التطبيق العامة.
  • **warning** : حوادث استثنائية ليست أخطاء.
  • **error** : أخطاء وقت التشغيل التي لا تتطلب إجراء فوري.
  • **critical** : الظروف الحرجة ، مثل فشل المكون.
  • للحصول على سجلات مفصلة ، يمكنك ضبط إعداد level في monolog.yaml debug أو info أو warning أو error أو critical .

مقطورة الموقع

تحقق من مقطع الفيديو الخاص بنا للحصول على نظرة عامة سريعة على تطبيق محول العملة :

currency.converter.php.mvc.symfony.framework.mp4