From 5c6f1c511a3c512ae5adcc7e75db71e6b860f3c8 Mon Sep 17 00:00:00 2001 From: Philip Olson Date: Thu, 17 Jan 2013 07:59:25 +0000 Subject: [PATCH] Moved mysqli_report() / $report_mode docs under mysqli_driver/. This closes PHP Bug #55329 This change includes updates, mainly to the example / see also sections. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@329175 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/mysqli/functions/mysqli-report.xml | 137 +---------- .../mysqli/mysqli_driver/report-mode.xml | 221 ++++++++++++++++++ 2 files changed, 223 insertions(+), 135 deletions(-) create mode 100644 reference/mysqli/mysqli_driver/report-mode.xml diff --git a/reference/mysqli/functions/mysqli-report.xml b/reference/mysqli/functions/mysqli-report.xml index 93bef03a26..018903e0f8 100644 --- a/reference/mysqli/functions/mysqli-report.xml +++ b/reference/mysqli/functions/mysqli-report.xml @@ -3,149 +3,16 @@ mysqli_report - Enables or disables internal report functions + &Alias; of mysqli_driver->report_mode &reftitle.description; - - boolmysqli_report - intflags - - mysqli_report is a powerful function to improve your queries - and code during development and testing phase. Depending on the flags it reports - errors from mysqli function calls or queries which don't use an index (or use a bad - index). + &info.function.alias; mysqli_driver->report_mode - - &reftitle.parameters; - - - - flags - - - - 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 of warnings - - - - MYSQLI_REPORT_INDEX - Report if no index or bad index was used in a query - - - MYSQLI_REPORT_ALL - Set all options (report all) - - - -
-
-
-
-
-
-
- - - &reftitle.returnvalues; - - &return.success; - - - - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 5.2.15 & 5.3.4 - - Changing the reporting mode is now be per-request, rather than per-process. - - - - - - - - - - &reftitle.examples; - - - &style.oop; - -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(); -?> -]]> - - - - - - - &reftitle.seealso; - - - mysqli_driver::$report_mode - mysqli_debug - mysqli_dump_debug_info - - -
diff --git a/reference/mysqli/mysqli_driver/report-mode.xml b/reference/mysqli/mysqli_driver/report-mode.xml new file mode 100644 index 0000000000..10a50a5c9c --- /dev/null +++ b/reference/mysqli/mysqli_driver/report-mode.xml @@ -0,0 +1,221 @@ + + + + + mysqli_driver::$report_mode + mysqli_report + Enables or disables internal report functions + + + + &reftitle.description; + &style.oop; + + intmysqli_driver->report_mode + + &style.procedural; + + boolmysqli_report + intflags + + + 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). + + + + + &reftitle.parameters; + + + + flags + + + + 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 of warnings + + + + MYSQLI_REPORT_INDEX + Report if no index or bad index was used in a query + + + MYSQLI_REPORT_ALL + Set all options (report all) + + + +
+
+
+
+
+
+
+ + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.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 than per-process. + + + + + + + + + + &reftitle.examples; + + &style.oop; + +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(); +} +?> +]]> + + + + &style.procedural; + + 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); +?> +]]> + + + + + + &reftitle.seealso; + + + mysqli_debug + mysqli_dump_debug_info + mysqli_sql_exception + set_exception_handler + error_reporting + + + + +
+ +