From 4e0eb5de70d760ebcc57e745032c6bef7dcc821d Mon Sep 17 00:00:00 2001 From: Ali Najmabadi Date: Thu, 28 Nov 2024 17:01:33 +0330 Subject: [PATCH] docs: some updates --- src/components/Sidebar/data.js | 14 +- .../how-tos/connect-via-platform/django.mdx | 90 ++++++++- .../how-tos/connect-via-platform/dotnet.mdx | 170 +++++++++++++++- .../how-tos/connect-via-platform/flask.mdx | 106 +++++++++- .../how-tos/connect-via-platform/ghost.mdx | 37 ++++ .../how-tos/connect-via-platform/go.mdx | 115 ++++++++++- .../how-tos/connect-via-platform/laravel.mdx | 185 +++++++++++++++++- .../how-tos/connect-via-platform/nextjs.mdx | 108 +++++++++- .../how-tos/connect-via-platform/nodejs.mdx | 102 +++++++++- .../how-tos/connect-via-platform/php.mdx | 109 ++++++++++- .../how-tos/connect-via-platform/python.mdx | 92 ++++++++- .../connect-via-platform/wordpress.mdx | 87 +++++++- src/pages/overview/about.mdx | 100 ++++++++-- src/pages/paas/about.mdx | 2 + src/pages/paas/docker/getting-started.mdx | 2 + src/pages/paas/docker/related-apps/bun.mdx | 75 +++++++ src/pages/paas/docker/related-apps/deno.mdx | 74 +++++++ src/pages/references/console/about.mdx | 4 +- 18 files changed, 1421 insertions(+), 51 deletions(-) create mode 100644 src/pages/paas/docker/related-apps/bun.mdx create mode 100644 src/pages/paas/docker/related-apps/deno.mdx diff --git a/src/components/Sidebar/data.js b/src/components/Sidebar/data.js index 8c3ecdc1..2f713599 100644 --- a/src/components/Sidebar/data.js +++ b/src/components/Sidebar/data.js @@ -3006,6 +3006,16 @@ export default { icon: , link: "/paas/docker/related-apps/arangodb" }, + { + title: "Deno", + icon: , + link: "/paas/docker/related-apps/deno" + }, + { + title: "Bun", + icon: , + link: "/paas/docker/related-apps/bun" + }, { title: "Seq", icon: , @@ -8821,11 +8831,11 @@ export default { hr: true }, { - title: "مدیریت حساب‌کاربری", + title: "مدیریت حساب کاربری", link: "/references/console/manage-accounts" }, { - title: "ارتقا سطح حساب‌کاربری", + title: "ارتقا سطح حساب کاربری", link: "/references/console/upgrade-user-level" }, { diff --git a/src/pages/email-server/how-tos/connect-via-platform/django.mdx b/src/pages/email-server/how-tos/connect-via-platform/django.mdx index 3354e309..6e21eaf8 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/django.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/django.mdx @@ -36,6 +36,11 @@ import Head from "next/head";

+ + برای استفاده از سرویس ایمیل در برنامه‌های Django، کافیست تا طبق مستندات SMTP، یک دسترسی SMTP و طبق مستندات افزودن نشانی، یک نشانی برای ایمیل‌سرور خود، ایجاد کنید. در ادامه نیز، بایستی @@ -46,7 +51,7 @@ import Head from "next/head";
{`MAIL_HOST=smtp.c1.liara.email -MAIL_PORT=587 +MAIL_PORT=465 MAIL_USER=hopeful_zhukovsky_9daqpv MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d MAIL_FROM_ADDRESS=info@example.com`} @@ -73,12 +78,83 @@ EMAIL_FROM_ADDRESS = os.getenv('MAIL_FROM_ADDRESS')`}
+ +تمامی کارها انجام شده است و شما می‌توانید از ایمیل‌سرور خود استفاده کنید؛ به عنوان مثال، می‌توانید یک app جدید ایجاد +کنید و views.py آن را همانند قطعه کد زیر، بنویسید: + +
+
+ + {`from django.core.mail import EmailMessage +from django.http import HttpResponse +from django.conf import settings + +def send_test_email(request): + subject = 'Test Email from Django' + message = 'This is a test email sent from Django using SMTP on Liara server.' + recipient_list = ['recipient@example.com'] + + email = EmailMessage( + subject, + message, + settings.EMAIL_FROM_ADDRESS, + recipient_list, + headers={"x-liara-tag": "test-tag"} # using liara tag feature, + ) + + + email.send(fail_silently=False) + return HttpResponse('Test email sent successfully!') `} + +
+
+ + , + <> + +برای استفاده از سرویس ایمیل در برنامه‌های Django، کافیست +تا طبق مستندات SMTP، یک دسترسی SMTP و طبق مستندات افزودن نشانی، یک نشانی برای ایمیل‌سرور خود، ایجاد کنید. +در ادامه نیز، بایستی +اطلاعات مربوط به ایمیل‌سرور خود را +به متغیرهای محیطی برنامه خود، اضافه کنید؛ به عنوان مثال: + +
+
+ + {`MAIL_HOST=smtp.c1.liara.email +MAIL_PORT=587 +MAIL_USER=hopeful_zhukovsky_9daqpv +MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d +MAIL_FROM_ADDRESS=info@example.com`} + +
+

+مقدار فیلد MAIL_FROM_ADDRESS باید یکی از نشانی‌های اضافه شده در سرویس ایمیل باشد. +

+ + +حال، بایستی قطعه کدی مشابه قطعه کد زیر را به فایل settings.py خود، اضافه کنید: +
+
+ + {`EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend' +EMAIL_HOST = os.getenv('MAIL_HOST') +EMAIL_PORT = os.getenv('MAIL_PORT') +EMAIL_HOST_USER = os.getenv('MAIL_USER') +EMAIL_HOST_PASSWORD = os.getenv('MAIL_PASSWORD') +EMAIL_USE_TLS = True # Use STARTTLS encryption +EMAIL_FROM_ADDRESS = os.getenv('MAIL_FROM_ADDRESS')`} + +
+
+{/* +

برای ارسال امن‌تر ایمیل‌ها، می‌توانید مقدار Port را بر روی 465 قرار دهید تا به جای STARTTLS، از TLS استفاده شود.

- + */} @@ -112,4 +188,14 @@ def send_test_email(request):
+ + ]} +/> + + +

+همچنین بخوانید: پورت‌های ایمیل‌سرور لیارا +

+ + \ No newline at end of file diff --git a/src/pages/email-server/how-tos/connect-via-platform/dotnet.mdx b/src/pages/email-server/how-tos/connect-via-platform/dotnet.mdx index be8baabd..0ff3783c 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/dotnet.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/dotnet.mdx @@ -36,6 +36,11 @@ import Head from "next/head";

+ + برای استفاده از سرویس ایمیل در برنامه‌های NET. کافیست تا طبق مستندات SMTP، یک دسترسی SMTP و طبق مستندات افزودن نشانی، یک نشانی برای ایمیل‌سرور خود، ایجاد کنید. در نهایت نیز، بایستی @@ -46,7 +51,7 @@ import Head from "next/head";
{`MAIL_HOST=smtp.c1.liara.email -MAIL_PORT=587 +MAIL_PORT=465 MAIL_USER=hopeful_zhukovsky_9daqpv MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d MAIL_FROM_ADDRESS=info@example.com`} @@ -125,10 +130,159 @@ app.Run(); با تنظیم EnableSsl = true، می‌توانید به‌صورت امن اقدام به ارسال ایمیل‌های تراکنشی کنید.

+ +برای استفاده از ایمیل‌سرور در کنترلر، می‌توانید مشابه قطعه کد زیر، عمل کنید: + +
+
+ + {`using MimeKit; +using MailKit.Net.Smtp; +using DotNetEnv; // for install this, run: dotnet install add package DotNetEnv + +namespace your_project_name.Controllers; + +public class TestController : Controller +{ + [HttpPost] + public IActionResult SendEmail(string email) + { + // Email Information + Env.Load(); + string senderName = Env.GetString("SENDER_NAME"); + string senderEmail = Env.GetString("SENDER_ADDRESS"); + string subject = Env.GetString("EMAIL_SUBJECT"); + string body = Env.GetString("EMAIL_BODY"); + + // Email Instance + var message = new MimeMessage(); + message.From.Add(new MailboxAddress(senderName, senderEmail)); + message.To.Add(new MailboxAddress("Recipient", email)); + message.Subject = subject; + + // Creating The Body + message.Body = new TextPart("plain") + { + Text = body + }; + + try + { + // Sending Email + using (var client = new SmtpClient()) + { + client.Connect(Env.GetString("MAIL_HOST"), Env.GetInt("MAIL_PORT"), false); + client.Authenticate(Env.GetString("MAIL_USERNAME"), Env.GetString("MAIL_PASSWORD")); + client.Send(message); + client.Disconnect(true); + } + + ViewBag.Message = "Email Sent Successfully."; + } + catch (Exception ex) + { + ViewBag.Message = $"Error In Sending Email: {ex.Message}"; + } + + + return RedirectToAction("Index"); + } + +} +`} + +
+
+ , + <> + +برای استفاده از سرویس ایمیل در برنامه‌های NET. +کافیست تا طبق مستندات SMTP، یک دسترسی SMTP و طبق مستندات افزودن نشانی، یک نشانی برای ایمیل‌سرور خود، ایجاد کنید. +در نهایت نیز، بایستی +اطلاعات مربوط به ایمیل‌سرور خود را +به متغیرهای محیطی برنامه خود، اضافه کنید؛ به عنوان مثال: + +
+
+ + {`MAIL_HOST=smtp.c1.liara.email +MAIL_PORT=587 +MAIL_USER=hopeful_zhukovsky_9daqpv +MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d +MAIL_FROM_ADDRESS=info@example.com`} + +
+
+ +

+مقدار فیلد MAIL_FROM_ADDRESS باید یکی از نشانی‌های اضافه شده در سرویس ایمیل باشد. +

+ + + +در نهایت می‌توانید در پروژه‌ی خود مانند مثال زیر عمل کرده و با استفاده از دسترسی SMTP سرویس ایمیل لیارا، +اقدام به ارسال ایمیل‌های تراکنشی کنید: + +
+
+ + {`using System.Net; +using System.Net.Mail; +using dotenv.net; + +DotEnv.Load(); // Load the environment variables from .env file + +var builder = WebApplication.CreateBuilder(args); +var app = builder.Build(); + +app.MapGet("/send-test-email", async context => +{ + // Read SMTP settings from environment variables + var smtpHost = Environment.GetEnvironmentVariable("MAIL_HOST"); + int smtpPort = int.Parse(Environment.GetEnvironmentVariable("MAIL_PORT") ?? "587"); + var smtpUser = Environment.GetEnvironmentVariable("MAIL_USER"); + var smtpPassword = Environment.GetEnvironmentVariable("MAIL_PASSWORD"); + var fromAddress = Environment.GetEnvironmentVariable("MAIL_FROM_ADDRESS") ?? "info@example.com"; + var toAddress = "recipient@example.com"; // Replace with recipient's email address + + // Create a new SmtpClient + using (var smtpClient = new SmtpClient(smtpHost, smtpPort)) + { + smtpClient.EnableSsl = true; // Use STARTTLS encryption + smtpClient.Credentials = new NetworkCredential(smtpUser, smtpPassword); + + // Create the email message + var mailMessage = new MailMessage(fromAddress, toAddress) + { + Subject = "Test Email", + Body = "

This is a test email sent from a .NET Core application using SMTP

", + IsBodyHtml = true + }; + + // Add custom headers + mailMessage.Headers.Add("x-liara-tag", "test-tag"); + + // Send the email + try + { + await smtpClient.SendMailAsync(mailMessage); + await context.Response.WriteAsync("Test email sent successfully!"); + } + catch (Exception ex) + { + await context.Response.WriteAsync($"Failed to send email: {ex.Message}"); + } + } +}); + +app.Run(); +`} + +

+

-برای ارسال امن‌تر ایمیل‌ها، می‌توانید مقدار Port را بر روی 465 قرار دهید تا -به جای STARTTLS، از TLS استفاده شود. +با تنظیم EnableSsl = true، می‌توانید به‌صورت امن اقدام به ارسال ایمیل‌های تراکنشی کنید.

@@ -194,4 +348,14 @@ public class TestController : Controller
+ + ]} +/> + + +

+همچنین بخوانید: پورت‌های ایمیل‌سرور لیارا +

+ + \ No newline at end of file diff --git a/src/pages/email-server/how-tos/connect-via-platform/flask.mdx b/src/pages/email-server/how-tos/connect-via-platform/flask.mdx index 6262e94a..5720af93 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/flask.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/flask.mdx @@ -36,6 +36,11 @@ import Head from "next/head";

+ + برای استفاده از سرویس ایمیل در برنامه‌های Flask، می‌توانید از پکیج Flask-Mail استفاده کنید که بایستی با دستور زیر، آن را در پروژه خود، نصب کنید: @@ -56,7 +61,7 @@ import Head from "next/head";
{`MAIL_HOST=smtp.c1.liara.email -MAIL_PORT=587 +MAIL_PORT=465 MAIL_USER=hopeful_zhukovsky_9daqpv MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d MAIL_FROM_ADDRESS=info@example.com`} @@ -118,13 +123,110 @@ if __name__ == '__main__': `}
+
+ + , + <> + +برای استفاده از سرویس ایمیل در برنامه‌های Flask، می‌توانید از +پکیج Flask-Mail استفاده کنید که بایستی با دستور زیر، آن را در پروژه خود، نصب کنید: + +
+
+ + {`pip install Flask-Mail`} + +
+
+ +پس از آن، کافیست تا طبق مستندات SMTP، یک دسترسی SMTP و طبق مستندات افزودن نشانی، یک نشانی برای ایمیل‌سرور خود، ایجاد کنید. +در نهایت نیز، بایستی +اطلاعات مربوط به ایمیل‌سرور خود را +به متغیرهای محیطی برنامه خود، اضافه کنید؛ به عنوان مثال: + +
+
+ + {`MAIL_HOST=smtp.c1.liara.email +MAIL_PORT=587 +MAIL_USER=hopeful_zhukovsky_9daqpv +MAIL_PASSWORD=fbef30d7-f852-428e-9573-bc73381c7d4d +MAIL_FROM_ADDRESS=info@example.com`} + +

+مقدار فیلد MAIL_FROM_ADDRESS باید یکی از نشانی‌های اضافه شده در سرویس ایمیل باشد. +

+ + +در نهایت می‌توانید در پروژه‌ی خود مانند مثال زیر عمل کرده و با استفاده از دسترسی SMTP سرویس ایمیل لیارا، +اقدام به ارسال ایمیل‌های تراکنشی کنید: + +
+
+ + {`from flask import Flask, request +from flask_mail import Mail, Message +from dotenv import load_dotenv +import os + +# Load environment variables from .env file +load_dotenv() + +app = Flask(__name__) + +# Flask-Mail configuration +app.config['MAIL_SERVER'] = os.getenv('MAIL_HOST') +app.config['MAIL_PORT'] = int(os.getenv('MAIL_PORT')) +app.config['MAIL_USERNAME'] = os.getenv('MAIL_USER') +app.config['MAIL_PASSWORD'] = os.getenv('MAIL_PASSWORD') +app.config['MAIL_USE_TLS'] = True # Use STARTTLS for encryption +app.config['MAIL_USE_SSL'] = False # Don't use SSL, because we are using STARTTLS +app.config['MAIL_DEFAULT_SENDER'] = os.getenv('MAIL_FROM_ADDRESS') + +# Initialize Flask-Mail +mail = Mail(app) + +@app.route('/send-test-email', methods=['GET']) +def send_test_email(): + try: + # Create a message + msg = Message(subject='Test Email from Flask', + recipients=['recipient@example.com'], # Replace with the recipient's email address + body='This is a test email sent from Flask using SMTP on Liara.', + extra_headers = {"x-liara-tag": "test_tag"}) # Use liara tag feature + + # Send the email + mail.send(msg) + return 'Test email sent successfully!', 200 + + except Exception as e: + return f'Failed to send email. Error: {str(e)}', 500 + +if __name__ == '__main__': + app.run(debug=True) +`} + +
+ +{/* +

برای ارسال امن‌تر ایمیل‌ها، می‌توانید مقدار Port را بر روی 465 قرار دهید تا به جای STARTTLS، از TLS استفاده شود.

- + */} + + + ]} +/> + + +

+همچنین بخوانید: پورت‌های ایمیل‌سرور لیارا +

+ \ No newline at end of file diff --git a/src/pages/email-server/how-tos/connect-via-platform/ghost.mdx b/src/pages/email-server/how-tos/connect-via-platform/ghost.mdx index d5ec97f1..876a5132 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/ghost.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/ghost.mdx @@ -28,6 +28,34 @@ import Head from "next/head"; اطلاعات مربوط به ایمیل‌سرور خود را طبق مستندات تنظیم متغیرهای محیطی، به برنامه خود، اضافه کنید؛ به عنوان مثال: + + +
+
+ + {`mail__transport=SMTP +mail__from=from@example.com +mail__options__service=Liara +mail__options__host=smtp.c1.liara.email +mail__options__port=465 +mail__options__secure=true +mail__options__auth__user=my-app +mail__options__auth__pass=my-pass`} + +
+
+ + +

+مقدار فیلد mail__from باید به جای from@example.com، یکی از نشانی‌های اضافه شده در سرویس ایمیل باشد. +

+ + , + <> +
@@ -46,6 +74,15 @@ mail__options__auth__pass=my-pass`}

مقدار فیلد mail__from باید به جای from@example.com، یکی از نشانی‌های اضافه شده در سرویس ایمیل باشد.

+ + + ]} +/> + + +

+همچنین بخوانید: پورت‌های ایمیل‌سرور لیارا +

 \ No newline at end of file diff --git a/src/pages/email-server/how-tos/connect-via-platform/go.mdx b/src/pages/email-server/how-tos/connect-via-platform/go.mdx index 54717c65..e83b8b8d 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/go.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/go.mdx @@ -36,6 +36,11 @@ import Head from "next/head";

+ + برای استفاده از سرویس ایمیل در برنامه‌های Golang، می‌توانید از پکیج gomail استفاده کنید که بایستی با دستور زیر، آن را در پروژه خود، نصب کنید: @@ -56,7 +61,7 @@ import Head from "next/head";
{`MAIL_HOST=smtp.c1.liara.email -MAIL_PORT=587 +MAIL_PORT=465 MAIL_USER=cranky_galileo_nhh78l MAIL_PASSWORD=7ae28d03-2e09-4211-8e79-c3a54ae5798e MAIL_FROM=info@example.com`} @@ -132,10 +137,116 @@ func main() { `}
+
+ + , + <> + +برای استفاده از سرویس ایمیل در برنامه‌های Golang، می‌توانید از +پکیج gomail استفاده کنید که بایستی با دستور زیر، آن را در پروژه خود، نصب کنید: + +
+
+ + {`go get gopkg.in/gomail.v2`} + +
+
+ +پس از آن، کافیست تا طبق مستندات SMTP، یک دسترسی SMTP و طبق مستندات افزودن نشانی، یک نشانی برای ایمیل‌سرور خود، ایجاد کنید. +در نهایت نیز، بایستی +اطلاعات مربوط به ایمیل‌سرور خود را +به متغیرهای محیطی برنامه خود، اضافه کنید؛ به عنوان مثال: + +
+
+ + {`MAIL_HOST=smtp.c1.liara.email +MAIL_PORT=587 +MAIL_USER=cranky_galileo_nhh78l +MAIL_PASSWORD=7ae28d03-2e09-4211-8e79-c3a54ae5798e +MAIL_FROM=info@example.com`} + +

-برای ارسال امن‌تر ایمیل‌ها، می‌توانید مقدار Port را بر روی 465 تنظیم کنید. با انجام این کار، از TLS به جای STARTTLS، استفاده خواهید کرد. +مقدار MAIL_FROM، باید یکی از نشانی‌های اضافه شده در سرویس ایمیل باشد. +

+ +{/* +

+با تنظیم MAIL_USE_TLS=True، می‌توانید به‌صورت امن اقدام به ارسال ایمیل‌های تراکنشی کنید. +

+ */} + +در نهایت می‌توانید در پروژه‌ی خود مانند مثال زیر عمل کرده و با استفاده از دسترسی SMTP سرویس ایمیل لیارا، +اقدام به ارسال ایمیل‌های تراکنشی کنید: + +
+
+ + {`package main + +import ( + "fmt" + "log" + "os" + "strconv" + + gomail "gopkg.in/gomail.v2" +) + +func main() { + + // Get environment variables for SMTP settings + mailHost := os.Getenv("MAIL_HOST") + mailPortStr := os.Getenv("MAIL_PORT") + mailUser := os.Getenv("MAIL_USER") + mailPassword := os.Getenv("MAIL_PASSWORD") + mailFrom := os.Getenv("MAIL_FROM") + + // Convert mail port from string to integer + mailPort, err := strconv.Atoi(mailPortStr) + if err != nil { + log.Fatalf("Invalid MAIL_PORT: %v", err) + } + + // Create a new email message + m := gomail.NewMessage() + m.SetHeader("From", mailFrom) + m.SetHeader("To", "recipient@example.com") // Set recipient email here + m.SetHeader("Subject", "Test Email from Go with HTML") + m.SetHeader("x-liara-tag", "test-tag") // Custom header for tagging + + // Set HTML body for the email + m.SetBody("text/html", \` +

This is a test email

+

Sent from Go using gomail and SMTP with TLS.

+ \`) + + // Create SMTP dialer with TLS + d := gomail.NewDialer(mailHost, mailPort, mailUser, mailPassword) + + // Send the email + if err := d.DialAndSend(m); err != nil { + log.Fatalf("Failed to send email: %v", err) + } + + fmt.Println("Test email sent successfully!") +} +`} + +
+
+ + + ]} +/> + + +

+همچنین بخوانید: پورت‌های ایمیل‌سرور لیارا

diff --git a/src/pages/email-server/how-tos/connect-via-platform/laravel.mdx b/src/pages/email-server/how-tos/connect-via-platform/laravel.mdx index 1d847274..7094ffc1 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/laravel.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/laravel.mdx @@ -36,6 +36,11 @@ import Head from "next/head";

+ + برای استفاده از سرویس ایمیل در برنامه‌های Laravel، کافیست تا طبق مستندات SMTP، یک دسترسی SMTP و طبق مستندات افزودن نشانی، یک نشانی برای ایمیل‌سرور خود، ایجاد کنید. در نهایت نیز، بایستی @@ -47,7 +52,7 @@ import Head from "next/head"; {`MAIL_MAILER=smtp MAIL_HOST=smtp.c1.liara.email -MAIL_PORT=587 +MAIL_PORT=465 MAIL_USERNAME=magical_benz_7s4t7p MAIL_PASSWORD=9aaf526a-3352-4d96-99b1-63af70c696e2 MAIL_ENCRYPTION=tls @@ -56,18 +61,182 @@ MAIL_FROM_NAME="\${APP_NAME}"`}
+{/* +

+برای ارسال امن‌تر ایمیل‌ها، می‌توانید مقدار Port را بر روی 465 قرار دهید تا +به جای STARTTLS، از TLS استفاده شود. +

+ */} + +

با تنظیم MAIL_ENCRYPTION=tls، می‌توانید به‌صورت امن اقدام به ارسال ایمیل‌های تراکنشی کنید.

- +در نظر داشته باشید که باید فایل config/mail.php، شامل قطعه کد زیر، باشد: + +
+
+ + {` env('MAIL_MAILER', 'log'), + + 'mailers' => [ + + 'smtp' => [ + 'transport' => 'smtp', + 'url' => env('MAIL_URL'), + 'host' => env('MAIL_HOST', '127.0.0.1'), + 'port' => env('MAIL_PORT', 2525), + 'encryption' => env('MAIL_ENCRYPTION', 'tls'), + 'username' => env('MAIL_USERNAME'), + 'password' => env('MAIL_PASSWORD'), + 'timeout' => null, + 'local_domain' => env('MAIL_EHLO_DOMAIN', parse_url(env('APP_URL', 'http://localhost'), PHP_URL_HOST)), + ], + + ], + + 'from' => [ + 'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'), + 'name' => env('MAIL_FROM_NAME', 'Example'), + ], + +]; +`} + +
+
+ +در ادامه، بایستی با اجرای دستوری مشابه دستور زیر، یک Mailable ایجاد کنید: + +
+
+ + {`php artisan make:mail TestEmail`} + +
+
+ +پس از ایجاد Mailable در آدرس app/mail/TestEmail.php، می‌توانید قطعه کد زیر را، در آن، قرار دهید: + +
+
+ + {`subject('Test Email') + ->view('emails.test'); + + } + + public function headers(): Headers + { + return new Headers( + text: [ + 'x-liara-tag' => 'test_email', + ], + ); + } + + +} +`} + +
+
+ +سپس، می‌توانید یک قالب ایمیل با نام test.blade.php در مسیر resources/views/emails ایجاد کنید و قطعه کد زیر را، در آن، قرار دهید: + +
+
+ + {` + + + Test Email + + +

This is a test email from Laravel

+

Sent via SMTP on Liara's server.

+ + +`} + +
+
+ +سپس، در routes/web.php مسیر زیر را برای ارسال ایمیل اضافه کنید: + +
+
+ + {`use App\\Mail\\TestEmail; +use Illuminate\\Support\\Facades\\Mail; +Route::get('/send-test-email', function () { + Mail::to('test@example.com')->send(new TestEmail()); + return 'Test email sent successfully!'; +});`} + +
+
+ +با انجام کارهای فوق، می‌توانید از ایمیل‌سرور در برنامه خود در صفحه send-test-email/، برای ارسال ایمیل، استفاده کنید. + + + , + <> + +برای استفاده از سرویس ایمیل در برنامه‌های Laravel، +کافیست تا طبق مستندات SMTP، یک دسترسی SMTP و طبق مستندات افزودن نشانی، یک نشانی برای ایمیل‌سرور خود، ایجاد کنید. +در نهایت نیز، بایستی +اطلاعات مربوط به ایمیل‌سرور خود را +به متغیرهای محیطی برنامه خود، اضافه کنید؛ به عنوان مثال: + +
+
+ + {`MAIL_MAILER=smtp +MAIL_HOST=smtp.c1.liara.email +MAIL_PORT=587 +MAIL_USERNAME=magical_benz_7s4t7p +MAIL_PASSWORD=9aaf526a-3352-4d96-99b1-63af70c696e2 +MAIL_ENCRYPTION=tls +MAIL_FROM_ADDRESS=info@example.com +MAIL_FROM_NAME="\${APP_NAME}"`} + +
+
+{/*

برای ارسال امن‌تر ایمیل‌ها، می‌توانید مقدار Port را بر روی 465 قرار دهید تا به جای STARTTLS، از TLS استفاده شود.

- + */} + + +

+با تنظیم MAIL_ENCRYPTION=tls، می‌توانید به‌صورت امن اقدام به ارسال ایمیل‌های تراکنشی کنید. +

+ در نظر داشته باشید که باید فایل config/mail.php، شامل قطعه کد زیر، باشد:
@@ -195,4 +364,14 @@ Route::get('/send-test-email', function () { با انجام کارهای فوق، می‌توانید از ایمیل‌سرور در برنامه خود در صفحه send-test-email/، برای ارسال ایمیل، استفاده کنید. + + ]} +/> + + +

+همچنین بخوانید: پورت‌های ایمیل‌سرور لیارا +

+ + \ No newline at end of file diff --git a/src/pages/email-server/how-tos/connect-via-platform/nextjs.mdx b/src/pages/email-server/how-tos/connect-via-platform/nextjs.mdx index 245845cf..38d7137b 100644 --- a/src/pages/email-server/how-tos/connect-via-platform/nextjs.mdx +++ b/src/pages/email-server/how-tos/connect-via-platform/nextjs.mdx @@ -22,6 +22,7 @@ import Head from "next/head"; # اتصال به ایمیل‌سرور در برنامه‌های NextJS
+