آماده‌سازی یک سرویس برای ثبت‌ در Plesk

تعاریف مهم

1. Plan_Item_Interface
   اینترفیس (Interface) اصلی در Plesk که هر سرویسی که می‌خواهید در PN ثبت شود باید آن را پیاده‌سازی کند.
   اینترفیس مشخص می‌کند سرویس:
   • چه ویژگی‌هایی دارد،
   • چه تغییراتی باید رصد شود،
   • و کد مربوط به واکنش به تغییرات چیست.
2. /PRODUCT_ROOT_D/
   پوشه اصلی نصب Plesk.
   (در لینوکس معمولاً /usr/local/psa و در ویندوز C:\Program Files (x86)\Plesk\ است).
3. /admin/plib/
   مسیر مخصوص فایل‌های PHP داخلی Plesk که قابلیت اجرای کدهای مدیریتی دارند.
   شما باید کلاس سرویس خود را در این مسیر قرار دهید.
4. Zend Naming Conventions (کنوانسیون نام‌گذاری Zend)
   استاندارد نام‌گذاری کلاس‌ها و فایل‌ها در PHP (در Plesk هم از همین استاندارد استفاده می‌شود).
   • نام فایل و نام کلاس باید با هم هماهنگ باشند.
   • مثال:
     • دایرکتوری: /admin/plib/servicedir/
     • فایل: servicefile.php
     • نام کلاس: servicedir_servicefile
5. Sample Class (کلاس نمونه)
   Plesk یک کلاس نمونه ارائه کرده که شامل توضیحات و کامنت‌ها است تا توسعه‌دهنده‌ها راحت‌تر اینترفیس Plan_Item_Interface را پیاده‌سازی کنند.

برای آماده کردن یک سرویس جهت ثبت در Plesk Notifications، باید یک فایل PHP بسازید که حاوی یک کلاس باشد و آن کلاس، اینترفیس Plan_Item_Interface را پیاده‌سازی کند. سپس فایل PHP را در یک مسیر که توسط Plesk قابل دسترسی است قرار دهید.

این مسیر باید در پوشه:

/PRODUCT_ROOT_D/admin/plib/

قرار داشته باشد و نام دایرکتوری باید یکتا باشد.

📌 قوانین نام‌گذاری

هنگام طراحی نام کلاس و فایل PHP، باید از کنوانسیون نام‌گذاری Zend پیروی کنید.

مثال:

• شما یک پوشه به نام: /PRODUCT_ROOT_D/admin/plib/servicedir/ ایجاد می‌کنید.
• در این پوشه، یک فایل به نام: servicefile.php قرار می‌دهید.
• در این فایل، کلاس شما باید نام داشته باشد: servicedir_servicefile

📚 برای جزئیات بیشتر، به مستندات رسمی Zend Naming Conventions مراجعه کنید.

🛠️ کلاس نمونه

Plesk یک کلاس نمونه (Sample Class) ارائه کرده است که می‌توانید از آن به عنوان پایه برای نوشتن کلاس خود استفاده کنید.
این کد نمونه همراه با کامنت‌ها است و توضیح می‌دهد که ساختار اینترفیس چگونه باید پیاده‌سازی شود.

📝 خلاصه ساده

• یک فایل PHP بسازید → در مسیر /PRODUCT_ROOT_D/admin/plib/yourservicedir/
• نام فایل و کلاس را بر اساس قوانین Zend انتخاب کنید.
• کلاس شما باید Plan_Item_Interface را پیاده‌سازی کند.
• می‌توانید از کلاس نمونه Plesk برای شروع استفاده کنید.

کیان پور