Articles in this section

See more

How to install the sqlsrv extension for PHP 7.x?

Avatar
Denis Bykov
Updated
Follow

Applicable to:

  • Plesk Onyx for Linux

Question

It is required to connect to SQLServer (MSSQL) databases via PHP script on a Linux system.

What extension should be installed and how it can be done?

Answer

Modules sqlsrv and pdo_sqlsrv should be enabled for PHP engine.

Warning: These extensions were not properly tested with Plesk and are not officially supported. Perform all operations at your own risk.

Note: The installation of pecl/sqlsrv requires PHP version >= 7.1.0. sqlsrv extension for PHP 7.0 was removed from pecl repository. Precompiled binaries for older sqlsrv which support PHP 7.0 can be found at https://github.com/Microsoft/msphpsql/releases/.

Ubuntu 16.04

  1. Connect to the server via SSH.

  2. Install necessary packages:

    • For PHP 7.1 provided by Plesk:

      # apt-get install apt-transport-https gcc g++ unixodbc unixodbc-dev plesk-php71-dev

    • For PHP 7.2 provided by Plesk:

      # apt-get install apt-transport-https gcc g++ unixodbc unixodbc-dev plesk-php72-dev

  3. Install the msodbcsql package:

    # curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
    # curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list > /etc/apt/sources.list.d/mssql-release.list
    # apt-get update
    # ACCEPT_EULA=Y apt-get install msodbcsql

  4. Add the pdo_sqlsrv and sqlsrv modules:

    • For PHP 7.1 provided by Plesk:

      # /opt/plesk/php/7.1/bin/pecl install pdo_sqlsrv
      # echo "extension=pdo_sqlsrv.so" > /opt/plesk/php/7.1/etc/php.d/pdo_sqlsrv.ini
      # /opt/plesk/php/7.1/bin/pecl install sqlsrv
      # echo "extension=sqlsrv.so" > /opt/plesk/php/7.1/etc/php.d/sqlsrv.ini

    • For PHP 7.2 provided by Plesk:

      # /opt/plesk/php/7.2/bin/pecl install pdo_sqlsrv
      # echo "extension=pdo_sqlsrv.so" > /opt/plesk/php/7.2/etc/php.d/pdo_sqlsrv.ini
      # /opt/plesk/php/7.2/bin/pecl install sqlsrv
      # echo "extension=sqlsrv.so" > /opt/plesk/php/7.2/etc/php.d/sqlsrv.ini

  5. Reread PHP handlers:

    # plesk bin php_handler --reread

  6. Make sure that the required modules are enabled:

    • For PHP 7.1 provided by Plesk:

      # /opt/plesk/php/7.1/bin/php -m | grep sqlsrv

      pdo_sqlsrv
      sqlsrv

    • For PHP 7.2 provided by Plesk:

      # /opt/plesk/php/7.2/bin/php -m | grep sqlsrv

      pdo_sqlsrv
      sqlsrv

  7. Restart the PHP-FPM master process to apply changes to FPM sites

CentOS 7

  1. Connect to the server via SSH.

  2. Install the msodbcsql package:

    # curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/mssql-release.repo
    # yum remove unixODBC-utf16 unixODBC-utf16-devel
    # ACCEPT_EULA=Y yum install msodbcsql

  3. Install necessary packages:

    • For PHP 7.1 provided by Plesk:

      # yum install unixODBC-devel gcc-c++ gcc autoconf automake plesk-php71-devel

    • For PHP 7.2 provided by Plesk:

      # yum install unixODBC-devel gcc-c++ gcc autoconf automake plesk-php72-devel

  4. Add the pdo_sqlsrv and sqlsrv modules:

    • For PHP 7.1 provided by Plesk:

      # /opt/plesk/php/7.1/bin/pecl install pdo_sqlsrv
      # echo "extension=pdo_sqlsrv.so" > /opt/plesk/php/7.1/etc/php.d/pdo_sqlsrv.ini
      # /opt/plesk/php/7.1/bin/pecl install sqlsrv
      # echo "extension=sqlsrv.so" > /opt/plesk/php/7.1/etc/php.d/sqlsrv.ini

    • For PHP 7.2 provided by Plesk:

      # /opt/plesk/php/7.2/bin/pecl install pdo_sqlsrv
      # echo "extension=pdo_sqlsrv.so" > /opt/plesk/php/7.2/etc/php.d/pdo_sqlsrv.ini
      # /opt/plesk/php/7.2/bin/pecl install sqlsrv
      # echo "extension=sqlsrv.so" > /opt/plesk/php/7.2/etc/php.d/sqlsrv.ini

  5. Reread PHP handlers:

    # plesk bin php_handler --reread

  6. Make sure that the required modules are enabled:

    • For PHP 7.1 provided by Plesk:

      # /opt/plesk/php/7.1/bin/php -m | grep sqlsrv

      pdo_sqlsrv
      sqlsrv

    • For PHP 7.2 provided by Plesk:

      # /opt/plesk/php/7.2/bin/php -m | grep sqlsrv

      pdo_sqlsrv
      sqlsrv

  7. Restart the PHP-FPM master process to apply changes to FPM sites

Centos 6

  1. Connect to the server via SSH.

  2. Install the msodbcsql package:

    # curl https://packages.microsoft.com/config/rhel/7/prod.repo >/etc/yum.repos.d/mssql-release.repo
    # yum remove unixODBC-utf16 unixODBC-utf16-devel
    # ACCEPT_EULA=Y yum install msodbcsql

  3. Install necessary packages:

  • For PHP 7.1 provided by Plesk:

    # yum install unixODBC-devel gcc-c++ gcc autoconf automake plesk-php71-devel

  • For PHP 7.2 provided by Plesk:

    # yum install unixODBC-devel gcc-c++ gcc autoconf automake plesk-php72-devel

  1. Add the pdo_sqlsrv and sqlsrv modules:

  • For PHP 7.1 provided by Plesk:

    # /opt/plesk/php/7.1/bin/pecl install pdo_sqlsrv
    # echo "extension=pdo_sqlsrv.so" > /opt/plesk/php/7.1/etc/php.d/pdo_sqlsrv.ini
    # /opt/plesk/php/7.1/bin/pecl install sqlsrv
    # echo "extension=sqlsrv.so" > /opt/plesk/php/7.1/etc/php.d/sqlsrv.ini

  • For PHP 7.2 provided by Plesk:

    # /opt/plesk/php/7.2/bin/pecl install pdo_sqlsrv
    # echo "extension=pdo_sqlsrv.so" > /opt/plesk/php/7.2/etc/php.d/pdo_sqlsrv.ini
    # /opt/plesk/php/7.2/bin/pecl install sqlsrv
    # echo "extension=sqlsrv.so" > /opt/plesk/php/7.2/etc/php.d/sqlsrv.ini

  1. Reread PHP handlers:

    # plesk bin php_handler --reread

  2. Make sure that the required modules are enabled:

  • For PHP 7.1 provided by Plesk:

    # /opt/plesk/php/7.1/bin/php -m | grep sqlsrv
    pdo_sqlsrv
    sqlsrv

  • For PHP 7.2 provided by Plesk:

    # /opt/plesk/php/7.2/bin/php -m | grep sqlsrv
    pdo_sqlsrv
    sqlsrv

  1. Restart the PHP-FPM master process to apply changes to FPM sites

Additional information

Instructions are taken from the Microsoft documentation page and adapted to Plesk PHP:

Installing the Microsoft ODBC Driver for SQL Server on Linux and macOS

It is also possible to use an older system version of PHP. For example, in order to connect to MSSQL on CentOS 7 with system PHP version 5.4, the following command needed to be executed:

# yum install epel-release
# yum install php-mssql

Comments

12 comments

Sort by Date Votes
  • Avatar
    Daniel

    Note in case someone stumbles across this article: I had to run the reread command for them to show up: https://www.danhendricks.com/2017/11/installing-microsoft-sql-server-php-extensions-plesk-onyx/

    0
    Permalink
  • Avatar
    Bulat Tsydenov

    @Daniel, Thank you for your input! You are right, that command is necessary indeed. The article has been modified accordingly.

    1
    Permalink
  • Avatar
    Noam Harel

    Hi,

    can you make the same proccess for CENTOS?

    i followed this:  https://www.danhendricks.com/2017/11/installing-microsoft-sql-server-php-extensions-plesk-onyx/

    and got some errors

     

    Noam

    0
    Permalink
  • Avatar
    Bulat Tsydenov

    @Noam, Hi!

    The article was updated with the corresponding steps for CentOS 7.

    0
    Permalink
  • Avatar
    Federica Della Monica (Edited )


    Good morning,

    I've installed sqlsrv extension for php 7.0 but I still have PDO Exception driver not found.

    0
    Permalink
  • Avatar
    Ivan Postnikov

    @Federica Della Monica

    Hi!

    Make sure pdo_mysql is also installed and enabled.
    In case you will have difficulties, feel free to contact Plesk Support.

    0
    Permalink
  • Avatar
    Federica Della Monica

    Hi!

    pdo_mysql is installed and enabled. 

    See image below

    0
    Permalink
  • Avatar
    Ivan Postnikov

    @Federica Della Monica

    Hi!
    Due to issue complexity, I would suggest contacting Plesk Technical Support for deeper investigation.

    0
    Permalink
  • Avatar
    Linus (Edited )

    Works also great with PHP 7.3 on Ubuntu / Debian:

    2. Install necessary packages:

    apt-get install apt-transport-https gcc g++ unixodbc unixodbc-dev plesk-php73-dev

     

    4. Add the pdo_sqlsrv and sqlsrv modules:

    # /opt/plesk/php/7.3/bin/pecl install pdo_sqlsrv
    # echo "extension=pdo_sqlsrv.so" > /opt/plesk/php/7.3/etc/php.d/pdo_sqlsrv.ini 
    # /opt/plesk/php/7.3/bin/pecl install sqlsrv 
    # echo "extension=sqlsrv.so" > /opt/plesk/php/7.3/etc/php.d/sqlsrv.ini

     

    6. Make sure that the required modules are enabled:

    # /opt/plesk/php/7.3/bin/php -m | grep sqlsrv

    pdo_sqlsrv 
    sqlsrv

     

     

    Hint for Debian 9:

    In Step 3 just adapt the repo url:

    # curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
    # curl https://packages.microsoft.com/config/debian/9/prod.list > /etc/apt/sources.list.d/mssql-release.list 
    # apt-get update 
    # ACCEPT_EULA=Y apt-get install msodbcsql

     

    0
    Permalink
  • Avatar
    Alexandr Redikultsev

    Hi @Linus!

    Thanks so much for the input!

    1
    Permalink
  • Avatar
    Peter Shaw (Edited )

    Trying this on Ubuntu18.04, Plesk Onyx, PHP7.2.

    Have modified the CURL URL in #3 to reflect Ubuntu18.04

    Struggling with the pecl install commands in #4 which fail with

    running: make
    sh: 1: make: not found
    ERROR: `make' failed

    After adding the Make package the install completed successfully. Is the expectation that Make is available in a default Plesk Onyx install?

    0
    Permalink
  • Avatar
    Ivan Postnikov

    Hello @Peter,

    Plesk is not in charge of this package installation, this depends on the used OS.

    Thank you for sharing your user experience, it may be helpful for other Pleskians.

     

    0
    Permalink

Please sign in to leave a comment.

Have more questions? Submit a request

Related articles