PHP 5.4.36 Released

mysqli::options

mysqli_options

(PHP 5)

mysqli::options -- mysqli_optionsЗадание настроек

Описание

Объектно-ориентированный стиль

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

Процедурный стиль

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

Используется для задания дополнительных настроек соединения и поведения подключения к базе данных.

Эту функцию можно вызывать неоднократно, чтобы задать несколько настроек.

mysqli_options() нужно вызывать после mysqli_init() и перед mysqli_real_connect().

Список параметров

link

Только для процедурного стиля: Идентификатор соединения, полученный с помощью mysqli_connect() или mysqli_init()

option

Настройка, которую требуется задать. Это может быть одно из следующих значений:

Допустимые настройки
Имя Описание
MYSQLI_OPT_CONNECT_TIMEOUT таймаут соединения в секундах (поддерживается в Windows с TCP/IP, начиная с PHP 5.3.1)
MYSQLI_OPT_LOCAL_INFILE включение/выключение LOAD LOCAL INFILE
MYSQLI_INIT_COMMAND команда, которую требуется выполнить сразу после подключения к серверу MySQL
MYSQLI_READ_DEFAULT_FILE Читать настройки из именованного файла вместо my.cnf
MYSQLI_READ_DEFAULT_GROUP Читать настройки из именованной группы в файле my.cnf или другом файле, заданным настройкой MYSQL_READ_DEFAULT_FILE.
MYSQLI_SERVER_PUBLIC_KEY RSA public key file used with the SHA-256 based authentication.

value

Значение настройки.

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Список изменений

Версия Описание
5.5.0 The MYSQLI_SERVER_PUBLIC_KEY option was added.

Примеры

См. mysqli_real_connect().

Примечания

Замечание:

MySQLnd всегда подразумевает кодировку, которую использует по умолчанию сервер. Эта кодировка передается во время установки соединения/авторизации, которе использует mysqlnd.

Libmysqlclient по умолчанию использует кодировку, установленную в my.cnf или специальным вызовом mysqli_options() до использования mysqli_real_connect(), но после mysqli_init().

Смотрите также

  • mysqli_init() - Инициализирует MySQLi и возвращает ресурс для использования в функции mysqli_real_connect()
  • mysqli_real_connect() - Устанавливает соединение с сервером mysql

add a note add a note

User Contributed Notes 2 notes

up
3
fluppy
7 years ago
Here es little example to create a SSL Connection

<?php

$db
= mysqli_init();

/*
When you want so use a separate cnf
$test = $db->options(MYSQLI_EAD_DEFAULT_FILE,'myother.cnf');
*/

$db->ssl_set('server-key.pem','server-cert.pem',
'cacert.pem',NULL,NULL);

$db->real_connct('localhost','root','','mydb');

//Here some query

$db->close();

?>
up
2
king at bobfish dot org
6 years ago
Example on using mysqli_options to increase size of max_allowed_packet for working with big blobs.

function dbConnect()
{
   $user = 'jomama';
   $pass = 'cartoon';
   $dbName = 'LifeCycle';
   $host = 'localhost';

   $mysqli = mysqli_init();
   mysqli_options($mysqli,MYSQLI_READ_DEFAULT_GROUP,
                                    "max_allowed_packet=50M");
   mysqli_real_connect($mysqli,$host, $user, $pass,$dbName)
                  or die ('<P>Unable to connect</P>');

   return $mysqli;
}
To Top