Mysqli connect php error

Правильная обработка ошибок позволяет сделать стабильное приложение, которое не будет завершаться неожиданно. В случае возникновения непредвиденной ситуации программа должна выдавать вменяемый ответ, почему она не хочет исполнится. И создание правильного механизма обработки ошибок — это задача программиста.

В этой статье рассмотрим два вида ошибок, которые могут возникнуть при программировании взаимодействия с базой данных. Первый тип — это ошибка подключения к базе данных. Второй тип — это ошибка выполнения запроса к базе данных. Для обработки этих ошибок будем использовать специальные функции для работы с базой.

Ошибка соединения с базой данных

Сразу приведём пример обработки ошибки с соединением с базой данных:

<?php 
   $host = 'localhost'; // адрес сервера
   $db_name = 'database'; // имя базы данных
   $user = 'user'; // имя пользователя
   $password = 'password'; // пароль

   // создание подключения к базе   
      $connection = mysqli_connect($host, $user, $password, $db_name);

   // проверка правильности подключения
      if(!$connection){ // при соединении с базой данных возникла ошибка
         echo 'Ошибка соединения: ' . mysqli_connect_error() . '<br>';
         echo 'Код ошибки: ' . mysqli_connect_errno();
      }else{ // соединение было установлено успешно
         // здесь можно делать запрос к базе, 
         // потому что соединение успешно установлено
      }
?>

В этом примере можно заметить функцию mysqli_connect_error. Она выводит текстовое описание ошибки подключения (на английском языке). В отличии от неё функция mysqli_connect_errno выводит числовой код ошибки, к примеру «1045».

Ошибка запроса к базе

Теперь попробуем доработать пример из предыдущего параграфа и добавить запрос к базе данных. Не будем вдаваться в детали, что будет записано в тексте SQL запроса, просто предположим, что он может завершиться ошибкой. К примеру, из-за неожиданного отключения сервера с базой данных от сети. В примере добавим проверку на наличие ошибок при выполнении запроса:

<?php 
   $host = 'localhost'; // адрес сервера
   $db_name = 'database'; // имя базы данных
   $user = 'user'; // имя пользователя
   $password = 'password'; // пароль

   // создание подключения к базе   
      $connection = mysqli_connect($host, $user, $password, $db_name);

      if(!$connection){ // проверка правильности подключения
         echo 'Ошибка соединения: ' . mysqli_connect_error() . '<br>';
         echo 'Код ошибки: ' . mysqli_connect_errno();
      }else{ // подключение успешно установлено

         // текст SQL запроса, который будет передан базе
            $query = 'SELECT * FROM `USERS`';

         // выполняем запрос к базе данных
            $result = mysqli_query($connection, $query);

            if(!$result){ // запрос завершился ошибкой
               echo 'Ошибка запроса: ' . mysqli_error($connection) . '<br>';
               echo 'Код ошибки: ' . mysqli_errno($connection);
            }else{ // запрос успешно выполнился
               while($row = $result->fetch_assoc()){
                  // обрабатываем полученные данные
               }
            }
         // закрываем соединение с базой
            mysqli_close($connection);
      }
?>

В этом примере есть две функции, которые работают с ошибками базы. Функция mysqli_error возвращает описание ошибки запроса (на английском языке), а функция mysqli_errno возвращает числовой код ошибки, к примеру, «1193».

Обратите внимание, что все функции обработки ошибок в этой статье (mysqli_connect_error, mysqli_connect_errno, mysqli_error, mysqli_errno) возвращают информацию только о последней ошибке. Но ошибок может быть несколько.

Была ли эта статья полезна?

Есть вопрос?

Закажите недорогой хостинг

Заказать

всего от 290 руб

mysqli::$connect_error

(PHP 5, PHP 7, PHP

mysqli::$connect_error — mysqli_connect_error — Возвращает описание последней ошибки подключения

Описание

Возвращает сообщение об ошибке последней попытки подключения.

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

У этой функции нет параметров.

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

Сообщение об ошибке. null , если ошибка отсутствует.

Примеры

Пример #1 Пример использования $mysqli->connect_error

/* @ используется для подавления предупреждений */
$mysqli = @new mysqli ( ‘localhost’ , ‘fake_user’ , ‘wrong_password’ , ‘does_not_exist’ );

if ( $mysqli -> connect_error ) <
/* Используйте предпочитаемый вами метод регистрации ошибок */
error_log ( ‘Ошибка при подключении: ‘ . $mysqli -> connect_error );
>
?>

/* @ используется для подавления предупреждений */
$link = @ mysqli_connect ( ‘localhost’ , ‘fake_user’ , ‘wrong_password’ , ‘does_not_exist’ );

if (! $link ) <
/* Используйте предпочитаемый вами метод регистрации ошибок */
error_log ( ‘Ошибка при подключении: ‘ . mysqli_connect_error ());
>
?>

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

• mysqli_connect() — Псевдоним mysqli::__construct
• mysqli_connect_errno() — Возвращает код ошибки последней попытки соединения
• mysqli_errno() — Возвращает код ошибки последнего вызова функции
• mysqli_error() — Возвращает строку с описанием последней ошибки
• mysqli_sqlstate() — Возвращает код состояния SQLSTATE последней MySQL операции

Источник

mysqli::$error

(PHP 5, PHP 7, PHP

mysqli::$error — mysqli_error — Returns a string description of the last error

Description

Returns the last error message for the most recent MySQLi function call that can succeed or fail.

Parameters

Procedural style only: A mysqli object returned by mysqli_connect() or mysqli_init()

Return Values

A string that describes the error. An empty string if no error occurred.

Examples

Example #1 $mysqli->error example

= new mysqli ( «localhost» , «my_user» , «my_password» , «world» );

/* check connection */
if ( $mysqli -> connect_errno ) <
printf ( «Connect failed: %sn» , $mysqli -> connect_error );
exit();
>

if (! $mysqli -> query ( «SET a=1» )) <
printf ( «Error message: %sn» , $mysqli -> error );
>

/* close connection */
$mysqli -> close ();
?>

= mysqli_connect ( «localhost» , «my_user» , «my_password» , «world» );

/* check connection */
if ( mysqli_connect_errno ()) <
printf ( «Connect failed: %sn» , mysqli_connect_error ());
exit();
>

if (! mysqli_query ( $link , «SET a=1» )) <
printf ( «Error message: %sn» , mysqli_error ( $link ));
>

/* close connection */
mysqli_close ( $link );
?>

The above examples will output:

See Also

• mysqli_connect_errno() — Returns the error code from last connect call
• mysqli_connect_error() — Returns a description of the last connection error
• mysqli_errno() — Returns the error code for the most recent function call
• mysqli_sqlstate() — Returns the SQLSTATE error from previous MySQL operation

User Contributed Notes 7 notes

The mysqli_sql_exception class is not available to PHP 5.05

I used this code to catch errors
= «SELECT XXname FROM customer_table » ;
$res = $mysqli -> query ( $query );

if (! $res ) <
printf ( «Errormessage: %sn» , $mysqli -> error );
>

?>
The problem with this is that valid values for $res are: a mysqli_result object , true or false
This doesn’t tell us that there has been an error with the sql used.
If you pass an update statement, false is a valid result if the update fails.

So, a better way is:
= «SELECT XXname FROM customer_table » ;
$res = $mysqli -> query ( $query );

if (! $mysqli -> error ) <
printf ( «Errormessage: %sn» , $mysqli -> error );
>

?>

This would output something like:
Unexpected PHP error [mysqli::query() [function.query]: (42S22/1054): Unknown column ‘XXname’ in ‘field list’] severity [E_WARNING] in [G:database.php] line [249]

Very frustrating as I wanted to also catch the sql error and print out the stack trace.

A better way is:

( MYSQLI_REPORT_OFF ); //Turn off irritating default messages

$mysqli = new mysqli ( «localhost» , «my_user» , «my_password» , «world» );

$query = «SELECT XXname FROM customer_table » ;
$res = $mysqli -> query ( $query );

if ( $mysqli -> error ) <
try <
throw new Exception ( «MySQL error $mysqli -> error
Query:
$query » , $msqli -> errno );
> catch( Exception $e ) <
echo «Error No: » . $e -> getCode (). » — » . $e -> getMessage () . «
» ;
echo nl2br ( $e -> getTraceAsString ());
>
>

//Do stuff with the result
?>
Prints out something like:
Error No: 1054
Unknown column ‘XXname’ in ‘field list’
Query:
SELECT XXname FROM customer_table

#0 G:\database.php(251): database->dbError(‘Unknown column . ‘, 1054, ‘getQuery()’, ‘SELECT XXname F. ‘)
#1 G:dataWorkSites1framework5testsdbtest.php(29): database->getString(‘SELECT XXname F. ‘)
#2 c:PHPincludessimpletestrunner.php(58): testOfDB->testGetVal()
#3 c:PHPincludessimpletestrunner.php(96): SimpleInvoker->invoke(‘testGetVal’)
#4 c:PHPincludessimpletestrunner.php(125): SimpleInvokerDecorator->invoke(‘testGetVal’)
#5 c:PHPincludessimpletestrunner.php(183): SimpleErrorTrappingInvoker->invoke(‘testGetVal’)
#6 c:PHPincludessimpletestsimple_test.php(90): SimpleRunner->run()
#7 c:PHPincludessimpletestsimple_test.php(498): SimpleTestCase->run(Object(HtmlReporter))
#8 c:PHPincludessimpletestsimple_test.php(500): GroupTest->run(Object(HtmlReporter))
#9 G:all_tests.php(16): GroupTest->run(Object(HtmlReporter))

This will actually print out the error, a stack trace and the offending sql statement. Much more helpful when the sql statement is generated somewhere else in the code.

The decription «mysqli_error — Returns a string description of the LAST error» is not exactly that what you get from mysqli_error. You get the error description from the last mysqli-function, not from the last mysql-error.

If you have the following situation

if (!$mysqli->query(«SET a=1»)) <
$mysqli->query(«ROLLBACK;»)
printf(«Errormessage: %sn», $mysqli->error);
>

you don’t get an error-message, if the ROLLBACK-Query didn’t failed, too. In order to get the right error-message you have to write:

if (!$mysqli->query(«SET a=1»)) <
printf(«Errormessage: %sn», $mysqli->error);
$mysqli->query(«ROLLBACK;»)
>

I had to set mysqli_report(MYSQLI_REPORT_ALL) at the begin of my script to be able to catch mysqli errors within the catch block of my php code.

Initially, I used the below code to throw and subsequent catch mysqli exceptions

try <
$mysqli = new mysqli ( ‘localhost’ , ‘root’ , ‘pwd’ , ‘db’ );
if ( $mysqli -> connect_errno )
throw new Exception ( $mysqli -> connect_error );

> catch ( Exception $e ) <
echo $e -> getMessage ();
>

I realized the exception was being thrown before the actual throw statement and hence the catch block was not being called .

My current code looks like
mysqli_report ( MYSQLI_REPORT_ALL ) ;
try <
$mysqli = new mysqli ( ‘localhost’ , ‘root’ , ‘pwd’ , ‘db’ );
/* I don’t need to throw the exception, it’s being thrown automatically */

> catch ( Exception $e ) <
echo $e -> getMessage ();
>

This works fine and I ‘m able to trap all mysqli errors

// The idea is the add formated errors information for developers to easier bugs detection.

$myfile = fopen ( «database_log.log» , «r» );
$db = new mysqli ( «localhost» , «root» , «root» , «data» );
if(! $db -> query ( «SELECT» )) <
$timestamp = new DateTime ();
$data_err = » <
»title»: » Select statement error »,
»date_time»: » . $timestamp -> getTimestamp (). «,
»error»:» » . $db -> error . » »
> » ; // Do more information
fwrite ( $myfile , $data_err ); // writing data
>
// In separate file do file read and format it for good visual.

$db -> close ();
fclose ( $myfile );
?>

Please note that the string returned may contain data initially provided by the user, possibly making your code vulnerable to XSS.

So even if you escape everything in your SQL query using mysqli_real_escape_string(), make sure that if you plan to display the string returned by mysqli_error() you run that string through htmlspecialchars().

As far as I can tell the two escape functions don’t escape the same characters, which is why you need both (the first for SQL and the second for HTML/JS).

Hi, you can also use the new mysqli_sql_exception to catch sql errors.
Example:
//set up $mysqli_instance here..
$Select = «SELECT xyz FROM mytable » ;
try <
$res = $mysqli_instance -> query ( $Select );
>catch ( mysqli_sql_exception $e ) <
print «Error Code
» . $e -> getCode ();
print «Error Message
» . $e -> getMessage ();
print «Strack Trace
» . nl2br ( $e -> getTraceAsString ());
>

Источник

mysqli::__construct

mysqli_connect

(PHP 5, PHP 7, PHP

mysqli::__construct — mysqli::connect — mysqli_connect — Устанавливает новое соединение с сервером MySQL

Описание

Устанавливает соединение с работающим сервером MySQL.

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

Может быть либо именем хоста, либо IP-адресом. Предполагается использование локального хоста при указании в этом параметре null или строки «localhost». По возможности вместо протокола TCP/IP будут использоваться каналы. Протокол TCP/IP используется, если указаны и имя хоста и номер порта, например, localhost:3308 .

Если перед именем хоста задать строку p: , то будет открыто постоянное соединение. Если соединение открыто из пула подключений, будет автоматически вызвана функция mysqli_change_user() .

Имя пользователя MySQL.

Если не задан или равен null , MySQL-сервер в первую очередь попытается аутентифицировать пользователя в принципе имеющего пароль, а затем будет искать среди пользователей, у которых нет пароля. Такой подход позволяет одному пользователю назначать различные права (в зависимости от того, задан пароль или нет).

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

Задаёт номер порта для подключения к серверу MySQL.

Задаёт сокет или именованный пайп, который необходимо использовать.

Передача параметра socket не будет явно задавать тип соединения при подключении к серверу MySQL. То, как будет устанавливаться соединение с MySQL-сервером, определяется параметром hostname .

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

mysqli::__construct() всегда возвращает объект, который представляет соединение с сервером MySQL, независимо от того, было оно успешным или нет.

mysqli_connect() возвращает объект, который представляет соединение с сервером MySQL или false в случае возникновения ошибки.

mysqli::connect() возвращает null в случае успешного выполнения или false в случае возникновения ошибки.

Ошибки

Если MYSQLI_REPORT_STRICT включена и во время подключения к базе данных произошла ошибка, выбрасывается mysqli_sql_exception .

Примеры

Пример #1 Пример использования mysqli::__construct()

/* Вы должны включить отчёт об ошибках для mysqli, прежде чем пытаться установить соединение */
mysqli_report ( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );

$mysqli = new mysqli ( ‘localhost’ , ‘my_user’ , ‘my_password’ , ‘my_db’ );

/* Установите желаемую кодировку после установления соединения */
$mysqli -> set_charset ( ‘utf8mb4’ );

printf ( «Успешно. %sn» , $mysqli -> host_info );
?>

/* Вы должны включить отчёт об ошибках для mysqli, прежде чем пытаться установить соединение */
mysqli_report ( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );

$mysqli = mysqli_connect ( ‘localhost’ , ‘my_user’ , ‘my_password’ , ‘my_db’ );

/* Установите желаемую кодировку после установления соединения */
mysqli_set_charset ( $mysqli , ‘utf8mb4’ );

printf ( «Успешно. %sn» , mysqli_get_host_info ( $mysqli ));

Результатом выполнения данных примеров будет что-то подобное:

Пример #2 Расширение класса mysqli

class FooMysqli extends mysqli <
public function __construct ( $host , $user , $pass , $db , $port , $socket , $charset ) <
mysqli_report ( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );
parent :: __construct ( $host , $user , $pass , $db , $port , $socket );
$this -> set_charset ( $charset );
>
>

$db = new FooMysqli ( ‘localhost’ , ‘my_user’ , ‘my_password’ , ‘my_db’ , 3306 , null , ‘utf8mb4’ );

Пример #3 Ручная обработка ошибок

Если отчёты об ошибках отключены, разработчик несёт ответственность за проверку и обработку ошибок

( 0 );
mysqli_report ( MYSQLI_REPORT_OFF );
$mysqli = new mysqli ( ‘localhost’ , ‘my_user’ , ‘my_password’ , ‘my_db’ );
if ( $mysqli -> connect_errno ) <
throw new RuntimeException ( ‘ошибка соединения mysqli: ‘ . $mysqli -> connect_error );
>

/* Установите желаемую кодировку после установления соединения */
$mysqli -> set_charset ( ‘utf8mb4’ );
if ( $mysqli -> errno ) <
throw new RuntimeException ( ‘ошибка mysqli: ‘ . $mysqli -> error );
>

( 0 );
mysqli_report ( MYSQLI_REPORT_OFF );
$mysqli = mysqli_connect ( ‘localhost’ , ‘my_user’ , ‘my_password’ , ‘my_db’ );
if ( mysqli_connect_errno ()) <
throw new RuntimeException ( ‘ошибка соединения mysqli: ‘ . mysqli_connect_error ());
>

/* Установите желаемую кодировку после установления соединения */
mysqli_set_charset ( $mysqli , ‘utf8mb4’ );
if ( mysqli_errno ( $mysqli )) <
throw new RuntimeException ( ‘ошибка mysqli: ‘ . mysqli_error ( $mysqli ));
>

Примечания

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

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

Если используется Объектно-ориентированный стиль: Если соединение установить не удалось, метод всё равно вернёт объект. Проверить успешность создания подключения можно либо функцией mysqli_connect_error() или с помощью свойства mysqli->connect_error, как показано в примерах.

Если необходимо задать дополнительные параметры подключения, вроде времени ожидания и т.п., то вместо этого метода необходимо использовать функцию mysqli_real_connect() .

Вызов конструктора без параметров идентичен вызову функции mysqli_init() .

Ошибка «Can’t create TCP/IP socket (10106)» обычно означает, что директива конфигурации variables_order не содержит символ E . В Windows системах, если окружение не скопировано, переменная среды SYSTEMROOT будет недоступна, и у PHP возникнут проблемы с загрузкой Winsock.

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

• mysqli_real_connect() — Устанавливает соединение с сервером mysql
• mysqli_options() — Установка настроек
• mysqli_connect_errno() — Возвращает код ошибки последней попытки соединения
• mysqli_connect_error() — Возвращает описание последней ошибки подключения
• mysqli_close() — Закрывает ранее открытое соединение с базой данных

User Contributed Notes 13 notes

That’s because since Windows 7, the hosts file doesn’t come with a preconfigured
127.0.0.1 localhost
anymore

So, if you notice a long connection creation, try «127.0.0.1» instead.

Please do use set_charset(«utf8») after establishing the connection if you want to avoid weird string issues. I do not know why the documentation does not warn you about this kind of stuff.

We had a hard time figuring out what was going on since we were using mb_detect_encoding and it said everything was UTF-8, but of course the display was wrong. If we used iconv from ISO-8859-1 to UTF-8 the strings looked fine, even though everything in the database had the right collation. So in the end, it was the connection that was the filter and although the notes for this function mention default charsets, it almost reads as a sidenote instead of a central issue when dealing with UTF and PHP/MySQL.

Just wanted to add a note for anyone looking to use the MySQLi persistent connections feature; it’s important to note that PHP opens and retains one connection per database user per process.

What this means is that if you are hosting multiple applications, each with its own database user (as is good practice) then you will end up multiplying the number of connections that PHP may hold open.

For example, if you have PHP configured with a maximum of eight worker processes, and you regularly use four different database users, then your MySQL server will need to accept at LEAST a maximum of 32 connections, or else it will run out.

However, if you would like to minimise the number of connections, what you can do is instead is to open the connection using a «guest» user (with no privileges except logging in) and then use ->change_user() to switch to a more privileged user, before switching back to the guest when you’re done. Since all of the connections would therefore belong to the guest user, PHP should only maintain one per worker process.

There’s a separate port parameter, unlike mysql_connect. However, using host:port on the host parameter does actually work.

There is a caveat. If the host is ‘localhost’ then the port is ignored, whether you use a port parameter or the implicit syntax I mentioned above. This is because ‘localhost’ will make it use unix sockets rather than TCP/IP.

If you want to connect via an alternate port (other than 3306), as you might when using an ssh tunnel to another host, using «localhost» as the hostname will not work.

Using 127.0.0.1 will work. Apparently, if you specify the host as «localhost», the constructor ignores the port specified as an argument to the constructor.

It should be noted that on PHP 7 (v7.0.2 at least), passing the empty string » for the Port argument while connecting to ‘localhost’ will prevent the connection from being successful altogether.

To work around this, use ‘null’.

public mysqli::__construct(
string $hostname = ini_get(«mysqli.default_host»),
string $username = ini_get(«mysqli.default_user»),
string $password = ini_get(«mysqli.default_pw»),
string $database = «»,
int $port = ini_get(«mysqli.default_port»),
string $socket = ini_get(«mysqli.default_socket»)
)

the mysqli construct looks at the Master PHP.ini values.
if you’re using a local ini overwrite of some sort add the ini_get to you’re php script:
$mysqli = new mysqli(ini_get(«mysqli.default_host»),ini_get(«mysqli.default_user»),ini_get(«mysqli.default_pw»))

If you get an error like
Can’t connect to MySQL server on ‘localhost’ (10061)
and you use named pipes/socket connections (or aren’t sure how you installed the MySQL server) try the following connect command:

( ‘.’ , $user_name , $password , $database_name , null , ‘mysql’ );
?>

The ‘.’ as hostname is absolutely necessary when using named pipes. ‘localhost’ won’t work. ‘mysql’ is the standard name for the pipe/socket.

A far more secure and language independent way of connecting to mysql is to use the READ_DEFAULT_FILE options. This passes the workload over to the mysql library, which allows for the configuration file itself to be outside of the scope of the language.

The config file itself is something like this:
[client]
user=user_u
password=user_password
host=dbhost
port=3306
database=the_database
default-character-set=utf8

The following code fragment (in OO mysql_i format)

$sqlconf=’/var/private/my.cnf’;
$sql = new mysqli;
$sql->init();
$sql->options(MYSQLI_READ_DEFAULT_FILE,$sqlconf);
$sql->real_connect();

A friend of mine encountered a sudden bug with CMS Piwigo. I discovered that :
— He had a hosting rule to use PHP 5.6.
— The hoster uses 5.6.6, verified using phpinfo();.
— The CMS declared a database name parameter as null.

That gallery CMS was unable to connect to MySQL and left only a warning message about it.

We tried to revert back to PHP 5.5, the CMS worked again.

Then we switched back to 5.6.6 and changed those lines :

$mysqli = new mysqli($host, $user, $password, $dbname, $port, $socket);

$dbname = »; // Use an empty string, not null

$mysqli = new mysqli($host, $user, $password, $dbname, $port, $socket);

So if you made the same mistake, using null where the manual invites to use an empty string, you should consider correcting your code.

mysqli can succeed in surprising ways, depending on the privileges granted to the user. For example,

GRANT USAGE ON *.* TO ‘myuser’@’localhost’ IDENTIFIED BY PASSWORD ‘mypassword’;
GRANT ALL PRIVILEGES ON `database_a`.* TO ‘myuser’@’localhost’;
CREATE DATABASE database_b;

= new mysqli ( ‘localhost’ , ‘myuser’ , ‘mypassword’ , ‘database_b’ );

if ( $db -> connect_error ) <
die( ‘Connect Error (‘ . $db -> connect_errno . ‘) ‘
. $mysqli -> connect_error );
>

printf ( «SQLSTATE: %sn» , $this -> db -> sqlstate );
printf ( «Warning Count: %sn» , $db -> warning_count );
$db -> close ();
?>

Will output:

SQLSTATE: 00000
Warning Count: 0

So, life is good — you’re connected to the database and executing mysqli methods. Except, life isn’t good, because you aren’t actually using database_b because myuser doesn’t have any privileges on it. You won’t catch this until you try to perform a later operation, when you’ll get an error, «MYSQL Error: No database selected», and find yourself scratching your head and thinking «what do you mean, of course I have a database selected; I selected one when I called the constructor».

As a result, you may want to perform an additional check after connecting to mysql, to confirm that you’re actually connected not just to the mysql server, but to the actual database:

= new mysqli ( ‘localhost’ , ‘myuser’ , ‘mypassword’ , ‘database_b’ );

if ( $db -> connect_error ) <
die( ‘Connect Error (‘ . $db -> connect_errno . ‘) ‘
. $mysqli -> connect_error );
> elseif ( $result = $db -> query ( «SELECT DATABASE()» )) <
$row = $result -> fetch_row ();
if ( $row [ 0 ] != ‘database_b’ ) <
//oops! We’re connected to mysql, but not to database_b
>
>
?>

Источник

---

Definition and Usage

During the attempt to connect to a MySQL server, if an occurs, the mysqli_connect_error() function returns the description of the error occurred (during the last connect call).

Syntax

mysqli_connect_error()

Parameters

This method doesn’t accept any parameters.

Return Values

PHP mysqli_connect_error() function returns an string value representing the description of the error from the last connection call, incase of a failure. If the connection was successful this function returns Null.

PHP Version

This function was first introduced in PHP Version 5 and works works in all the later versions.

Example

Following example demonstrates the usage of the mysqli_connect_error() function (in procedural style) −

<?php
   //Creating a connection
   $con = @mysqli_connect("localhost", "root", "wrong_password", "mydb");

   //Connection Error
   $error = mysqli_connect_error($con);
   print("Error: ".$error);
?>

This will produce following result −

Error: Access denied for user 'root'@'localhost' (using password: YES)

Example

In object oriented style the syntax of this function is $con -> connect_error. Following is the example of this function in object oriented style −

<?php
   //Creating a connection
   $con = @new mysqli("localhost", "root", "wrong_password", "mydb");

   //Connection Error
   $error = $con->connect_error;
   print("Error: ".$error);
?>

This will produce following result −

Error: Access denied for user 'root'@'localhost' (using password: YES)

Example

Following example demonstrates the behaviour of the mysqli_connect_error() function incase of a successful connection −

<?php
   //Creating a connection
   $con = @mysqli_connect("localhost", "root", "password", "mydb");
   
   //Connection Error
   $error = mysqli_connect_error();
   if(!$con){
      print("Connection Failed: ".$error);
   }else{
      print("Connection Established Successfully");
   }
?>

This will produce following result −

Connection Established Successfully

Example

<?php
   $connection = @mysqli_connect("localhost","root","wrong_pass","wrong_db");
   
   if (!$connection){
      die("Connection error: " . mysqli_connect_error());
   }
?>

This will produce following result −

Connection error: Access denied for user 'root'@'localhost' (using password: YES)

php_function_reference.htm

  John Mwaniki /   29 Nov 2021

I have seen it severally where PHP mysqli_connect() database connection worked perfectly well for months or years, then all of a sudden it stops working. On enabling PHP error reporting, or on checking for errors in the error_log file in the cPanel, you find the error below:

PHP Fatal error: Uncaught Error: Call to undefined function mysqli_connect() in /home/username/public_html/…

This can create a great inconvenience and affect your database-driven website negatively especially if you don’t visit it regularly.

As you can see from the error above, PHP doesn’t recognize the mysqli_connect() function. This usually happens when some changes are made on the server that affects the mysqli extension.

There are 2 ways of connecting PHP to MySQL database:

• MySQLi extension
• PDO (PHP Data Objects) extension

Earlier versions of PHP(before version 5) used the MySQL extension which became deprecated in 2012 and was replaced with the MySQLi extension. The «i» in MySQLi stands for improved.

MySQLi extension supports both object-oriented and procedural ways of connecting to the database.

Procedural way

$conn = mysqli_connect("hostname", "username", "password", "database");

Object-Oriented way

$conn = new mysqli("hostname", "username", "password", "database");

All you have to do is to replace the values in quotes above with your real database credentials where the hostname in most cases will be «Localhost», though it may differ in some instances. The «username» is the username of the user assigned to the database, «password» is the password of that user, and «database» is the name of the database you are connecting to.

Either of the above methods will enable communication between PHP and the MySQL database server to take place.

When the error above occurs, the first thing you should do is to check if the PHP MySQL extension module is being loaded.

To do so, simply echo the phpinfo() function. It will show you all the information about your installed PHP version.

<?php
echo phpinfo();
?>

On the PHP information page, scroll down to the section titled «mysqli». You should be able to see the enabled MySQLi library in the Client API library version row as shown below:

There are two libraries for connecting PHP to MySQL database:

• MySQL native driver for PHP (mysqlnd)
• MySQL Client Library (libmysql)

The extensions(mysqli or PDO_MySQL) can either use the mysqlnd or libmysql library to connect from PHP to MySQL.

The MySQL Client Library is a general-purpose client library, meaning it can be used across different languages. On the other hand, mysqlnd library is highly optimized for and tightly integrated into PHP. The mysqlnd library is the default library for PHP 5.4 and later versions. MySQL recommends using the MySQL native driver for PHP (mysqlnd) together with ext/mysqli or PDO_MySQL.

In our case from the above screenshot, you can see that mysqlnd is the enabled driver.

We can now scroll more down to the section titled «mysqlnd» for more information as in the screenshot below:

From the last row(API Extensions) of the above table, you can see that both mysqli and pdo_mysql extensions are enabled. This way the database connection works perfectly with no error.

In the case where the database connection results in the undefined function mysqli_connect() error, then you will find that the phpinfo() page doesn’t have the «mysqli» and the «mysqlnd» sections.

The solutions to undefined function mysqli_connect() error

1. Upgrading to a later PHP version

In most of the cases that this has happened, I have found that changing PHP to a later version has always worked and fixed the issue. Let’s say for example your current PHP version is 7.0, you can change to a later PHP version such as PHP 7.4 or 8.0.

This personally fixed the issue for me the last time it happened to one of the websites I manage.

Here is a brief guide on how to check your website PHP version -> 3 Simple ways of checking your website PHP version

And here is a simple guide for upgrading the PHP version -> How to change the PHP version in cPanel

2. Changing mysqli_connect to new mysqli

Try changing your database connection from procedural to OOP, ie. change replace mysqli_connect to new mysqli. Though it is the OOP way, it doesn’t mean that you will have to change anything else in your PHP code. I have seen it severally where making this change fixed the error.

3. Installing the PHP MySQL extension

If you host the website by yourself, you can simply install the php-mysqli extension on Ubuntu by use of the command below:

sudo apt install php-mysqli

You will then be required to restart the apache server with the command below for it to take effect.

sudo service apache2 restart

4. Adding or uncommenting the line «extension=php_mysql.dll» in the php.ini file

If you host the server yourself, open the php.ini file and remove the semicolon in front of the line below:

;extension=php_mysqli.dll

So that it will be like below:

extension=php_mysqli.dll

If this line doesn’t exist, simply add it. After making the changes, save and restart your Apache server.

If your website is hosted by a hosting provider/company, and upgrading to a later PHP version or changing mysqli_connect to new mysqli doesn’t seem to work for you, simply contact the host with the error message and they will fix it for you.

That’s all for this article. It’s my hope that it was helpful for you.

PHP поддерживает работу с базой данных MySQL. Специальные встроенные функции для работы с MySQL позволяют просто и эффективно работать с этой СУБД: выполнять любые запросы, читать и записывать данные, обрабатывать ошибки.

Сценарий, который подключается к БД, выполняет запрос и показывает результат, будет состоять всего из нескольких строк. Для работы с MySQL не надо ничего дополнительно устанавливать и настраивать; всё необходимое уже доступно вместе со стандартной поставкой PHP.

Что такое mysqli?

mysqli (MySQL Improved) — это расширение PHP, которое добавляет в язык полную поддержку баз данных MySQL. Это расширение поддерживает множество возможностей современных версий MySQL.

Как выглядит работа с базой данных

Типичный процесс работы с СУБД в PHP-сценарии состоит из нескольких шагов:

1. Установить подключение к серверу СУБД, передав необходимые параметры: адрес, логин, пароль.
2. Убедиться, что подключение прошло успешно: сервер СУБД доступен, логин и пароль верные и так далее.
3. Сформировать правильный SQL запрос (например, на чтение данных из таблицы).
4. Убедиться, что запрос был выполнен успешно.
5. Получить результат от СУБД в виде массива из записей.
6. Использовать полученные записи в своём сценарии (например, показать их в виде таблицы).

Функция mysqli connect: соединение с MySQL

Перед началом работы с данными внутри MySQL, нужно открыть соединение с сервером СУБД. В PHP это делается с помощью стандартной функции mysqli_connect(). Функция возвращает результат — ресурс соединения. Данный ресурс используется для всех следующих операций с MySQL.

Но чтобы выполнить соединение с сервером, необходимо знать как минимум три параметра:

• Адрес сервера СУБД;
• Логин;
• Пароль.

Если вы следовали стандартной процедуре установки MySQL или используете OpenServer, то адресом сервера будет localhost, логином — root. При использовании OpenServer пароль для подключения — это пустая строка ‘’, а при самостоятельной установке MySQL пароль вы задавали в одном из шагов мастера установки.

Базовый синтаксис функции mysqli_connect():

mysqli_connect(<адрес сервера>, <имя пользователя>, <пароль>, <имя базы данных>);

Проверка соединения

Первое, что нужно сделать после соединения с СУБД — это выполнить проверку, что оно было успешным. Эта проверка нужна, чтобы исключить ошибку при подключении к БД. Неверные параметры подключения, неправильная настройка или высокая нагрузка заставит MySQL отвергать новые подключения. Все эти ситуации приведут к невозможности соединения, поэтому программист должен проверить успешность подключения к серверу, прежде чем выполнять следующие действия.

Соединение с MySQL устанавливается один раз в сценарии, а затем используется при всех запросах к БД.

Результатом выполнения функции mysqli_connect() будет значение специального типа — ресурс. Если подключение к MySQL не удалось, то функция mysqli_connect() вместо ресурса вернет логическое значение типа «ложь» — false. Хорошей практикой будет всегда проверять результат выполнения этой функции и сравнивать его с ложью.

Соединение с MySQL и проверка на ошибки:

<?php
$link = mysqli_connect("localhost", "root", "");

if ($link == false){
    print("Ошибка: Невозможно подключиться к MySQL " . mysqli_connect_error());
}
else {
    print("Соединение установлено успешно");
}
?>

Функция mysqli_connect_error() просто возвращает текстовое описание последней ошибки MySQL.

Установка кодировки

Первым делом после установки соединения крайне желательно явно задать кодировку, которая будет использоваться при обмене данными с MySQL. Если этого не сделать, то вместо записей со значениями, написанными кириллицей, можно получить последовательность из знаков вопроса: ?????????????????. Вызовите эту функцию сразу после успешной установки соединения: mysqli_set_charset($con, "utf8");

Выполнение запросов

Установив соединение и определив кодировку мы готовы выполнить свои первые SQL-запросы. Вы уже умеете составлять корректные SQL команды и выполнять их через консольный или визуальный интерфейс MySQL-клиента. Те же самые запросы можно отправлять без изменений и из PHP-сценария. Помогут в этом несколько встроенных функций языка.

Два вида запросов

Следует разделять все SQL-запросы на две группы:

1. Чтение информации (SELECT).
2. Модификация (UPDATE, INSERT, DELETE).

При выполнении запросов из среды PHP, запросы из второй группы возвращают только результат их исполнения: успех или ошибку.

Запросы первой группы при успешном выполнении возвращают специальный ресурс результата. Его, в свою очередь, можно преобразовать в ассоциативный массив (если нужна одна запись) или в двумерный массив (если требуется список записей).

Добавление записи

Вернёмся к нашему проекту — дневнику наблюдений за погодой. Начнём практическую работу с заполнения таблиц данными. Для начала добавим хотя бы один город в таблицу cities.

Выражение INSERT INTO используется для добавления новых записей в таблицу базы данных.

Составим корректный SQL-запрос на вставку записи с именем города, а затем выполним его путём передачи этого запроса в функцию mysqli_query(), чтобы добавить новые данные в таблицу.

<?php
$link = mysqli_connect("localhost", "root", "");

$sql = 'INSERT INTO cities SET name = "Санкт-Петербург"';
$result = mysqli_query($link, $sql);

if ($result == false) {
    print("Произошла ошибка при выполнении запроса");
}

Обратите внимание, что первым параметром для функции mysqli_query() передаётся ресурс подключения, полученный от функции mysqli_connect(), вторым параметром следует строка с SQL-запросом.

При запросах на изменение данных (не SELECT) результатом выполнения будет логическое значение — true или false, которое будет означать, что запрос выполнить не удалось. Для получения строки с описанием ошибки существует функция mysqli_error($link).

Функция insert id: как получить идентификатор добавленной записи

Следующим шагом будет добавление погодной записи для нового города. Погодные записи хранит таблица weather_log, но, чтобы сослаться на город, необходимо знать идентификатор записи из таблицы cities.

Здесь пригодится функция mysqli_insert_id(). Она принимает единственный аргумент — ресурс соединения, а возвращает идентификатор последней добавленной записи.

Теперь у нас есть всё необходимое, чтобы добавить погодную запись. Вот как будет выглядеть комплексный пример с подключением к MySQL и добавлением двух новых записей:

<?php
$link = mysqli_connect("localhost", "root", "");

if ($link == false){
    print("Ошибка: Невозможно подключиться к MySQL " . mysqli_connect_error());
}
else {
    $sql = 'INSERT INTO cities SET name = "Санкт-Петербург"';
    $result = mysqli_query($link, $sql);

    if ($result == false) {
        print("Произошла ошибка при выполнении запроса");
    }
    else {
        $city_id = mysqli_insert_id($link);

        $sql = 'INSERT INTO weather_log SET city_id = ' . $city_id . ', day = "2017-09-03", temperature = 10, cloud = 1';

        $result = mysqli_query($link, $sql);

        if ($result == false) {
            print("Произошла ошибка при выполнении запроса");
        }
    }
}

Чтение записей

Другая частая операция при работе с базами данных в PHP — это получение записей из таблиц (запросы типа SELECT). Составим SQL-запрос, который будет использовать SELECT выражение. Затем выполним этот запрос с помощью функции mysqli_query(), чтобы получить данные из таблицы.

В этом примере показано, как вывести все существующие города из таблицы cities:

<?php

$sql = 'SELECT id, name FROM cities';

$result = mysqli_query($link, $sql);

while ($row = mysqli_fetch_array($result)) {
    print("Город: " . $row['name'] . "; Идентификатор: . " . $row['id'] . "<br>");
}

В примере выше результат выполнения функции mysqli_query() сохранён в переменной $result. В этой переменной находятся не данные из таблицы, а специальный тип данных — так называемая ссылка на результаты запроса.

Чтобы получить действительные данные, то есть записи из таблицы, следует использовать другую функцию — mysqli_fetch_array() — и передать ей единственным параметром эту самую ссылку. Теперь каждый вызов функции mysqli_fetch_array() будет возвращать следующую запись из всего результирующего набора записей в виде ассоциативного массива.

Цикл while здесь используется для «прохода» по всем записям из полученного набора записей. Значение поля каждой записи можно узнать просто обратившись по ключу этого ассоциативного массива.

Как получить сразу все записи в виде двумерного массива

Иногда бывает удобно после запроса на чтение не вызывать в цикле mysqli_fetch_array для извлечения очередной записи по порядку, а получить их сразу все одним вызовом. PHP так тоже умеет.

Функция mysqli_fetch_all($res, MYSQLI_ASSOC) вернёт двумерный массив со всеми записями из результата последнего запроса. Перепишем пример с показом существующих городов с её использованием:

<?php

$sql = 'SELECT id, name FROM cities';
$result = mysqli_query($link, $sql);

$rows = mysqli_fetch_all($result, MYSQLI_ASSOC)

foreach ($rows as $row) {
    print("Город: " . $row['name'] . "; Идентификатор: . " . $row['id'] . "<br>");
}

Как узнать количество записей

Часто бывает необходимо узнать, сколько всего записей вернёт выполненный SQL запрос. Это может помочь при организации постраничной навигации, или просто в качестве информации. Узнать число записей поможет функция mysqli_num_rows(), которой следует передать ссылку на результат запроса.