PDO::connect
(PHP 8 >= 8.4.0)
PDO::connect — Connect to a database and return a PDO subclass for drivers that support it
Description
string
$dsn,?string
$username = null,#[\SensitiveParameter] ?string
$password = null,?array
$options = null): static
Creates an instance of a PDO subclass for the database being connection if it exists, otherwise return a generic PDO instance.
Parameters
dsnThe Data Source Name, or DSN, contains the information required to connect to the database.
In general, a DSN consists of the PDO driver name, followed by a colon, followed by the PDO driver-specific connection syntax. Further information is available from the PDO driver-specific documentation.
The
dsnparameter supports three different methods of specifying the arguments required to create a database connection:- Driver invocation
dsncontains the full DSN.- URI invocation
dsnconsists ofuri:followed by a URI that defines the location of a file containing the DSN string. The URI can specify a local file or a remote URL.uri:file:///path/to/dsnfile- Aliasing
dsnconsists of a namenamethat maps topdo.dsn.in php.ini defining the DSN string.nameNote:
The alias must be defined in php.ini, and not .htaccess or httpd.conf
usernameThe user name for the DSN string. This parameter is optional for some PDO drivers.
passwordThe password for the DSN string. This parameter is optional for some PDO drivers.
optionsA key=>value array of driver-specific connection options.
Return Values
Returns an instance of a PDO subclass for the corresponding PDO driver if it exists, or a generic PDO instance.
Errors/Exceptions
A PDOException is thrown if the attempt to connect to the requested database fails, regardless of which PDO::ATTR_ERRMODE is currently set.
See Also
- Pdo\Dblib
- Pdo\Firebird
- Pdo\Mysql
- Pdo\Odbc
- Pdo\Pgsql
- Pdo\Sqlite
- PDO::__construct() - Creates a PDO instance representing a connection to a database