برنامه‌نویسی Event Handler ها برای اجرای اسکریپت‌های سفارشی در Plesk

تعاریف کلیدی مقاله

• Event Handler (مدیریت رخداد): مکانیزمی در Plesk که به مدیر سرور امکان می‌دهد برای رویدادهای خاص (مثل ایجاد کاربر جدید یا تغییر تنظیمات دامنه) اسکریپت دلخواهی را اجرا کند.
• Plesk Events (رخدادهای Plesk): رویدادهایی که هنگام انجام تغییرات توسط کاربر یا مدیر در Plesk رخ می‌دهند، مانند ایجاد یا حذف حساب، ایجاد وب‌سایت، تغییر پلن سرویس و غیره.
• Custom Script (اسکریپت سفارشی): یک فایل اجرایی (مثل Shell Script یا PowerShell یا PHP Script) که توسط مدیر سرور نوشته شده و هنگام وقوع رویداد اجرا می‌شود.
• Server Administration Panel (پنل مدیریت سرور): بخش مدیریتی Plesk که امکانات پیشرفته برای تنظیمات، امنیت، و مدیریت منابع سرور فراهم می‌کند.
• Trigger (محرک): رخدادی که باعث می‌شود اسکریپت مربوطه فعال و اجرا شود.

Plesk قابلیتی ارائه می‌دهد که به مدیران سرور امکان می‌دهد رخدادهای خاص (Events) را دنبال کرده و در هنگام وقوع آن‌ها، اسکریپت‌های دلخواه را اجرا کنند.

این رخدادها شامل عملیات‌هایی هستند که کاربران Plesk انجام می‌دهند؛ مانند:

• ایجاد یا حذف اکانت کاربری
• تغییر در اشتراک‌ها (Subscriptions)
• ایجاد یا ویرایش وب‌سایت‌ها
• تغییر در پلن‌های خدماتی (Service Plans)
• تغییرات در تنظیمات مدیریتی Plesk

🔧 نحوه عملکرد

1. ابتدا یک اسکریپت سفارشی می‌نویسید که قرار است هنگام رخ دادن یک رویداد خاص اجرا شود.
   • این اسکریپت می‌تواند به زبان‌های مختلف مانند Bash، PHP، Python یا PowerShell نوشته شود.
2. سپس در Server Administration Panel یک Event Handler تعریف می‌کنید.
   • Event Handler مشخص می‌کند که چه اسکریپتی هنگام وقوع چه رویدادی اجرا شود.
3. پس از تنظیم، هر بار که آن رویداد رخ دهد، Plesk به‌طور خودکار اسکریپت شما را اجرا می‌کند.

⚡ مثال ساده

فرض کنید می‌خواهید هر بار که یک کاربر جدید در Plesk ساخته می‌شود، یک ایمیل اطلاع‌رسانی برای مدیر ارسال شود.

• اسکریپتی می‌نویسید که وظیفه ارسال ایمیل را انجام دهد.
• یک Event Handler ایجاد می‌کنید و آن را روی رویداد “Customer created” تنظیم می‌کنید.
• حالا با هر بار ایجاد کاربر جدید، اسکریپت شما اجرا می‌شود و ایمیل ارسال خواهد شد.

⚠️ نکات مهم

• می‌توانید چندین Event Handler را برای یک رویداد تعریف کنید. یعنی امکان دارد چند اسکریپت مختلف هم‌زمان هنگام یک رخداد اجرا شوند.
• اجرای اسکریپت‌ها به سطح دسترسی کاربر بستگی دارد. برای مثال اگر اسکریپت نیاز به سطح دسترسی Root داشته باشد، باید به‌درستی تنظیم شود.
• در صورت وجود خطا در اسکریپت، ممکن است اجرای آن متوقف شود ولی عملکرد کلی Plesk تحت تأثیر قرار نمی‌گیرد.
• این قابلیت برای اتوماسیون (Automation) در سرور بسیار کاربردی است، مثلاً:
  • گرفتن بکاپ خودکار پس از ایجاد سایت
  • لاگ‌برداری سفارشی هنگام تغییر تنظیمات
  • همگام‌سازی با سرویس‌های خارجی

🎯 توضیحات بیشتر

• کاربرد در DevOps: مدیران DevOps می‌توانند از Event Handlerها برای هماهنگی بین Plesk و سایر سرویس‌ها (مثل مانیتورینگ، بکاپ، CI/CD) استفاده کنند.
• یکپارچه‌سازی با API: Event Handler می‌تواند اسکریپت‌هایی اجرا کند که از APIهای خارجی (مثلاً یک CRM یا سیستم مانیتورینگ) استفاده می‌کنند.
• مثال پیشرفته: وقتی یک دامنه جدید ایجاد شد، اسکریپت می‌تواند رکورد DNS جدیدی در یک سرور خارجی ایجاد کند یا در یک سیستم صورتحساب، مشتری را ثبت کند.

✅ نتیجه:
قابلیت Event Handlers در Plesk به شما امکان می‌دهد مدیریت سرور را خودکار و هوشمند کنید. با این قابلیت می‌توانید هر رویداد مهم را به یک عملیات سفارشی گره بزنید و روندهای مدیریتی و عملیاتی خود را ساده‌تر کنید.

کیان پور