نصب ماژول‌های Perl در cPanel & WHM

1. What Are Perl Modules?

Perl Modules به شما اجازه می‌دهند قابلیت‌های cPanel & WHM را گسترش دهید. این ماژول‌ها می‌توانند ویژگی‌های جدید اضافه کنند یا عملکردهای موجود را بهبود دهند. پیش از نصب هر ماژول، باید مطمئن شوید که با محیط Perl ارائه‌شده توسط cPanel سازگار است.

2. Install Modules to the System Perl

Perl سیستم در مسیر /usr/bin/perl قرار دارد. برای نصب ماژول‌ها روی این محیط، چند روش وجود دارد.

2.1 Install from WHM

برای نصب ماژول از طریق WHM، از مسیر زیر استفاده کنید:

WHM » Software » Install a Perl Module

برای استفاده از این بخش باید دسترسی compiler فعال باشد.

2.2 Install via perlinstaller Script

اسکریپت perlinstaller ماژول را با استفاده از نام CPAN نصب می‌کند.

/usr/local/cpanel/scripts/perlinstaller Module::Name

اگر اسکریپت را بدون آرگومان اجرا کنید، وارد محیط تعاملی CPAN می‌شوید. همچنین می‌توانید از فلگ --force برای نادیده گرفتن خطاها استفاده کنید، اما این کار ممکن است باعث نصب ماژول‌های خراب شود.

2.3 Install via cpan Command

دستور cpan مستقیماً ابزار CPAN را فراخوانی می‌کند.

cpan Module::Name

3. Install Modules to cPanel Perl

Perl اختصاصی cPanel در مسیر /usr/local/cpanel/3rdparty/bin/perl قرار دارد. برای نصب ماژول روی این محیط از ابزار cpanm استفاده می‌شود.

/usr/local/cpanel/bin/cpanm -i Module::Name

این روش کمترین تعامل را نیاز دارد و سریع‌ترین راه برای نصب ماژول‌هاست.

4. Confirm Module Installation

4.1 Check System Perl

/usr/bin/perl -MModule::Name -e 'print $Module::Name::VERSION . "\n"'

4.2 Check cPanel Perl

/usr/local/cpanel/3rdparty/bin/perl -MModule::Name -e 'print $Module::Name::VERSION . "\n"'

در هر دو حالت، نسخه ماژول نصب‌شده نمایش داده می‌شود.

5. Manage Installed Modules

اسکریپت perlmods برای مدیریت ماژول‌ها استفاده می‌شود.

• -l: لیست تمام ماژول‌های نصب‌شده
• -s: جستجوی یک ماژول
• -u: حذف ماژول

6. Troubleshooting Perl Module Issues

6.1 Check Error Logs

خطاهای Perl در مسیر زیر ثبت می‌شوند:

/usr/local/cpanel/logs/error_log

6.2 Use strace for Deeper Debugging

برای خطاهایی که در لاگ‌ها ثبت نمی‌شوند، از strace استفاده کنید:

strace -s 4096 -fvt -o /root/strace.issue.at.hand -p `cat /var/run/cpsrvd.pid`

6.3 Fix @INC Errors

اگر خطای @INC دریافت کردید، یعنی Perl نتوانسته مسیر ماژول را پیدا کند. پیام خطا مسیرهایی را نشان می‌دهد که جستجو شده‌اند.

راه‌حل‌ها:

• کپی ماژول در یکی از مسیرهای موجود در @INC
• ساخت symlink از مسیر @INC به محل ماژول
• رفع مشکل ماژول هنگام build

View Current @INC Paths

perl -V

این دستور مسیرهای فعلی @INC را نمایش می‌دهد.

Conclusion

نصب و مدیریت Perl Modules در cPanel & WHM شامل روش‌های مختلفی برای محیط Perl سیستم و Perl اختصاصی cPanel است. با استفاده از ابزارهای خط فرمان، رابط WHM و تکنیک‌های عیب‌یابی، می‌توانید ماژول‌ها را به‌درستی نصب و مشکلات احتمالی را رفع کنید.