From 65e697ff671608989432a6e6bf8ae8128b2be2c7 Mon Sep 17 00:00:00 2001 From: Adam Harvey Date: Mon, 10 Dec 2012 15:22:07 +0000 Subject: [PATCH] Officially deprecate ext/mysql in the manual. Specific changes: - Upgraded the soft deprecation sidebars to full blown warnings. - Beefed up the wording of the soft deprecation notice boilerplate. - Added changelog items for mysql_connect() and mysql_pconnect(), since they're the functions that have changed behaviour. - Updated the MySQL changelog. - Updated the 5.5 migration guide. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@328734 c90b9560-bf6c-de11-be94-00142212c4b1 --- appendices/migration55.xml | 12 ++++++++++++ language-snippets.ent | 8 ++++---- reference/mysql/book.xml | 5 +++-- reference/mysql/changelog.xml | 15 ++++++++++++++- reference/mysql/functions/mysql-affected-rows.xml | 6 +++--- .../mysql/functions/mysql-client-encoding.xml | 6 +++--- reference/mysql/functions/mysql-close.xml | 6 +++--- reference/mysql/functions/mysql-connect.xml | 13 ++++++++++--- reference/mysql/functions/mysql-create-db.xml | 6 +++--- reference/mysql/functions/mysql-data-seek.xml | 6 +++--- reference/mysql/functions/mysql-db-name.xml | 6 +++--- reference/mysql/functions/mysql-db-query.xml | 6 +++--- reference/mysql/functions/mysql-drop-db.xml | 6 +++--- reference/mysql/functions/mysql-errno.xml | 6 +++--- reference/mysql/functions/mysql-error.xml | 6 +++--- reference/mysql/functions/mysql-escape-string.xml | 6 +++--- reference/mysql/functions/mysql-fetch-array.xml | 6 +++--- reference/mysql/functions/mysql-fetch-assoc.xml | 6 +++--- reference/mysql/functions/mysql-fetch-field.xml | 6 +++--- reference/mysql/functions/mysql-fetch-lengths.xml | 6 +++--- reference/mysql/functions/mysql-fetch-object.xml | 6 +++--- reference/mysql/functions/mysql-fetch-row.xml | 6 +++--- reference/mysql/functions/mysql-field-flags.xml | 6 +++--- reference/mysql/functions/mysql-field-len.xml | 6 +++--- reference/mysql/functions/mysql-field-name.xml | 6 +++--- reference/mysql/functions/mysql-field-seek.xml | 6 +++--- reference/mysql/functions/mysql-field-table.xml | 6 +++--- reference/mysql/functions/mysql-field-type.xml | 6 +++--- reference/mysql/functions/mysql-free-result.xml | 6 +++--- .../mysql/functions/mysql-get-client-info.xml | 6 +++--- reference/mysql/functions/mysql-get-host-info.xml | 6 +++--- .../mysql/functions/mysql-get-proto-info.xml | 6 +++--- .../mysql/functions/mysql-get-server-info.xml | 6 +++--- reference/mysql/functions/mysql-info.xml | 6 +++--- reference/mysql/functions/mysql-insert-id.xml | 6 +++--- reference/mysql/functions/mysql-list-dbs.xml | 6 +++--- reference/mysql/functions/mysql-list-fields.xml | 6 +++--- .../mysql/functions/mysql-list-processes.xml | 6 +++--- reference/mysql/functions/mysql-list-tables.xml | 6 +++--- reference/mysql/functions/mysql-num-fields.xml | 6 +++--- reference/mysql/functions/mysql-num-rows.xml | 6 +++--- reference/mysql/functions/mysql-pconnect.xml | 13 ++++++++++--- reference/mysql/functions/mysql-ping.xml | 6 +++--- reference/mysql/functions/mysql-query.xml | 6 +++--- .../mysql/functions/mysql-real-escape-string.xml | 6 +++--- reference/mysql/functions/mysql-result.xml | 14 ++++++++++++++ reference/mysql/functions/mysql-select-db.xml | 6 +++--- reference/mysql/functions/mysql-set-charset.xml | 6 +++--- reference/mysql/functions/mysql-stat.xml | 6 +++--- reference/mysql/functions/mysql-tablename.xml | 6 +++--- reference/mysql/functions/mysql-thread-id.xml | 6 +++--- .../mysql/functions/mysql-unbuffered-query.xml | 6 +++--- reference/mysqlinfo/set.xml | 12 +++++++----- 53 files changed, 209 insertions(+), 153 deletions(-) diff --git a/appendices/migration55.xml b/appendices/migration55.xml index 550a0f76bc..278deeeaef 100644 --- a/appendices/migration55.xml +++ b/appendices/migration55.xml @@ -331,6 +331,18 @@ String dereferencing: P Deprecated features in PHP 5.5.x + + <link linkend="book.mysql">ext/mysql</link> deprecation + + + The original MySQL extension is now + deprecated, and will generate E_DEPRECATED errors + when connecting to a database. Instead, use the + MySQLi or + PDO_MySQL extensions. + + + <function>preg_replace</function> <literal>/e</literal> modifier diff --git a/language-snippets.ent b/language-snippets.ent index e9eb4302fe..cc883de58e 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1167,10 +1167,10 @@ field_offsetThe numerical field offset. The field_offset does not exist, an error of level E_WARNING is also issued.'> -Suggested alternatives -Use of this extension is discouraged. Instead, the MySQLi or -PDO_MySQL extension should be used. See also MySQL: -choosing an API guide and related FAQ for more information. +This extension is deprecated as of PHP 5.5.0, and will be removed in the future. +Instead, the MySQLi or PDO_MySQL extension should be used. +See also MySQL: choosing an API guide and +related FAQ for more information. Alternatives to this function include:'> diff --git a/reference/mysql/book.xml b/reference/mysql/book.xml index 3468d53571..cecc482f8d 100644 --- a/reference/mysql/book.xml +++ b/reference/mysql/book.xml @@ -11,8 +11,9 @@ &reftitle.intro; - This extension is not recommended for writing new code. Instead, - either the mysqli or + This extension is deprecated as of PHP 5.5.0, and is not recommended for + writing new code as it will be removed in the future. Instead, either the + mysqli or PDO_MySQL extension should be used. See also the MySQL API Overview for further help while choosing a MySQL API. diff --git a/reference/mysql/changelog.xml b/reference/mysql/changelog.xml index 93c5d4047c..f7d84a2361 100644 --- a/reference/mysql/changelog.xml +++ b/reference/mysql/changelog.xml @@ -40,7 +40,20 @@ 5.5.0 - All of the old deprecated functions and aliases now emit E_DEPRECATED errors. These functions are: + This extension has been deprecated. Connecting to a MySQL database + via mysql_connect, + mysql_pconnect or an implicit connection via any + other mysql_* function will generate an + E_DEPRECATED error. + + + + + 5.5.0 + + + All of the old deprecated functions and aliases now emit + E_DEPRECATED errors. These functions are: mysql(), mysql_fieldname(), mysql_fieldtable(), mysql_fieldlen(), mysql_fieldtype(), mysql_fieldflags(), mysql_selectdb(), diff --git a/reference/mysql/functions/mysql-affected-rows.xml b/reference/mysql/functions/mysql-affected-rows.xml index aa1e4d6bb5..633764ad32 100644 --- a/reference/mysql/functions/mysql-affected-rows.xml +++ b/reference/mysql/functions/mysql-affected-rows.xml @@ -6,14 +6,14 @@ Get number of affected rows in previous MySQL operation - - + + &mysql.alternative.note; mysqli_affected_rows PDOStatement::rowCount - + diff --git a/reference/mysql/functions/mysql-client-encoding.xml b/reference/mysql/functions/mysql-client-encoding.xml index 765936e9f5..92a72c4314 100644 --- a/reference/mysql/functions/mysql-client-encoding.xml +++ b/reference/mysql/functions/mysql-client-encoding.xml @@ -6,13 +6,13 @@ Returns the name of the character set - - + + &mysql.alternative.note; mysqli_character_set_name - + diff --git a/reference/mysql/functions/mysql-close.xml b/reference/mysql/functions/mysql-close.xml index 924b315321..091ada4327 100644 --- a/reference/mysql/functions/mysql-close.xml +++ b/reference/mysql/functions/mysql-close.xml @@ -6,14 +6,14 @@ Close MySQL connection - - + + &mysql.alternative.note; mysqli_close PDO: Assign the value of &null; to the PDO object - + diff --git a/reference/mysql/functions/mysql-connect.xml b/reference/mysql/functions/mysql-connect.xml index 02f3296a96..dd93dba533 100644 --- a/reference/mysql/functions/mysql-connect.xml +++ b/reference/mysql/functions/mysql-connect.xml @@ -6,14 +6,14 @@ Open a connection to a MySQL Server - - + + &mysql.alternative.note; mysqli_connect PDO::__construct - + @@ -126,6 +126,13 @@ + + 5.5.0 + + This function will generate an E_DEPRECATED + error. + + 4.3.0 diff --git a/reference/mysql/functions/mysql-create-db.xml b/reference/mysql/functions/mysql-create-db.xml index 498b8d978b..1a199d3a5e 100644 --- a/reference/mysql/functions/mysql-create-db.xml +++ b/reference/mysql/functions/mysql-create-db.xml @@ -6,14 +6,14 @@ Create a MySQL database - - + + &mysql.alternative.note; mysqli_query PDO::query - + diff --git a/reference/mysql/functions/mysql-data-seek.xml b/reference/mysql/functions/mysql-data-seek.xml index d6817a8094..206100e2a2 100644 --- a/reference/mysql/functions/mysql-data-seek.xml +++ b/reference/mysql/functions/mysql-data-seek.xml @@ -6,14 +6,14 @@ Move internal result pointer - - + + &mysql.alternative.note; mysqli_data_seek PDO::FETCH_ORI_ABS - + diff --git a/reference/mysql/functions/mysql-db-name.xml b/reference/mysql/functions/mysql-db-name.xml index 7db8f302e5..665a4a34df 100644 --- a/reference/mysql/functions/mysql-db-name.xml +++ b/reference/mysql/functions/mysql-db-name.xml @@ -6,13 +6,13 @@ Retrieves database name from the call to mysql_list_dbs - - + + &mysql.alternative.note; Query: SELECT DATABASE() - + diff --git a/reference/mysql/functions/mysql-db-query.xml b/reference/mysql/functions/mysql-db-query.xml index 2ce2a1c471..69b7a67e8e 100644 --- a/reference/mysql/functions/mysql-db-query.xml +++ b/reference/mysql/functions/mysql-db-query.xml @@ -6,14 +6,14 @@ Selects a database and executes a query on it - - + + &mysql.alternative.note; mysqli_select_db then the query PDO::__construct - + diff --git a/reference/mysql/functions/mysql-drop-db.xml b/reference/mysql/functions/mysql-drop-db.xml index 32b3241178..ee286f2ea9 100644 --- a/reference/mysql/functions/mysql-drop-db.xml +++ b/reference/mysql/functions/mysql-drop-db.xml @@ -6,13 +6,13 @@ Drop (delete) a MySQL database - - + + &mysql.alternative.note; Execute a DROP DATABASE query - + diff --git a/reference/mysql/functions/mysql-errno.xml b/reference/mysql/functions/mysql-errno.xml index 318a4afc09..5838a6545e 100644 --- a/reference/mysql/functions/mysql-errno.xml +++ b/reference/mysql/functions/mysql-errno.xml @@ -6,14 +6,14 @@ Returns the numerical value of the error message from previous MySQL operation - - + + &mysql.alternative.note; mysqli_errno PDO::errorCode - + diff --git a/reference/mysql/functions/mysql-error.xml b/reference/mysql/functions/mysql-error.xml index 479b7d23d5..0c5e33209b 100644 --- a/reference/mysql/functions/mysql-error.xml +++ b/reference/mysql/functions/mysql-error.xml @@ -6,14 +6,14 @@ Returns the text of the error message from previous MySQL operation - - + + &mysql.alternative.note; mysqli_error PDO::errorInfo - + diff --git a/reference/mysql/functions/mysql-escape-string.xml b/reference/mysql/functions/mysql-escape-string.xml index 94eb7bbebe..ffc6124feb 100644 --- a/reference/mysql/functions/mysql-escape-string.xml +++ b/reference/mysql/functions/mysql-escape-string.xml @@ -6,14 +6,14 @@ Escapes a string for use in a mysql_query - - + + &mysql.alternative.note; mysqli_escape_string PDO::quote - + diff --git a/reference/mysql/functions/mysql-fetch-array.xml b/reference/mysql/functions/mysql-fetch-array.xml index 2e4671d873..5e98209df2 100644 --- a/reference/mysql/functions/mysql-fetch-array.xml +++ b/reference/mysql/functions/mysql-fetch-array.xml @@ -6,14 +6,14 @@ Fetch a result row as an associative array, a numeric array, or both - - + + &mysql.alternative.note; mysqli_fetch_array PDOStatement::fetch - + diff --git a/reference/mysql/functions/mysql-fetch-assoc.xml b/reference/mysql/functions/mysql-fetch-assoc.xml index 41851fffca..d13d8843f8 100644 --- a/reference/mysql/functions/mysql-fetch-assoc.xml +++ b/reference/mysql/functions/mysql-fetch-assoc.xml @@ -6,14 +6,14 @@ Fetch a result row as an associative array - - + + &mysql.alternative.note; mysqli_fetch_assoc PDOStatement::fetch - + diff --git a/reference/mysql/functions/mysql-fetch-field.xml b/reference/mysql/functions/mysql-fetch-field.xml index 643d24ce99..d5138e348f 100644 --- a/reference/mysql/functions/mysql-fetch-field.xml +++ b/reference/mysql/functions/mysql-fetch-field.xml @@ -6,14 +6,14 @@ Get column information from a result and return as an object - - + + &mysql.alternative.note; mysqli_fetch_field PDOStatement::getColumnMeta - + diff --git a/reference/mysql/functions/mysql-fetch-lengths.xml b/reference/mysql/functions/mysql-fetch-lengths.xml index 91361de6f0..d54960ad2f 100644 --- a/reference/mysql/functions/mysql-fetch-lengths.xml +++ b/reference/mysql/functions/mysql-fetch-lengths.xml @@ -6,14 +6,14 @@ Get the length of each output in a result - - + + &mysql.alternative.note; mysqli_fetch_lengths PDOStatement::getColumnMeta - + diff --git a/reference/mysql/functions/mysql-fetch-object.xml b/reference/mysql/functions/mysql-fetch-object.xml index 24198e8920..4eff43cfcc 100644 --- a/reference/mysql/functions/mysql-fetch-object.xml +++ b/reference/mysql/functions/mysql-fetch-object.xml @@ -6,14 +6,14 @@ Fetch a result row as an object - - + + &mysql.alternative.note; mysqli_fetch_object PDOStatement::fetch - + diff --git a/reference/mysql/functions/mysql-fetch-row.xml b/reference/mysql/functions/mysql-fetch-row.xml index ce2b8e5683..5c6b9dc143 100644 --- a/reference/mysql/functions/mysql-fetch-row.xml +++ b/reference/mysql/functions/mysql-fetch-row.xml @@ -6,14 +6,14 @@ Get a result row as an enumerated array - - + + &mysql.alternative.note; mysqli_fetch_row PDOStatement::fetch - + diff --git a/reference/mysql/functions/mysql-field-flags.xml b/reference/mysql/functions/mysql-field-flags.xml index c1b5a5a917..3e5f1885a3 100644 --- a/reference/mysql/functions/mysql-field-flags.xml +++ b/reference/mysql/functions/mysql-field-flags.xml @@ -6,14 +6,14 @@ Get the flags associated with the specified field in a result - - + + &mysql.alternative.note; mysqli_fetch_fields [flags] PDOStatement::getColumnMeta [flags] - + diff --git a/reference/mysql/functions/mysql-field-len.xml b/reference/mysql/functions/mysql-field-len.xml index 7d8f6e02f0..ab018ebf9d 100644 --- a/reference/mysql/functions/mysql-field-len.xml +++ b/reference/mysql/functions/mysql-field-len.xml @@ -6,14 +6,14 @@ Returns the length of the specified field - - + + &mysql.alternative.note; mysqli_fetch_field_direct [length] PDOStatement::getColumnMeta [len] - + diff --git a/reference/mysql/functions/mysql-field-name.xml b/reference/mysql/functions/mysql-field-name.xml index b0ede0fac5..5e5fe204e4 100644 --- a/reference/mysql/functions/mysql-field-name.xml +++ b/reference/mysql/functions/mysql-field-name.xml @@ -6,14 +6,14 @@ Get the name of the specified field in a result - - + + &mysql.alternative.note; mysqli_fetch_field_direct [name] or [orgname] PDOStatement::getColumnMeta [name] - + diff --git a/reference/mysql/functions/mysql-field-seek.xml b/reference/mysql/functions/mysql-field-seek.xml index 4637745fab..a235ee83db 100644 --- a/reference/mysql/functions/mysql-field-seek.xml +++ b/reference/mysql/functions/mysql-field-seek.xml @@ -6,15 +6,15 @@ Set result pointer to a specified field offset - - + + &mysql.alternative.note; mysqli_field_seek PDOStatement::fetch using optional parameters - + diff --git a/reference/mysql/functions/mysql-field-table.xml b/reference/mysql/functions/mysql-field-table.xml index dc856f05b4..478220db6e 100644 --- a/reference/mysql/functions/mysql-field-table.xml +++ b/reference/mysql/functions/mysql-field-table.xml @@ -6,14 +6,14 @@ Get name of the table the specified field is in - - + + &mysql.alternative.note; mysqli_fetch_field_direct [table] or [orgtable] PDOStatement::getColumnMeta [table] - + diff --git a/reference/mysql/functions/mysql-field-type.xml b/reference/mysql/functions/mysql-field-type.xml index 8519916956..06949c5d92 100644 --- a/reference/mysql/functions/mysql-field-type.xml +++ b/reference/mysql/functions/mysql-field-type.xml @@ -6,14 +6,14 @@ Get the type of the specified field in a result - - + + &mysql.alternative.note; mysqli_fetch_field_direct [type] PDOStatement::getColumnMeta [driver:decl_type] or [pdo_type] - + diff --git a/reference/mysql/functions/mysql-free-result.xml b/reference/mysql/functions/mysql-free-result.xml index 80e16508d4..df8026bf52 100644 --- a/reference/mysql/functions/mysql-free-result.xml +++ b/reference/mysql/functions/mysql-free-result.xml @@ -6,14 +6,14 @@ Free result memory - - + + &mysql.alternative.note; mysqli_free_result Assign the value of &null; to the PDO object, or PDOStatement::closeCursor - + diff --git a/reference/mysql/functions/mysql-get-client-info.xml b/reference/mysql/functions/mysql-get-client-info.xml index d46b4cb101..c97b099995 100644 --- a/reference/mysql/functions/mysql-get-client-info.xml +++ b/reference/mysql/functions/mysql-get-client-info.xml @@ -6,14 +6,14 @@ Get MySQL client info - - + + &mysql.alternative.note; mysqli_get_client_info PDO::getAttribute - + diff --git a/reference/mysql/functions/mysql-get-host-info.xml b/reference/mysql/functions/mysql-get-host-info.xml index 229a07432e..9d83ca7bea 100644 --- a/reference/mysql/functions/mysql-get-host-info.xml +++ b/reference/mysql/functions/mysql-get-host-info.xml @@ -6,14 +6,14 @@ Get MySQL host info - - + + &mysql.alternative.note; mysqli_get_host_info PDO::getAttribute - + diff --git a/reference/mysql/functions/mysql-get-proto-info.xml b/reference/mysql/functions/mysql-get-proto-info.xml index b609bf1ae5..9c4a88d0b6 100644 --- a/reference/mysql/functions/mysql-get-proto-info.xml +++ b/reference/mysql/functions/mysql-get-proto-info.xml @@ -6,13 +6,13 @@ Get MySQL protocol info - - + + &mysql.alternative.note; mysqli_get_proto_info - + diff --git a/reference/mysql/functions/mysql-get-server-info.xml b/reference/mysql/functions/mysql-get-server-info.xml index 1f8584af4b..1c8d34224b 100644 --- a/reference/mysql/functions/mysql-get-server-info.xml +++ b/reference/mysql/functions/mysql-get-server-info.xml @@ -6,14 +6,14 @@ Get MySQL server info - - + + &mysql.alternative.note; mysqli_get_server_info PDO::getAttribute - + diff --git a/reference/mysql/functions/mysql-info.xml b/reference/mysql/functions/mysql-info.xml index 309e56d207..cb17111888 100644 --- a/reference/mysql/functions/mysql-info.xml +++ b/reference/mysql/functions/mysql-info.xml @@ -6,13 +6,13 @@ Get information about the most recent query - - + + &mysql.alternative.note; mysqli_info - + diff --git a/reference/mysql/functions/mysql-insert-id.xml b/reference/mysql/functions/mysql-insert-id.xml index 18675965ca..c11f7d597b 100644 --- a/reference/mysql/functions/mysql-insert-id.xml +++ b/reference/mysql/functions/mysql-insert-id.xml @@ -6,14 +6,14 @@ Get the ID generated in the last query - - + + &mysql.alternative.note; mysqli_insert_id PDO::lastInsertId - + diff --git a/reference/mysql/functions/mysql-list-dbs.xml b/reference/mysql/functions/mysql-list-dbs.xml index 99eaa05e97..c675bd784f 100644 --- a/reference/mysql/functions/mysql-list-dbs.xml +++ b/reference/mysql/functions/mysql-list-dbs.xml @@ -6,13 +6,13 @@ List databases available on a MySQL server - - + + &mysql.alternative.note; SQL Query: SHOW DATABASES - + diff --git a/reference/mysql/functions/mysql-list-fields.xml b/reference/mysql/functions/mysql-list-fields.xml index 6fd3f8a008..7753d04406 100644 --- a/reference/mysql/functions/mysql-list-fields.xml +++ b/reference/mysql/functions/mysql-list-fields.xml @@ -6,13 +6,13 @@ List MySQL table fields - - + + &mysql.alternative.note; SQL Query: SHOW COLUMNS FROM sometable - + diff --git a/reference/mysql/functions/mysql-list-processes.xml b/reference/mysql/functions/mysql-list-processes.xml index 0b59a5bad9..564ffc3854 100644 --- a/reference/mysql/functions/mysql-list-processes.xml +++ b/reference/mysql/functions/mysql-list-processes.xml @@ -6,13 +6,13 @@ List MySQL processes - - + + &mysql.alternative.note; mysqli_thread_id - + diff --git a/reference/mysql/functions/mysql-list-tables.xml b/reference/mysql/functions/mysql-list-tables.xml index 0064dbf644..f2c7a04ba8 100644 --- a/reference/mysql/functions/mysql-list-tables.xml +++ b/reference/mysql/functions/mysql-list-tables.xml @@ -6,13 +6,13 @@ List tables in a MySQL database - - + + &mysql.alternative.note; SQL Query: SHOW TABLES FROM sometable - + diff --git a/reference/mysql/functions/mysql-num-fields.xml b/reference/mysql/functions/mysql-num-fields.xml index 87d9210640..44bd0ca44f 100644 --- a/reference/mysql/functions/mysql-num-fields.xml +++ b/reference/mysql/functions/mysql-num-fields.xml @@ -6,14 +6,14 @@ Get number of fields in result - - + + &mysql.alternative.note; mysqli_field_count PDOStatement::columnCount - + diff --git a/reference/mysql/functions/mysql-num-rows.xml b/reference/mysql/functions/mysql-num-rows.xml index 4466d4997e..652b9dfb47 100644 --- a/reference/mysql/functions/mysql-num-rows.xml +++ b/reference/mysql/functions/mysql-num-rows.xml @@ -6,14 +6,14 @@ Get number of rows in result - - + + &mysql.alternative.note; mysqli_stmt_num_rows PDOStatement::rowCount - + diff --git a/reference/mysql/functions/mysql-pconnect.xml b/reference/mysql/functions/mysql-pconnect.xml index 7cd54187e1..5629b97082 100644 --- a/reference/mysql/functions/mysql-pconnect.xml +++ b/reference/mysql/functions/mysql-pconnect.xml @@ -6,14 +6,14 @@ Open a persistent connection to a MySQL server - - + + &mysql.alternative.note; mysqli_connect with p: host prefix PDO::__construct with PDO::ATTR_PERSISTENT as a driver option - + @@ -134,6 +134,13 @@ + + 5.5.0 + + This function will generate an E_DEPRECATED + error. + + 4.3.0 diff --git a/reference/mysql/functions/mysql-ping.xml b/reference/mysql/functions/mysql-ping.xml index dadfdfad78..cb3d62a646 100644 --- a/reference/mysql/functions/mysql-ping.xml +++ b/reference/mysql/functions/mysql-ping.xml @@ -6,13 +6,13 @@ Ping a server connection or reconnect if there is no connection - - + + &mysql.alternative.note; mysqli_ping - + diff --git a/reference/mysql/functions/mysql-query.xml b/reference/mysql/functions/mysql-query.xml index 63f3687a94..8203b1cf2f 100644 --- a/reference/mysql/functions/mysql-query.xml +++ b/reference/mysql/functions/mysql-query.xml @@ -6,14 +6,14 @@ Send a MySQL query - - + + &mysql.alternative.note; mysqli_query PDO::query - + diff --git a/reference/mysql/functions/mysql-real-escape-string.xml b/reference/mysql/functions/mysql-real-escape-string.xml index 588b838429..bdc20018be 100644 --- a/reference/mysql/functions/mysql-real-escape-string.xml +++ b/reference/mysql/functions/mysql-real-escape-string.xml @@ -6,14 +6,14 @@ Escapes special characters in a string for use in an SQL statement - - + + &mysql.alternative.note; mysqli_real_escape_string PDO::quote - + diff --git a/reference/mysql/functions/mysql-result.xml b/reference/mysql/functions/mysql-result.xml index da6839633b..a0845a0bc1 100644 --- a/reference/mysql/functions/mysql-result.xml +++ b/reference/mysql/functions/mysql-result.xml @@ -6,6 +6,20 @@ Get result data + + + &mysql.alternative.note; + + + mysqli_data_seek in conjunction with + mysqli_field_seek and + mysqli_fetch_field + + PDOStatement::fetchColumn + + + + &reftitle.description; diff --git a/reference/mysql/functions/mysql-select-db.xml b/reference/mysql/functions/mysql-select-db.xml index bfdb218407..d4b21fd6f2 100644 --- a/reference/mysql/functions/mysql-select-db.xml +++ b/reference/mysql/functions/mysql-select-db.xml @@ -6,14 +6,14 @@ Select a MySQL database - - + + &mysql.alternative.note; mysqli_select_db PDO::__construct (part of dsn) - + diff --git a/reference/mysql/functions/mysql-set-charset.xml b/reference/mysql/functions/mysql-set-charset.xml index 15e5157e3b..3c9be87e84 100644 --- a/reference/mysql/functions/mysql-set-charset.xml +++ b/reference/mysql/functions/mysql-set-charset.xml @@ -6,14 +6,14 @@ Sets the client character set - - + + &mysql.alternative.note; mysqli_character_set_name PDO: Add charset to the connection string, such as charset=utf8 - + diff --git a/reference/mysql/functions/mysql-stat.xml b/reference/mysql/functions/mysql-stat.xml index e217d383d5..038e49dcef 100644 --- a/reference/mysql/functions/mysql-stat.xml +++ b/reference/mysql/functions/mysql-stat.xml @@ -6,14 +6,14 @@ Get current system status - - + + &mysql.alternative.note; mysqli_stat PDO::getAttribute - + diff --git a/reference/mysql/functions/mysql-tablename.xml b/reference/mysql/functions/mysql-tablename.xml index 9c0482e457..ac854fc173 100644 --- a/reference/mysql/functions/mysql-tablename.xml +++ b/reference/mysql/functions/mysql-tablename.xml @@ -6,13 +6,13 @@ Get table name of field - - + + &mysql.alternative.note; SQL Query: SHOW TABLES - + diff --git a/reference/mysql/functions/mysql-thread-id.xml b/reference/mysql/functions/mysql-thread-id.xml index 58d8d5eb1e..c772a27864 100644 --- a/reference/mysql/functions/mysql-thread-id.xml +++ b/reference/mysql/functions/mysql-thread-id.xml @@ -6,13 +6,13 @@ Return the current thread ID - - + + &mysql.alternative.note; mysqli_thread_id - + diff --git a/reference/mysql/functions/mysql-unbuffered-query.xml b/reference/mysql/functions/mysql-unbuffered-query.xml index 81a02796da..ff6f251ed7 100644 --- a/reference/mysql/functions/mysql-unbuffered-query.xml +++ b/reference/mysql/functions/mysql-unbuffered-query.xml @@ -6,13 +6,13 @@ Send an SQL query to MySQL without fetching and buffering the result rows. - - + + &mysql.alternative.note; See: Buffered and Unbuffered queries - + diff --git a/reference/mysqlinfo/set.xml b/reference/mysqlinfo/set.xml index ab63bc7033..1662115698 100644 --- a/reference/mysqlinfo/set.xml +++ b/reference/mysqlinfo/set.xml @@ -199,10 +199,12 @@ echo htmlentities($row['_message']); It is recommended to use either the mysqli or PDO_MySQL extensions. It is not recommended to use the old mysql - extension for new development. A detailed feature comparison matrix is provided - below. The overall performance of all three extensions is considered to be - about the same. Although the performance of the extension contributes only a fraction - of the total run time of a PHP web request. Often, the impact is as low as 0.1%. + extension for new development, as it has been deprecated as of PHP 5.5.0 + and will be removed in the future. A detailed feature comparison matrix is + provided below. The overall performance of all three extensions is + considered to be about the same. Although the performance of the extension + contributes only a fraction of the total run time of a PHP web request. + Often, the impact is as low as 0.1%. Feature comparison @@ -240,7 +242,7 @@ echo htmlentities($row['_message']); Lifecycle Active Active - Long term deprecation announced + Deprecated Recommended for new projects