simple todo

تودو بسيط

Simple ToDo هو webapp الحد الأدنى للغاية. لقد تم تصميمه لإظهار عملية إنشاء webapp باستخدام "php" الموجهة نحو الكائن. على الرغم من ذلك ، فإن هذا التطبيق أضيق الحدود في الطبيعة ، إلا أنه يحتوي على جميع الخصائص الأساسية لتطبيق الويب الجيد. لقد تم تصميمه بطريقة موجهة بالكامل للكائنات باستخدام PHP Pure (لم يتم استخدام أي إطار عمل بخلاف phpunit ، وهو مجرد إطار اختبار) و HTML و CSS و JavaScript. في الوقت الحالي ، يدعم هذا التطبيق العديد من الميزات الجيدة. سأصفهم أدناه.

يعيش

لقد استضافت التطبيق على Heroku وأنا أستخدم التكامل المستمر لشحن التغييرات تلقائيًا وعلى الفور (المزيد حول هذا لاحقًا). يمكنك زيارة التطبيق باستخدام الرابط التالي:

http://simple-todo-rs.herokuapp.com/

الميزات التي تدعمها Simple ToDo

ميزات الخلفية

على الواجهة الخلفية ، قمت ببناء الأشياء التالية:

1. محرك توجيه مخصص
2. دعم URL جميل
3. دعم البرامج الوسيطة (كل من العام والطريق المحدد)
4. وحدة التحكم للتعامل مع الطلب
5. المسارات المسماة
6. حماية CSRF من خلال البرامج الوسيطة
7. محرك صغير ولكن قابلية التوسيع وفعالة
8. طريقة مريحة OOP للوصول إلى المتغيرات العالمية (ملاحظة: الطريقة التي قمت بتنفيذها ، فهي تمتد ، ولكنها غير كاملة بعد).

تم تصميم التطبيق باستخدام طريقة موجهة بالكامل للكائنات ولديها دعم قوي قد يكتشف الفواصل أثناء مرحلة التطوير وبالتالي زيادة السرعة.

ميزات الواجهة الأمامية

1. واجهة مستخدم سريعة الاستجابة وسريعة ومتسقة.
2. آلية التخزين المؤقت لتخزين البيانات على جانب العميل.
3. مكالمات الشبكة المحسنة (IE DB).

اختبار الدعم والتعليقات

لاختبار الوحدة أنا أستخدم phpunit. رغم ذلك ، لقد بدأت بالفعل في كتابة الاختبارات والاستمرار ، ولكن لا يزال الأمر يستغرق وقتًا ما لتغطية قاعدة الشفرة بأكملها.

حول التعليقات ، نظرًا لأن التطبيق يغطي الكثير من الميزات ، فقد حاولت كتابة الرمز بشكل عام ، بحيث لا يحتاج المرء إلى تعليقات لفهم الرمز (لإدارة وقت Dev). ولكن ما زال التعليق هو حقيقة واقعة للوثيقة. سأحاول أخذ قاعدة الكود بأكملها تحت التعليقات مع مرور الوقت.

الاختبار الآلي والنشر المستمر

1. دعم الاختبار الآلي باستخدام إجراءات github و phpunit.
2. دعم النشر المستمر باستخدام إجراءات GITHUB ونظام النشر القائم على Heroku GIT.

[ملاحظة: يعمل التطبيق على اختبار تلقائي على كل دفعة ، ولكنه ينشر فقط إلى Heroku إذا نجح الاختبار].

قاعدة البيانات

لقاعدة البيانات لقد استخدمت postgreSQL. ولتعامل مع عمليات قاعدة البيانات ، استخدمت PHP PDO لإدراج Perfom ، حذف ، تحديث وما إلى ذلك.

كملاحظة جانبية ، تم استخدام Composer التبعية.

للاستخدام المحلي أو التنمية

إذا كنت ترغب في تشغيل هذا التطبيق محليًا لاستخدامك أو تطويره ، فيمكنك القيام بذلك بسهولة. تأكد من تثبيت PHP و Composer و PostgreSQL المثبت على جهاز الكمبيوتر الخاص بك واتصال الإنترنت.

في أول ملحن التشغيل لتثبيت التبعيات:

$ php composer.phar install

الآن ، قم بإنشاء .env في دليل جذر المشروع ووضع معلومات DB الخاصة بك هناك على النحو التالي:

DATABASE_URL=postgres:// < username > : < password > @ < hostname > : < port > / < dbname >

قد ترغب أيضًا في وضع معلومات أخرى في ملف .env الخاص بك (افعل حسب حاجتك)

ثم الركض:

$ php database/migrate.php

بعد إنشاء جدول DB ، يمكنك إجراء الاختبارات:

$ ./vendor/bin/phpunit

إذا نجحت الاختبارات ، فيمكنك تشغيل التطبيق باستخدام خادم ويب تطوير PHP على النحو التالي:

$ php -c < path-to-php.ini > -t public/ -S 127.0.0.1:8000

تفضل الآن بزيارة 127.0.0.1:8000 على متصفحك لاستخدام WebApp.

شكر وتقدير

لقد استخدمت phpunit لاختبار الوحدة ونصي تم تحريره قليلاً (وفقًا لحاجتي) من DevCoder-xyz/php-dotenv إلى ملف .env .

رخصة

يتم نشر هذا المستودع بموجب MIT License . لمعرفة المزيد عن الترخيص ، يرجى زيارة هذا الرابط.

المساهمة

أفكر في شرح الهندسة المعمارية بالكامل لهذا المشروع لكل من مهتم بتطوير WebApp. أفكر في التخطيط لكتاب (أو نوع من الموارد التعليمية) حول كيفية إنشاء تطبيق ويب من نقطة الصفر. إذا كان لديك أي شيء للمساهمة أو تقديم المشورة ، فأنا كل آذان. فقط أعطني ضربة.