mysqli::ssl_set

mysqli_ssl_set

(PHP 5, PHP 7, PHP 8)

mysqli::ssl_set -- mysqli_ssl_set — 使用 SSL 建立到數(shù)據(jù)庫(kù)之間的安全連接

說(shuō)明

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

mysqli::ssl_set(
    string $key,
    string $cert,
    string $ca,
    string $capath,
    string $cipher
): bool

過(guò)程化風(fēng)格

mysqli_ssl_set(
    mysqli $link,
    string $key,
    string $cert,
    string $ca,
    string $capath,
    string $cipher
): bool

使用 SSL 建立到數(shù)據(jù)庫(kù)之間的安全連接， 必須在調(diào)用 mysqli_real_connect() 函數(shù)之前調(diào)用此函數(shù)。 除非啟用 OpenSSL 支持，否則此函數(shù)無(wú)任何作用。

需要注意的是，在 PHP 5.3.3 之前的版本中， MySQL 原生驅(qū)動(dòng)不支持建立 SSL 連接， 所以，在使用 MySQL 原生驅(qū)動(dòng)的時(shí)候，調(diào)用此函數(shù)會(huì)產(chǎn)生錯(cuò)誤。 從 PHP 5.3 開(kāi)始，在 Windows 平臺(tái)上，默認(rèn)是啟用 MySQL 原生驅(qū)動(dòng)的。

參數(shù)

mysql

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

key

密鑰文件的路徑

cert

證書文件的路徑

ca

簽發(fā)機(jī)構(gòu)的證書文件路徑

capath

指向一個(gè)目錄的路徑， 該目錄下存放的是受信任的 CA 機(jī)構(gòu)證書 PEM 格式的文件。

cipher

SSL 加密允許使用的算法清單

任何未使用的 SSL 參數(shù)，可以設(shè)置為 null。

返回值

此函數(shù)永遠(yuǎn)會(huì)返回 true。 如果 SSL 的設(shè)置有誤，那么在調(diào)用 mysqli_real_connect() 函數(shù)建立連接的時(shí)候才會(huì)報(bào)錯(cuò)。

參見(jiàn)