This topic describes how to connect a PHP client to a PolarDB cluster compatible with Oracle.
Prerequisites
- An account is created for your PolarDB for MySQL cluster. For more information, see Create a database account.
- The IP address of the host that you want to connect to the PolarDB for MySQL cluster is added to the whitelist of the cluster. For more information, see Configure a whitelist for a cluster.
Prepare the environment in Windows
- Download and install WampServer. For more information, see WampServer official website.
- Launch the PostgreSQL plug-in.
- Modify the
php.inifile. - Remove semicolons
;from the following code.Before you remove semicolons:
;extension=php_pgsql.dll ;extension=php_pdo_pgsql.dllAfter you remove semicolons:
extension=php_pgsql.dll extension=php_pdo_pgsql.dll
- Modify the
- Copy the
libpq.dllfile from the C:\wamp\bin\php\php5.6.40 directory to the C:\windows\system32\ directory. Note: php5.6.40 is used in this example, and the actual directory is subject to your client version. - Restart the Apache service.
Prepare the environment in Linux
- Install the
php-pgsql.x86_64driver.sudo yum install php-pgsql.x86_64 - Modify the
php.inifile.vim /etc/php.ini - Add the following content to the
php.inifile.extension=php_pgsql.so
Connect to Apsara PolarDB
After you prepare the environment in Windows or Linux, you can run a PHP script to connect to the Apsara PolarDB database.
The following sample code shows how to use PHP to connect to the Apsara PolarDB cluster.
<? php
$host = "host=xxxx";
$port = "port=xxxx";
$dbname = "dbname=xxxx";
$credentials = "user=xxxx password=xxxxx";
$db = pg_connect( "$host $port $dbname $credentials" );
if(! $db){
echo "Error : Unable to open database\n";
} else {
echo "Opened database successfully\n";
}
$sql =<<<EOF
select * from pg_roles;
EOF;
$ret = pg_query($db, $sql);
if(! $ret){
echo pg_last_error($db);
} else {
echo "Records created successfully\n";
}
$results = pg_fetch_all($ret);
print_r($results);
pg_close($db);
? >In the preceding sample code, the connection information of Apsara PolarDB consists of parameters, such as host, port, dbname, and credentials, as shown in the following table.
| Parameter | Example | Description |
| host | "host=xxxxxx" | The endpoint of the Apsara PolarDB cluster. For more information about how to retrieve the endpoint, see View or apply for an endpoint. |
| port | "port=1521" | The port of the Apsara PolarDB cluster. Default value: 1521. |
| dbname | "dbname=xxxx" | The name of the database to be connected. |
| credentials | "user=xxx password=xxxx" | The username and password used to log on to the Apsara PolarDB cluster. |
For more information about PHP APIs, see PHP documentation.