Todos os produtos
Search
Central de documentação

PolarDB:PHP

Última atualização: Jun 28, 2026

Conecte um cliente PHP a um cluster PolarDB compatível com Oracle usando a função pg_connect() da extensão pgsql.

Pré-requisitos

Configurar o ambiente PHP

Escolha as etapas de configuração adequadas ao seu sistema operacional.

Windows

  1. Baixe e instale o WampServer.

  2. Ative o plug-in do PostgreSQL modificando o arquivo php.ini: Antes:

    1. Abra o arquivo php.ini. Geralmente, ele está localizado em C:\wamp\bin\php\php<version>\php.ini, onde <version> corresponde à versão do PHP instalada (por exemplo, php5.6.40).

    2. Localize as linhas abaixo e remova os pontos e vírgulas iniciais para descomentá-las:

    ;extension=php_pgsql.dll
    ;extension=php_pdo_pgsql.dll

    Depois:

    extension=php_pgsql.dll
    extension=php_pdo_pgsql.dll

    Caso essas linhas não existam no arquivo, adicione-as sem os pontos e vírgulas.

  3. Copie o arquivo libpq.dll de C:\wamp\bin\php\php<version> para C:\windows\system32\.

  4. Reinicie o serviço Apache.

Linux

  1. Instale o driver php-pgsql:

    sudo yum install php-pgsql.x86_64
  2. Abra o arquivo php.ini:

    vim /etc/php.ini
  3. Adicione a seguinte linha ao arquivo php.ini:

    extension=php_pgsql.so

Conectar ao PolarDB

O script a seguir estabelece conexão com o PolarDB, executa uma consulta em pg_roles e exibe os resultados.

<?php
// Connection parameters — replace with your actual values
$host        = "<cluster-endpoint>";
$port        = "1521";
$dbname      = "<database-name>";
$user        = "<username>";
$password    = "<password>";

// Establish a connection
$db = pg_connect("host=$host port=$port dbname=$dbname user=$user password=$password");

if (!$db) {
    echo "Error: Unable to connect to the database.\n";
    exit(1);
} else {
    echo "Connected successfully.\n";
}

// Run a query
$sql = "SELECT * FROM pg_roles;";
$result = pg_query($db, $sql);

if (!$result) {
    echo pg_last_error($db);
} else {
    echo "Query executed successfully.\n";
    $rows = pg_fetch_all($result);
    print_r($rows);
}

// Close the connection
pg_close($db);
?>

Substitua os espaços reservados pelos seus valores reais:

Espaço reservado

Descrição

Exemplo

<cluster-endpoint>

Endpoint do cluster PolarDB. Consulte Visualizar ou solicitar um endpoint.

"host=xxxxxx"

<database-name>

Nome do banco de dados alvo da conexão

"dbname=xxxx"

<username>

Nome de usuário da conta do banco de dados

"user=xxx"

<password>

Senha da conta do banco de dados

A porta padrão para clusters PolarDB compatíveis com Oracle é 1521.

Próximos passos

Para obter a lista completa de funções PHP para conexões PostgreSQL, consulte a documentação do PHP pgsql.