Partager via

Constantes SQLSRV

  • Article

Cette rubrique répertorie les constantes qui sont définies par le Pilote SQL Server pour PHP.

Constantes ERR

Le tableau suivant répertorie les constantes qui sont utilisées pour spécifier si sqlsrv_errors retourne des erreurs, des avertissements ou les deux.

Valeur Description

SQLSRV_ERR_ALL

Les erreurs et les avertissements générés lors du dernier appel de la fonction sqlsrv sont retournés. Il s'agit de la valeur par défaut.

SQLSRV_ERR_ERRORS

Les erreurs générées lors du dernier appel de la fonction sqlsrv sont retournées.

SQLSRV_ERR_WARNINGS

Les avertissements générés lors du dernier appel de la fonction sqlsrv sont retournés.

Constantes FETCH

Le tableau suivant répertorie les constantes qui sont utilisées pour spécifier le type de tableau retourné par sqlsrv_fetch_array.

Constante SQLSRV Description

SQLSRV_FETCH_ASSOC

sqlsrv_fetch_array retourne la ligne de données suivante sous forme de tableau associatif.

SQLSRV_FETCH_BOTH

sqlsrv_fetch_array retourne la ligne de données suivante sous forme d'un tableau avec des clés numériques et associatives. Il s'agit de la valeur par défaut.

SQLSRV_FETCH_NUMERIC

sqlsrv_fetch_array retourne la ligne de données suivante sous forme de tableau indexé numériquement.

Pour plus d'informations sur l'utilisation de ces constantes, consultez Procédure : récupérer des données sous forme de tableau.

Constantes de journalisation

Cette section répertorie les constantes qui sont utilisées pour modifier les paramètres de journalisation avec sqlsrv_configure. Pour plus d'informations sur la journalisation de l'activité, consultez Journalisation de l'activité.

Le tableau suivant répertorie les constantes qui peuvent être utilisées en tant que valeur du paramètre LogSubsystems :

Constante SQLSRV (entier équivalent entre parenthèses) Description

SQLSRV_LOG_SYSTEM_ALL (-1)

Active la journalisation de tous les sous-systèmes.

SQLSRV_LOG_SYSTEM_CONN (2)

Active la journalisation de l'activité des connexions.

SQLSRV_LOG_SYSTEM_INIT (1)

Active la journalisation de l'activité des initialisations.

SQLSRV_LOG_SYSTEM_OFF (0)

Désactive la journalisation.

SQLSRV_LOG_SYSTEM_STMT (4)

Active la journalisation de l'activité des instructions.

SQLSRV_LOG_SYSTEM_UTIL (8)

Active la journalisation de l'activité des fonctions d'erreur (par exemple handle_error et handle_warning).

Le tableau suivant répertorie les constantes qui peuvent être utilisées en tant que valeur du paramètre LogSeverity :

Constante SQLSRV (entier équivalent entre parenthèses) Description

SQLSRV_LOG_SEVERITY_ALL (-1)

Spécifie que les erreurs, les avertissements et les avis doivent être journalisés.

SQLSRV_LOG_SEVERITY_ERROR (1)

Spécifie que les erreurs doivent être journalisées.

SQLSRV_LOG_SEVERITY_NOTICE (4)

Spécifie que les avis doivent être journalisés.

SQLSRV_LOG_SEVERITY_WARNING (2)

Spécifie que les avertissements doivent être journalisés.

Constantes acceptant la valeur Null

Le tableau suivant répertorie les constantes que vous pouvez utiliser pour déterminer si une colonne peut accepter une valeur Null ou si ces informations ne sont pas disponibles. Vous pouvez comparer la valeur de la clé Nullable retournée par sqlsrv_field_metadata pour déterminer si la colonne accepte la valeur Null.

Constante SQLSRV (entier équivalent entre parenthèses) Description

SQLSRV_NULLABLE_YES (0)

La colonne accepte la valeur NULL.

SQLSRV_NULLABLE_NO (1)

La colonne n'accepte pas la valeur NULL.

SQLSRV_NULLABLE_UNKNOWN (2)

L'acceptation de la valeur NULL par la colonne n'est pas déterminée.

Constantes PARAM

La liste suivante contient les constantes pour spécifier la direction des paramètres lorsque vous appelez sqlsrv_query ou sqlsrv_prepare.

Constante SQLSRV Description

SQLSRV_PARAM_IN

Indique un paramètres d'entrée.

SQLSRV_PARAM_INOUT

Indique un paramètres bidirectionnel.

SQLSRV_PARAM_OUT

Indique un paramètres de sortie.

Constantes PHPTYPE

Le tableau suivant répertorie les constantes qui sont utilisées pour décrire les types de données PHP. Pour plus d'informations sur les types de données PHP, consultez la rubrique Types PHP (en anglais).

Constante SQLSRV Type de données PHP

SQLSRV_PHPTYPE_INT

Entier

SQLSRV_PHPTYPE_DATETIME

Datetime

SQLSRV_PHPTYPE_FLOAT

Float

SQLSRV_PHPTYPE_STREAM(<encoding>1)

Flux

SQLSRV_PHPTYPE_STRING(<encoding>1)

Chaîne

1. SQLSRV_PHPTYPE_STREAM et SQLSRV_PHPTYPE_STRING acceptent un paramètre qui spécifie le codage de flux. Le tableau suivant contient les constantes SQLSRV qui sont des paramètres acceptables et une description du codage correspondant.

Constante SQLSRV Description

SQLSRV_ENC_BINARY

Les données sont retournées sous forme de flux d'octets bruts à partir du serveur, sans codage ni traduction.

SQLSRV_ENC_CHAR

Les données sont retournées sous forme de caractères 8 bits conformément à la page de codes des paramètres régionaux Windows définis sur le système. Les caractères multioctets ou les caractères qui ne sont pas mappés à cette page de codes sont remplacés par un caractère codé sur un seul octet, le point d'interrogation (?).

"UTF-8"

Les données sont retournées au format UTF-8. Cette constante est une nouveauté de la version 1.1 du Pilote SQL Server pour PHP. Pour plus d'informations sur la prise en charge d'UTF-8, consultez Procédure : envoyer et récupérer des données UTF-8 grâce à la prise en charge UTF-8 intégrée.
Cc296183.note(fr-fr,SQL.90).gifRemarque :
Lorsque vous utilisez SQLSRV_PHPTYPE_STREAM ou SQLSRV_PHPTYPE_STRING, le codage doit être spécifié. Si aucun paramètre n'est fourni, une erreur est retournée.

Pour plus d'informations sur ces constantes, consultez Procédure : spécifier les types de données PHP, Procédure : récupérer des données de type caractère sous forme de flux.

Constantes SQLTYPE

Le tableau suivant répertorie les constantes qui sont utilisées pour décrire les types de données SQL Server. Certaines constantes nécessitent des paramètres qui correspondent à la précision, l'échelle et/ou la longueur. Pour plus d'informations sur les types de données SQL Server, consultez Types de données (Transact-SQL). Pour obtenir des informations sur la précision, l'échelle et la longueur, consultez Précision, échelle et longueur (Transact-SQL).

Constante SQLSRV Type de données SQL Server

SQLSRV_SQLTYPE_BIGINT

bigint

SQLSRV_SQLTYPE_BINARY

binary

SQLSRV_SQLTYPE_BIT

bit

SQLSRV_SQLTYPE_CHAR($charCount)

char

SQLSRV_SQLTYPE_DATE

date4

SQLSRV_SQLTYPE_DATETIME

datetime

SQLSRV_SQLTYPE_DATETIME2

datetime24

SQLSRV_SQLTYPE_DATETIMEOFFSET

datetimeoffset4

SQLSRV_SQLTYPE_DECIMAL($precision, $scale)

decimal

SQLSRV_SQLTYPE_FLOAT

float

SQLSRV_SQLTYPE_IMAGE

image1

SQLSRV_SQLTYPE_INT

int

SQLSRV_SQLTYPE_MONEY

money

SQLSRV_SQLTYPE_NCHAR($charCount)

nchar

SQLSRV_SQLTYPE_NUMERIC($precision, $scale)

numeric

SQLSRV_SQLTYPE_NVARCHAR($charCount)

nvarchar

SQLSRV_SQLTYPE_NVARCHAR('max')

nvarchar(MAX)

SQLSRV_SQLTYPE_NTEXT

ntext2

SQLSRV_SQLTYPE_REAL

real

SQLSRV_SQLTYPE_SMALLDATETIME

smalldatetime

SQLSRV_SQLTYPE_SMALLINT

smallint

SQLSRV_SQLTYPE_SMALLMONEY

smallmoney

SQLSRV_SQLTYPE_TEXT

text3

SQLSRV_SQLTYPE_TIME

time4

SQLSRV_SQLTYPE_TIMESTAMP

timestamp

SQLSRV_SQLTYPE_TINYINT

tinyint

SQLSRV_SQLTYPE_UNIQUEIDENTIFIER

uniqueidentifier

SQLSRV_SQLTYPE_UDT

UDT

SQLSRV_SQLTYPE_VARBINARY($byteCount)

varbinary

SQLSRV_SQLTYPE_VARBINARY('max')

varbinary(MAX)

SQLSRV_SQLTYPE_VARCHAR($charCount)

varchar

SQLSRV_SQLTYPE_VARCHAR('max')

varchar(MAX)

SQLSRV_SQLTYPE_XML

xml
  1. Il s'agit d'un type hérité qui est mappé au type varbinary(max).
  2. Il s'agit d'un type hérité qui est mappé au type plus récent nvarchar.
  3. Il s'agit d'un type hérité qui est mappé au type plus récent varchar.
  4. La prise en charge de ce type est une nouveauté de la version 1.1 du Pilote SQL Server pour PHP.

Le tableau suivant répertorie les constantes SQLTYPE qui acceptent des paramètres et la plage des valeurs autorisées pour le paramètre.

SQLTYPE Paramètre Plage autorisée pour le paramètre

SQLSRV_SQLTYPE_CHAR,

SQLSRV_SQLTYPE_VARCHAR

charCount

1 - 8000

SQLSRV_SQLTYPE_NCHAR,

SQLSRV_SQLTYPE_NVARCHAR

charCount

1 - 4000

SQLSRV_SQLTYPE_BINARY,

SQLSRV_SQLTYPE_VARBINARY

byteCount

1 - 8000

SQLSRV_SQLTYPE_DECIMAL,

SQLSRV_SQLTYPE_NUMERIC

precision

1 - 38

SQLSRV_SQLTYPE_DECIMAL,

SQLSRV_SQLTYPE_NUMERIC

scale

1 - precision

Constantes de niveau d'isolation d'une transaction

La clé TransactionIsolation, qui est utilisée avec sqlsrv_connect, accepte l'une des constantes suivantes :

  • SQLSRV_TXN_READ_UNCOMMITTED
  • SQLSRV_TXN_READ_COMMITTED
  • SQLSRV_TXN_REPEATABLE_READ
  • SQLSRV_TXN_SNAPSHOT
  • SQLSRV_TXN_SERIALIZABLE

Constantes de curseur et de défilement

Les constantes ci-dessous spécifient le type de curseur que vous pouvez utiliser dans un jeu de résultats :

  • SQLSRV_CURSOR_FORWARD
  • SQLSRV_CURSOR_STATIC
  • SQLSRV_CURSOR_DYNAMIC
  • SQLSRV_CURSOR_KEYSET

Les constantes suivantes indiquent la ligne à sélectionner dans le jeu de résultats :

  • SQLSRV_SCROLL_NEXT
  • SQLSRV_SCROLL_PRIOR
  • SQLSRV_SCROLL_FIRST
  • SQLSRV_SCROLL_LAST
  • SQLSRV_SCROLL_ABSOLUTE
  • SQLSRV_SCROLL_RELATIVE

Pour plus d'informations sur l'utilisation de ces constantes, consultez Spécification d'un type de curseur et sélection de lignes.

Voir aussi

Autres ressources

Référence de l'API (Pilote SQL Server pour PHP)