آماده‌سازی سرور ویندوز برای نصب – نسخه ۸.۰.۴.۷۰۳۶

دستورالعمل‌های زیر به شما کمک می‌کند با روش نصب TestRail روی سیستم Windows Server آشنا شوید. اطلاعات بیشتر درباره سیستم‌عامل‌ها و سیستم‌های سرور پشتیبانی‌شده را اینجا ببینید.

TestRail برای نصب روی سرور به یک web server، یک پایگاه داده SQL یعنی SQL Server، یک پایگاه داده NoSQL یعنی Cassandra ۳.۱۱، و یک محیط فعال PHP ۸.۰ یا ۸.۱ نیاز دارد. روی Windows Server، TestRail بهترین عملکرد را با وب‌سرور IIS مایکروسافت و PHP پیکربندی‌شده برای اجرا با FastCGI دارد.

نصب IIS #

برای نصب IIS روی Windows Server، Server Managerرا اجرا کنید. در Dashboard، زیر Configure This Local Server، روی Add roles and features کلیک کنید.

 

گزینه Role-based or feature-based installation را انتخاب کنید و روی Next کلیک کنید.

 

از server pool، میزبان سرور موردنظر برای نصب IIS را انتخاب کنید و روی Next کلیک کنید. سپس هنگام انتخاب Server Roles، مطمئن شوید Web Server (IIS)  انتخاب شده باشد و زیر Web Server > Application Development  مطمئن شوید CGI  نیز انتخاب شده باشد؛ اگر از قبل انتخاب نشده است. روی Install کلیک کنید.

 

 

 

 

فایل‌های رسمی PHP را دانلود کنید با فرمت .zip.

از سال ۲۰۲۳، VS16 x64 Non Thread Safe  نسخه پیشنهادی برای دانلود است، چون در مستندات نصب از همین نسخه استفاده می‌شود.

 

پس از کامل شدن دانلود، فایل‌های فشرده PHP را در مسیر C:\php\ روی سیستم میزبان استخراج کنید.

بخش Environment Variables را ویرایش کنید و یک متغیر جدید System Path با مقدار C:\php اضافه کنید. 

 

 

به IIS Manager بروید، روی میزبان سرور کلیک کنید، سپس روی Handler Mappings و بعد روی Add Module Mapping کلیک کنید.

 

 

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

 

در IIS Manager دوباره به میزبان سرور برگردید و این بار روی Default Document کلیک کنید. در Add Actions Panel کلیک کنید.

 

 

در فیلد Name مقدار Index.php را وارد کنید و روی OK کلیک کنید. سپس دوباره روی Add کلیک کنید و این بار در فیلد Name مقدار Default.php را وارد کنید و روی OK کلیک کنید.

 

 

نصب پیش‌نیازها #

برای استفاده از TestRail روی Windows همراه با database در SQL Server، extensionهای PHP زیر لازم هستند:

• extension Cassandra برای دسترسی به database نوع NoSQL
• extension gd در PHP برای ساخت نمودارها
• sqlsrv_81_nts_x64 PHP extension برای دسترسی به databaseهای SQL Server
• extension pdo_mysql در PHP برای دسترسی به database
• extension fileinfo در PHP برای تشخیص نوع فایل و encoding آن
• extension imagick در PHP برای کار با تصاویر
• extension mbstring در PHP برای کار با رشته‌های Unicode
• extension curl در PHP برای بررسی updateها و موارد مشابه
• extension openssl در PHP برای مدیریت اتصال‌های SSL
• ionCube PHP Loader برای decode کردن فایل‌های PHP مربوط به TestRail

دانلود کنید: PHP Microsoft drivers for SQL Server از اینجا، و روی Download Microsoft Drivers for PHP for SQL Server (Windows) کلیک کنید.

قبل از extract کردن فایل‌ها، ابتدا باید مطمئن شوید نسخه PHP شما از کدام حالت Thread Safety استفاده می‌کند (ts یا nts)؛ در غیر این صورت نصب درست کار نمی‌کند. برای اینکه ببینید نسخه شما Thread Safe است یا Not Thread Safe، دستور زیر را وارد کنید:

php -i|find "Thread Safety"

بعد از extract کردن فایل‌ها، فایل‌های Thread Safety مطابق با نسخه خود را پیدا کنید و آن‌ها را در مسیر C:\php\ext\ کپی کنید. برای مثال:

• • php_pdo_sqlsrv_81_nts_x64.dll
  • php_sqlsrv_81_nts_x64.dll

برای نصب این extensionها، موارد زیر را به فایل‌های php.ini خود اضافه کنید:

• • extension=pdo_sqlsrv_81_nts_x64
  • extension=sqlsrv_81_nts_x64

 

این driver به نصب ODBC Driver هم نیاز دارد. package مناسب را دانلود و نصب کنید:

• دانلود package x86
• دانلود package x64

 

بعد از فعال کردن extension در فایل تنظیمات PHP.ini و نصب ODBC Driver، وب‌سرور IIS را restart کنید. می‌توانید با اجرای تابع phpinfo()بررسی کنید که extension با موفقیت load شده باشد. همچنین می‌توانید در Command Prompt دستور php -m را اجرا کنید تا مطمئن شوید moduleها فعال هستند.

مستندات رسمی نصب extension imagick را از اینجا دنبال کنید.

آخرین extension موردنیاز PHP، ionCube PHP Loader رایگان است. می‌توانید ionCube Loader for Windows را از اینجا دانلود کنید.

برای این روش نصب به فایل «ioncube_loader_win_8.۱.dll» نیاز دارید. این فایل با دانلود نسخه Windows VC16 (Non-TS) (64 bits) در قالب فایل zip یعنی ioncube_loaders_win_nonts_vc16_x86-۶۴.zip در دسترس است. همه فایل‌ها را روی server خود extract کنید و loader extension را در ext directory مربوط به PHP کپی کنید؛ این مسیر معمولاً C:\php\ext\ است. سپس extension را با اضافه کردن خط زیر به فایل PHP.ini فعال کنید. این فایل معمولاً در پوشه نصب PHP، یعنی C:\php\، قرار دارد:

zend_extension = "C:\php\ext\ioncube_loader_win_8.1.dll"

برای بررسی اینکه ionCube loader extension با موفقیت نصب شده است، دستور php -v را در Windows Command Prompt اجرا کنید. برای اجرای این دستور باید ابتدا به پوشه نصب PHP بروید.

اگر خروجی php -v شبیه نمونه زیر باشد، ionCube loader extension با موفقیت نصب شده است. به خط ionCube PHP Loader توجه کنید:

PHP 8.1.14 (cli) (built: Jan 4 2023 12:24:57) (NTS Visual C++ 2019 x64)
Copyright (c) The PHP Group
Zend Engine v4.1.14, Copyright (c) Zend Technologies
with the ionCube PHP Loader v12.0.5, Copyright (c) 2002-2022, by ionCube Ltd.

بیشتر extensionها باید به‌صورت خودکار اضافه شوند، اما لازم است مراحل اضافی مربوط به Cassandra، IonCube و imagick را هم انجام دهید. اگر PHP را دستی نصب کرده‌اید، ممکن است لازم باشد extensionهای موردنیاز را در فایل PHP.ini به این شکل فعال کنید:

zend_extension = "C:\php\ext\ioncube_loader_win_8.1.dll"
extension=cassandra
extension=gd
extension=fileinfo
extension=imagick
extension=mbstring
extension=curl
extension=openssl
extension=pdo_sqlsrv_81_nts_x64
extension=sqlsrv_81_nts_x64

برای reload کردن PHP، وب‌سرور IIS را restart کنید. ساده‌ترین راه این است که سرویس World Wide Web Publishing Windows را restart کنید. برای این کار، از Administrative Tools برنامه Services را باز کنید و سرویس را restart کنید. توجه داشته باشید که این کار همه IIS application poolها و websiteها را restart می‌کند. اگر websiteها یا applicationهای دیگری هم روی این server میزبانی می‌کنید، بهتر است فقط application pool مربوطه را restart کنید.