ایجاد دستورهای سفارشی PHP و نصب برنامه Jekyll در cPanel

این مقاله نحوه ایجاد Directiveهای سفارشی PHP در EasyApache 4 و همچنین مراحل کامل نصب و راه‌اندازی برنامه Jekyll روی سرور cPanel را توضیح می‌دهد. شامل ساخت فایل YAML برای PHP، نصب Ruby، نصب Jekyll، ساخت سایت و استقرار آن است.c

PHP DirectivesJekyll InstallationEasyApache 4

~3 دقیقه مطالعه • بروزرسانی ۲ اسفند ۱۴۰۴

1. ایجاد دستورهای سفارشی PHP (Custom PHP Directives)


نکته مهم: این بخش فقط برای سرورهایی است که از EasyApache 4 استفاده می‌کنند.


اگر نیاز دارید تنظیمات اضافی PHP را در سیستم خود اعمال کنید و می‌خواهید این تنظیمات در بخش Editor Mode از رابط MultiPHP INI Editor در WHM قابل مدیریت باشند، باید Directiveهای سفارشی را در مسیر زیر ثبت کنید:


/etc/cpanel/ea4/phpini_directives


1.1 مراحل ایجاد یک PHP Directive سفارشی


  • اگر مسیر بالا وجود ندارد، آن را ایجاد کنید.
  • در این مسیر یک فایل .yaml بسازید.
  • داخل فایل، Directiveهای خود را در کلید directives تعریف کنید.

ساختار فایل YAML باید دقیقاً مشابه فایل زیر باشد:


directives:
  directive_foo:
    changeable: PHP_INI_ALL
    default: foo
    multiple: 0
    note: '...'
    section: '...'
    type: string

  directive_bar:
    changeable: PHP_INI_PERDIR
    default: 1
    multiple: 0
    note: '...'
    deprecated: 5.4.0
    section: '...'
    type: boolean

نکات مهم:

  • اگر Directive شما قبلاً وجود داشته باشد، سیستم آن را نادیده می‌گیرد.
  • سیستم ابتدا فایل /usr/local/cpanel/whostmgr/etc/phpini_directives.yaml را می‌خواند و سپس فایل‌های مسیر /etc/cpanel/ea4/phpini_directives را به ترتیب ASCII.
  • اولین Directive با نام مشابه، استفاده می‌شود.



2. نصب و ساخت برنامه Jekyll روی cPanel


Jekyll یک سازنده سایت استاتیک مبتنی بر Ruby است. این بخش نحوه نصب و ساخت یک سایت Jekyll را توضیح می‌دهد.


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


2.1 پیش‌نیازها


ابتدا باید RubyGems را به‌روز کنید:


source /opt/cpanel/ea-ruby27/enable && gem update --system

سپس مطمئن شوید RPMهای زیر نصب شده‌اند:


  • ea-ruby27-mod_passenger
  • ea-ruby27-ruby-devel

برای نصب آن‌ها:


yum install ea-ruby27-mod_passenger ea-ruby27-ruby-devel

2.2 نصب Bundler و Jekyll


به‌عنوان کاربر root دستور زیر را اجرا کنید:


scl enable ea-ruby27 'gem install bundler jekyll'

اگر نمی‌خواهید از scl استفاده کنید:


  • به‌عنوان کاربر cPanel وارد شوید.
  • خط زیر را به فایل .bashrc اضافه کنید:

source /opt/cpanel/ea-ruby27/enable

سپس دوباره وارد ترمینال شوید و دستور زیر را اجرا کنید:


gem install bundler jekyll

2.3 ساخت سایت Jekyll


برای ساخت سایت جدید:


scl enable ea-ruby27 'jekyll new hyde'

2.4 Build و Deploy سایت


به دایرکتوری /hyde بروید و دستور زیر را اجرا کنید:


scl enable ea-ruby27 'jekyll build --baseurl '/hyde' --destination ~/public_html/hyde'

سپس سایت را در مرورگر باز کنید:


http://example.com/hyde


در این مثال، example.com دامنه سایت شماست.




نتیجه‌گیری


با استفاده از این راهنما می‌توانید Directiveهای سفارشی PHP را در EasyApache 4 اضافه کنید و همچنین یک سایت Jekyll را روی cPanel نصب و اجرا نمایید. این دو قابلیت برای توسعه‌دهندگان حرفه‌ای و مدیران سیستم بسیار کاربردی هستند.


نوشته و پژوهش شده توسط دکتر شاهین صیامی