Documentation – کار با کلاینت SMTP

Python-Net: راه‌اندازی اتصال کلاینت SMTP

Mon, 01 Jan 0001 00:00:00 +0000

اتصال به سرور SMTP با SSL

برای برقراری اتصال امن با سرور SMTP که از SSL پشتیبانی می‌کند، باید ویژگی‌های کلیدی زیر را پیکربندی کنید SmtpClient کلاس:

هاست: آدرس سرور SMTP (مثلاً smtp.gmail.com)
پورت: پورت مورد استفاده برای ارتباط با SSL (معمولاً ۴۶۵ برای SSL ضمنی یا ۵۸۷ برای SSL/TLS صریح)
نام کاربری: نام حساب استفاده شده برای احراز هویت
رمز عبور: رمز عبور حساب SMTP
گزینه‌های امنیتی: نوع رمزگذاری مورد استفاده (SSLEXPLICIT، SSLIMPLICIT و غیره)

نمونه کد زیر نحوه پیکربندی و اتصال به یک سرور SMTP با SSL را نشان می‌دهد:

تنظیم زمان‌انتظار برای پاسخ خوش‌آمدگویی سرور

هنگام برقراری اتصال با سرور SMTP، سرور معمولاً پس از اتصال موفق، یک رشته خوش‌آمدگویی ارسال می‌کند. این پاسخ تأیید می‌کند که سرور آماده ادامه ارتباط است.

در برخی سناریوها، کلاینت‌های ایمیل در حالت اتصال خودکار عمل می‌کنند و ترکیب‌های متعددی از پروتکل‌های امنیتی و پورت‌ها (مانند SSL ضمنی یا STARTTLS) را برای برقراری اتصال موفق امتحان می‌نمایند. اگر تنظیمات کلاینت با حالت امنیتی مورد انتظار سرور مطابقت نداشته باشد، سرور رشته خوش‌آمدگویی را ارسال نمی‌کند. این ناسازگاری باعث می‌شود کلاینت تا زمان انقضای زمان‌انتظار کلی صبر کند قبل از اینکه ترکیب بعدی را امتحان کند — که منجر به کندی در مدیریت اتصال می‌شود.

برای بهبود این رفتار، Aspose.Email ارائه می‌دهد greeting_timeout ویژگی در SmtpClient کلاس. این ویژگی زمان‌انتظار خاصی (به میلی‌ثانیه) برای انتظار رشته خوش‌آمدگویی سرور تنظیم می‌کند. اگر خوش‌آمدگویی در زمان تعیین‌شده دریافت نشود، کلاینت بلافاصله پیکربندی بعدی را امتحان می‌کند — که فرآیندهای اتصال خودکار را به‌طور چشمگیری سرعت می‌بخشد.

نمونه کد زیر نشان می‌دهد چگونه این ویژگی را در یک پروژه پیاده‌سازی کنید:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("localhost", 25, "username", "password")
client.greeting_timeout = 4000

ارسال ایمیل‌ها از طریق SMTP با استفاده از پروکسی SOCKS

Aspose.Email از نسخه‌های ۴، ۴a و ۵ پروتکل پروکسی SOCKS پشتیبانی می‌کند. نمونه کد زیر نشان می‌دهد چگونه با استفاده از پروکسی SOCKS ایمیلی را از طریق SMTP ارسال کنید:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("smtp.domain.com", "username", "password")

client.security_options = ae.clients.SecurityOptions.SSL_IMPLICIT
# proxy address
proxy_address = "192.168.203.142"
#proxy port
proxy_port = 1080
socks_proxy = ae.clients.SocksProxy(proxy_address, proxy_port, ae.clients.SocksVersion.SOCKS_V5)
client.proxy = socks_proxy
client.send(ae.MailMessage("sender@domain.com", "receiver@domain.com", "Sending Email via proxy", "Implement socks proxy protocol for versions 4, 4a, 5 (only Username/Password authentication)"))

ارسال ایمیل‌ها از طریق SMTP با استفاده از پروکسی HTTP

نمونه کد زیر استفاده از پروکسی HTTP برای ارسال ایمیل از طریق سرور SMTP را نشان می‌دهد:

import aspose.email as ae

http_proxy = ae.clients.HttpProxy("18.222.124.59", 8080)
client = ae.clients.smtp.SmtpClient("host", 587, "username", "password")
client.proxy = http_proxy
client.send(ae.MailMessage("sender@domain.com", "receiver@domain.com", "Sending Email via proxy", "Body"))

انتخاب روش‌های احراز هویت SMTP پشتیبانی‌شده در Python

برای اطمینان از یک اتصال امن و سازگار با سرور SMTP، استفاده از روش احراز هویتی که هم توسط کلاینت و هم توسط سرور پشتیبانی می‌شود اهمیت دارد. Aspose.Email برای Python از طریق .NET امکان‌پذیری داخلی ارائه می‌دهد ویژگی‌ها برای مدیریت این مورد:

supported_authentication — دریافت فهرستی از روش‌های احراز هویت پشتیبانی‌شده توسط سرور SMTP.
allowed_authentication — دریافت یا تنظیم روش‌های احراز هویت که کلاینت اجازه استفاده از آن‌ها را دارد.

با استفاده از این ویژگی‌ها، توسعه‌دهندگان می‌توانند قابلیت‌های کلاینت را با الزامات سرور همسو کنند و از بروز خطاهای احراز هویت در طول فرایند اتصال جلوگیری نمایند.

قطعه کد زیر نشان می‌دهد چگونه روش احراز هویت SMTP مجاز را با استفاده از allowed_authentication ویژگی:

client.allowed_authentication = ae.clients.smtp.SmtpKnownAuthenticationType.LOGIN

تنظیم زمان‌انتظار سرور SMTP

هنگامی که ایمیل‌ها را از طریق شبکه ارسال می‌کنید، تعیین زمان‌انتظاری مناسب برای جلوگیری از قفل شدن برنامه در صورتی که سرور پاسخ ندهد، ضروری است. timeout ویژگی SmtpClient کلاس در Aspose.Email برای Python از طریق .NET به شما اجازه می‌دهد حداکثر زمان انتظار (به میلی‌ثانیه) برای پاسخ‌های سرور را تعریف کنید.

این ویژگی برای عملیات‌هایی مانند برقراری اتصال یا ارسال دستورات SMTP اعمال می‌شود. اگر سرور در مدت زمان مشخص پاسخ ندهد، کلاینت یک استثناء زمان‌انتظار را پرتاب می‌کند که به شما کمک می‌کند سرورهای بدون پاسخ را به‌طور مؤثرتری مدیریت کنید.

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

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("host", 587, "username", "password", ae.clients.SecurityOptions.SSL_EXPLICIT)
# 60 seconds
client.timeout = 60000

فعال‌سازی رمزگذاری TLS برای اتصال‌های امن SMTP

Aspose.Email ارتباط امن با سرورهای SMTP را با استفاده از پروتکل‌های کریپتوگرافی SSL و TLS پشتیبانی می‌کند. این پروتکل‌ها به حفاظت از داده‌های مبادله‌شده بین برنامه شما و سرور ایمیل کمک می‌کنند و محرمانگی و یکپارچگی را در هنگام انتقال تضمین می‌نمایند.

NOTE: Only versions of SSL/TLS supported by your current Python framework can be applied. Unsupported protocol versions will be silently ignored without raising exceptions. If you need to bypass compatibility checks and explicitly set the encryption protocols, use the `set_supported_encryption_unsafe(value)` method of the [SmtpClient](https://reference.aspose.com/email/python-net/aspose.email.clients.smtp/smtpclient/#smtpclient-class) class.

مثال کد زیر نشان می‌دهد چگونه TLS 1.3 را برای ارتباط SMTP تنظیم کنید:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("host", 587, "username", "password", ae.clients.SecurityOptions.SSL_EXPLICIT)
client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS13

استفاده از مکانیزم CRAM-MD5 برای احراز هویت

Aspose.Email برای Python از طریق .NET از مکانیزم احراز هویت CRAM-MD5 پشتیبانی می‌کند که با جلوگیری از ارسال رمزهای عبور به صورت متن ساده در هنگام احراز هویت SMTP، امنیت را ارتقا می‌دهد. این روش به‌ویژه هنگام اتصال به سرورهایی که احراز هویت چالش-پاسخ را می‌طلبند مفید است.

برای فعال‌سازی احراز هویت CRAM-MD5، مقدار allowed_authentication ویژگی SmtpClient کلاس به CRAM_MD5، همان‌طور که در نمونه کد زیر نشان داده شده است:

client.allowed_authentication = ae.clients.smtp.SmtpKnownAuthenticationType.CRAM_MD5

Python-Net: ارسال ایمیل‌ها و فوروارد پیام‌ها از طریق SMTP در Python

Mon, 01 Jan 0001 00:00:00 +0000

این SmtpClient کلاس در Aspose.Email برای Python از طریق .NET یک رابط قوی و انعطاف‌پذیر برای ارسال ایمیل‌ها با استفاده از پروتکل انتقال ایمیل ساده (SMTP) فراهم می‌کند. این نقطه‌ی ورودی اصلی برای توسعه دهندگانی است که می‌خواهند پیام‌های ایمیل را در برنامه‌های خود تحویل دهند.

ویژگی‌های کلیدی SmtpClient شامل کلاس:

تحویل ایمیل SMTP: ارسال ایمیل‌ها را به‌صورت مستقیم از طریق سرور SMTP ممکن می‌سازد.
گزینه‌های تحویل جایگزین: از روش‌های تحویل اضافی مانند ذخیرهٔ پیام‌ها در سیستم فایل یا نوشتن در صف پیام پشتیبانی می‌کند.
عملیات‌های همزمان و ناهمزمان:
- حالت همزمان: از متدهای Send برای مسدود کردن رشتهٔ جاری تا زمان ارسال کامل ایمیل استفاده کنید.
- حالت ناهمزمان: از متدهای SendAsync برای ارسال پیام‌ها در پس‌زمینه استفاده کنید تا برنامه پاسخگو بماند.
پشتیبانی TNEF: امکان ارسال پیام‌ها در قالب Transport Neutral Encapsulation Format (TNEF) برای سازگاری با ویژگی‌های Microsoft Outlook را می‌دهد.

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

ارسال ایمیل‌ها به‌صورت همزمان

این SmtpClient.send متد امکان ارسال پیام ایمیل به‌صورت همزمان را فراهم می‌کند. این روش زمانی مفید است که برنامه نیاز دارد تحویل را قبل از ادامه تایید کند.

برای ارسال ایمیل متن ساده به‌صورت همزمان با استفاده از Aspose.Email برای Python از طریق .NET، از مراحل و نمونه کد زیر استفاده کنید:

ایجاد یک MailMessage نمونه و تنظیم فرستنده، گیرنده(ها)، موضوع و بدنه.
پیکربندی SmtpClient با اطلاعات سرور شامل میزبان، پورت، نام کاربری و رمز عبور.
متد را فراخوانی کنید send متد روی SmtpClient نمونه و پاس دادن در MailMessage شیء.

# Create email
eml = ae.MailMessage()
eml.subject = "Message with Plain Text Body"
eml.body = "This is text body."
eml.from_address = "from@gmail.com"
eml.to.append(ae.MailAddress("to@gmail.com", "Recipient 1")) 

# Configure SmtpClient object
client = SmtpClient("smtp.gmail.com", 995, "username", "password")
client.security_options = SecurityOptions.AUTO 

# Send email
client.send(eml)

ارسال ایمیل به‌صورت ناهمزمان توسط API پشتیبانی نمی‌شود.

ارسال یک فایل EML از پیش ساخته شده از طریق SMTP

اگر نیاز دارید پیام ایمیلی که قبلاً ساخته و در قالب EML ذخیره شده است را بفرستید، می‌توانید آن را به‌صورت برنامه‌نویسی با استفاده از Aspose.Email برای Python از طریق .NET بارگذاری و ارسال کنید.

کد نمونه زیر به همراه مراحل نشان می‌دهد چگونه یک فایل EML را با استفاده از SmtpClient:

فایل EML را با استفاده از MailMessage.load متد.
یک نمونه از … را ایجاد و پیکربندی کنید SmtpClient، با ارائهٔ میزبان سرور SMTP، نام کاربری و رمز عبور برای احراز هویت.
متد را فراخوانی کنید send متد روی SmtpClient نمونه را ایجاد کنید و پیام بارگذاری‌شده را پاس کنید.

import aspose.email as ae

message = ae.MailMessage.load("test.eml")

# Send this message using SmtpClient
client = ae.clients.SmtpClient("host", "username", "password")
client.send(message)

ارسال ایمیل متن ساده

می‌توانید با استفاده از Aspose.Email، ایمیل متن ساده را با تعیین بدنه پیام به‌صورت متن ساده ارسال کنید. MailMessage.body ویژگی برای تعریف محتوا استفاده می‌شود، در حالی که SmtpClient کلاس فرآیند ارسال را مدیریت می‌کند.

کد نمونه زیر به همراه مراحل نشان می‌دهد چگونه یک ایمیل متن ساده ارسال شود:

یک نمونه از MailMessage کلاس.
آدرس‌های ایمیل فرستنده و گیرنده را تنظیم کنید.
محتوای متن ساده را به ویژگی body اختصاص دهید.
یک نمونه از SmtpClient کلاس با جزئیات سرور و اعتبارنامه‌ها.
ارسال ایمیل با استفاده از send متد.

ارسال ایمیل HTML

Aspose.Email برای Python از طریق .NET به شما امکان می‌دهد ایمیل‌ها را با بدنه‌های قالب‌بندی شده HTML ارسال کنید با استفاده از MailMessage کلاس. با اختصاص محتوای HTML به html_body ویژگی و تنظیم is_body_html به True تنظیم کنید، می‌توانید پیام‌های غنی و قالب‌بندی‌شده بسازید.

کد نمونه زیر به همراه مراحل نشان می‌دهد چگونه یک ایمیل HTML ارسال شود:

یک نمونه از MailMessage کلاس.
آدرس‌های ایمیل فرستنده و گیرنده را تنظیم کنید.
تنظیم is_body_html = True برای نشان دادن قالب‌بندی HTML.
محتوای HTML خود را به html_body ویژگی.
ایجاد و پیکربندی SmtpClient نمونه.
از send متد برای انتقال پیام.

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

ارسال ایمیل HTML با متن ساده به عنوان جایگزین

هنگام ارسال ایمیل‌های HTML، بهترین روش این است که نسخهٔ متن ساده را برای دریافت‌کنندگانی که کلاینت ایمیل آنها از HTML پشتیبانی نمی‌کند، اضافه کنید. Aspose.Email برای Python از طریق .NET این امکان را فراهم می‌کند. AlternateView کلاس برای شامل‌کردن هر دو محتوای HTML و متن ساده در یک پیام واحد، سازگاری و تجربه کاربری را ارتقا می‌دهد.

کد نمونه زیر و مراحل نشان می‌دهند چگونه ایمیلی با محتوای متنی جایگزین ارسال کنید:

یک نمونه از MailMessage کلاس.
آدرس‌های ایمیل فرستنده و گیرنده را تنظیم کنید.
محتوای HTML را به html_body ویژگی و تنظیم is_body_html = True.
یک AlternateView متن ساده ایجاد کنید با استفاده از create_alternate_view_from_string.
نمای جانبی را به alternate_views مجموعهٔ MailMessage.
ایجاد و پیکربندی SmtpClient نمونه.
ارسال ایمیل با استفاده از send متد.

نحوه ارسال ایمیل‌های دسته‌ای

ارسال ایمیل‌های دسته‌ای شامل ارسال همزمان چندین پیام — که هر کدام ممکن است به گیرنده متفاوتی ارسال شود. Aspose.Email این قابلیت را با استفاده از SmtpClient کلاس.

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

یک نمونه از SmtpClient کلاس و میزبان، پورت، اعتبارنامه‌ها و تنظیمات امنیتی آن را پیکربندی کنید.
چندین MailMessage نمونه‌ها — هر کدام نمایانگر یک پیام ایمیل جداگانه هستند.
فرستنده، گیرنده، موضوع و بدنه پیام را برای هر ایمیل مشخص کنید.
همه را اضافه کنید MailMessage اشیا به یک MailMessageCollection.
متد را فراخوانی کنید send متد از SmtpClient کلاس، با پاس کردن MailMessageCollection به‌عنوان آرگومان.

import aspose.email as ae
from aspose.email.clients import SmtpClient, SecurityOptions
from aspose.email import MailMessage, MailMessageCollection

# Create individual email messages
message1 = MailMessage("from@gmail.com", "to1@gmail.com", "Bulk Email - Message 1", "Hello, this is message 1.")
message2 = MailMessage("from@gmail.com", "to2@gmail.com", "Bulk Email - Message 2", "Hello, this is message 2.")
message3 = MailMessage("from@gmail.com", "to3@gmail.com", "Bulk Email - Message 3", "Hello, this is message 3.")

# Add messages to a collection
many_messages = MailMessageCollection()
many_messages.append(message1)
many_messages.append(message2)
many_messages.append(message3)

# Configure SMTP client
client = SmtpClient("smtp.gmail.com", 995, "username", "password")
client.security_options = SecurityOptions.AUTO

# Send all messages in bulk
client.send(many_messages)

ارسال ایمیل‌ها با پشتیبانی از چنداتصال

Aspose.Email برای Python از طریق .NET به شما اجازه می‌دهد هنگام ارسال ایمیل‌ها از طریق SmtpClient کلاس. این ویژگی می‌تواند هنگام ارسال حجم بالای ایمیل با توزیع بار کاری در چندین اتصال، عملکرد را بهینه‌سازی کند. با این حال، توجه داشته باشید که فعال‌سازی حالت چنداتصال تضمین‌کننده افزایش عملکرد در تمام سناريوها نیست — این موضوع به پیکربندی سرور و شرایط شبکه بستگی دارد.

ویژگی‌های کلیدی:

use_multi_connection: حالت چنداتصال برای مشتری SMTP را فعال یا غیرفعال می‌کند.
connections_quantity: تعداد اتصال‌هایی را که هنگام فعال‌سازی حالت چنداتصال باز می‌شوند، مشخص می‌کند.

کد نمونه زیر نشان می‌دهد چگونه حالت چنداتصال را فعال کنید:

یک نمونه از … را ایجاد و پیکربندی کنید SmtpClient.
جزئیات سرور مانند میزبان، پورت، نام کاربری، رمز عبور و رمزنگاری را تنظیم کنید.
حالت چنداتصال را با تنظیم فعال کنید use_multi_connection.
تعداد اتصالات را با connections_quantity.

import aspose.email as ae

client = ae.clients.smtp.SmtpClient
client.host = "<HOST>"
client.username = "<USERNAME>"
client.password = "<PASSWORD>"
client.port = 587
client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS
client.security_options = ae.clients.SecurityOptions.SSL_EXPLICIT

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
client.send(messages)

ارسال ایمیل‌های قالب‌بندی شده با TNEF

قالب حمل‌ونقل خنثی (TNEF) یک قالب ایمیل اختصاصی است که توسط Microsoft Outlook و Exchange برای حفظ قالب‌بندی‌های غنی، اشیاء جاسازی شده و ویژگی‌های خاص مانند دکمه‌های نظرسنجی استفاده می‌شود. کلاینت‌های ایمیل استاندارد ممکن است این قالب‌بندی را هنگام استفاده از پیام‌های مبتنی بر MIME معمولی حفظ نکنند.

Aspose.Email برای Python از طریق .NET از ارسال ایمیل‌ها در قالب TNEF پشتیبانی می‌کند تا تمام قالب‌بندی‌ها و ویژگی‌های پیشرفته حفظ شوند. این کار با فعال‌سازی use_tnef ویژگی SmtpClient کلاس.

کد نمونه زیر و مراحل نشان می‌دهند چگونه یک ایمیل TNEF ارسال شود:

یک پیام EML موجود را بارگذاری کنید یا با استفاده از MailMessage کلاس.
آدرس‌های فرستنده و گیرنده را تنظیم کنید.
قالب‌بندی TNEF را با تنظیم فعال کنید use_tnef = True روی SmtpClient نمونه.
پیام را با استفاده از send() متد.

ارسال درخواست‌های جلسه از طریق ایمیل

Microsoft Outlook و دیگر کلاینت‌های ایمیل با قابلیت تقویم مانند IBM Lotus Notes به کاربران امکان می‌دهند قرارهای ملاقات را مستقیماً از صندوق ورودی مدیریت کنند. زمانی که کاربر یک دعوت‌نامه جلسه دریافت می‌کند، می‌تواند آن را مستقیماً در کلاینت ایمیل خود بپذیرد یا رد کند. با Aspose.Email برای Python از طریق .NET، توسعه‌دهندگان می‌توانند به‌صورت برنامه‌نویسی این دعوت‌نامه‌های جلسه را با رعایت استاندارد iCalendar (RFC 2445) ایجاد و ارسال کنند.

نحوه ارسال دعوت‌نامه‌های جلسه از طریق ایمیل

Aspose.Email پشتیبانی داخلی برای نوشتن و ارسال درخواست‌های ملاقات iCalendar به‌عنوان بخشی از ایمیل فراهم می‌کند. این درخواست‌ها با کلاینت‌های تقویم محبوب سازگارند و به دریافت‌کنندگان امکان پاسخ‌گویی به دعوت‌نامه‌ها را به‌صورت آسان می‌دهند.

|درخواست جلسه iCalendar ارسال شده توسط ایمیل| | :- | ||

کد نمونه زیر نشان می‌دهد چگونه درخواست‌ها را از طریق ایمیل ارسال کنید:

ایجاد یک MailMessage نمونه.
آدرس‌های ایمیل فرستنده و گیرنده را مشخص کنید.
یک Appointment شیء با مکان، زمان شروع/پایان، فرستنده و گیرندگان.
خلاصه و توصیف قرار ملاقات را تنظیم کنید.
قرار دادن قرار ملاقات به ایمیل با استفاده از add_alternate_view().
ارسال ایمیل با استفاده از SmtpClient.

پشتیبانی iCalendar برای IBM Lotus Notes

Aspose.Email از قالب iCalendar (RFC 2445) استفاده می‌کند که اطمینان می‌دهد درخواست‌های جلسه شما با Microsoft Outlook، IBM Lotus Notes و هر کلاینت دیگری که از این استاندارد پشتیبانی می‌کند سازگار باشد. همان فرآیند می‌تواند بدون توجه به پلتفرم گیرنده استفاده شود.

ارسال ایمیل‌های پیشرو با استفاده از کلاینت SMTP

انتقال ایمیل‌ها یک کار رایج در ارتباطات دیجیتالی است و اغلب برای اشتراک‌گذاری پیام‌های دریافت‌شده با دیگران استفاده می‌شود. Aspose.Email برای Python از طریق .NET به توسعه‌دهندگان اجازه می‌دهد ایمیل‌ها را به‌صورت برنامه‌نویسی با استفاده از SmtpClient کلاس. متد forward امکان ارسال مجدد ایمیل‌های ذخیره‌شده یا دریافت‌شده به گیرندگان جدید بدون درگیر کردن فرستنده اصلی را فراهم می‌کند.

در زیر یک کد نمونه وجود دارد که نشان می‌دهد چگونه یک ایمیل را با استفاده از MailMessage کلاس:

ارسال مستقیم فایل‌های EML بدون بارگذاری در MailMessage

Aspose.Email همچنین از ارسال مستقیم فایل‌های .eml بدون بارگذاری اولیه آن‌ها به یک MailMessage شیء. این به‌ویژه در سناریوهایی که نیاز به کاهش مصرف حافظه سیستم است مفید می‌باشد.

کد نمونه زیر نشان می‌دهد چگونه یک فایل EML را به‌صورت مستقیم ارسال کنید:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient(host, smtp_port, username, password, ae.clients.SecurityOptions.AUTO)
file = open("test.eml", "rb")
client.forward(sender, recipients, file)

Python-Net: بازیابی افزونه‌های سرور SMTP | اعتبارسنجی اعتبارنامه‌های SMTP

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email SmtpClient کلاس ویژگی‌های پیشرفته‌ای فراتر از ارسال ایمیل‌ها فراهم می‌کند. این امکان را به توسعه‌دهندگان می‌دهد تا:

بازیابی افزونه‌های پشتیبانی‌شده توسط سرور مانند IDLE، UNSELECT، QUOTA و غیره، برای اطمینان از سازگاری پیش از استفاده از ویژگی‌های خاص.
اعتبارسنجی اعتبارنامه‌های SMTP بدون ارسال واقعی ایمیل، که برای تأیید ورود و تست اتصال مفید است.

بازیابی افزونه‌های سرور SMTP

قبل از استفاده از ویژگی‌های خاص SMTP، بررسی این که سرور ایمیل چه افزونه‌هایی را پشتیبانی می‌کند مفید است. این get_capabilities() متد این موارد را به عنوان یک لیست از رشته‌ها بازیابی می‌کند.

قطعه کد زیر نشان می‌دهد چگونه افزونه‌های سرور را بازیابی کنید:

اعتبارسنجی اعتبارنامه‌های SMTP بدون ارسال ایمیل

برای بررسی صحت اعتبارنامه‌های ارائه‌شده — بدون ارسال پیام آزمایشی — می‌توانید از validate_credentials() متد از SmtpClient کلاس. این برای بررسی‌های احراز هویت و تشخیص‌های سیستمی مفید است.

نمونه کد زیر می‌تواند برای تأیید اعتبارنامه‌های ورود ارائه‌شده برای احراز هویت با سرور SMTP بدون ارسال ایمیل استفاده شود:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("Url", port, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 4000   # Set timeout in milliseconds

# Validate login
if client.validate_credentials():
    print("Credentials are valid.")
else:
    print("Invalid credentials or unable to connect.")

Python-Net: فعال‌سازی ثبت فعالیت‌های کلاینت SMTP

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email برای Python از طریق .NET پشتیبانی داخلی برای ثبت فعالیت SMTP ارائه می‌دهد. این ویژگی — که به طور معمول به عنوان ثبت فعالیت شناخته می‌شود — به توسعه‌دهندگان امکان می‌دهد تراکنش‌های ایمیلی، رویدادها یا خطاها را به صورت سیستماتیک در طول فرایند ارسال ردیابی کنند. این می‌تواند به‌ویژه برای اشکال‌زدایی، حسابرسی یا حفظ شفافیت عملیاتی در برنامه‌های سمت سرور مفید باشد.

این SmtpClient کلاس ویژگی‌های زیر را برای فعال‌سازی و پیکربندی ثبت فعالیت ارائه می‌دهد:

log_file_name: مسیر کامل و نام فایل لاگ را مشخص می‌کند.
use_date_in_log_file_name: تعیین می‌کند آیا تاریخ فعلی به نام فایل لاگ اضافه شود یا نه، که برای ایجاد لاگ‌های روزانه مفید است.

نمونه کد زیر نشان می‌دهد چگونه ثبت فعالیت SMTP را در کد برنامه فعال کنید:

import aspose.email as ae

# Initialize and configure the SMTP client
client = ae.clients.smtp.SmtpClient
client.host = "<HOST>"
client.username = "<USERNAME>"
client.password = "<PASSWORD>"
client.port = 587
client.security_options = ae.clients.SecurityOptions.SSL_EXPLICIT

# Set the log file name and enable/disable date in file name
client.log_file_name = "C:\Aspose.Email.Smtp.log"

# Set to True to append current date
client.use_date_in_log_file_name = False

# Prepare and send the email
eml = ae.MailMessage("from address", "to address", "this is a test subject", "this is a test body")
client.send(eml)

Python-Net: ویژگی‌های کمکی - مشتری SMTP

Mon, 01 Jan 0001 00:00:00 +0000

فهرست‌کردن سرویس‌گیرندگان افزونه با استفاده از Smtp Client

Pop3Client Aspose.Email به شما اجازه می‌دهد افزونه‌های سروری که سرور پشتیبانی می‌کند مانند IDLE، UNSELECT، QUOTA و غیره را بازیابی کنید. این کار به شناسایی موجود بودن یک افزونه قبل از استفاده از کلاینت برای آن قابلیت خاص کمک می‌کند. متد GetCapabilities() انواع افزونه‌های پشتیبانی‌شده را به‌صورت یک آرایهٔ رشته‌ای برمی‌گرداند.

دریافت افزونه‌های سرور

قطعه کد زیر نشان می‌دهد چگونه افزونه‌های سرور را بازیابی کنید.

اعتبارسنجی اعتبارهای سرور ایمیل بدون ارسال ایمیل

متد ‘validate_credentials()’ از SmtpClient کلاس برای بررسی معتبر بودن اعتبارهای ارائه‌شده با برقراری اتصال به سرور SMTP استفاده می‌شود. اگر اعتبارها معتبر بوده و اتصال موفق باشد، می‌توان اقدامات بیشتری انجام داد. کد نمونه زیر می‌تواند برای تأیید اعتبارهای ارائه‌شده برای احراز هویت با سرور SMTP بدون ارسال ایمیل استفاده شود:

import aspose.email as ae

client = ae.clients.smtp.SmtpClient("Url", port, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 4000

if client.validate_credentials():
  # to do something