Drupal telepítése Windowson MSSQL adatbázis környezetben

Az alábbi leírás a Drupal aktuális verziójának telepítését írja leg MSSQL támogatással Windows környezetben. 

Kell egy működő Windows 10 / 11 / 12 vagy Server.

MSSQL szerver telepítése 

Telepítsd fel az MSSQL servert a számítógépre. Létezik a szervernek ingyenese változata is. Telepítő link

WEB szerver telepítése

Telepítsd fel a Windows rendszerre az XAMPP aktuális változatát ( XAMPP install ). Ekkor kapsz egy működő Apache + MySQL + PHP rendszert a gépeden.

Alapesetben a XAMPP a C:\xampp könyvtárba települ.

Az Apache a C:\xampp\apache könyvtárban lesz

Az Apache konfigurációs állományainak helye az alábbi könyvtár: C:\xampp\apache\conf

A PHP ide kerül: C:\xampp\phpPHP 

A PHP beállító fájlja pedig itt található: C:\xampp\php\php.ini

Ha szeretsz magad bíbelődni, akkor letöltöd az Apache 2.4.xx 64 bites változatát ( letöltés innen ) és a PHP aktuális 64 bites változatát ( letöltés innen ) és beállítod, hogy működjön együtt a két rendszer.  leírás.

Hogy milyen apache és PHP van a gépeden XAMPP esetén itt tudod megnézni: http://localhost/dashboard/phpinfo.php

PHP beállítása, hogy használja az MSSQL-t.

Letöltöd a PHP-MSSQL drivert innen (PHP 8.1.x vagy PHP 8.2.x )-t. Ez két drivert tartalmaz és annak a különböző változatait, 

  • php_sqlsrv_<php verzio>_<ts/nts>_<x86/x64>.dll
  • php_pdo_sqlsrv_<php verzio>_<ts/nts>_<x86/x64>.dll

A csomagban lévő fájlok jelzései: a PHP (8.1 és 8.2 és 8.3) változatot, a processzor és az operációs rendszer változatát (x86 és x64) jelentik. Az nts - Non Thread Safe és ts Thread Safe változat közül azt kell használni, amelyiket az apache + PHP telepítésekor kiválasztottad. Az XAMPP használata esetén érdemes a ts (Thread Safe) változatot használni. 

Ezeket bemásolod az alábbi könyvtárba: C:\xampp\php\ext, majd átnevezed őket:  

  • php_pdo_sqlsrv_82_ts_x64.dll => php_pdo_sqlsrv.dll
  • php_sqlsrv_82_ts_x64.dll => php_sqlsrv.dll

 a PHP.ini fájlban beállítod az alábbi sorokat (XAMPP esetén C:\xampp\php\php.ini):

extension=odbc    // itt csak kiveszed a ; jelet előle.
extension=sqlsrv  // beírod, ha nincsen ott
extension=pdo_sqlsrv

Újraindítod az Apache szervert. XAMPP esetén megnézed, hogy elindultak-e a driverek: 

http://localhost/dashboard/phpinfo.php

Drupal letöltése és bemásolása a helyére

Ha nem használsz composert

Ha nem használsz composert, belépsz a C:\xampp\htdocs könyvtárba, létrehozol egy könyvtárat ( C:\xampp\htdocs\d10teszt ) 

Letöltöd a Drupal utolsó változatát ( ezen az oldalon keresztül,  jelenleg 10.2.3 ), kicsomagolod a zip fájlt a létrehozott könyvtárba.

Ha használsz composer

Ez javasolt ma már. Telepíted a Composert: telepítése itt

A htdocs könyvtárban nyitsz egy parancssort és az alábbi parancsot kiadod:

composer create-project drupal/recommended-project:10.2.3 "d10teszt"

Drupal beállítása, hogy használja az MSSQL-t

Ha nem használsz composert

Letöltöd a Drupal mssql driverét: Letöltés innen.

A letöltött cuccot bemásolod a d10tesz\modules\contrib\sqlsrv\Driver\Database\sqlsrv

Ha használsz composert

Composer használata esetén belépsz a htdocs\d10teszt könyvtárba parancssorral és kiadod az alábbi parancsot

composer require 'drupal/sqlsrv:².0'

Elindítod a Drupal telepítőt. 

Az elején megkérdezi, hogy milyen adatbázis szervert használsz. Ki választod az MSSQL-t és hajrá...