- 2.5 MySQL Functions
- 2.5.1 mysql_affected_rows
- 2.5.2 mysql_client_encoding
- 2.5.3 mysql_close
- 2.5.4 mysql_connect
- 2.5.5 mysql_create_db
- 2.5.6 mysql_data_seek
- 2.5.7 mysql_db_name
- 2.5.8 mysql_db_query
- 2.5.9 mysql_drop_db
- 2.5.10 mysql_errno
- 2.5.11 mysql_error
- 2.5.12 mysql_escape_string
- 2.5.13 mysql_fetch_array
- 2.5.14 mysql_fetch_assoc
- 2.5.15 mysql_fetch_field
- 2.5.16 mysql_fetch_lengths
- 2.5.17 mysql_fetch_object
- 2.5.18 mysql_fetch_row
- 2.5.19 mysql_field_flags
- 2.5.20 mysql_field_len
- 2.5.21 mysql_field_name
- 2.5.22 mysql_field_seek
- 2.5.23 mysql_field_table
- 2.5.24 mysql_field_type
- 2.5.25 mysql_free_result
- 2.5.26 mysql_get_client_info
- 2.5.27 mysql_get_host_info
- 2.5.28 mysql_get_proto_info
- 2.5.29 mysql_get_server_info
- 2.5.30 mysql_info
- 2.5.31 mysql_insert_id
- 2.5.32 mysql_list_dbs
- 2.5.33 mysql_list_fields
- 2.5.34 mysql_list_processes
- 2.5.35 mysql_list_tables
- 2.5.36 mysql_num_fields
- 2.5.37 mysql_num_rows
- 2.5.38 mysql_pconnect
- 2.5.39 mysql_ping
- 2.5.40 mysql_query
- 2.5.41 mysql_real_escape_string
- 2.5.42 mysql_result
- 2.5.43 mysql_select_db
- 2.5.44 mysql_set_charset
- 2.5.45 mysql_stat
- 2.5.46 mysql_tablename
- 2.5.47 mysql_thread_id
- 2.5.48 mysql_unbuffered_query
Copyright 1997-2012 the PHP Documentation Group.
mysql_connectOpen a connection to a MySQL Server
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:
mysqli_connect
|
PDO::__construct
|
Description
resource mysql_connect(string server= =ini_get("mysql.default_host"),
string username= =ini_get("mysql.default_user"),
string password= =ini_get("mysql.default_password"),
bool new_link= =false,
int client_flags= =0);Opens or reuses a connection to a MySQL server.
Parameters
-
server The MySQL server. It can also include a port number. e.g. "hostname:port" or a path to a local socket e.g. ":/path/to/socket" for the localhost.
If the PHP directive mysql.default_host is undefined (default), then the default value is 'localhost:3306'. In SQL safe mode, this parameter is ignored and value 'localhost:3306' is always used.
-
username The username. Default value is defined by mysql.default_user. In SQL safe mode, this parameter is ignored and the name of the user that owns the server process is used.
-
password The password. Default value is defined by mysql.default_password. In SQL safe mode, this parameter is ignored and empty password is used.
-
new_link If a second call is made to
mysql_connectwith the same arguments, no new link will be established, but instead, the link identifier of the already opened link will be returned. Thenew_linkparameter modifies this behavior and makesmysql_connectalways open a new link, even ifmysql_connectwas called before with the same parameters. In SQL safe mode, this parameter is ignored.-
client_flags The
client_flagsparameter can be a combination of the following constants: 128 (enableLOAD DATA LOCALhandling),MYSQL_CLIENT_SSL,MYSQL_CLIENT_COMPRESS,MYSQL_CLIENT_IGNORE_SPACEorMYSQL_CLIENT_INTERACTIVE. Read the section about Table 2.3, “MySQL client constants” for further information. In SQL safe mode, this parameter is ignored.
Return Values
Returns a MySQL link identifier on success or
FALSE
on failure.
Changelog
| Version | Description |
|---|---|
| 5.5.0 | This function will generate an
E_DEPRECATED
error. |
| 4.3.0 | Added the client_flags parameter. |
| 4.2.0 | Added the new_link parameter. |
Examples
Example 2.6. mysql_connect
example
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
?>
Example 2.7. mysql_connect
example using hostname:port syntax
<?php
// we connect to example.com and port 3307
$link = mysql_connect('example.com:3307', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
// we connect to localhost at port 3307
$link = mysql_connect('127.0.0.1:3307', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
?>
Example 2.8. mysql_connect
example using ":/path/to/socket" syntax
<?php
// we connect to localhost and socket e.g. /tmp/mysql.sock
// variant 1: omit localhost
$link = mysql_connect(':/tmp/mysql', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
// variant 2: with localhost
$link = mysql_connect('localhost:/tmp/mysql.sock', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
?>
Notes
Whenever you specify "localhost" or
"localhost:port" as server, the MySQL client library
will override this and try to connect to a local socket (named
pipe on Windows). If you want to use TCP/IP, use
"127.0.0.1" instead of "localhost". If the
MySQL client library tries to connect to the wrong local
socket, you should set the correct path as
mysql.default_host
string
in your PHP
configuration and leave the server field blank.
The link to the server will be closed as soon as the execution
of the script ends, unless it's closed earlier by
explicitly calling
mysql_close.
You can suppress the error message on failure by prepending a @ to the function name.
Error "Can't create TCP/IP socket (10106)"
usually means that the
variables_order
configure directive doesn't contain character
E. On Windows, if the environment is not
copied the SYSTEMROOT environment variable
won't be available and PHP will have problems loading
Winsock.
See Also
mysql_pconnect
|
mysql_close
|
User Comments
Add your own comment.