mysql_connect
(PHP 3, PHP 4 )
mysql_connect -- Open a connection to a MySQL Server
Description
resource mysql_connect ( [string server [, string username
[, string password [, bool new_link [, int client_flags]]]]])
Returns a MySQL link identifier on success, or FALSE on
failure.
mysql_connect() establishes a connection to a MySQL server.
The following defaults are assumed for missing optional
parameters: server = 'localhost:3306', username = name of
the user that owns the server process and password = empty
password.
The server parameter 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.
Note: 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 in your PHP configuration
and leave the server field blank.
Support for ":port" was added in PHP 3.0B4.
Support for ":/path/to/socket" was added in PHP
3.0.10.
You can suppress the error message on failure by prepending
a @ to the function name.
If a second call is made to mysql_connect() with the same
arguments, no new link will be established, but instead,
the link identifier of the already opened link will be returned.
The new_link parameter modifies this behavior and makes
mysql_connect() always open a new link, even if mysql_connect()
was called before with the same parameters. The client_flags
parameter can be a combination of the constants MYSQL_CLIENT_COMPRESS,
MYSQL_CLIENT_IGNORE_SPACE or MYSQL_CLIENT_INTERACTIVE.
Note: The new_link parameter became available in PHP 4.2.0
The client_flags parameter became available in PHP 4.3.0
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().
Example 1. 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);
?>
See also mysql_pconnect() and mysql_close().
