آموزش نصب کتابخانه GD در cPanel و DirectAdmin

اگر هنگام کار با سیستم‌های مدیریت محتوا مانند وردپرس در بخش “سلامت سایت” با خطای “ماژول مورد نیاز gd نصب نیست” (The required module, gd, is not installed) مواجه شده‌اید، نگران نباشید. این یک مشکل رایج با راه‌حلی بسیار ساده است. کتابخانه GD یک افزونه حیاتی برای PHP است که برای پردازش و دستکاری تصاویر استفاده می‌شود. بسیاری از پلتفرم‌ها برای کارهایی مانند ساخت تصاویر بندانگشتی (Thumbnails)، تغییر اندازه عکس‌ها و افزودن واترمارک به آن نیاز دارند.

برای مدیریت حرفه‌ای یک سایت، داشتن دسترسی کامل به سرور ضروری است. پس از سفارش vps برای دایرکت ادمین و نصب کنترل پنل، فعال‌سازی ماژول‌های مورد نیاز مانند GD یکی از اولین قدم‌هاست. این راهنما به شما روش صحیح فعال‌سازی آن را در cPanel و DirectAdmin آموزش می‌دهد.

فعال‌سازی GD در cPanel (با EasyApache 4)

در تنظیمات جدید cPanel، این فرآیند از طریق رابط کاربری گرافیکی WHM به سادگی انجام می‌شود.

قدم اول: ورود به بخش EasyApache 4

وارد پنل WHM شوید. در منوی جستجوی سمت چپ، عبارت EasyApache را تایپ کرده و روی EasyApache 4 کلیک کنید.

قدم دوم: سفارشی‌سازی پروفایل PHP

در صفحه EasyApache 4، در بخش “Currently Installed Packages”، روی دکمه Customize کلیک کنید.

قدم سوم: پیدا کردن و فعال‌سازی افزونه GD

1. از منوی سمت چپ، روی بخش PHP Extensions کلیک کنید.
2. در کادر جستجو، عبارت gd را تایپ کنید.
3. سیستم پکیج مربوط به کتابخانه GD (با نام php-gd) را نمایش می‌دهد.
4. سوییچ (toggle) مقابل پکیج php-gd را روشن کنید. با این کار، این افزونه برای تمام نسخه‌های PHP نصب شده روی سرور، فعال خواهد شد.

قدم چهارم: بازبینی و اجرای تغییرات (Provision)

1. پس از انتخاب پکیج، از منوی سمت چپ روی Review کلیک کنید.
2. مطمئن شوید که پکیج php-gd در لیست پکیج‌هایی که قرار است نصب شوند، وجود دارد.
3. روی دکمه Provision در پایین صفحه کلیک کنید و صبر کنید تا فرآیند نصب به پایان برسد.

فعال‌سازی GD در دایرکت ادمین (با CustomBuild)

در دایرکت ادمین، این فرآیند از طریق ابزار قدرتمند CustomBuild انجام می‌شود که هم رابط گرافیکی و هم خط فرمان دارد.

روش اول: از طریق رابط گرافیکی (روش آسان)

1. وارد کنترل پنل دایرکت ادمین با دسترسی ادمین (Admin) شوید.
2. در بخش Extra Features، روی گزینه CustomBuild 2.0 کلیک کنید.
3. روی تب Edit Options کلیک کنید. در لیست تنظیمات، ردیف مربوط به PHP GD را پیدا کنید.
4. منوی کشویی مقابل آن را از “no” به “yes” تغییر دهید و روی دکمه Save کلیک کنید.
5. قدم مهم: حالا به تب Build Software برگردید و روی دکمه Build php کلیک کنید تا PHP با افزونه جدید دوباره کامپایل شود.

روش دوم: از طریق خط فرمان (برای کاربران حرفه‌ای)

1. از طریق SSH به سرور خود متصل شوید و وارد دایرکتوری CustomBuild شوید:

   cd /usr/local/directadmin/custombuild

2. با دستور زیر، گزینه GD را فعال کنید:

   ./build set php_gd yes

3. در نهایت، PHP را دوباره کامپایل کنید تا تغییرات اعمال شوند:

   ./build php_n

چگونه از نصب صحیح مطمئن شویم؟

این روش برای هر دو کنترل پنل یکسان است.

1. یک فایل با نام info.php در هاست خود (مثلا در پوشه public_html) ایجاد کرده و کد <?php phpinfo(); ?> را در آن قرار دهید.
2. فایل را در مرورگر باز کنید (yourdomain.com/info.php). در صفحه‌ای که باز می‌شود، باید بخشی مربوط به GD Support را با وضعیت “enabled” مشاهده کنید.
3. نکته امنیتی: پس از بررسی، حتما این فایل را از روی هاست خود حذف کنید.

نصب نبودن GD Module میتواند باعث ایجاد خطای صفحه سفید شود که در مقاله عیب‌یابی خطای صفحه سفید مرگ (WSOD) برای رفع این مشکل توضیح داده شده.

مدیریت صحیح ماژول‌های PHP یکی از وظایف اصلی در مدیریت سرور است. سرور مجازی cPanel بلوسرور با دسترسی کامل root به شما این امکان را می‌دهد که محیط سرور خود را دقیقا مطابق با نیازهای اپلیکیشن‌های خود پیکربندی کنید.