(PHP 5, PHP 7, PHP 8)
mysqli::options -- mysqli_options — 設(shè)置選項(xiàng)
面向?qū)ο箫L(fēng)格
過程化風(fēng)格
設(shè)置一個(gè)連接的擴(kuò)展選項(xiàng),這些選項(xiàng)可以改變這個(gè)連接的行為。
如果要對多個(gè)選項(xiàng)進(jìn)行設(shè)置,可以多次調(diào)用此函數(shù)來。
mysqli_options() 需要在 mysqli_init() 函數(shù)之后、 mysqli_real_connect() 函數(shù)之前被調(diào)用。
mysql
僅以過程化樣式:由mysqli_connect() 或 mysqli_init() 返回的 mysqli 對象。
option
要進(jìn)行設(shè)置的選項(xiàng),可以是下列中的某一項(xiàng):
名稱 | 描述 |
---|---|
MYSQLI_OPT_CONNECT_TIMEOUT |
連接超時(shí)設(shè)置,以秒為單位(在 Windows 平臺上,PHP 5.3.1 之后才支持此選項(xiàng))。 |
MYSQLI_OPT_LOCAL_INFILE |
啟用或禁用 LOAD LOCAL INFILE 語句 |
MYSQLI_INIT_COMMAND |
成功建立 MySQL 連接之后要執(zhí)行的 SQL 語句 |
MYSQLI_READ_DEFAULT_FILE |
從指定的文件中讀取選項(xiàng),而不是使用 my.cnf 中的選項(xiàng) |
MYSQLI_READ_DEFAULT_GROUP |
從 my.cnf 或者 MYSQL_READ_DEFAULT_FILE 指定的文件中
讀取指定的組中的選項(xiàng)。
|
MYSQLI_SERVER_PUBLIC_KEY |
SHA-256 認(rèn)證模式下,要使用的 RSA 公鑰文件。 |
MYSQLI_OPT_NET_CMD_BUFFER_SIZE |
內(nèi)部命令/網(wǎng)絡(luò)緩沖大小, 僅在 mysqlnd 驅(qū)動下有效。 |
MYSQLI_OPT_NET_READ_BUFFER_SIZE |
以字節(jié)為單位,讀取 MySQL 命令報(bào)文時(shí)候的塊大小, 僅在 mysqlnd 驅(qū)動下有效。 |
MYSQLI_OPT_INT_AND_FLOAT_NATIVE |
將整數(shù)和浮點(diǎn)數(shù)類型的列轉(zhuǎn)換成 PHP 的數(shù)值類型, 僅在 mysqlnd 驅(qū)動下有效。 |
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT |
value
選項(xiàng)值。
成功時(shí)返回 true
, 或者在失敗時(shí)返回 false
。
版本 | 說明 |
---|---|
5.5.0 |
新增 MYSQLI_SERVER_PUBLIC_KEY 和
MYSQLI_SERVER_PUBLIC_KEY 選項(xiàng)。
|
5.3.0 |
新增 MYSQLI_OPT_INT_AND_FLOAT_NATIVE ,
MYSQLI_OPT_NET_CMD_BUFFER_SIZE ,
MYSQLI_OPT_NET_READ_BUFFER_SIZE 和
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT
選項(xiàng)。
|
注意:
MySQLnd 總是使用服務(wù)器的默認(rèn)字符集。此字符集在連接握手/認(rèn)證時(shí)發(fā)送,并被 mysqlnd 使用。
Libmysqlclient 使用 my.cnf 中的默認(rèn)字符集或者由在調(diào)用 mysqli_init() 之后,mysqli_real_connect() 之前先調(diào)用 mysqli_options() 來指定。