Microsoft Drivers for PHP for SQL Server Team Blog https://docs.microsoft.com/archive/blogs/sqlphp/feed.xml All about the Microsoft Drivers for PHP for SQL Server, SQL Server and PHP (SQLSRV and PDO_SQLSRV) Fri, 29 Mar 2019 18:27:42 GMT en-US hourly 1 We have moved! https://docs.microsoft.com/archive/blogs/sqlphp/we-have-moved Fri, 29 Mar 2019 18:27:42 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1675 https://techcommunity.microsoft.com/t5/SQL-Server/bg-p/SQLServer/label-name/SQLServerDrivers  ]]> Hofix Release: Drivers 5.6.1 for PHP for SQL Server https://docs.microsoft.com/archive/blogs/sqlphp/hofix-release-drivers-5-6-1-for-php-for-sql-server Wed, 20 Mar 2019 19:43:18 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1665
  • Issue #937 - fixed assumptions made when calculating field or column metadata which may have resulted in application termination
  • Issue #955 - modified sqlsrv config file such that it can be compiled independently of pdo_sqlsrv
  • Pull Request #946 - fixed PDOStatement::getColumnMeta() to return false when something goes wrong
    • Limitations and Known Issues remain unchanged. Direct downloads can be found on the Microsoft Download Center or the Github release tag.]]>         Security Update: Microsoft PHP Drivers 4.3.1 for SQL Server https://docs.microsoft.com/archive/blogs/sqlphp/security-update-microsoft-php-drivers-4-3-1-for-sql-server Thu, 14 Mar 2019 16:00:19 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1635 speculative execution side-channel attacks. To learn more about the vulnerabilities, go to ADV180002. If you are using version 4.3.0 of the drivers and need Spectre-type mitigations in your environment, we recommend you download and install version 4.3.1 in place of the original ones. Direct downloads can be found on the Microsoft Download Center or the Github release tag.]]> We are moving! https://docs.microsoft.com/archive/blogs/sqlphp/we-are-moving Mon, 04 Mar 2019 18:29:46 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1655 SQL Server and Azure SQL Database blogs on the Microsoft TechCommunity website. Once the migration is complete, we will post the new URL along with instructions for how to navigate the new blog and update your RSS feeds. Until then, feel free to keep reading here, but keep in mind that any comments that are added may not make it over to the new blog. You will be able to re-post them there once we are live. Stay tuned and see you on the new site soon!]]> Drivers 5.6 for PHP for SQL Server Released https://docs.microsoft.com/archive/blogs/sqlphp/drivers-5-6-for-php-for-sql-server-released Fri, 01 Mar 2019 00:40:08 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1625 Microsoft Drivers 5.6 for PHP for SQL Server. The drivers enable access to SQL Server, Azure SQL Database, Azure SQL Managed Instance, and Azure SQL DW from PHP 7.1-7.3 applications on Linux, Windows and macOS. Notable items about the 5.6 release since the previous 5.3 production release:

    Added

    • Added support for PHP 7.3
    • Added support for Linux SUSE 15, Ubuntu 18.10 and macOS Mojave
    • Feature Request #415 - new options at connection and statement levels for both drivers for formatting decimal values in the fetched results
    • Added support for Azure AD Access Token (in Linux / macOS this requires MS ODBC Driver 17+ and unixODBC3.6+)
    • Added support for Authentication with Azure Active Directory using Managed Identity for Azure Resources (requires MS ODBC Driver 17.3+)
    • Feature Request #842 - new PDO_STMT_OPTION_FETCHES_DATETIME_TYPE flag for pdo_sqlsrv to return datetime as objects
    • Feature Request #844 - add ReturnDatesAsStrings option to statement level for sqlsrv

    Fixed

    • Issue #434- To avoid possible crashes, before freeing stmt in the destructor check if its dbh driver data is NULL
    • Pull Request #833- Streamlined the error handling to remove a potential cause of crash
    • Pull Request #836- Modified the config files to enable Spectre Mitigations (use /Qspectre switch) for PHP 7.2 (see related Request #878)
    • Pull Request #854- Clear Azure Key Vault data after connection attributes are successfully set or when exception is thrown
    • Pull Request #855- Improved performance by saving meta data before fetching and skipping unnecessary conversions for numeric data
    • Pull Request #865- Corrected the way SQLPutData and SQLParamData are used when sending stream data to the server
    • Pull Request #878- Modified the config files to enable Spectre Mitigations for PHP 7.1 (see related Request #836)
    • Pull Request #891- Improved performance of Unicode conversions
    • Pull Request #892- Removed warning messages while compiling extensions
    • Pull Request #904- Enabled compiling extensions statically into PHP
    • Pull Request #907- Initialized output param buffer when allocating extra space
    • Pull Request #919- Initialized a boolean variable before passing it by reference into a function that will modify its value

    Limitations

    • No support for inout / output params when using sql_variant type
    • No support for inout / output params when formatting decimal values
    • On Linux and macOS, setlocale() only takes effect if it is invoked before the first connection. Attempting to set the locale after connecting will not work
    • Always Encrypted requires MS ODBC Driver 17+
      • Only Windows Certificate Store and Azure Key Vault are supported. Custom Keystores are not supported
      • Issue #716 - Wit h Always Encrypted enabled, named parameters in subqueries are not supported
      • Always Encrypted limitations

    Known Issues

    • Connection pooling on Linux or macOS is not recommended with unixODBC < 2.3.6
    • When pooling is enabled in Linux or macOS
      • unixODBC <= 2.3.4 (Linux and macOS) might not return proper diagnostic information, such as error messages, warnings and informative messages
      • due to this unixODBC bug, fetch large data (such as xml, binary) as streams as a workaround. See these connection pooling examples
    • With ColumnEncryption enabled, calling stored procedures with XML parameters does not work (Issue #674)

    Get Started

    Direct downloads can be found on the Microsoft Download Center or the Github release tag.]]>         Microsoft Drivers 5.5.0 Preview for PHP for SQL Server Released! https://docs.microsoft.com/archive/blogs/sqlphp/microsoft-drivers-5-5-0-preview-for-php-for-sql-server-released Tue, 11 Dec 2018 16:27:50 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1615 Hi all, We are excited to announce a new technical preview for SQLSRV and PDO_SQLSRV drivers for PHP. The drivers now support PHP 7.3 and include some fixes and new features. Notable items about the 5.5.0-preview release:

    Added

    • Added support for PHP 7.3.0
    • Added support for Linux Ubuntu 18.10 and mac OS Mojave
    • Feature Request #415 - new options at connection and statement levels for both drivers for formatting decimal values in the fetched results

    Fixed

    • Pull Request #854 - Clear Azure Key Vault data after connection attributes are successfully set or when exception is thrown
    • Pull Request #855 - Improved performance by saving meta data before fetching and skipping unnecessary conversions for numeric data
    • Pull Request #865 - Corrected the way SQLPutData and SQLParamData are used when sending stream data to the server
    • Pull Request #878 - Modified the config files to enable Spectre Mitigations for PHP 7.1 (see related Request #836)
    • Pull Request #891 - Improved performance of Unicode conversions
    • Pull Request #892 - Removed warning messages while compiling extensions

    Limitations

    • No support for inout / output params when using sql_variant type
    • No support for inout / output params when formatting decimal values
    • In Linux and macOS, setlocale() only takes effect if it is invoked before the first connection. Attempting to set the locale after connecting will not work
    • Always Encrypted requires MS ODBC Driver 17+
      • Only Windows Certificate Store and Azure Key Vault are supported. Custom Keystores are not yet supported
      • Issue #716 - With Always Encrypted enabled, named parameters in subqueries are not supported
      • Always Encrypted limitations

    Known Issues

    • Connection pooling on Linux or macOS is not recommended with unixODBC < 2.3.7
    • When pooling is enabled in Linux or macOS
      • unixODBC <= 2.3.4 (Linux and macOS) might not return proper diagnostic information, such as error messages, warnings and informative messages
      • due to this unixODBC bug, fetch large data (such as xml, binary) as streams as a workaround. See the examples here
    • With ColumnEncryption enabled, calling stored procedures with XML parameters does not work (Issue #674)
    • With ColumnEncryption enabled, fetching varbinary(max), varchar(max) or nvarchar(max) may fail with ODBC Driver 17.3 CTP

    Survey

    Let us know how we are doing and how you use our driver by taking our pulse survey: https://aka.ms/mssqlphpsurvey

    Get Started

    Direct downloads can be found on the Github release tag. David Engel]]>         Microsoft Drivers 5.4.0 Preview for PHP for SQL Server Released! https://docs.microsoft.com/archive/blogs/sqlphp/microsoft-drivers-5-4-0-preview-for-php-for-sql-server-released Mon, 24 Sep 2018 21:22:28 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1605 Hi all, We are excited to announce a new technical preview for SQLSRV and PDO_SQLSRV drivers for PHP. The driver supports the Microsoft ODBC Driver 17.3 (Preview) for SQL Server driver and includes some fixes and new features. Notable items about the 5.4.0-preview release:

    Added

    Removed

    • Dropped support for Ubuntu 17.10
    • Dropped support for PHP 7.0 - Version 5.3 is the last to support PHP 7.0.

    Fixed

    • Issue #434 - To avoid the pitfall that could result in a crash, before freeing stmt in the destructor check if its dbh driver data is NULL
    • Pull Request #836 - Modified the config files to enable Spectre Mitigations (use /Qspectre switch) for PHP 7.2
    • Pull Request #833 - Streamlined the error handling to remove a potential cause of crash

    Limitations

    • No support for inout / output params when using sql_variant type
    • In Linux and macOS, setlocale() only takes effect if it is invoked before the first connection. Attempting to set the locale after connecting will not work
    • Always Encrypted requires MS ODBC Driver 17+
      • Only Windows Certificate Store and Azure Key Vault are supported. Custom Keystores are not yet supported
      • Issue #716 - With Always Encrypted enabled, named parameters in subqueries are not supported
      • Always Encrypted limitations

    Known Issues

    • Connection pooling on Linux or macOS is not recommended with unixODBC < 2.3.7
    • When pooling is enabled in Linux or macOS
      • unixODBC <= 2.3.4 (Linux and macOS) might not return proper diagnostic information, such as error messages, warnings and informative messages
      • due to this unixODBC bug, fetch large data (such as xml, binary) as streams as a workaround. See the examples here
    • With ColumnEncryption enabled, calling stored procedures with XML parameters does not work (Issue #674)
    • With ColumnEncryption enabled, fetching varbinary(max), varchar(max) or nvarchar(max) may fail with ODBC Driver 17.3 CTP

    Survey

    Let us know how we are doing and how you use our driver by taking our pulse survey: https://aka.ms/mssqlphpsurvey

    Get Started

    Direct downloads can be found on the Github release tag. David Engel]]>         Microsoft Drivers 5.3.0 for PHP for SQL Server Released! https://docs.microsoft.com/archive/blogs/sqlphp/microsoft-drivers-5-3-0-for-php-for-sql-server-released Fri, 20 Jul 2018 21:30:05 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1595 Hi all, We are excited to announce the production ready release for the Microsoft Drivers 5.3.0 for PHP for SQL Server. The driver enables access to SQL Server, Azure SQL Database, Azure SQL Managed Instance, and Azure SQL DW from PHP 7.0-7.2 applications on Linux, Windows and macOS. Notable items about the 5.3.0 release since 5.2.0:

    Added

    • Added support for Azure Key Vault for Always Encrypted functionality. Always Encrypted functionality is supported on Linux and macOS through Azure Key Vault
    • Added support for connection resiliency on Linux and macOS (requires version 17.2 or higher of the ODBC driver)
    • Added support for macOS High Sierra (requires version 17 or higher of the ODBC driver)
    • Added support for Ubuntu 18.04 (requires version 17.2 or higher of the ODBC driver)

    Fixed

    • Issue #577 - Idle Connection Resiliency doesn't work with Column Encryption enabled connections (fixed in MS ODBC Driver 17.1)
    • Issue #678 - Idle Connection Resiliency doesn't work with Connection Pooling (fixed in MS ODBC Driver 17.1)
    • Issue #699 - Binding output parameters fails when the query in the stored procedure returns no data. The test case has been added to the test lab.
    • Issue #705 - Always Encrypted - Retrieving a negative decimal value (edge case) as output parameter causes truncation
    • Issue #706 - Always Encrypted - Cannot insert double with precision and scale (38, 38)
    • Issue #707 - Always Encrypted - Fetching decimals / numerics as output parameters bound to PDO::PARAM_BOOL or PDO::PARAM_INT returns floats, not integers
    • Issue #735 - Extended the buffer size for PDO::lastInsertId so that data types other than integers can be supported
    • Pull Request #759 - Removed the limitation of binding a binary as inout param as PDO::PARAM_STR with SQLSRV_ENCODING_BINARY
    • Pull Request #775 - Fixed the truncation problem for output params with SQL types specified as SQLSRV_SQLTYPE_DECIMAL or SQLSRV_SQLTYPE_NUMERIC

    Limitations

    • No support for inout / output params when using sql_variant type
    • In Linux and macOS, setlocale() only takes effect if it is invoked before the first connection. Attempting to set the locale after connecting will not work
    • Always Encrypted requires MS ODBC Driver 17+
      • Only Windows Certificate Store and Azure Key Vault are supported. Custom Keystores are not supported
      • Issue #716 - With Always Encrypted enabled, named parameters in subqueries are not supported
      • Always Encrypted limitations

    Known Issues

    • Connection pooling on Linux or macOS is not recommended with unixODBC < 2.3.6
    • When pooling is enabled in Linux or macOS
      • unixODBC <= 2.3.4 (Linux and macOS) might not return proper diagnostic information, such as error messages, warnings and informative messages
      • due to this unixODBC bug, fetch large data (such as xml, binary) as streams as a workaround. See the examples here
    • With ColumnEncryption enabled, calling stored procedures with XML parameters does not work (Issue #674)

    Survey

    Let us know how we are doing and how you use our driver by taking our pulse survey: https://aka.ms/mssqlphpsurvey

    Get Started

    Direct downloads can be found on the Microsoft website or the Github release tag. David Engel]]>         Microsoft Drivers 5.2.1 Preview for PHP for SQL Server Released! https://docs.microsoft.com/archive/blogs/sqlphp/microsoft-drivers-5-2-1-preview-for-php-for-sql-server-released Thu, 31 May 2018 21:17:52 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1585 Hi all, We are excited to announce a new technical preview for SQLSRV and PDO_SQLSRV drivers. The driver now supports basic CRUD functionalities with the Always Encrypted feature for Windows, Linux and macOS. Both drivers have been built with PHP 7.0+ and tested on all supported platforms (Windows, Ubuntu 16.04 and 17.10, RedHat 7, Debian 8 and 9, Suse 12, and macOS 10.11, 10.12, and 10.13). Notable items about 5.2.1-preview release:

    Added

    • Added support for Azure Key Vault for Always Encrypted for basic CRUD functionalities such that Always Encrypted feature is also available to Linux or macOS users
    • Added support for macOS High Sierra (requires MS ODBC Driver 17+)

    Fixed

    • Issue #577 - Idle Connection Resiliency doesn't work with Column Encryption enabled connection
    • Issue #678 - Idle Connection Resiliency doesn't work with Connection Pooling bug
    • Issue #699 - Binding output parameter failed when the query in the stored procedure returned no data. The test case has been added to the test lab.
    • Issue #705 - AE - Retrieving a negative decimal value (edge case) as output parameter causes truncation
    • Issue #706 - AE - Cannot insert double with precision and scale (38, 38)
    • Issue #707 - AE - Fetching decimals / numerics as output parameters bound to PDO::PARAM_BOOL or PDO::PARAM_INT returns floats, not integers
    • Issue #735 - Extended the buffer size for PDO lastInsertId such that data types other than integers can be supported
    • Pull Request #759 - Removed the limitation of binding a binary as inout param as PDO::PARAM_STR with SQLSRV_ENCODING_BINARY
    • Pull Request #775 - Fixed the problem for output params with SQL types specified as SQLSRV_SQLTYPE_DECIMAL or SQLSRV_SQLTYPE_NUMERIC

    Limitations

    • No support for inout / output params when using sql_variant type
    • In Linux and macOS, setlocale() only takes effect if it is invoked before the first connection. Attempting to set the locale after connection will not work
    • Always Encrypted feature, which requires MS ODBC Driver 17+
      • only Windows Certificate Store and Azure Key Vault are supported
      • Issue #716 - With Always Encrypted feature enabled, Named Parameters in Sub Queries are not supported
      • Always Encrypted limitations

    Known Issues

    • Connection pooling on Linux or macOS is not recommended with unixODBC < 2.3.6
    • When pooling is enabled on Linux or macOS
      • unixODBC <= 2.3.4 (Linux and macOS) might not return proper diagnostics information, such as error messages, warnings and informative messages
      • due to this unixODBC bug, fetch large data (such as xml, binary) as streams as a workaround. See the examples here
    • With ColumnEncryption enabled, calling stored procedures with XML parameters does not work (Issue #674)

    Survey

    Let us know how we are doing and how you use our driver by taking our pulse survey: https://aka.ms/mssqlphpsurvey

    Get Started

    Direct downloads can be found on the Github release tag.

    Getting Drivers for PHP5 and older runtimes

    You can download the Microsoft Drivers for PHP for SQL Server for old versions of  PHP (5.4, 5.5 and 5.6) from the download center: https://www.microsoft.com/en-us/download/details.aspx?id=20098. Version 3.0 supports PHP 5.4, version 3.1 supports PHP 5.4 and PHP 5.5 and version 3.2 supports PHP 5.4, 5.5 and 5.6.
    PHP Driver Version Supported
    v3.2 PHP 5.6, 5.5, 5.4
    v3.1 PHP 5.5, 5.4
    v3.1 PHP 5.4
    David Engel]]>         Microsoft Drivers 5.2.0 for PHP for SQL Server Released! https://docs.microsoft.com/archive/blogs/sqlphp/microsoft-drivers-5-2-0-for-php-for-sql-server-released Tue, 27 Mar 2018 17:28:56 GMT https://blogs.msdn.microsoft.com/sqlphp/?p=1575 Hi all, We are excited to announce the production ready release for the Microsoft Drivers 5.2.0 for PHP for SQL Server. The drivers now support basic select/insert/update/delete functionality with the Always Encrypted feature. The driver enables access to SQL Server, Azure SQL Database and Azure SQL DW from PHP 7.0-7.2 applications on Linux, Windows and macOS. Notable items about 5.2.0 since 4.3.0:

    Added

    • Added support for Always Encrypted (see Features)
      • Support for Windows Certificate Store
      • Support for inserting into and modifying an encrypted column
      • Support for fetching from an encrypted column
    • Added support for PHP 7.2
    • Added support for Microsoft ODBC Driver 17 for SQL Server
    • Added support for Ubuntu 17 (requires Microsoft ODBC Driver 17 for SQL Server)
    • Added support for Debian 9 (requires Microsoft ODBC Driver 17 for SQL Server)
    • Added support for SUSE 12
    • Added Driver option to specify the Microsoft ODBC driver
      • Valid options are "ODBC Driver 17 for SQL Server", "ODBC Driver 13 for SQL Server", and "ODBC Driver 11 for SQL Server"
      • The default driver is ODBC Driver 17 for SQL Server

    Changed

    • Implementation of PDO::lastInsertId($name) to return the last inserted sequence number if the sequence name is supplied to the function (lastInsertId)

    Fixed

    • Issue #555 - Hebrew strings truncation (requires Microsoft ODBC Driver 17)
    • Adjusted precisions for numeric/decimal inputs with Always Encrypted
    • Support for non-UTF8 locales in Linux and macOS
    • Fixed crash caused by executing an invalid query in a transaction (Issue #434)
    • Added error handling for using PDO::SQLSRV_ATTR_DIRECT_QUERY or PDO::ATTR_EMULATE_PREPARES in a Column Encryption enabled connection
    • Added error handling for binding TEXT, NTEXT or IMAGE as output parameter (Issue #231)
    • PDO::quote with string containing ASCII NUL character (Issue #538)
    • Decimal types with no decimals are correctly handled when Always Encrypted is enabled (PR #544)
    • BIGINT as an output param no longer results in value out of range exception when the returned value is larger than a maximum integer (PR #567)

    Removed

    • Dropped support for Ubuntu 15
    • Supplying tablename into PDO::lastInsertId($name) no longer return the last inserted row (lastInsertId)

    Limitations

    • Always Encrypted is not supported in Linux and macOS
    • In Linux and macOS, setlocale() only takes effect if it is invoked before the first connection. Attempting to set the locale after connection will not work
    • Always Encrypted functionalities are only supported using MS ODBC Driver 17
    • Always Encrypted limitations
    • When using sqlsrv_query with Always Encrypted feature, SQL type has to be specified for each input (see here)
    • No support for inout / output params when using sql_variant type

    Known Issues

    • Connection pooling on Linux doesn't may not work properly when using Microsoft ODBC Driver 17 unixODBC < 2.3.6
    • When pooling is enabled in Linux or macOS
      • unixODBC <= 2.3.4 (Linux and macOS) might not return proper diagnostics information, such as error messages, warnings and informative messages
      • due to this unixODBC bug, fetch large data (such as xml, binary) as streams as a workaround. See the examples here
    • Connection with Connection Resiliency enabled does not resume properly with Connection Pooling (Issue #678) - Fixed with MS ODBC Driver 17.1
    • With ColumnEncryption enabled, calling stored procedure with XML parameter does not work (Issue #674)
    • Cannot connect with both Connection Resiliency enabled and ColumnEncryption enabled (Issue #577)
    • With ColumnEncryption enabled, retrieving a negative decimal value as output parameter causes truncation of the last digit (Issue #705)
    • With ColumnEncryption enabled, cannot insert a double into a decimal column with precision and scale of (38, 38) (Issue #706)
    • With ColumnEncryption enabled, when fetching decimals as output parameters bound to PDO::PARAM_BOOL or PDO::PARAM_INT, floats are returned, not integers (Issue #707)

    Survey

    Let us know how we are doing and how you use our driver by taking our pulse survey: https://aka.ms/mssqlphpsurvey

    Get Started

    Direct downloads can be found on the Github release tag. David Engel]]>