Spec-Zone .ru
спецификации, руководства, описания, API

22.9.3.12. The mysqli_driver class (mysqli_driver)

Copyright 1997-2012 the PHP Documentation Group.

MySQLi Driver.

 mysqli_driver {
mysqli_driverProperties public readonly string client_info ;
public readonly string client_version ;
public readonly string driver_version ;
public readonly string embedded ;
public bool reconnect ;
public int report_mode ;
Methods void mysqli_driver::embedded_server_end();
bool mysqli_driver::embedded_server_start(bool start,
array arguments,
array groups);

}

client_info

The Client API header version

client_version

The Client version

driver_version

The MySQLi Driver version

embedded

Whether MySQLi Embedded support is enabled

reconnect

Allow or prevent reconnect (see the mysqli.reconnect INI directive)

report_mode

Set to MYSQLI_REPORT_OFF , MYSQLI_REPORT_ALL or any combination of MYSQLI_REPORT_STRICT (throw Exceptions for errors), MYSQLI_REPORT_ERROR (report errors) and MYSQLI_REPORT_INDEX (errors regarding indexes). See also mysqli_report.

22.9.3.12.1. mysqli_driver::embedded_server_end,mysqli_embedded_server_end

Copyright 1997-2012 the PHP Documentation Group.

  • mysqli_driver::embedded_server_end

    mysqli_embedded_server_end

    Stop embedded server

Description

Object oriented style

void mysqli_driver::embedded_server_end();

Procedural style

void mysqli_embedded_server_end();
Warning

This function iscurrently not documented; only its argument list is available.

22.9.3.12.2. mysqli_driver::embedded_server_start,mysqli_embedded_server_start

Copyright 1997-2012 the PHP Documentation Group.

  • mysqli_driver::embedded_server_start

    mysqli_embedded_server_start

    Initialize and start embedded server

Description

Object oriented style

bool mysqli_driver::embedded_server_start(bool start,
array arguments,
array groups);

Procedural style

bool mysqli_embedded_server_start(bool start,
array arguments,
array groups);
Warning

This function iscurrently not documented; only its argument list is available.

22.9.3.12.3. mysqli_driver::$report_mode,mysqli_report

Copyright 1997-2012 the PHP Documentation Group.

  • mysqli_driver::$report_mode

    mysqli_report

    Enables or disables internal report functions

Description

Object oriented style

int mysqli_driver->report_mode ;

Procedural style

bool mysqli_report(int flags);

A function helpful in improving queries during code development and testing. Depending on the flags, it reports errors from mysqli function calls or queries that don't use an index (or use a bad index).

Parameters

flags

Table 22.59. Supported flags

Name Description
MYSQLI_REPORT_OFF Turns reporting off
MYSQLI_REPORT_ERROR Report errors from mysqli function calls
MYSQLI_REPORT_STRICT Throw mysqli_sql_exception for errors instead ofwarnings
MYSQLI_REPORT_INDEX Report if no index or bad index was used in a query
MYSQLI_REPORT_ALL Set all options (report all)

Return Values

Returns TRUE on success or FALSE on failure.

Changelog

Version Description
5.3.4 Changing the reporting mode is now be per-request, rather than per-process.
5.2.15 Changing the reporting mode is now be per-request, rather thanper-process.

Examples

Example 22.209. Object oriented style

<?php$mysqli = new mysqli("localhost", "my_user", "my_password", "world");/* check connection */if (mysqli_connect_errno()) {    printf("Connect failed: %s\n", mysqli_connect_error());    exit();}/* activate reporting */$driver = new mysqli_driver();$driver->report_mode = MYSQLI_REPORT_ALL;try {    /* this query should report an error */    $result = $mysqli->query("SELECT Name FROM Nonexistingtable WHERE population > 50000");    /* this query should report a bad index */    $result = $mysqli->query("SELECT Name FROM City WHERE population > 50000");    $result->close();    $mysqli->close();} catch (mysqli_sql_exception $e) {    echo $e->__toString();}?>

Example 22.210. Procedural style

<?php/* activate reporting */mysqli_report(MYSQLI_REPORT_ALL);$link = mysqli_connect("localhost", "my_user", "my_password", "world");/* check connection */if (mysqli_connect_errno()) {    printf("Connect failed: %s\n", mysqli_connect_error());    exit();}/* this query should report an error */$result = mysqli_query("SELECT Name FROM Nonexistingtable WHERE population > 50000");/* this query should report a bad index */$result = mysqli_query("SELECT Name FROM City WHERE population > 50000");mysqli_free_result($result);mysqli_close($link);?>

See Also

mysqli_debug
mysqli_dump_debug_info
mysqli_sql_exception
set_exception_handler
error_reporting