Notas de lanzamiento de los controladores de Microsoft para PHP para SQL Server

En esta página se describe lo que se agregó en cada versión de Controladores de Microsoft para PHP para SQL Server.

5.14.0

Descarga controladores de Microsoft para PHP para SQL Server (Windows)

Etiqueta de versión de GitHub v5.14.0 (paquetes de Linux y macOS)

  • Número de versión: 5.14.0
  • Publicado: 20 de noviembre de 2026

Novedades en la versión 5.14.0

Nuevo elemento Detalles
Soporte para PHP 8.6. Se añadió soporte para PHP 8.6 a SQLSRV y PDO_SQLSRV. Para detalles de implementación, consulte el cambio de controlador.
Declaraciones explícitas de cadena de entrada PDO. Use PDO::SQLSRV_ATTR_PARAM_METADATA para los valores bindParam, bindValue y execute, o pase opciones de declaración a bindParam. Elige varchar o nvarchar y una longitud SQL independientemente de la codificación fuente.
Dimensionamiento adaptativo de cadenas PDO opcional. Establezca el atributo de conexión PDO::SQLSRV_ATTR_DEFAULT_STR_LENGTH antes de crear una sentencia. Las declaraciones crecen para valores de entrada más largos, mantienen tamaños por parámetro y se promocionan a max cuando es necesario. Los valores predeterminados existentes y las longitudes del búfer de salida permanecen sin cambios.
Codificación UTF-8 opcional de parámetros varchar. Úsase PDO::SQLSRV_ENCODING_UTF8_VARCHAR con PDO_SQLSRV, o "CharacterSet" => SQLSRV_ENC_UTF8_VARCHAR (utf-8-varchar) con SQLSRV. El controlador lee cadenas PHP como UTF-8 y envía parámetros varchar . La entrada sin pérdida no ASCII requiere una ordenación de base de datos UTF-8 y una columna de destino compatible. Una ordenación UTF-8 por sí sola en la columna no es suficiente. Las columnas de parámetros con valor de tabla respetan las sobrescrituras de codificación por columna. Para más detalles, consulte Enviar cadenas UTF-8 como parámetros varchar.
Alias de opciones de conexión. Ambos conductores aceptan ConnectTimeout para LoginTimeout, FailoverPartner para Failover_Partner, y WorkstationID para WSID. Los nombres no distinguen entre mayúsculas y minúsculas, y la última aparición de una opción o su alias gana.
Alias de la contraseña. SQLSRV acepta Password para PWD en el array de opciones de conexión. PDO_SQLSRV acepta PWD o Password en el nombre de la fuente de datos (DSN). Una contraseña no nula pasada al constructor PDO, incluida una cadena vacía, tiene prioridad sobre la contraseña DSN. Pasar credenciales al constructor cuando un DSN pueda registrarse o compartirse.
Recuperaciones de PDO_SQLSRV más rápidas con parámetros vinculados. El tiempo de obtención ya no crece con el número de parámetros vinculados. Para más detalles, véase la incidencia 1685.
El texto del comando mal formado es rechazado. Ambos controladores ahora reportan un error de codificación de consulta para el texto de comandos que no es válido en su codificación. Las versiones anteriores convertían los bytes inválidos en caracteres de reemplazo.
Correcciones de fiabilidad. Corregir el tamaño del búfer de credenciales de Azure Key Vault para Always Encrypted, liberar reescrituras de consultas con nombres de parámetros cuando la preparación falla, vincular la validación de cuadernés en las opciones de conexión a la longitud del valor y borrar copias propiedad del controlador de las contraseñas DSN PDO.
Se eliminó el soporte para PHP 8.3. Utilice PHP 8.4, 8.5 u 8.6 con esta versión.
Las nuevas versiones utilizan PHP Installer for Extensions (PIE) en lugar de PHP Extension Community Library (PECL). Instala con pie install microsoft/sqlsrv y pie install microsoft/pdo_sqlsrv. Las versiones PECL existentes siguen disponibles. Los binarios preconstruidos siguen disponibles en GitHub.

Para conversiones, ejemplos y limitaciones, consulte Declarar tipos y longitudes de cadena de entrada (PDO_SQLSRV).

Para la lista completa de cambios, consulte el registro de cambios de la versión 5.14.0.

Para conocer los requisitos de la plataforma, consulte la matriz de soporte.

5.13.3

Descarga controladores de Microsoft para PHP para SQL Server (Windows)
Etiqueta de versión de GitHub v5.13.3 (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.13.3
  • Lanzamiento: 7 de agosto de 2026

¿Qué hay de nuevo en la versión 5.13.3?

Nuevo elemento Detalles
Se añadió soporte para Windows para instalar los controladores con PIE (PHP Installer for Extensions). La instalación basada en PIE, introducida para Linux y macOS en la versión 5.13.2, también está disponible ahora en Windows. Instala con pie install microsoft/sqlsrv y pie install microsoft/pdo_sqlsrv.

5.13.2

Descarga controladores de Microsoft para PHP para SQL Server (Windows)
Etiqueta de versión de GitHub v5.13.2 (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.13.2
  • Estreno: 29 de julio de 2026

Novedades en la 5.13.2

Nuevo elemento Detalles
Se añadió soporte para instalar los controladores con PIE (PHP Installer for Extensions). Ahora puedes instalar los controladores usando la herramienta PIE además de PECL.
Corregido una vulnerabilidad de inyección SQL en PDO::lastInsertId() (CWE-89). La búsqueda por nombres de secuencia ahora está parametrizada, y los nombres de secuencia no ASCII se gestionan correctamente.
Se ha corregido el truncamiento de parámetros binarios en bytes nulos incrustados con preparaciones emuladas de PDO (CWE-626). Los datos binarios que contienen bytes nulos ya no se truncan cuando PDO::ATTR_EMULATE_PREPARES están habilitados.
Solucionado un fallo de enlace en compilaciones compartidas de Windows Thread-Safe (ZTS). Se resolvió un símbolo externo no resuelto (_tsrm_ls_cache) al construir las extensiones compartidas en ZTS.
Se corrigió la caché de configuración obsoleta de unixODBC en Linux y macOS. El controlador ahora borra la caché INI de unixODBC al apagar el módulo.
Se ha corregido una violación de ODR de AddressSanitizer cuando ambas extensiones están cargadas.  
Abordó los hallazgos del análisis estático de código (CodeQL).  

5.13.1

Descarga controladores de Microsoft para PHP para SQL Server (Windows)
GitHub Release Tag v5.13.1 (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.13.1
  • Fecha de publicación: 30 de abril de 2026

Novedades de la versión 5.13.1

Nuevo elemento Detalles
Se ha corregido la identidad del token de acceso que se filtraba entre las conexiones agrupadas. Las conexiones con tokens de acceso diferentes podrían compartir la misma entrada de grupo, lo que provoca una contaminación cruzada de identidades. Al usar AccessToken con la agrupación de conexiones, el controlador ahora anexa un hash del token a la palabra clave APP para garantizar la diferenciación de clave de grupo por identidad de token.
Se ha corregido una pérdida de datos silenciosa con inserciones de sentencias preparadas. Los conjuntos de resultados no consumidos procedentes de desencadenadores o SET NOCOUNT OFF podrían provocar la reversión implícita de transacciones con MARS habilitado.
Se corrigió un bloqueo al reejecutar instrucciones preparadas con múltiples conjuntos de resultados. Los metadatos de columna obsoletos no se borraron entre ejecuciones con diseños de columna diferentes.
Se corrigió que sqlsrv_errors() devolviera "null" tras un fallo de conexión. Cuando ODBC no proporciona registros de diagnóstico, ahora se devuelve un error genérico en lugar de null.
Se ha corregido la invalidación de secuencia cuando la instrucción sale del ámbito. Los flujos binarios ahora conservan una referencia al recurso de instrucción, evitando la destrucción prematura.

5.13.0

Descarga controladores de Microsoft para PHP para SQL Server (Windows)
Etiqueta de versión de GitHub v5.13.0 (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.13.0
  • Fecha de publicación: 27 de febrero de 2026

Novedades de la versión 5.13.0

Nuevo elemento Detalles
Se ha agregado compatibilidad con PHP 8.4 y 8.5.  
Se ha agregado compatibilidad con las nuevas versiones del sistema operativo. Windows Server 2025, Ubuntu 24.04, Debian 11, Debian 12, Debian 13, Red Hat 9, Red Hat 10, Alpine Linux 3.20, Alpine Linux 3.21, Alpine Linux 3.22, Alpine Linux 3.23, macOS 15 y macOS 26
Se ha quitado la compatibilidad con PHP 8.1 y 8.2.  
Se ha quitado la compatibilidad con versiones de sistema operativo de fin de ciclo de vida. Windows Server 2012, Windows Server 2012, Windows 10, Ubuntu 20.04, Debian 10, Red Hat 7, SUSE Linux 12, Alpine Linux 3.16, Alpine Linux 3.17, Alpine Linux 3.18, Alpine Linux 3.19, macOS 11, macOS 12 y macOS 13.
Se han corregido problemas de seguridad de memoria y análisis de código estático.  

Versiones anteriores

5.12.0

Descarga controladores de Microsoft para PHP para SQL Server (Windows)
GitHub Etiqueta de versión v5.12.0 (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.12.0
  • Fecha de publicación: 31 de enero de 2024

Novedades de la versión 5.12.0

Nuevo elemento Detalles
Se agregó la compatibilidad con PHP 8.3.  
Se eliminó la compatibilidad con PHP 8.0.  
Se eliminó la compatibilidad con Ubuntu 18.04.  
Se corrigió un error de precisión no válida para varchar.  

5.11.1

Descarga controladores de Microsoft para PHP para SQL Server (Windows)
GitHub Release Tag v5.11.1 (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.11.1
  • Fecha de publicación: 7 de septiembre de 2023

Novedades de la versión 5.11.1

Nuevo elemento Detalles
Restablecer el tipo después de vincular el parámetro.  
Se ha corregido el error al usar PDO::ATTR_STRINGIFY_FETCHES.  
Cambie las opciones de conexión para distinguir mayúsculas de minúsculas.  
Corrección de errores para 1465 Agregar una comprobación NULL.  

5.11.0

Descarga controladores de Microsoft para PHP para SQL Server (Windows)
GitHub Release Tag v5.11.0 (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.11.0
  • Fecha de publicación: febrero de 28, 2023

Novedades de la versión 5.11.0

Nuevo elemento
Se ha agregado compatibilidad con PHP 8.2.
Se ha quitado la compatibilidad con PHP 7.4.
Se ha quitado la compatibilidad con Debian 9, macOS 10.15 y Alpine 3.13.

5.10

  • Número de versión: 5.10.11
  • Fecha de publicación: 31 de enero de 2022

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

Novedades de la versión 5.10

Nuevo elemento Detalles
Se ha agregado compatibilidad con PHP 8.1.  
Se ha quitado la compatibilidad con PHP 7.3.  
Se ha quitado la compatibilidad con macOS Mojave, Ubuntu 16.04, Alpine 3.11 y 3.12.  
Se ha agregado compatibilidad con Windows 11 y Windows Server 2022.  
Se ha agregado compatibilidad con macOS Monterey, Debian 11, Ubuntu 21.04 y 21.10, Alpine 3.13, 3.14 y 3.15.  
Se ha agregado compatibilidad con el hardware ARM64 Apple M1. Requiere el controlador ODBC 17.8 o una versión posterior.
Se ha agregado compatibilidad con parámetros con valores de tabla.  
Se permite establecer PDO::ATTR_EMULATE_PREPARES en el nivel de conexión.  
Palabra clave de conexión y validación de valores ajustadas para una mayor flexibilidad.  

1 Esta versión requiere el controlador ODBC 17.4.2 o superior. De lo contrario, se produce una advertencia sobre el fallo al establecer un atributo. Esta advertencia se puede suprimir cuando se usa un controlador ODBC anterior. Si usa SQLSRV, consulte Procedimientos: Configuración del control de errores y advertencias con el controlador SQLSRV. Si usa PDO_SQLSRV, las advertencias se suprimen de forma predeterminada, pero se pueden registrar. Consulte el articulo Actividad de registro para obtener más información.

Problemas conocidos

  • Si los parámetros de cadena se enlazan como cadena corta y se reutilizan posteriormente para enlazar cadenas más largas, se produce un error de truncamiento de cadena.

5.9

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

Información de la versión

  • Número de versión: 5.9.01
  • Fecha de publicación: 29 de enero de 2021

Novedades de la versión 5.9

Nuevo elemento Detalles
Se ha agregado compatibilidad con PHP 8.0.  
Se ha eliminado la compatibilidad con PHP 7.2.  
Se ha agregado compatibilidad con Microsoft ODBC Driver 17.7 en todas las plataformas.  
Se ha agregado compatibilidad con macOS Big Sur, Ubuntu 20.04, Ubuntu 20.10 y Alpine 3.12. Algunos sistemas operativos requieren el controlador ODBC 17.5 o una versión posterior.
Se ha quitado la compatibilidad con macOS High Sierra, Debian 8 y Ubuntu 19.10.  
Compatibilidad con la configuración regional GB18030.  
Se ha ampliado la compatibilidad con PDO errorinfo para incluir mensajes de ODBC adicionales, si están disponibles.  
Compatibilidad con la clasificación de datos con información de rango. Requiere SQL Server 2019 y el controlador ODBC 17.4.2 o posterior.
Se ha agregado compatibilidad con la autenticación del Principal del Servicio de Azure Active Directory. Requiere el controlador ODBC 17.7 o una versión posterior.
Se ha mejorado el rendimiento al usar números decimales como entradas o salidas y se han quitado las conversiones innecesarias de los valores numéricos.  
Se ha mejorado el rendimiento al capturar números mediante búferes de cliente.  
Establecimiento del tiempo de espera de la consulta sin usar el tiempo de expiración de bloqueo, lo que ahorra un viaje adicional al servidor.  

1 Esta versión requiere el controlador ODBC 17.4.2 o superior. De lo contrario, se produce una advertencia sobre el fallo al establecer un atributo. Esta advertencia se puede suprimir cuando se usa un controlador ODBC anterior. Si usa SQLSRV, consulte Procedimientos: Configuración del control de errores y advertencias con el controlador SQLSRV. Si usa PDO_SQLSRV, las advertencias se suprimen de forma predeterminada, pero se pueden registrar. Consulte el articulo Actividad de registro para obtener más información.

5.8.1

Esta versión solo se aplica a Linux y macOS.

Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.8.1
  • Fecha de publicación: 15 de abril de 2020

Novedades de la versión 5.8.1

Nuevo elemento Detalles
Corrección de errores Se corrigieron problemas de configuración regional predeterminados en Alpine Linux.
Corrección de errores Se quitó la estructura de datos innecesaria para admitir la característica de cursores del lado cliente en Alpine Linux.
Corrección de errores Se corrigieron problemas de registro cuando ambos controladores están habilitados en Alpine Linux.

5.8

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.8.0
  • Fecha de publicación: 31 de enero de 2020

Novedades de la versión 5.8

Nuevo elemento Detalles
Se agregó compatibilidad con PHP 7.4.  
Se eliminó el soporte para PHP 7.1.  
Se agregó compatibilidad con Microsoft ODBC Driver 17.5 en todas las plataformas.  
Se agregó compatibilidad con Debian 10 y Red Hat 8. Ambos requieren el controlador ODBC 17.4 o superior.
Se agregó compatibilidad con macOS Catalina, Alpine Linux 3.111 y Ubuntu 19.10. Todos requieren el controlador ODBC 17.5 o superior.
Se quitó la compatibilidad con SQL Server 2008 R2, macOS Sierra, Ubuntu 18.10 y Ubuntu 19.04.  
Compatibilidad con la opción Language al conectarse a SQL Server.  
Compatibilidad con los tipos de cadenas extendidas de PHP que se introdujeron en PHP 7.2.  
Compatibilidad con la recuperación de metadatos de confidencialidad de clasificación de datos. Requiere SQL Server 2019 y el controlador ODBC 17.4.2 o posterior.
Compatibilidad con Always Encrypted con enclaves seguros Requiere el controlador ODBC 17.4 o superior.
Compatibilidad con opciones configurables para la configuración regional en Linux y macOS.  
Rendimiento mejorado al almacenar en caché los metadatos en las capturas y al omitir las llamadas redundantes.  

1 El soporte para Alpine Linux es experimental para la versión 5.8.

5.6.1

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.6.1
  • Fecha de publicación: 19 de marzo de 2019

Novedades de la versión 5.6.1

Nuevo elemento Detalles
Corrección de errores Se han corregido las suposiciones realizadas al calcular metadatos de campo o columna, las cuales podrían haber provocado la finalización de la aplicación.
Corrección de errores Se modificó el archivo de configuración sqlsrv para que se pueda compilar de forma independiente de pdo_sqlsrv.
Corrección de errores Se corrigió PDOStatement::getColumnMeta() para que se devuelva false cuando algo sale mal.

5.6

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.6.0
  • Fecha de publicación: 21 de febrero de 2019

Novedades de la versión 5.6

Nuevo elemento Detalles
Soporte para PHP 7.3.  
Se ha dejado de dar soporte a PHP 7.0.  
Compatibilidad con Microsoft ODBC Driver 17.3 en todas las plataformas.  
Compatibilidad con macOS Mojave. Requiere el controlador ODBC 17.3 o superior.
Compatibilidad con Ubuntu 18.10 y SUSE Linux 15. Ambos requieren el controlador ODBC 17.3 o superior.
Se eliminó la compatibilidad con Linux Ubuntu 17.10 y macOS El Capitan.  
Compatibilidad con el token de acceso de Azure AD. En Linux y macOS, requiere el controlador ODBC 17.2 y versiones posteriores y unixODBC 2.3.6 y versiones posteriores.
Compatibilidad con la autenticación con Azure AD mediante Identidad administrada para recursos de Azure. Requiere el controlador ODBC 17.3 o versiones posteriores.
Nuevas funcionalidades de recuperación • Nueva marca PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE para que pdo_sqlsrv devuelva datetime como objetos.

• Agregue la opción ReturnDatesAsStrings en el nivel de instrucción para sqlsrv.

• Opciones nuevas en los niveles de conexión y de instrucción para ambos controladores para dar formato a los valores decimales en los resultados capturados.
Compatibilidad con la compilación estática de controladores si los usuarios deciden compilar desde el origen.  
Rendimiento mejorado al almacenar en caché los metadatos en las capturas y acelerar las conversiones de cadenas Unicode.  

5.3

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.3.0
  • Fecha de publicación: 20 de julio de 2018

Novedades de la versión 5.3

  • Compatibilidad con Microsoft ODBC Driver 17.2 en todas las plataformas.
  • Compatibilidad con macOS High Sierra (requiere el controlador ODBC 17 y versiones posteriores).
  • Compatibilidad con Azure Key Vault para Always Encrypted para las funcionalidades CRUD básicas, de modo que la característica Always Encrypted esté disponible para todas las plataformas compatibles con Windows, Linux o macOS Uso de Always Encrypted con los controladores PHP para SQL Server
  • Compatibilidad con Ubuntu 18.04 LTS (requiere el controlador ODBC 17.2).
  • Compatibilidad con la resistencia de conexión en Linux o macOS también (requiere el controlador ODBC 17.2).

5.2

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 5.2.0
  • Fecha de publicación: 23 de marzo de 2018

Novedades de la versión 5.2

  • Compatibilidad con PHP 7.2.1 y superior en Windows, y 7.2.0 y superior en otras plataformas.
  • Compatibilidad con Microsoft ODBC Driver 17
    • La versión 17 es ahora la versión predeterminada en todas las plataformas.
  • Compatibilidad con Ubuntu 17.10, Debian 9 y SUSE Linux Enterprise Server 12
  • Se dejó de ofrecer soporte para Ubuntu 15.10.
  • Compatibilidad con Always Encrypted con funcionalidades CRUD en Windows. Para obtener más información, vea Using Always Encrypted with the PHP Drivers for SQL Server (Uso de Always Encrypted con los controladores PHP para SQL Server).
    • Compatibilidad con el Almacén de certificados de Windows.
    • Always Encrypted solo es compatible con Microsoft ODBC Driver 17 y versiones posteriores.
  • Compatibilidad con configuraciones regionales no UTF8 en Linux y macOS.
    • Las configuraciones regionales no UTF8 en Linux y macOS solo se admiten con Microsoft ODBC Driver 17 y versiones posteriores.
  • Compatibilidad de Azure Synapse Analytics
  • Compatibilidad con Instancia administrada de Azure SQL.

4.3

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub (los paquetes de Linux y macOS están disponibles aquí)

  • Número de versión: 4.3.0
  • Fecha de publicación: 6 de julio de 2017

Novedades de la versión 4.3

  • Compatibilidad con PHP 7.1
  • Compatibilidad con macOS Sierra y macOS el Capitan.
  • Compatibilidad con Ubuntu 15.10 y Debian 8.
  • Se dejó de dar soporte a Ubuntu 15.04.
  • Compatibilidad con grupos de disponibilidad de Always On a través de la resolución de IP de red transparente. Para obtener más información, consulte Connection Options.
  • Compatibilidad agregada para el tipo de datos sql_variant con limitación.
  • Compatibilidad con la resistencia de conexión inactiva en Windows. Para obtener más información, consulte Connection Options.
  • Compatibilidad con la agrupación de conexiones para Linux y macOS. Para obtener más información, vea Connection Pooling (Agrupación de conexiones).
  • Compatibilidad con la autenticación de Azure Active Directory con ActiveDirectoryPassword y SqlPassword. Para obtener más información, consulte Connection Options.

4.0

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub

  • Número de versión: 4.0
  • Fecha de publicación: 1 de julio de 2016

Novedades de la versión 4.0

  • Compatibilidad con PHP 7.0
  • Compatibilidad completa con 64 bits
  • Compatibilidad con Ubuntu 15.04, Ubuntu 16.04 y Red Hat 7

3.2

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub

  • Número de versión: 3.2
  • Fecha de publicación: 9 de marzo de 2015

Novedades de la versión 3.2

  • Soporte para PHP 5.6.
  • Incluye las actualizaciones más recientes para las versiones anteriores de PHP 5.5 y 5.4.
  • Requiere Microsoft ODBC Driver 11 for SQL Server

3.1

Descargar paquete de Windows
Etiqueta de lanzamiento de GitHub

  • Número de versión: 3.1
  • Fecha de publicación: 12 de diciembre de 2014

Novedades de la versión 3.1

  • Soporte para PHP 5.5.
  • Requiere Microsoft ODBC Driver 11 for SQL Server. Las versiones anteriores requerían SQL Native Client.

3.0

Descargar paquete de Windows

Novedades de la versión 3.0

2.0

Novedades de la versión 2.0

En la versión 2.0, se ha agregado la compatibilidad con el controlador PDO_SQLSRV. Para obtener más información, vea Referencia del controlador PDO_SQLSRV.