- 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_pconnectOpen a persistent 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 with p: host prefix |
PDO::__construct with PDO::ATTR_PERSISTENT as a driver option |
Description
resource mysql_pconnect(string server= =ini_get("mysql.default_host"),
string username= =ini_get("mysql.default_user"),
string password= =ini_get("mysql.default_password"),
int client_flags= =0);Establishes a persistent connection to a MySQL server.
mysql_pconnect
acts very much like
mysql_connect
with two major differences.
First, when connecting, the function would first try to find a (persistent) link that's already open with the same host, username and password. If one is found, an identifier for it will be returned instead of opening a new connection.
Second, the connection to the SQL server will not be closed when
the execution of the script ends. Instead, the link will remain
open for future use
(mysql_close
will not close links established by
mysql_pconnect).
This type of link is therefore called 'persistent'.
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'
-
username The username. Default value is the name of the user that owns the server process.
-
password The password. Default value is an empty password.
-
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.
Return Values
Returns a MySQL persistent 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. |
Notes
Note, that these kind of links only work if you are using a module version of PHP. See the Persistent Database Connections section for more information.
Using persistent connections can require a bit of tuning of your Apache and MySQL configurations to ensure that you do not exceed the number of connections allowed by MySQL.
You can suppress the error message on failure by prepending a @ to the function name.
See Also
mysql_connect
|
| Persistent Database Connections |
User Comments
Add your own comment.