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

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 نصب و اجرا نمایید. این دو قابلیت برای توسعه‌دهندگان حرفه‌ای و مدیران سیستم بسیار کاربردی هستند.