رفع خطای “This extension requires the Microsoft ODBC Driver for SQL Server” در CloudLinux

اگر هنگام استفاده از تابع sqlsrv_connect() در PHP با خطای «This extension requires the Microsoft ODBC Driver for SQL Server» مواجه شده‌اید، لازم است درایور مربوطه را نصب و پیکربندی کنید. در این مقاله، روش رفع این مشکل در محیط CloudLinux OS را به صورت مرحله به مرحله شرح می‌دهیم.

چرا این ارور رخ می‌دهد؟

خطای «This extension requires the Microsoft ODBC Driver for SQL Server» زمانی رخ می‌دهد که افزونه PHP نیاز به درایوری دارد که ارتباط با SQL Server را از طریق ODBC فراهم کند، اما این درایور نصب یا فعال نشده است.

در محیط CloudLinux، به خصوص نسخه‌های 6، 7 و 8، لازم است تنظیمات و بسته‌های مرتبط با ODBC به درستی نصب شده باشند.

گام‌های رفع مشکل

۱. نصب درایور Microsoft ODBC Driver for SQL Server

برای رفع خطا، ابتدا درایور Microsoft ODBC Driver for SQL Server را دانلود و نصب کنید. این اقدام پایه‌ای‌ترین قدم برای فعال شدن افزونه SQL Server در PHP است.

۲. نصب و پیکربندی ODBC و FreeTDS

در محیط CloudLinux، پس از نصب درایور، لازم است ODBC و FreeTDS را نیز نصب و تنظیم کنید:

• اجرای /opt/alt/alt-php-config/install_odbc
• نصب بسته‌های alt-freetds*
• سپس در فایل /etc/odbcinst.ini باید بخش‌های مربوط به FreeTDS تعریف شود.
• همچنین در /etc/odbc.ini اطلاعات سرور MSSQL وارد می‌شود (نام سرور، پایگاه‌داده، پورت).

۳. به‑روزرسانی CageFS و فعال‌سازی افزونه‌های PHP

در صورت استفاده از CageFS در CloudLinux باید دستور زیر اجرا شود:

cagefsctl --update-etc

cagefsctl --update-etc

سپس افزونه‌های PHP مرتبط مانند pdo_odbc و odbc فعال شوند:

selectorctl -u USERNAME -v PHP_VERSION -e pdo_odbc,odbc

selectorctl -u USERNAME -v PHP_VERSION -e pdo_odbc,odbc

۴. استفاده از PDO یا sqlsrv_connect

در اسکریپت PHP باید نمونه‌ای از اتصال مثل زیر داشته باشید:

$pdo = new PDO(
   sprintf(
      "sqlsrv:server=%s;database=%s",
      "sqlserver-hostname,port",
      "database"
   ),
   "user",
   "password"
);

$pdo = new PDO(
   sprintf(
      "sqlsrv:server=%s;database=%s",
      "sqlserver-hostname,port",
      "database"
   ),
   "user",
   "password"
);

با این روش، پس از نصب صحیح Microsoft ODBC Driver for SQL Server و پیکربندی ODBC، خطای «This extension requires the Microsoft ODBC Driver for SQL Server» برطرف خواهد شد.

نکات تکمیلی و توصیه‌ها

• مطمئن شوید نسخه PHP شما با افزونه‌های pdo_odbc و odbc سازگار است.
• اگر معماری سرور x86 (i386/i686) است، مسیر فایل libtdsodbc.so در /etc/odbcinst.ini ممکن است متفاوت باشد.
• پس از انجام تغییرات، سرویس وب را ری‌استارت کنید تا تنظیمات اعمال شود.
• در سرورهای تولیدی، پیش از اعمال تغییرات بیشتر، از صحت عملکرد در محیط تست مطمئن شوید.

برای رفع خطای «This extension requires the Microsoft ODBC Driver for SQL Server» در CloudLinux، نصب و فعال‌سازی Microsoft ODBC Driver for SQL Server همراه با پیکربندی ODBC و افزونه‌های PHP ضروری است. با اجرای مراحل فوق، اتصال PHP به SQL Server به صورت پایدار برقرار خواهد شد.