PHP :: Doc Bug #63295 :: Missing information about function alias

Missing information about function alias

Submitted:

2012-10-16 23:02 UTC

Modified:

2013-01-17 08:11 UTC

Votes:	1
Avg. Score:	3.0 ± 0.0
Reproduced:	0 of 1 (0.0%)

From:

dreen1 at gmail dot com

Assigned:

philip (profile)

Status:

Closed

Package:

MySQL related

PHP Version:

Irrelevant

OS:

any

Private report:

CVE-ID:

None

View Developer Edit

[2012-10-16 23:02 UTC] dreen1 at gmail dot com

Description:
------------
mysql() is an alias to mysql_db_query() which itself is deprecated. this fact is 
undocumented and left me wondering for a long time why I can't define mysql(). 
Reading source code revealed the truth.

Test script:
---------------
<?php
function mysql()
{
    return "nope";
}
?>

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports

[2012-10-25 09:57 UTC] uw@php.net

I think, we should change all undocumented PHP_FALIAS into PHP_DEP_FALIAS to cause deprecation warnings. This change should then be noted in the docs together with the deprecated functions. 

Ulf



	/* for downwards compatability */
	PHP_FALIAS(mysql,				mysql_db_query,		arginfo_mysql_db_query)

--> undocumented

	PHP_FALIAS(mysql_fieldname,		mysql_field_name,	arginfo_mysql_field_name)

--> undocumented

	PHP_FALIAS(mysql_fieldtable,	mysql_field_table,	arginfo_mysql_field_seek)

--> undocumented

	PHP_FALIAS(mysql_fieldlen,		mysql_field_len,	arginfo_mysql_field_seek)

--> undocumented

	PHP_FALIAS(mysql_fieldtype,		mysql_field_type,	arginfo_mysql_field_seek)

--> undocumented

	PHP_FALIAS(mysql_fieldflags,	mysql_field_flags,	arginfo_mysql_field_seek)

--> undocumented 

	PHP_FALIAS(mysql_selectdb,		mysql_select_db,	arginfo_mysql_select_db)

--> undocumented

#ifndef NETWARE		/* The below two functions not supported on NetWare */
#if MYSQL_VERSION_ID < 40000
	PHP_DEP_FALIAS(mysql_createdb,	mysql_create_db,	arginfo_mysql_select_db)

--> undocumented

	PHP_DEP_FALIAS(mysql_dropdb,	mysql_drop_db,		arginfo_mysql_select_db)

--> undocumented

#endif
#endif	/* NETWARE */
	PHP_FALIAS(mysql_freeresult,	mysql_free_result,	arginfo__result_mysql_arg)

--> undocumented

	PHP_FALIAS(mysql_numfields,		mysql_num_fields,	arginfo__result_mysql_arg)

--> undocumented

	PHP_FALIAS(mysql_numrows,		mysql_num_rows,		arginfo__result_mysql_arg)

--> undocumented

	PHP_FALIAS(mysql_listdbs,		mysql_list_dbs,		arginfo__optional_mysql_link)

--> undocumented

	PHP_DEP_FALIAS(mysql_listtables,mysql_list_tables,	arginfo_mysql_select_db)

--> undocumented

	PHP_FALIAS(mysql_listfields,	mysql_list_fields,	arginfo_mysql_list_fields)


--> undocumented

	PHP_FALIAS(mysql_db_name,		mysql_result,		arginfo_mysql_result)

--> ATTN: documented

	PHP_FALIAS(mysql_dbname,		mysql_result,		arginfo_mysql_result)

--> undocumented

	PHP_FALIAS(mysql_tablename,		mysql_result,		arginfo_mysql_result)

--> ATTN: documented

	PHP_FALIAS(mysql_table_name,	mysql_result,		arginfo_mysql_result)

--> ATTN: undocumented although it seems to follow naming of documented ones

[2012-10-25 12:00 UTC] uw@php.net

I've deprecated all undocumented functions alias in PHP 5.5, http://news.php.net/php.cvs/70459 . As I do not know how to properly document it (changelog is auto generated and those functions have never been documented, thus auto generation cannot cover them), I leave the documentation task to the experts - the docs team.

[2012-12-07 08:09 UTC] philip@php.net

-Assigned To: +Assigned To: philip

[2012-12-07 08:30 UTC] philip@php.net

Automatic comment from SVN on behalf of philip
Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=328703
Log: Moved generated changelog to a new changelog.xml, and added deprecated aliases as per PHP Bug #63295.

[2013-01-17 08:11 UTC] philip@php.net

-Status: Assigned +Status: Closed

[2013-01-17 08:11 UTC] philip@php.net

Thank you for the bug report, this has been fixed. 

And as this entire extension is now deprecated, we have decided to keep it 
simple by only including the single changelog entry for all of these old 
aliases. It can be seen here:

http://php.net/manual/en/changelog.mysql.php

	php.net \| support \| documentation \| report a bug \| advanced search \| search howto \| statistics \| random bug \| login
go to bug id or search bugs for


Copyright © 2001-2025 The PHP Group All rights reserved.	Last updated: Sun Nov 23 13:00:01 2025 UTC