Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym temacie omówiono stałe zdefiniowane przez sterowniki firmy Microsoft dla języka PHP dla programu SQL Server.
Stałe dla sterownika PDO_SQLSRV
Stałe wymienione w witrynie internetowej PDO są prawidłowe w sterownikach firmy Microsoft dla języka PHP dla programu SQL Server.
Poniżej opisano stałe specyficzne dla firmy Microsoft w sterowniku PDO_SQLSRV.
Stałe poziomów izolacji transakcji
Klucz TransactionIsolation , który jest używany z pdO::__construct, akceptuje jedną z następujących stałych:
PdO::SQLSRV_TXN_READ_UNCOMMITTED
PDO::SQLSRV_TXN_READ_COMMITTED
PDO::SQLSRV_TXN_REPEATABLE_READ
PDO::SQLSRV_TXN_SNAPSHOT
PDO::SQLSRV_TXN_SERIALIZABLE
Aby uzyskać więcej informacji na temat klucza TransactionIsolation , zobacz Opcje połączenia.
Stałe deklaracji wejściowego ciągu znaków
Te stałe dotyczą tylko PDO_SQLSRV, nie SQLSRV.
| Stała | Purpose |
|---|---|
PDO::SQLSRV_ATTR_PARAM_METADATA |
Atrybut polecenia zawierający mapę od pozycji opartych na 1 lub unikalnych nazw parametrów do tablic deklaracji. Ustaw go po prepare. |
PDO::SQLSRV_ATTR_DEFAULT_STR_LENGTH |
Atrybut połączenia kontrolujący początkową adaptacyjną długość łańcucha znaków dla nowych instrukcji. Akceptuje liczby całkowite od 0 do 8 000; domyślna wartość 0 wyłącza adaptacyjne rozmiarowanie. |
PDO::SQLSRV_PARAM_DECLARED_STR_TYPE |
Wymagany klucz deklaracji dla typu łańcucha SQL. |
PDO::SQLSRV_PARAM_DECLARED_STR_LENGTH |
Wymagany klucz deklaracji dla długości SQL. |
PDO::SQLSRV_PARAM_DECLARED_STR_TYPE_VARCHAR |
Deklaruje varchar. Ograniczone długości to od 1 do 8 000 bajtów. |
PDO::SQLSRV_PARAM_DECLARED_STR_TYPE_NVARCHAR |
Deklaruje nvarchar. Ograniczone długości wynoszą od 1 do 4 000 jednostek kodu UTF-16. |
PDO::SQLSRV_PARAM_DECLARED_STR_LENGTH_MAX |
Deklaruje wybrany typ o długości max. |
Dla kształtów metadanych, kodowania, precedencji, przykładów i ograniczeń zobacz Deklarowanie typów i długości ciągów wejściowych (PDO_SQLSRV).
Stałe kodowania
Atrybut PDO::SQLSRV_ATTR_ENCODING można przekazać do PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare, PDOStatement::bindColumn i PDOStatement::bindParam.
Dostępne wartości przekazywane do PDO::SQLSRV_ATTR_ENCODING to:
| stała sterownika PDO_SQLSRV | Description |
|---|---|
| PDO::SQLSRV_ENCODING_BINARY | Dane są nieprzetworzonym strumieniem bajtów z serwera bez kodowania ani tłumaczenia. Nieprawidłowy dla pdO::setAttribute. |
| PDO::SQLSRV_ENCODING_SYSTEM | Dane to znaki 8-bitowe, zgodnie z określoną stroną kodową ustawień regionalnych systemu Windows, które są ustawione w systemie. Wszelkie znaki wielobajtowe lub znaki, które nie są mapowane na tę stronę kodową, są zastępowane znakiem zapytania jednobajtowego (?). |
| PDO::SQLSRV_ENCODING_UTF8 | Dane są w kodowaniu UTF-8. Jest to kodowanie domyślne. |
| PDO::SQLSRV_ENCODING_UTF8_VARCHAR | Dane są w kodowaniu UTF-8, a parametry łańcuchowe bez jawnego typu SQL są wysyłane jako varchar zamiast nvarchar. Odczyty zwracają UTF-8. Dodano w wersji 5.14.0. Aby uzyskać wymagania i reguły pierwszeństwa, zobacz Wysyłanie ciągów UTF-8 jako parametrów varchar. |
| PDO::SQLSRV_ENCODING_DEFAULT | Używa PDO::SQLSRV_ENCODING_SYSTEM, jeśli zostało to określone podczas połączenia. Użyj kodowania połączenia, jeśli zostanie określone w instrukcji przygotowawczej. |
Limit czasu zapytania
Atrybut PDO::SQLSRV_ATTR_QUERY_TIMEOUT jest dowolną nieujemną liczbą całkowitą reprezentującą okres limitu czasu w sekundach. Zero (0) jest wartością domyślną i oznacza brak limitu czasu.
Możesz określić atrybut PDO::SQLSRV_ATTR_QUERY_TIMEOUT za pomocą PDOStatement::setAttribute, PDO::setAttribute i PDO::prepare.
Bezpośrednie lub przygotowane wykonanie
Możesz wybrać bezpośrednie wykonanie zapytania lub przygotowane wykonanie instrukcji za pomocą atrybutu PDO::SQLSRV_ATTR_DIRECT_QUERY. PDO::SQLSRV_ATTR_DIRECT_QUERY można ustawić za pomocą PDO::prepare lub PDO::setAttribute. Aby uzyskać więcej informacji na temat PDO::SQLSRV_ATTR_DIRECT_QUERY, zobacz Wykonywanie instrukcji bezpośredniej i Przygotowane wykonywanie instrukcji w sterowniku PDO_SQLSRV.
Obsługa operacji z liczbami
Atrybut PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE może służyć do obsługi pobierania liczbowego z kolumn z numerycznymi typami SQL (bit, integer, smallint, tinyint, float i real). Gdy atrybut PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE jest ustawiony na true, wyniki z kolumny całkowitej są reprezentowane jako liczby całkowite, podczas gdy liczby typu float w SQL są reprezentowane jako liczby zmiennoprzecinkowe. Ten atrybut można ustawić za pomocą atrybutu PDOStatement::setAttribute.
Możesz modyfikować domyślne formatowanie dziesiętne za pomocą atrybutów PDO::SQLSRV_ATTR_FORMAT_DECIMALS i PDO::SQLSRV_ATTR_DECIMAL_PLACES. Zachowanie tych atrybutów jest identyczne jak odpowiadające im opcje po stronie SQLSRV (FormatDecimals i DecimalPlaces), z tą różnicą, że parametry wyjściowe nie są obsługiwane do formatowania. Te atrybuty można ustawić na poziomie połączenia lub instrukcji z pdO::setAttribute lub PDOStatement::setAttribute, ale każdy atrybut instrukcji zastąpi odpowiedni atrybut połączenia. Aby uzyskać więcej informacji, zobacz Formatowanie ciągów dziesiętnych i wartości pieniężnych (PDO_SQLSRV Driver).
Obsługa pobierania dat i godzin
PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE określa, czy mają być pobierane typy dat i godzin jako obiekty PHP DateTime. Jeśli pozostawi fałszywe, domyślne zachowanie polega na zwracaniu ich jako ciągów znaków. Ten atrybut może być ustawiony na poziomie połączenia lub instrukcji z pdO::setAttribute lub PDOStatement::setAttribute, ale atrybut instrukcji zastąpi odpowiedni atrybut połączenia. Aby uzyskać więcej informacji, zobacz How to: Retrieve Date and Time Types as PHP DateTime Objects Using the PDO_SQLSRV Driver (Jak pobrać typy dat i godzin jako obiekty typu data/godzina w języku PHP przy użyciu sterownika PDO_SQLSRV).
Stałe sterowników SQLSRV
W poniższych sekcjach wymieniono stałe używane przez sterownik SQLSRV.
Stałe ERR
W poniższej tabeli wymieniono stałe używane do określania, czy sqlsrv_errors zwraca błędy, ostrzeżenia lub oba te elementy.
| Wartość | Description |
|---|---|
| SQLSRV_ERR_ALL | Zwracane są błędy i ostrzeżenia wygenerowane podczas ostatniego wywołania funkcji sqlsrv . Jest to wartość domyślna. |
| SQLSRV_ERR_ERRORS | Zwracane są błędy wygenerowane podczas ostatniego wywołania funkcji sqlsrv . |
| SQLSRV_ERR_WARNINGS | Zwracane są ostrzeżenia wygenerowane podczas ostatniego wywołania funkcji sqlsrv . |
Stałe pobierania
W poniższej tabeli wymieniono stałe używane do określania typu tablicy zwracanej przez sqlsrv_fetch_array.
| Stała SQLSRV | Description |
|---|---|
| SQLSRV_FETCH_ASSOC | sqlsrv_fetch_array zwraca następny wiersz danych jako tablicę asocjacyjną. |
| SQLSRV_FETCH_BOTH | sqlsrv_fetch_array zwraca następny wiersz danych jako tablicę z kluczami numerycznymi i asocjacyjnymi. Jest to wartość domyślna. |
| SQLSRV_FETCH_NUMERIC | sqlsrv_fetch_array zwraca następny wiersz danych jako tablicę indeksowaną numerycznie. |
Stałe rejestrowania
W tej sekcji wymieniono stałe używane do zmiany ustawień rejestrowania przy użyciu sqlsrv_configure. Aby uzyskać więcej informacji na temat działań rejestrowania, zobacz Rejestrowanie aktywności.
W poniższej tabeli wymieniono stałe, które mogą być używane jako wartość ustawienia LogSubsystems :
| Stała SQLSRV (odpowiednik liczb całkowitych w nawiasach) | Description |
|---|---|
| SQLSRV_LOG_SYSTEM_ALL (-1) | Włącza rejestrowanie wszystkich podsystemów. |
| SQLSRV_LOG_SYSTEM_CONN (2) | Włącza rejestrowanie aktywności połączenia. |
| SQLSRV_LOG_SYSTEM_INIT (1) | Włącza rejestrowanie działań inicjowania. |
| SQLSRV_LOG_SYSTEM_OFF (0) | Włącza wylogowywania. |
| SQLSRV_LOG_SYSTEM_STMT (4) | Włącza rejestrowanie działania instrukcji. |
| SQLSRV_LOG_SYSTEM_UTIL (8) | Włącza rejestrowanie działań funkcji błędów (takich jak handle_error i handle_warning). |
W poniższej tabeli wymieniono stałe, które mogą być używane jako wartość ustawienia LogSeverity :
| Stała SQLSRV (odpowiednik liczb całkowitych w nawiasach) | Description |
|---|---|
| SQLSRV_LOG_SEVERITY_ALL (-1) | Określa, że błędy, ostrzeżenia i powiadomienia będą rejestrowane. |
| SQLSRV_LOG_SEVERITY_ERROR (1) | Określa, że błędy zostaną zarejestrowane. |
| SQLSRV_LOG_SEVERITY_NOTICE (4) | Określa, że powiadomienia zostaną zarejestrowane. |
| SQLSRV_LOG_SEVERITY_WARNING (2) | Określa, że ostrzeżenia zostaną zarejestrowane. |
Stałe nullable
W poniższej tabeli wymieniono stałe, których można użyć do określenia, czy kolumna jest nullowalna, czy te informacje nie są dostępne. Możesz porównać wartość klucza Nullable zwróconą przez sqlsrv_field_metadata, aby określić możliwość przyjmowania wartości null przez kolumnę.
| Stała SQLSRV (odpowiednik liczb całkowitych w nawiasach) | Description |
|---|---|
| SQLSRV_NULLABLE_YES (0) | Kolumna może przyjmować wartość null. |
| SQLSRV_NULLABLE_NO (1) | Kolumna nie może zawierać wartości null. |
| SQLSRV_NULLABLE_UNKNOWN (2) | Nie wiadomo, czy kolumna jest podatna na wartości NULL. |
Stałe PARAM
Poniższa lista zawiera stałe do określania kierunku parametru podczas wywoływania sqlsrv_query lub sqlsrv_prepare.
| Stała SQLSRV | Description |
|---|---|
| SQLSRV_PARAM_IN | Wskazuje parametr wejściowy. |
| SQLSRV_PARAM_INOUT | Wskazuje dwukierunkowy parametr. |
| SQLSRV_PARAM_OUT | Wskazuje parametr wyjściowy. |
Stałe PHPTYPE
W poniższej tabeli wymieniono stałe używane do opisywania typów danych PHP. Aby uzyskać informacje o typach danych PHP, zobacz Typy PHP.
| Stała SQLSRV | Typ danych PHP |
|---|---|
| SQLSRV_PHPTYPE_INT | Integer |
| SQLSRV_PHPTYPE_DATETIME | Data i czas |
| SQLSRV_PHPTYPE_FLOAT | Pływak |
| SQLSRV_PHPTYPE_STREAM($encoding1) | Stream |
| SQLSRV_PHPTYPE_STRING($encoding1) | Sznurek |
1SQLSRV_PHPTYPE_STREAM i SQLSRV_PHPTYPE_STRING akceptują parametr określający kodowanie strumienia. Poniższa tabela zawiera stałe SQLSRV, które są akceptowalnymi parametrami, oraz opis odpowiadającego kodowania.
| Stała SQLSRV | Description |
|---|---|
| SQLSRV_ENC_BINARY | Dane są zwracane jako nieprzetworzony strumień bajtów z serwera bez wykonywania kodowania lub tłumaczenia. |
| SQLSRV_ENC_CHAR | Dane są zwracane w 8-bitowych znakach, jak określono na stronie kodowej ustawień regionalnych systemu Windows ustawionych w systemie. Wszelkie znaki wielobajtowe lub znaki, które nie są mapowane na tę stronę kodową, są zastępowane znakiem zapytania jednobajtowego (?). Jest to kodowanie domyślne. |
| "UTF-8" | Dane są zwracane w kodowaniu UTF-8. Ta stała została dodana w wersji 1.1 sterowników firmy Microsoft dla języka PHP dla programu SQL Server. Aby uzyskać więcej informacji na temat obsługi protokołu UTF-8, zobacz Instrukcje: wysyłanie i pobieranie danych UTF-8 przy użyciu Built-In obsługi protokołu UTF-8. |
| SQLSRV_ENC_UTF8_VARCHAR | Dane są w kodowaniu UTF-8, a parametry łańcuchowe bez jawnego typu SQL są wysyłane jako varchar zamiast nvarchar. Odczyty zwracają UTF-8. Wartość stałej to ciąg "utf-8-varchar". Dodano w wersji 5.14.0. Aby uzyskać wymagania i reguły pierwszeństwa, zobacz Wysyłanie ciągów UTF-8 jako parametrów varchar. |
Uwaga / Notatka
W przypadku używania SQLSRV_PHPTYPE_STREAM lub SQLSRV_PHPTYPE_STRING należy określić kodowanie. Jeśli nie podano parametru, zostanie zwrócony błąd.
Aby uzyskać więcej informacji na temat tych stałych, zobacz Instrukcje: Jak określić typy danych PHP, Jak pobierać dane znakowe jako strumień przy użyciu sterownika SQLSRV.
Stałe SQLTYPE
W poniższej tabeli wymieniono stałe używane do opisywania typów danych programu SQL Server. Niektóre stałe są podobne do funkcji i mogą przyjmować parametry, które odpowiadają precyzji, skali i/lub długości. Podczas wiązania parametrów należy używać stałych w formie przypominającej funkcję. W przypadku porównań typów wymagane są standardowe stałe (inne niż funkcja). Aby uzyskać informacje o SQL Server typach danych, zobacz Typy danych (Transact-SQL). Aby uzyskać informacje o precyzji, skali i długości, zobacz Precyzja, Skala i Długość (Transact-SQL).
| Stała SQLSRV | Typ danych programu SQL Server |
|---|---|
| SQLSRV_SQLTYPE_BIGINT | bigint |
| SQLSRV_SQLTYPE_BINARY | binarny |
| SQLSRV_SQLTYPE_BIT | bit |
| SQLSRV_SQLTYPE_CHAR | znak5 |
| SQLSRV_SQLTYPE_CHAR($charCount) | char |
| SQLSRV_SQLTYPE_DATE | data4 |
| SQLSRV_SQLTYPE_DATETIME | data/godzina |
| SQLSRV_SQLTYPE_DATETIME2 | datetime24 |
| SQLSRV_SQLTYPE_DATETIMEOFFSET (typ danych w SQL Server odpowiedzialny za uwzględnianie stref czasowych) | datetimeoffset4 |
| SQLSRV_SQLTYPE_DECIMAL | liczba dziesiętna5 |
| SQLSRV_SQLTYPE_DECIMAL($precision, $scale) | liczba dziesiętna |
| SQLSRV_SQLTYPE_FLOAT | float |
| SQLSRV_SQLTYPE_IMAGE | obraz1 |
| SQLSRV_SQLTYPE_INT | int |
| SQLSRV_SQLTYPE_MONEY | pieniądze |
| SQLSRV_SQLTYPE_NCHAR | nchar5 |
| SQLSRV_SQLTYPE_NCHAR($charCount) | nchar |
| SQLSRV_SQLTYPE_NUMERIC | numeryczny5 |
| SQLSRV_SQLTYPE_NUMERIC($precision, $scale) | numeryczny |
| SQLSRV_SQLTYPE_NVARCHAR | nvarchar5 |
| 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 | tekst3 |
| SQLSRV_SQLTYPE_TIME | godzina4 |
| SQLSRV_SQLTYPE_TIMESTAMP | sygnatura czasowa |
| SQLSRV_SQLTYPE_TINYINT | tinyint |
| SQLSRV_SQLTYPE_UNIQUEIDENTIFIER | uniqueidentifier |
| SQLSRV_SQLTYPE_UDT | UDT |
| SQLSRV_SQLTYPE_VARBINARY | varbinary5 |
| SQLSRV_SQLTYPE_VARBINARY($byteCount) | varbinary |
| SQLSRV_SQLTYPE_VARBINARY('max') | varbinary(MAX) |
| SQLSRV_SQLTYPE_VARCHAR | varchar5 |
| SQLSRV_SQLTYPE_VARCHAR($charCount) | Varchar powiedział: |
| SQLSRV_SQLTYPE_VARCHAR('max') | varchar(MAX) |
| SQLSRV_SQLTYPE_XML | XML |
1 Jest to typ przestarzały, który odpowiada typowi varbinary(max).
2 Jest to typ dziedziczny, który odpowiada nowszemu typowi nvarchar.
3 Jest to typ przestarzały, który odpowiada nowszemu typowi varchar.
4 Wsparcie dla tego typu zostało dodane w wersji 1.1 sterowników Microsoft dla PHP dla SQL Server.
5 Te stałe powinny być używane w operacjach porównywania typów i nie zastępują stałych przypominających funkcje o podobnej składni. Do wiązania parametrów używaj stałych funkcyjnych.
W poniższej tabeli wymieniono stałe SQLTYPE, które akceptują parametry i zakres wartości dozwolonych dla parametru.
| TYP SQL | Parameter | Dozwolony zakres parametru |
|---|---|---|
| SQLSRV_SQLTYPE_CHAR, SQLSRV_SQLTYPE_VARCHAR |
Charcount | 1 - 8000 |
| SQLSRV_SQLTYPE_NCHAR, SQLSRV_SQLTYPE_NVARCHAR |
Charcount | 1 - 4000 |
| SQLSRV_SQLTYPE_BINARY, SQLSRV_SQLTYPE_VARBINARY |
liczba bajtów | 1 - 8000 |
| SQLSRV_SQLTYPE_DECIMAL SQLSRV_SQLTYPE_NUMERIC |
precyzja | 1 - 38 |
| SQLSRV_SQLTYPE_DECIMAL SQLSRV_SQLTYPE_NUMERIC |
skala | 1 — precyzja |
Stałe poziomów izolacji transakcji
Klucz TransactionIsolation , który jest używany z sqlsrv_connect, akceptuje jedną z następujących stałych:
SQLSRV_TXN_READ_UNCOMMITTED
SQLSRV_TXN_READ_COMMITTED
SQLSRV_TXN_REPEATABLE_READ
SQLSRV_TXN_SNAPSHOT
SQLSRV_TXN_SERIALIZABLE
Stałe kursora i przewijania
Następujące stałe określają rodzaj kursora, którego można użyć w zestawie wyników:
SQLSRV_CURSOR_FORWARD
SQLSRV_CURSOR_STATIC
SQLSRV_CURSOR_DYNAMIC
SQLSRV_CURSOR_KEYSET
SQLSRV_CURSOR_CLIENT_BUFFERED
Następujące stałe określają wiersz do wybrania w zestawie wyników:
SQLSRV_SCROLL_NEXT
SQLSRV_SCROLL_PRIOR
SQLSRV_SCROLL_FIRST
SQLSRV_SCROLL_LAST
SQLSRV_SCROLL_ABSOLUTE
SQLSRV_SCROLL_RELATIVE
Aby uzyskać informacje na temat używania tych stałych, zobacz Określanie typu kursora i Wybieranie wierszy.