mysqli::options

mysqli_options

(PHP 5, PHP 7, PHP 8)

mysqli::options -- mysqli_options設(shè)置選項(xiàng)

說明

面向?qū)ο箫L(fēng)格

mysqli::options(int $option, mixed $value): bool

過程化風(fēng)格

mysqli_options(mysqli $link, int $option, mixed $value): bool

設(shè)置一個(gè)連接的擴(kuò)展選項(xiàng),這些選項(xiàng)可以改變這個(gè)連接的行為。

如果要對(duì)多個(gè)選項(xiàng)進(jìn)行設(shè)置,可以多次調(diào)用此函數(shù)來。

mysqli_options() 需要在 mysqli_init() 函數(shù)之后、 mysqli_real_connect() 函數(shù)之前被調(diào)用。

參數(shù)

mysql

僅以過程化樣式:由mysqli_connect()mysqli_init() 返回的 mysqli 對(duì)象。

option

要進(jìn)行設(shè)置的選項(xiàng),可以是下列中的某一項(xiàng):

有效的選項(xiàng)
名稱 描述
MYSQLI_OPT_CONNECT_TIMEOUT 連接超時(shí)設(shè)置,以秒為單位(在 Windows 平臺(tái)上,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ū)動(dòng)下有效。
MYSQLI_OPT_NET_READ_BUFFER_SIZE 以字節(jié)為單位,讀取 MySQL 命令報(bào)文時(shí)候的塊大小, 僅在 mysqlnd 驅(qū)動(dòng)下有效。
MYSQLI_OPT_INT_AND_FLOAT_NATIVE 將整數(shù)和浮點(diǎn)數(shù)類型的列轉(zhuǎn)換成 PHP 的數(shù)值類型, 僅在 mysqlnd 驅(qū)動(dòng)下有效。
MYSQLI_OPT_SSL_VERIFY_SERVER_CERT

value

選項(xiàng)值。

返回值

成功時(shí)返回 true, 或者在失敗時(shí)返回 false。

更新日志

版本 說明
5.5.0 新增 MYSQLI_SERVER_PUBLIC_KEYMYSQLI_SERVER_PUBLIC_KEY 選項(xiàng)。
5.3.0 新增 MYSQLI_OPT_INT_AND_FLOAT_NATIVE, MYSQLI_OPT_NET_CMD_BUFFER_SIZEMYSQLI_OPT_NET_READ_BUFFER_SIZEMYSQLI_OPT_SSL_VERIFY_SERVER_CERT 選項(xiàng)。

范例

參見 mysqli_real_connect()

注釋

注意:

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() 來指定。

參見

  • mysqli_init() - 初始化 MySQLi 并返回一個(gè)資源類型的值,這個(gè)值可以作為 mysqli_real_connect() 函數(shù)的傳入?yún)?shù)
  • mysqli_real_connect() - 建立一個(gè) MySQL 服務(wù)器連接