دانستنی‌های دنیای وب و زیرساخت

اتصال PHP به SQL Server؛ درایور، TLS و آزمون

برای اتصال PHP به SQL Server، فقط نصب SQL Server کافی نیست؛ محیط اجرای PHP به درایور سازگار و وابستگی ODBC مناسب نیاز دارد. ابتدا روش SQLSRV یا PDO_SQLSRV را انتخاب و نیاز نسخه، سیستم‌عامل و احراز هویت برنامه را مشخص کنید.

نمودار درایور سازگار PHP، حساب دیتابیس، TLS معتبر و آزمون برنامهٔ SQL Server

برای اتصال PHP به SQL Server، فقط نصب SQL Server کافی نیست؛ محیط اجرای PHP به درایور سازگار و وابستگی ODBC مناسب نیاز دارد. ابتدا روش SQLSRV یا PDO_SQLSRV را انتخاب و نیاز نسخه، سیستم‌عامل و احراز هویت برنامه را مشخص کنید.

آماده‌کردن محیط و حساب دیتابیس

SQLSRV رابط تابعی و PDO_SQLSRV رابط PDO را فراهم می‌کند. بستهٔ درایور باید با نسخهٔ PHP، معماری و تنظیم Thread Safety همان محیط سازگار باشد. نصب افزونه در PHP خط فرمان الزاماً آن را برای وب‌سرور یا PHP-FPM فعال نمی‌کند؛ هر محیط اجرا را جدا کنترل کنید.

در هاست مشترک، فعال‌سازی افزونه یا دسترسی شبکه ممکن است به میزبان وابسته باشد. حساب برنامه فقط مجوزهای لازم در دیتابیس هدف را داشته باشد؛ استفاده از حساب مدیر SQL Server، شرط اتصال برنامه نیست. روش ورود را با سیاست سرور تطبیق دهید.

تنظیم اتصال بدون پنهان‌کردن مشکل گواهی

نام سرور یا نمونه، پورت در صورت نیاز، Database و روش احراز هویت را از مدیر دیتابیس بگیرید. در SQLSRV گزینه‌ها به sqlsrv_connect و در PDO_SQLSRV به DSN و سازندهٔ PDO مربوط‌اند؛ شکل و مقادیر آن‌ها را از راهنمای همان درایور استفاده کنید.

گزینه‌های Encrypt و TrustServerCertificate هدف یکسان ندارند. اتصال رمزگذاری‌شده همراه با بررسی درست گواهی را برای محیط عملیاتی طراحی کنید. اعتماد بی‌قید به گواهی سرور، روش رفع معتبرِ نام اشتباه یا گواهی نامعتبر نیست. رمز اتصال را خارج از فایل قابل دریافت وب و در پیکربندی امن نگه دارید.

نمونهٔ اتصال SQLSRV و آزمون SELECT

این نمونه برای احراز هویت SQL Server با افزونهٔ SQLSRV است، نه PDO_SQLSRV. نسخهٔ PHP، افزونهٔ Microsoft و ODBC را از جدول سازگاری رسمی برای سیستم خود انتخاب کنید. ابتدا وجود افزونه را در همان محیطی که برنامه اجرا می‌شود بررسی کنید؛ موفقیت PHP در CLI، فعال‌بودن افزونه در PHP وب را ثابت نمی‌کند.

مقادیر DB_SERVER، DB_NAME، DB_USER و DB_PASSWORD را در تنظیمات امن محیط اجرای برنامه قرار دهید؛ رمز واقعی را در فایل عمومی یا مخزن کد ننویسید. نام سرور باید با گواهی TLS معتبر آن سازگار باشد.

<?php
// Set these variables securely in the application's runtime environment.
if (!function_exists('sqlsrv_connect')) {
    throw new RuntimeException('SQLSRV extension is unavailable.');
}
$config = [];
foreach (['DB_SERVER', 'DB_NAME', 'DB_USER', 'DB_PASSWORD'] as $key) {
    $value = getenv($key);
    if ($value === false || $value === '') {
        throw new RuntimeException('Database configuration is incomplete.');
    }
    $config[$key] = $value;
}
$conn = sqlsrv_connect($config['DB_SERVER'], [
    'Database' => $config['DB_NAME'],
    'UID' => $config['DB_USER'],
    'PWD' => $config['DB_PASSWORD'],
    'Encrypt' => true,
    'TrustServerCertificate' => false,
    'CharacterSet' => 'UTF-8',
]);
if ($conn === false) {
    throw new RuntimeException('Database connection failed.');
}
$stmt = sqlsrv_query($conn, 'SELECT 1 AS ok');
if ($stmt === false) {
    sqlsrv_close($conn);
    throw new RuntimeException('Database health query failed.');
}
$row = sqlsrv_fetch_array($stmt, SQLSRV_FETCH_ASSOC);
sqlsrv_free_stmt($stmt);
sqlsrv_close($conn);
if (!is_array($row) || (int) $row['ok'] !== 1) {
    throw new RuntimeException('Unexpected database response.');
}
echo 'Connection OK';

خروجی موفق Connection OK است. در محیط آزمایشی، خطای شبکه، ورود و گواهی را جدا بررسی کنید. خطاهای تفصیلی درایور فقط در لاگ خصوصی برای مدیر بررسی شوند؛ نمایش خطا و traceback در خروجی عمومی خاموش باشد. برای رفع خطای گواهی، اعتبار و نام گواهی را اصلاح کنید؛ TrustServerCertificate را در محیط تولید به true تغییر ندهید. این نمونه در دیتابیس واقعی شما اجرا نشده است.

مرجع گزینه‌ها: Connection options در مستندات Microsoft.

آزمون و تفکیک خطاها

یک اتصال محدود به دیتابیس هدف و یک پرس‌وجوی خواندنی ساده را آزمایش کنید. خطای نبود افزونه، شکست شبکه، رد ورود و خطای گواهی را جدا بررسی کنید؛ اصلاح یکی الزاماً بقیه را حل نمی‌کند. گزارش تشخیصی را در لاگ محدود نگه دارید و اطلاعات اتصال را به بازدیدکننده نشان ندهید. پس از موفقیت، عملیات واقعی برنامه و متن فارسی را نیز کنترل کنید تا صحت اتصال و پردازش داده هر دو روشن شود.

از مطالعه تا اجرا

سرویس‌های مرتبط با این مطلب

برای بررسی راهکار مناسب، مشخصات و شرایط این خدمات را ببینید.

میزبانی ویندوز ایران

برای سایت یا برنامه مبتنی بر فناوری‌های مایکروسافت، هاست ویندوز ایران را بررسی کنید. نسخه چارچوب اجرایی، نیاز پایگاه داده و فضای برنامه را مشخص کنید تا پلن با پیش‌نیازهای پروژه هماهنگ باشد.

بررسی سرویس

میزبانی لینوکس ایران

هاست لینوکس ایران را برای سایت وردپرسی، شرکتی یا فروشگاهی خود بررسی کنید. فضای دیسک، پایگاه داده و منابع پلن را با نیاز سایت تطبیق دهید و سازگاری نسخه PHP و افزونه‌ها را پیش از انتقال مشخص کنید.

بررسی سرویس
نظر شما مهم است

این مطلب چقدر برایتان مفید بود؟

اولین نفری باشید که به این مطلب امتیاز می‌دهد.

ادامه گفت‌وگو

این مطلب را به اشتراک بگذارید

اگر برایتان مفید بود، آن را برای همکاران و دوستانتان بفرستید.

برای ادامه مطالعه
همه مطالب مجله
قدم بعدی را با هم برداریم

برای شروع، یک گفت‌وگو کافی‌ست.

از انتخاب سرور تا ساخت وب‌سایت، مسیر مناسب کسب‌وکارتان را پیدا کنیم.

تماس با آفاق هاست 021-91092061