Automated Email

جدولة البريد الإلكتروني ونظام الإخطار

هذا المشروع عبارة عن نظام بسيط لجدولة البريد الإلكتروني والإشعارات تم إنشاؤه باستخدام PHP و MySQL و PHPMailer . يمكن للمستخدمين جدولة رسائل البريد الإلكتروني ليتم إرسالها في تاريخ ووقت مستقبلي. يقوم النظام بالتحقق من رسائل البريد الإلكتروني المعلقة بشكل دوري باستخدام وظيفة cron ويرسلها تلقائيًا.

سمات

• مصادقة المستخدم : يمكن للمستخدمين التسجيل وتسجيل الدخول والوصول إلى لوحة المعلومات المخصصة.
• جدولة البريد الإلكتروني : يمكن للمستخدمين جدولة رسائل البريد الإلكتروني ليتم إرسالها في تاريخ ووقت محددين في المستقبل.
• إرسال البريد الإلكتروني تلقائيًا : تقوم مهمة cron بفحص قاعدة البيانات كل دقيقة بحثًا عن رسائل البريد الإلكتروني المعلقة وإرسالها باستخدام PHPMailer.
• معالجة رسائل البريد الإلكتروني الفاشلة : يقوم النظام بإعادة محاولة رسائل البريد الإلكتروني الفاشلة ويسجل حالة كل بريد إلكتروني.
• جلسات PHP : تحمي صفحات معينة (مثل لوحة التحكم) من خلال التأكد من أن المستخدمين الذين قاموا بتسجيل الدخول فقط هم الذين يمكنهم الوصول إليها.

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

قبل تشغيل المشروع، تأكد من تثبيت ما يلي:

• PHP (>=7.3)
• ماي إس كيو إل
• الملحن (لإدارة التبعية)
• PHPMailer (مثبت عبر Composer)

تثبيت

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

git clone https://github.com/yourusername/email-scheduling-app.git
cd email-scheduling-app

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

تأكد من تثبيت Composer، ثم قم بتشغيل:

composer install

سيؤدي هذا إلى تثبيت PHPMailer والتبعيات الأخرى.

3. قم بإنشاء ملف .env

قم بإنشاء ملف .env في جذر المشروع وحدد التكوينات الحساسة الخاصة بك:

DB_HOST=your_db_host
DB_NAME=your_db_name
DB_USER=your_db_user
DB_PASSWORD=your_db_password

SMTP_HOST=smtp.yourmailprovider.com
SMTP_PORT=587
[email protected]
SMTP_PASS=your_email_password

4. إعداد قاعدة البيانات

قم بإنشاء قاعدة بيانات MySQL واستيراد مخطط SQL:

 CREATE DATABASE email_scheduler ;
USE email_scheduler;

CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY ,
  username VARCHAR ( 255 ) NOT NULL ,
  email VARCHAR ( 255 ) NOT NULL ,
  password VARCHAR ( 255 ) NOT NULL
);

CREATE TABLE scheduled_emails (
  email_id INT AUTO_INCREMENT PRIMARY KEY ,
  recipient_email VARCHAR ( 255 ) NOT NULL ,
  subject VARCHAR ( 255 ) NOT NULL ,
  body TEXT NOT NULL ,
  scheduled_time DATETIME NOT NULL ,
  status ENUM( ' pending ' , ' sent ' , ' failed ' ) DEFAULT ' pending ' ,
  attempts INT DEFAULT 0
);

5. تكوين اتصال قاعدة البيانات

قم بتحرير ملف config/db.php لتحميل متغيرات البيئة باستخدام حزمة vlucas/phpdotenv.

 <?php
require_once __DIR__ . ' /../vendor/autoload.php ' ;

use Dotenv  Dotenv ;
$ dotenv = Dotenv:: createImmutable ( __DIR__ . ' /../ ' );
$ dotenv -> load ();

class Dbh {
    protected function connect () {
        $ dsn = ' mysql:host= ' . $ _ENV [ ' DB_HOST ' ] . ' ;dbname= ' . $ _ENV [ ' DB_NAME ' ];
        try {
            $ pdo = new PDO ( $ dsn , $ _ENV [ ' DB_USER ' ], $ _ENV [ ' DB_PASSWORD ' ]);
            $ pdo -> setAttribute ( PDO :: ATTR_ERRMODE , PDO :: ERRMODE_EXCEPTION );
            return $ pdo ;
        } catch ( PDOException $ e ) {
            die ( ' Connection failed: ' . $ e -> getMessage ());
        }
    }
}

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

قم بخدمة تطبيق PHP محليًا (أو على الخادم المفضل لديك). إذا كنت تستخدم خادم PHP المدمج، فقم بتشغيل:

php -S localhost:8000

ثم افتح http://localhost:8000 في متصفحك.

7. إعداد وظيفة Cron لإرسال البريد الإلكتروني

قم بإعداد مهمة cron ليتم تشغيلها كل دقيقة لمعالجة رسائل البريد الإلكتروني المجدولة:

1. افتح محرر crontab:

crontab -e

2. أضف السطر التالي لتنفيذ البرنامج النصي لإرسال البريد الإلكتروني كل دقيقة:

 * * * * * /usr/bin/php /path/to/project/includes/send_email.inc.php

تأكد من صحة المسار إلى PHP الثنائي ودليل المشروع.

الاستخدام

• التسجيل: قم بإنشاء حساب في صفحة التسجيل.
• تسجيل الدخول: قم بتسجيل الدخول إلى حسابك والوصول إلى لوحة التحكم.
• جدولة بريد إلكتروني: أدخل البريد الإلكتروني للمستلم والموضوع والنص والوقت المحدد.
• عرض رسائل البريد الإلكتروني المجدولة: تحقق من لوحة المعلومات للحصول على قائمة بجميع رسائل البريد الإلكتروني المجدولة والمرسلة.
• الإرسال الآلي: سيقوم النظام تلقائيًا بإرسال رسائل البريد الإلكتروني عند الوصول إلى الوقت المحدد لها.

هيكل الملف

project-root/
│
├── .env
├── .gitignore
├── composer.json
├── composer.lock
├── config.php
├── index.php
├── project.sql
├── README.md
│
├── config/
│   └── db.php
│
├── controllers/
│   ├── login-contr.php
│   ├── schedule_email-contr.php
│   └── signup-contr.php
│
├── includes/
│   ├── login.inc.php
│   ├── logout.inc.php
│   ├── schedule_email.inc.php
│   ├── send_email.inc.php
│   └── signup.inc.php
│
├── models/
│   ├── login-model.php
│   ├── schedule_email-model.php
│   └── signup-model.php
│
├── cron/
│   └── send_email.php
│
└── views/
    ├── dashboard.php
    ├── login.php
    ├── schedule_email.php
    └── signup.php

التحسينات المستقبلية

• إضافة وظيفة لجداول البريد الإلكتروني المتكررة.
• تنفيذ آلية أكثر قوة لتسجيل الأخطاء.
• قم بتنفيذ قوالب البريد الإلكتروني لتخصيص أفضل.

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

• PHP: لغة الواجهة الخلفية
• MySQL: قاعدة بيانات لتخزين المستخدمين وجداول البريد الإلكتروني
• PHPMailer: للتعامل مع إرسال البريد الإلكتروني
• الملحن: إدارة التبعية PHP
• Dotenv: لإدارة متغير البيئة

المساهمات

المساهمات هي موضع ترحيب! لا تتردد في تقديم طلب سحب أو فتح قضية.