minimal blog

مدونة الحد الأدنى

Minimal Blog هي مدونة بسيطة مصممة بواجهة بسيطة. يمكن للمستخدم الانتقال إلى الفئات وقراءة المقالات والتفاعل مع المؤلف من خلال قسم التعليقات. يتمتع مؤلف المدونة بالتحكم الكامل في كل محتوى عبر لوحة تحكم إدارية آمنة.

---

تم إنشاء هذا المشروع لإظهار بعض مهاراتي مثل:

• التكامل الأساسي مع عناصر TailwindCSS
• CRUD على الفئات والمشاركات والتعليقات والنشرات الإخبارية
• الأمن (المصادقة، الترخيص، الناخبين)
• العناصر الجمركية (خدمة slugifier، امتداد غصين للتواريخ، المدقق، منشئي الاستعلامات...)
• صفحات العقيدة
• رسائل غير متزامنة (رسائل البريد الإلكتروني الإخبارية) مع Messenger وRabbitMQ عبر Docker
• تغطية الاختبار (اختبارات الوحدة والوظيفة) باستخدام PHPUnit

ابدأ

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

• PHP 8.1 أو أعلى (Symfony 6.1)
• الملحن
• الغزل / NodeJS
• عامل ميناء

ثَبَّتَ

1. استنساخ هذا المشروع
2. تثبيت التبعيات مع composer install yarn install
3. قم بإنشاء .env.local الخاص بك وأضف DSN لقاعدة البيانات الخاصة بك
4. إنشاء قاعدة بيانات، وتطبيق عمليات الترحيل، وملئها بالتركيبات: bin/console doctrine:database:create bin/console doctrine:migrations:migrate bin/console doctrine:fixtures:load

عمل

1. قم بتشغيل docker-compose up لبدء تشغيل صور Docker (mailcatcher وخادم RabbitMQ)
2. قم بتحرير .env.local الخاص بك عن طريق تحديث RABBITMQ_DSN و MAILER_DSN ، ويمكنك العثور عليهما عن طريق تشغيل: symfony var:export --multiline | grep 'MAILER_DSN|RABBITMQ_DSN'
3. قم بتشغيل yarn run dev --watch لبدء تشغيل الخادم المحلي الخاص بك للأصول
4. قم بتشغيل symfony serve لتشغيل خادم الويب php المحلي الخاص بك
5. منتهي ! تحقق من خادم المضيف المحلي الخاص بك: http://127.0.0.1:8000/

تستهلك الرسائل غير المتزامنة

1. قم بتشغيل symfony open:local:rabbitmq و symfony open:local:webmail لبدء خادم RabbitMQ وصائد بريد الويب
2. قم بتسجيل الدخول إلى RabbitMQ باستخدام بيانات الاعتماد: guest:guest
3. لإرسال رسائل إلى RabbitMQ، قم بتسجيل الدخول كمسؤول ( [email protected]:admin ) ثم انتقل إلى لوحة تحكم المسؤول وانقر على "النشرة الإخبارية"، وسترى زر "إرسال"، وسيرسل رسالة واحدة لكل مشترك إلى النشرة الإخبارية (الافتراضي 50).
4. قم بتشغيل bin/console messenger:consume -vv async لاستهلاك الرسائل في RabbitMQ، وسيتم إرسالها وعرضها تدريجيًا في mailcatcher.

اختبار

بشكل افتراضي، تعمل جميع الاختبارات مع التركيبات، لذا لا تنس تحميلها!

1. قم بتحديث .env.test الخاص بك وأضف DSN لقاعدة بيانات الاختبار الخاصة بك
2. قم بإنشاء قاعدة بيانات، وتطبيق عمليات الترحيل، واملأها بالتركيبات: bin/console doctrine:database:create --env=test bin/console doctrine:migrations:migrate --env=test bin/console doctrine:fixtures:load --env=test
3. قم بتشغيل bin/phpunit لتشغيل بطارية الاختبارات

بنيت مع

• سيمفوني 6.1
• ماي إس كيو إل
• TailwindCSS (موضوع Ghostwind)
• عامل ميناء
• RabbitMQ
• PHPUnit