۲۵ شهریور ۱۴۰۴فارسی

راهنمای جامعی برای استفاده از بسته ایمیل پایتون برای ساخت، ارسال و تجزیه پیام‌های MIME (افزونه‌های ایمیل چند منظوره)، با مثال‌های عملی و بهترین روش‌ها.

بسته ایمیل پایتون: ساخت و تجزیه پیام MIME

ایمیل همچنان یک ابزار ارتباطی حیاتی برای افراد و سازمان‌ها در سراسر جهان است. بسته email داخلی پایتون قابلیت‌های قدرتمندی را برای ایجاد، ارسال و دریافت ایمیل‌ها، به‌ویژه آنهایی که دارای قالب‌بندی و پیوست‌های پیچیده با استفاده از استاندارد MIME (افزونه‌های ایمیل چند منظوره) هستند، فراهم می‌کند. این راهنمای جامع، ساخت و تجزیه پیام‌های MIME را با استفاده از بسته email پایتون بررسی می‌کند و مثال‌های عملی و بهترین روش‌ها را ارائه می‌دهد.

درک MIME

قبل از ورود به کد، درک این که MIME چیست ضروری است. MIME فرمت ایمیل پایه را برای پشتیبانی از موارد زیر گسترش می‌دهد:

متن در مجموعه‌های کاراکتر غیر از ASCII.
پیوست‌هایی از فایل‌های صوتی، تصویری، تصاویر و برنامه‌های کاربردی.
بدنه پیام با چندین بخش.
فیلدهای هدر در مجموعه‌های کاراکتر غیر از ASCII.

پیام‌های MIME به صورت سلسله مراتبی ساختار یافته‌اند. پیام سطح بالا از یک یا چند بخش پیام تشکیل شده است. هر بخش هدرهای خود را دارد که Content-Type، Content-Disposition و سایر اطلاعات مربوطه را تعریف می‌کند. هدر Content-Type نوع رسانه بخش را مشخص می‌کند (به عنوان مثال، text/plain، text/html، image/jpeg، application/pdf).

تنظیم محیط

بسته email پایتون بخشی از کتابخانه استاندارد است، بنابراین نیازی به نصب جداگانه آن ندارید. با این حال، احتمالاً اگر قصد دارید ایمیل ارسال کنید، می‌خواهید smtplib را نصب کنید. همچنین ممکن است لازم باشد ارائه دهنده ایمیل خود را پیکربندی کنید تا به "برنامه‌های کم‌امنیت" اجازه دهد یا اگر از احراز هویت دو مرحله‌ای استفاده می‌کنید، یک رمز عبور برنامه ایجاد کنید.

برای ارسال ایمیل، معمولاً از ماژول smtplib استفاده می‌کنید که یک شیء جلسه کلاینت SMTP (پروتکل انتقال ایمیل ساده) را فراهم می‌کند.

ساخت یک ایمیل متنی ساده

بیایید با یک مثال اساسی از ایجاد و ارسال یک ایمیل متنی ساده شروع کنیم:

مثال: ارسال یک ایمیل متنی پایه

```python import smtplib from email.message import EmailMessage # پیکربندی ایمیل sender_email = "your_email@example.com" # آدرس ایمیل خود را جایگزین کنید recipient_email = "recipient_email@example.com" # آدرس ایمیل گیرنده را جایگزین کنید password = "your_password" # رمز عبور یا رمز عبور برنامه ایمیل خود را جایگزین کنید # ایجاد پیام ایمیل msg = EmailMessage() msg['Subject'] = 'سلام از پایتون!' msg['From'] = sender_email msg['To'] = recipient_email msg.set_content('این یک ایمیل متنی ساده است که از پایتون ارسال شده است.') # ارسال ایمیل try: with smtplib.SMTP_SSL('smtp.gmail.com', 465) as smtp: smtp.login(sender_email, password) smtp.send_message(msg) print("ایمیل با موفقیت ارسال شد!") except Exception as e: print(f"خطا در ارسال ایمیل: {e}") ```

توضیحات:

ما ماژول‌های لازم را وارد می‌کنیم: smtplib برای ارسال ایمیل و EmailMessage برای ایجاد ایمیل.
ما آدرس ایمیل فرستنده، آدرس ایمیل گیرنده و رمز عبور (یا رمز عبور برنامه) را تعریف می‌کنیم. مهم: هرگز اطلاعات حساسی مانند رمزهای عبور را در کد خود سخت‌کد نکنید. در عوض از متغیرهای محیطی یا فایل‌های پیکربندی امن استفاده کنید.
ما یک شی EmailMessage ایجاد می‌کنیم.
ما هدرهای Subject، From و To را تنظیم می‌کنیم.
ما از set_content() برای تنظیم بدنه ایمیل به عنوان متن ساده استفاده می‌کنیم.
ما به سرور SMTP متصل می‌شویم (در این مورد، سرور SMTP Gmail با استفاده از SSL) و با استفاده از اعتبارنامه‌های فرستنده وارد می‌شویم.
ما ایمیل را با استفاده از smtp.send_message(msg) ارسال می‌کنیم.
ما خطاهای احتمالی را در طول فرآیند ارسال مدیریت می‌کنیم.

ساخت پیام‌های MIME با پیوست‌ها

برای ارسال ایمیل با پیوست‌ها، باید یک پیام MIME با چندین بخش ایجاد کنیم. ما از کلاس MIMEMultipart برای ساخت پیام اصلی و کلاس‌های MIMEText، MIMEImage، MIMEAudio و MIMEApplication برای ایجاد بخش‌های جداگانه استفاده خواهیم کرد.

مثال: ارسال ایمیل با متن و پیوست تصویر

```python import smtplib from email.message import EmailMessage from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.image import MIMEImage # پیکربندی ایمیل sender_email = "your_email@example.com" # آدرس ایمیل خود را جایگزین کنید recipient_email = "recipient_email@example.com" # آدرس ایمیل گیرنده را جایگزین کنید password = "your_password" # رمز عبور یا رمز عبور برنامه ایمیل خود را جایگزین کنید # ایجاد پیام چند قسمتی msg = MIMEMultipart() msg['Subject'] = 'ایمیل با متن و پیوست تصویر' msg['From'] = sender_email msg['To'] = recipient_email # افزودن بخش متن ساده text = MIMEText('این قسمت متن ساده ایمیل است.', 'plain') msg.attach(text) # افزودن بخش HTML (اختیاری) html = MIMEText('

این قسمت HTML ایمیل است.

', 'html') msg.attach(html) # افزودن پیوست تصویر with open('image.jpg', 'rb') as img_file: img = MIMEImage(img_file.read(), name='image.jpg') img.add_header('Content-ID', '') # Required for embedding in HTML msg.attach(img) # ارسال ایمیل try: with smtplib.SMTP_SSL('smtp.gmail.com', 465) as smtp: smtp.login(sender_email, password) smtp.send_message(msg) print("ایمیل با موفقیت ارسال شد!") except Exception as e: print(f"خطا در ارسال ایمیل: {e}") ```

توضیحات:

ما ماژول‌های لازم، از جمله MIMEMultipart، MIMEText و MIMEImage را وارد می‌کنیم.
ما یک شیء MIMEMultipart برای نگهداری بخش‌های مختلف ایمیل ایجاد می‌کنیم.
ما یک شیء MIMEText برای بخش متن ساده ایجاد می‌کنیم و آن را به پیام اصلی پیوست می‌کنیم.
ما یک شیء MIMEText دیگر برای قسمت HTML ایجاد می‌کنیم و آن را به پیام اصلی پیوست می‌کنیم. به هدر Content-ID که برای جاسازی تصویر استفاده می‌شود توجه کنید.
ما فایل تصویر را در حالت خواندن باینری ('rb') باز می‌کنیم و یک شیء MIMEImage ایجاد می‌کنیم. سپس آن را به پیام اصلی پیوست می‌کنیم.
ما ایمیل را مانند قبل ارسال می‌کنیم.

مدیریت انواع پیوست‌های مختلف

شما می‌توانید مثال بالا را تطبیق دهید تا انواع پیوست‌های مختلف را با استفاده از کلاس MIME مناسب مدیریت کنید:

MIMEAudio: برای فایل‌های صوتی.
MIMEApplication: برای فایل‌های کاربردی عمومی (به عنوان مثال، PDF، ZIP).

به عنوان مثال، برای پیوست کردن یک فایل PDF، از کد زیر استفاده می‌کنید:

```python from email.mime.application import MIMEApplication with open('document.pdf', 'rb') as pdf_file: pdf = MIMEApplication(pdf_file.read(), _subtype='pdf') pdf.add_header('Content-Disposition', 'attachment', filename='document.pdf') msg.attach(pdf) ```

هدر Content-Disposition به کلاینت ایمیل می‌گوید که چگونه با پیوست رفتار کند. مقدار attachment نشان می‌دهد که فایل باید دانلود شود نه اینکه در خط نمایش داده شود.

تجزیه پیام‌های MIME

بسته email پایتون همچنین به شما امکان می‌دهد پیام‌های MIME را تجزیه کنید. این امر زمانی مفید است که شما نیاز به پردازش ایمیل‌های ورودی، استخراج پیوست‌ها یا تجزیه و تحلیل محتوای ایمیل دارید.

مثال: تجزیه یک پیام ایمیل

```python import email from email.policy import default # نمونه پیام ایمیل (با محتوای ایمیل واقعی خود جایگزین کنید) email_string = ''' From: sender@example.com To: recipient@example.com Subject: Test Email with Attachment Content-Type: multipart/mixed; boundary="----boundary" ------boundary Content-Type: text/plain این قسمت متن ساده ایمیل است. ------boundary Content-Type: application/pdf; name="document.pdf" Content-Disposition: attachment; filename="document.pdf" ... (محتوای فایل PDF در اینجا - این داده‌های باینری خواهد بود) ... ------boundary-- ''' # تجزیه پیام ایمیل msg = email.message_from_string(email_string, policy=default) # دسترسی به هدرهای ایمیل print(f"از: {msg['From']}") print(f"به: {msg['To']}") print(f"موضوع: {msg['Subject']}") # تکرار از طریق بخش‌های پیام for part in msg.walk(): content_type = part.get_content_type() content_disposition = part.get('Content-Disposition') if content_type == 'text/plain': print(f"\nمتن ساده:\n{part.get_payload()}") elif content_disposition: filename = part.get_filename() if filename: print(f"\nPیوست: {filename}") # پیوست را در یک فایل ذخیره کنید with open(filename, 'wb') as f: f.write(part.get_payload(decode=True)) print(f"پیوست '{filename}' ذخیره شد.") ```

توضیحات:

ما ماژول email و سیاست default را وارد می‌کنیم.
ما یک رشته پیام ایمیل نمونه را تعریف می‌کنیم (در یک برنامه واقعی، این از یک سرور ایمیل یا فایل می‌آید).
ما از email.message_from_string() برای تجزیه رشته ایمیل به یک شیء EmailMessage، با استفاده از سیاست default برای رفتار تجزیه مدرن، استفاده می‌کنیم.
ما می‌توانیم با استفاده از دسترسی شبیه دیکشنری (به عنوان مثال، msg['From']) به هدرهای ایمیل دسترسی داشته باشیم.
ما از msg.walk() برای تکرار از طریق تمام بخش‌های پیام (از جمله پیام اصلی و هر پیوست) استفاده می‌کنیم.
برای هر بخش، ما هدرهای Content-Type و Content-Disposition را بررسی می‌کنیم تا تعیین کنیم چگونه با آن برخورد کنیم.
اگر بخش متن ساده است، محموله را با استفاده از part.get_payload() استخراج می‌کنیم.
اگر بخش یک پیوست است، نام فایل را با استفاده از part.get_filename() استخراج می‌کنیم و پیوست را در یک فایل ذخیره می‌کنیم. آرگومان decode=True اطمینان می‌دهد که محموله به درستی رمزگشایی می‌شود.

بهترین روش‌ها و ملاحظات امنیتی

هنگام کار با ایمیل در پایتون، مهم است که از بهترین روش‌ها پیروی کنید و پیامدهای امنیتی را در نظر بگیرید:

هرگز رمزهای عبور را سخت‌کد نکنید: رمزهای عبور و سایر اطلاعات حساس را با خیال راحت با استفاده از متغیرهای محیطی، فایل‌های پیکربندی یا یک سیستم مدیریت اسرار ذخیره کنید.
از SSL/TLS استفاده کنید: همیشه هنگام اتصال به سرورهای SMTP از رمزگذاری SSL/TLS استفاده کنید تا از اعتبارنامه و محتوای ایمیل خود محافظت کنید.
آدرس‌های ایمیل را اعتبار‌سنجی کنید: از یک عبارت منظم یا یک کتابخانه اعتبارسنجی ایمیل اختصاصی برای اعتبارسنجی آدرس‌های ایمیل قبل از ارسال ایمیل استفاده کنید. این به جلوگیری از ارسال ایمیل به آدرس‌های نامعتبر کمک می‌کند و خطر پرچم‌گذاری شدن به‌عنوان اسپمر را کاهش می‌دهد.
استثناها را به درستی مدیریت کنید: مدیریت خطای مناسب را برای به دام انداختن استثناهای احتمالی در هنگام ارسال و تجزیه ایمیل پیاده‌سازی کنید. خطاها را برای اهداف اشکال‌زدایی ثبت کنید.
به محدودیت‌های ایمیل توجه داشته باشید: اکثر ارائه‌دهندگان ایمیل محدودیت‌هایی را در تعداد ایمیل‌هایی که می‌توانید در روز یا ساعت ارسال کنید، دارند. از تجاوز از این محدودیت‌ها برای جلوگیری از تعلیق حساب خودداری کنید.
محتوای ایمیل را پاکسازی کنید: هنگام تولید محتوای ایمیل به‌صورت پویا، ورودی کاربر را پاکسازی کنید تا از آسیب‌پذیری‌های اسکریپت‌نویسی متقابل سایت (XSS) جلوگیری کنید.
DKIM، SPF و DMARC را پیاده‌سازی کنید: این پروتکل‌های احراز هویت ایمیل به جلوگیری از حملات جعل ایمیل و فیشینگ کمک می‌کنند. سرور ایمیل و رکوردهای DNS خود را برای استفاده از این پروتکل‌ها پیکربندی کنید.

ویژگی‌های پیشرفته و کتابخانه‌ها

بسته email پایتون ویژگی‌های پیشرفته زیادی را برای کار با ایمیل‌ها فراهم می‌کند. در اینجا برخی از موارد قابل توجه آورده شده است:

رمزگذاری کاراکتر: بسته email به‌طور خودکار رمزگذاری کاراکتر را مدیریت می‌کند و اطمینان حاصل می‌کند که ایمیل‌ها در کلاینت‌های ایمیل مختلف به درستی نمایش داده می‌شوند.
دستکاری هدر: شما می‌توانید به راحتی هدرهای ایمیل را با استفاده از شیء EmailMessage اضافه، اصلاح و حذف کنید.
رمزگذاری محتوا: بسته email از طرح‌های رمزگذاری محتوای مختلفی مانند Base64 و Quoted-Printable پشتیبانی می‌کند.
سیاست‌های ایمیل: ماژول email.policy به شما امکان می‌دهد تجزیه و تولید پیام‌های ایمیل را سفارشی کنید.

علاوه بر بسته email استاندارد، چندین کتابخانه شخص ثالث می‌توانند مدیریت ایمیل را در پایتون ساده کنند:

yagmail: یک کتابخانه ساده و آسان برای ارسال ایمیل.
Flask-Mail: یک افزونه برای چارچوب وب Flask که ارسال ایمیل از برنامه‌های Flask را ساده می‌کند.
django.core.mail: یک ماژول در چارچوب وب Django برای ارسال ایمیل.

ملاحظات بین‌المللی

هنگام توسعه برنامه‌های ایمیل برای مخاطبان جهانی، جنبه‌های بین‌المللی زیر را در نظر بگیرید:

رمزگذاری کاراکتر: از رمزگذاری UTF-8 برای محتوای ایمیل و هدرها استفاده کنید تا از طیف گسترده‌ای از کاراکترها از زبان‌های مختلف پشتیبانی کنید.
قالب‌های تاریخ و زمان: از قالب‌های تاریخ و زمان مخصوص زبان برای نمایش تاریخ‌ها و زمان‌ها به روشی کاربرپسند استفاده کنید.
پشتیبانی از زبان: ترجمه‌هایی برای قالب‌های ایمیل و رابط‌های کاربری ارائه دهید تا از چندین زبان پشتیبانی شود.
زبان‌های راست به چپ: اگر برنامه شما از زبان‌های راست به چپ (به عنوان مثال، عربی، عبری) پشتیبانی می‌کند، اطمینان حاصل کنید که محتوای ایمیل و طرح‌بندی‌ها به درستی نمایش داده می‌شوند.

نتیجه‌گیری

بسته email پایتون یک ابزار قدرتمند و همه‌کاره برای ساخت و تجزیه پیام‌های MIME است. با درک اصول MIME و استفاده از کلاس‌ها و متدهای مناسب، می‌توانید برنامه‌های ایمیل پیچیده‌ای ایجاد کنید که قالب‌بندی پیچیده، پیوست‌ها و الزامات بین‌المللی را مدیریت می‌کنند. به یاد داشته باشید که از بهترین روش‌ها و دستورالعمل‌های امنیتی پیروی کنید تا اطمینان حاصل شود که برنامه‌های ایمیل شما قابل اعتماد، ایمن و کاربرپسند هستند. از ایمیل‌های متنی ساده گرفته تا پیام‌های چند قسمتی پیچیده با پیوست‌ها، پایتون همه چیز مورد نیاز شما را برای مدیریت مؤثر ارتباطات ایمیل فراهم می‌کند.