상수(Microsoft Drivers for PHP for SQL Server)

아티클
03/22/2024

PHP 드라이버 다운로드

이 항목에서는 MICROSOFT Drivers for PHP for SQL Server가 정의한 상수에 대해 설명합니다.

PDO_SQLSRV 드라이버 상수

PDO 웹 사이트에 나열된 상수는 MICROSOFT Drivers for PHP for SQL Server에서 유효합니다.

다음은 PDO_SQLSRV 드라이버의 Microsoft 관련 상수에 대해 설명합니다.

트랜잭션 격리 수준 상수

PDO::__construct와 함께 사용되는 TransactionIsolation 키에는 다음 상수 중 하나를 사용할 수 있습니다.

PDO::SQLSRV_TXN_READ_UNCOMMITTED
PDO::SQLSRV_TXN_READ_COMMITTED
PDO::SQLSRV_TXN_REPEATABLE_READ
PDO::SQLSRV_TXN_SNAPSHOT
PDO::SQLSRV_TXN_SERIALIZABLE

TransactionIsolation 키에 대한 자세한 내용은 연결 옵션을 참조하세요.

상수 인코딩

PDO::SQLSRV_ATTR_ENCODING 특성은 PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare, PDOStatement::bindColumn 및 PDOStatement::bindParam에 전달될 수 있습니다.

PDO::SQLSRV_ATTR_ENCODING에 전달할 수 있는 값은 다음과 같습니다.

PDO_SQLSRV 드라이버 상수	설명
PDO::SQLSRV_ENCODING_BINARY	데이터는 인코딩 또는 변환을 수행하지 않고 서버에서 반환되는 원시 바이트 스트림입니다. PDO::setAttribute에는 유효하지 않습니다.
PDO::SQLSRV_ENCODING_SYSTEM	데이터는 시스템에 설정된 Windows 로캘의 코드 페이지에 지정된 8비트 문자입니다. 이 코드 페이지에 매핑되지 않는 멀티바이트 문자 또는 문자는 단일바이트 물음표(?) 문자로 대체됩니다.
PDO::SQLSRV_ENCODING_UTF8	데이터는 UTF-8 인코딩 형식입니다. 이는 기본 인코딩입니다.
PDO::SQLSRV_ENCODING_DEFAULT	연결 중에 지정한 경우 PDO::SQLSRV_ENCODING_SYSTEM을 사용합니다. prepare 문에 지정된 경우 연결의 인코딩을 사용합니다.

쿼리 제한 시간

PDO::SQLSRV_ATTR_QUERY_TIMEOUT 특성은 제한 시간(초)을 나타내는 음수가 아닌 정수입니다. 영(0)이 기본값이며 시간 제한이 없음을 의미합니다.

PDOStatement::setAttribute, PDO::setAttribute 및 PDO::prepare를 사용하여 PDO::SQLSRV_ATTR_QUERY_TIMEOUT 특성을 지정할 수 있습니다.

직접 또는 준비된 실행

PDO::SQLSRV_ATTR_DIRECT_QUERY 특성을 사용하여 직접 쿼리 실행 또는 준비된 문 실행을 선택할 수 있습니다. PDO::SQLSRVATTRDIRECTQUERY는 PDO::prepare 또는 PDO::setAttribute를 사용하여 설정될 수 있습니다. PDO::SQLSRV_ATTR_DIRECT_QUERY에 대한 자세한 내용은 PDO_SQLSRV 드라이버에서 직접 명령문 실행 및 준비된 명령문 실행을 참조하세요.

숫자 페치 처리

PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE 특성은 숫자 SQL 형식(비트, 정수, smallint, tinyint, 부동 및 실수)이 있는 열에서 숫자 페치를 처리하는 데 사용할 수 있습니다. PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE이 true로 설정되면 정수 열의 결과는 실수로 표시되고 SQL 부동 소수점 및 실수는 부동 소수점으로 표시됩니다. 이 특성은 PDOStatement::setAttribute를 사용하여 설정할 수 있습니다.

PDO::SQLSRV_ATTR_FORMAT_DECIMALS 및 PDO::SQLSRV_ATTR_DECIMAL_PLACES 특성을 사용하여 기본 10진수 형식 지정 동작을 수정할 수 있습니다. 이러한 특성의 동작은 출력 매개 변수가 형식에 지원되지 않는다는 점을 제외하고 SQLSRV 쪽(FormatDecimals 및 DecimalPlaces)의 해당 옵션과 동일합니다. 이러한 특성은 PDO::setAttribute 또는 PDOStatement::setAttribute를 사용하여 연결 또는 문 수준에서 설정할 수 있지만, 문 특성은 해당 연결 특성을 재정의합니다. 자세한 내용은 10진수 문자열 및 Money 값 형식 지정(PDO_SQLSRV 드라이버)을 참조하세요.

날짜 및 시간 가져오기 처리

PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE은 날짜 및 시간 형식을 PHP DateTime 개체로 검색할지 여부를 지정합니다. false로 유지하면, 기본 동작은 문자열로 반환하는 것입니다. 이러한 특성은 PDO::setAttribute 또는 PDOStatement::setAttribute를 사용하여 연결 또는 문 수준에서 설정할 수 있지만 문 특성은 해당 연결 특성을 재정의합니다. 자세한 내용은 방법: PDO_SQLSRV 드라이버를 사용하여 날짜 및 시간 형식을 PHP 날짜/시간 개체로 검색을 참조하세요.

SQLSRV 드라이버 상수

다음 섹션에서는 SQLSRV 드라이버에서 사용하는 상수에 대해 설명합니다.

ERR 상수

다음 테이블에는 sqlsrv_errors가 오류, 경고 또는 둘 다를 반환하는지 여부를 지정하는 데 사용되는 상수가 나열되어 있습니다.

값	설명
SQLSRV_ERR_ALL	마지막 sqlsrv 함수 호출 시 생성된 오류 및 경고가 반환됩니다. 기본값입니다.
SQLSRV_ERR_ERRORS	마지막 sqlsrv 함수 호출 시 생성된 오류가 반환됩니다.
SQLSRV_ERR_WARNINGS	마지막 sqlsrv 함수 호출 시 생성된 경고가 반환됩니다.

FETCH 상수

다음 테이블에는 sqlsrv_fetch_array가 반환하는 배열 유형을 지정하는 데 사용되는 상수가 나열되어 있습니다.

SQLSRV 상수	설명
SQLSRV_FETCH_ASSOC	sqlsrv_fetch_array는 데이터의 다음 행을 결합형 배열로 반환합니다.
SQLSRV_FETCH_BOTH	sqlsrv_fetch_array는 데이터의 다음 행을 숫자와 결합형 키를 모두 가진 배열로 반환합니다. 기본값입니다.
SQLSRV_FETCH_NUMERIC	sqlsrv_fetch_array는 데이터의 다음 행을 숫자 인덱싱된 배열로 반환합니다.

Logging 상수

이 섹션에서는 sqlsrv_configure로 로깅 설정을 변경하는 데 사용되는 상수를 나열합니다. 로깅 활동에 대한 자세한 내용은 로깅 활동그을 참조하세요.

다음 테이블은 LogSubsystems 설정에 대한 값으로 사용할 수 있는 상수를 나열합니다.

SQLSRV 상수(괄호 안의 정수에 해당하는 정수)	설명
SQLSRV_LOG_SYSTEM_ALL(-1)	모든 하위 시스템의 로깅을 활성화합니다.
SQLSRV_LOG_SYSTEM_CONN (2)	연결 작업의 로깅을 활성화합니다.
SQLSRV_LOG_SYSTEM_INIT(1)	초기화 작업의 로깅을 설정합니다.
SQLSRV_LOG_SYSTEM_OFF (0)	로깅을 해제합니다.
SQLSRV_LOG_SYSTEM_STMT (4)	문 활동의 로깅을 활성화합니다.
SQLSRV_LOG_SYSTEM_UTIL(8)	오류 함수 작업(예: handle_error 및 handle_warning)의 로깅을 설정합니다.

다음 표는 LogSeverity 설정에 대한 값으로 사용할 수 있는 상수를 나열합니다.

SQLSRV 상수(괄호 안의 정수에 해당하는 정수)	설명
SQLSRV_LOG_SEVERITY_ALL (-1)	오류, 경고 및 알림이 기록된다는 것을 지정합니다.
SQLSRV_LOG_SEVERITY_ERROR (1)	오류를 기록하도록 지정합니다.
SQLSRV_LOG_SEVERITY_NOTICE (4)	알림을 기록하도록 지정합니다.
SQLSRV_LOG_SEVERITY_WARNING (2)	경고가 기록된다는 것을 지정합니다.

Null을 허용하는 상수

다음 표는 열이 Null을 허용하는지 여부 또는 이 정보를 사용할 수 있는지 여부를 확인하는 데 사용할 수 있는 상수를 나열합니다. sqlsrv_field_metadata에서 반환되는 Nullable 키의 값을 비교하여 열의 null 허용 상태를 확인할 수 있습니다.

SQLSRV 상수(괄호 안의 정수에 해당하는 정수)	설명
SQLSRV_NULLABLE_YES(0)	열이 Null을 허용합니다.
SQLSRV_NULLABLE_NO (1)	열이 null 허용이 아닙니다.
SQLSRV_NULLABLE_UNKNOWN (2)	열이 null 허용인지 여부는 알 수 없습니다.

PARAM 상수

다음 목록에는 sqlsrv_query 또는 sqlsrv_prepare를 호출할 때 매개 변수 방향을 지정하는 상수가 포함되어 있습니다.

SQLSRV 상수	설명
SQLSRV_PARAM_IN	입력 매개 변수를 나타냅니다.
SQLSRV_PARAM_INOUT	양방향 매개 변수를 나타냅니다.
SQLSRV_PARAM_OUT	출력 매개 변수를 나타냅니다.

PHPTYPE 상수

다음 테이블은 PHP 데이터 형식을 설명하는 데 사용되는 상수를 나열합니다. PHP 데이터 형식에 대한 자세한 내용은 PHP 형식을 참조하세요.

SQLSRV 상수	PHP 데이터 형식
SQLSRV_PHPTYPE_INT	정수
SQLSRV_PHPTYPE_DATETIME	DateTime
SQLSRV_PHPTYPE_FLOAT	Float
SQLSRV_PHPTYPE_STREAM($encoding¹)	스트림
SQLSRV_PHPTYPE_STRING($encoding¹)	문자열

SQLSRV_PHPTYPE_STREAM 및 SQLSRV_PHPTYPE_STRING은 스트림 인코딩을 지정하는 매개 변수를 허용합니다. 다음 테이블에는 허용되는 매개 변수인 SQLSRV 상수와 해당 인코딩에 대한 설명이 포함되어 있습니다.

SQLSRV 상수	설명
SQLSRV_ENC_BINARY	데이터는 인코딩 또는 변환을 수행하지 않은 원시 바이트 스트림으로 서버에서 반환됩니다.
SQLSRV_ENC_CHAR	데이터는 시스템에 설정된 Windows 로캘의 코드 페이지에 지정된 8비트 문자입니다. 이 코드 페이지에 매핑되지 않는 멀티바이트 문자 또는 문자는 단일바이트 물음표(?) 문자로 대체됩니다. 이는 기본 인코딩입니다.
"UTF-8"	데이터는 UTF-8 인코딩으로 반환됩니다. 이 상수는 Microsoft Drivers for PHP for SQL Server 버전 1.1에 추가되었습니다. UTF-8 지원에 대한 자세한 내용은 기본 제공 UTF-8 지원을 사용하여 UTF-8 데이터 보내기 및 검색을 참조하세요.

참고 항목

SQLSRV_PHPTYPE_STREAM 또는 SQLSRV_PHPTYPE_STRING을 사용하는 경우 인코딩이 지정되어야 합니다. 매개 변수가 제공되지 않으면 오류가 반환됩니다.

이러한 상수에 대한 자세한 내용은 방법: PHP 데이터 형식 지정, 방법: SQLSRV 드라이버를 사용하여 스트림으로 문자 데이터 가져오기를 참조하세요.

SQLTYPE 상수

다음 표는 SQL Server 데이터 형식을 설명하는 데 사용되는 상수를 나열합니다. 일부 상수는 함수와 유사하며 정밀도, 소수 자릿수 및/또는 길이에 해당하는 매개 변수를 사용할 수 있습니다. 매개 변수를 바인딩하는 경우 함수 형태 상수를 사용해야 합니다. 형식 비교를 위해서는 표준(함수와 유사하지 않은) 상수가 필요합니다. SQL Server 데이터 형식에 대한 내용은 데이터 형식(Transact-SQL)을 참조하세요. 전체 자릿수, 정밀도 및 길이에 대한 내용은 전체 자릿수, 정밀도 및 길이(Transact-SQL)를 참조하세요.

SQLSRV 상수	SQL Server 데이터 형식
SQLSRV_SQLTYPE_BIGINT	bigint
SQLSRV_SQLTYPE_BINARY	binary
SQLSRV_SQLTYPE_BIT	bit
SQLSRV_SQLTYPE_CHAR	char⁵
SQLSRV_SQLTYPE_CHAR($charCount)	char
SQLSRV_SQLTYPE_DATE	날짜⁴
SQLSRV_SQLTYPE_DATETIME	날짜/시간
SQLSRV_SQLTYPE_DATETIME2	날짜/시간2⁴
SQLSRV_SQLTYPE_DATETIMEOFFSET	datetimeoffset⁴
SQLSRV_SQLTYPE_DECIMAL	decimal⁵
SQLSRV_SQLTYPE_DECIMAL($precision, $scale)	decimal
SQLSRV_SQLTYPE_FLOAT	float
SQLSRV_SQLTYPE_IMAGE	image¹
SQLSRV_SQLTYPE_INT	int
SQLSRV_SQLTYPE_MONEY	money
SQLSRV_SQLTYPE_NCHAR	nchar⁵
SQLSRV_SQLTYPE_NCHAR($charCount)	nchar
SQLSRV_SQLTYPE_NUMERIC	numeric⁵
SQLSRV_SQLTYPE_NUMERIC($precision, $scale)	numeric
SQLSRV_SQLTYPE_NVARCHAR	nvarchar⁵
SQLSRV_SQLTYPE_NVARCHAR($charCount)	nvarchar
SQLSRV_SQLTYPE_NVARCHAR('max')	nvarchar(MAX)
SQLSRV_SQLTYPE_NTEXT	ntext²
SQLSRV_SQLTYPE_REAL	real
SQLSRV_SQLTYPE_SMALLDATETIME	smalldatetime
SQLSRV_SQLTYPE_SMALLINT	smallint
SQLSRV_SQLTYPE_SMALLMONEY	smallmoney
SQLSRV_SQLTYPE_TEXT	text³
SQLSRV_SQLTYPE_TIME	time⁴
SQLSRV_SQLTYPE_TIMESTAMP	timestamp
SQLSRV_SQLTYPE_TINYINT	tinyint
SQLSRV_SQLTYPE_UNIQUEIDENTIFIER	uniqueidentifier
SQLSRV_SQLTYPE_UDT	UDT
SQLSRV_SQLTYPE_VARBINARY	varbinary⁵
SQLSRV_SQLTYPE_VARBINARY($byteCount)	varbinary
SQLSRV_SQLTYPE_VARBINARY('max')	varbinary(MAX)
SQLSRV_SQLTYPE_VARCHAR	varchar⁵
SQLSRV_SQLTYPE_VARCHAR($charCount)	varchar
SQLSRV_SQLTYPE_VARCHAR('max')	varchar(MAX)
SQLSRV_SQLTYPE_XML	xml

varbinary(max) 형식에 매핑되는 레거시 형식입니다.
최신 nvarchar 형식에 매핑되는 레거시 형식입니다.
최신 varchar 형식에 매핑되는 레거시 형식입니다.
이 유형에 대한 지원은 Microsoft Drivers for PHP for SQL Server 버전 1.1에 추가되었습니다.
이러한 상수는 형식 비교 연산에서 사용해야 하며 함수 유형 상수를 유사한 구문으로 바꾸지 않습니다. 매개 변수를 바인딩하는 경우 함수 형태 상수를 사용해야 합니다.

다음 테이블은 매개 변수를 허용하는 SQLTYPE 상수와 매개 변수에 허용되는 값 범위를 나열합니다.

SQLTYPE	매개 변수	매개 변수에 허용되는 범위
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	자릿수	1 - 38
SQLSRV_SQLTYPE_DECIMAL, SQLSRV_SQLTYPE_NUMERIC	scale	1 - 정밀도

트랜잭션 격리 수준 상수

sqlsrv_connect와 함께 사용되는 TransactionIsolation 키에는 다음 상수 중 하나를 사용할 수 있습니다.

SQLSRV_TXN_READ_UNCOMMITTED
SQLSRV_TXN_READ_COMMITTED
SQLSRV_TXN_REPEATABLE_READ
SQLSRV_TXN_SNAPSHOT
SQLSRV_TXN_SERIALIZABLE

커서 및 스크롤 상수

다음 상수는 결과 집합에서 사용할 수 있는 커서 종류를 지정합니다.

SQLSRV_CURSOR_FORWARD
SQLSRV_CURSOR_STATIC
SQLSRV_CURSOR_DYNAMIC
SQLSRV_CURSOR_KEYSET
SQLSRV_CURSOR_CLIENT_BUFFERED

다음 상수는 결과 집합에서 선택할 행을 지정합니다.

SQLSRV_SCROLL_NEXT
SQLSRV_SCROLL_PRIOR
SQLSRV_SCROLL_FIRST
SQLSRV_SCROLL_LAST
SQLSRV_SCROLL_ABSOLUTE
SQLSRV_SCROLL_RELATIVE

이러한 상수 사용에 대한 내용은 커서 유형 지정 및 행 선택을 참조하세요.

참고 항목

SQLSRV 드라이버 API 참조

다음을 통해 공유

상수(Microsoft Drivers for PHP for SQL Server)

PDO_SQLSRV 드라이버 상수

트랜잭션 격리 수준 상수

상수 인코딩

쿼리 제한 시간

직접 또는 준비된 실행

숫자 페치 처리

날짜 및 시간 가져오기 처리

SQLSRV 드라이버 상수

ERR 상수

FETCH 상수

Logging 상수

Null을 허용하는 상수

PARAM 상수

PHPTYPE 상수

SQLTYPE 상수

트랜잭션 격리 수준 상수

커서 및 스크롤 상수

참고 항목

피드백

추가 리소스