Criar um Aplicativo PHP
Para criar um aplicativo PHP que acesse um Autonomous Database, comece configurando seu sistema de desenvolvimento para oferecer suporte ao acesso ao banco de dados que possa aproveitar a disponibilidade contínua e os recursos de alto desempenho do Autonomous Database.
Depois de configurar seu sistema de desenvolvimento, você codifica conexões de banco de dados e instruções SQL em seu aplicativo para aproveitar a disponibilidade contínua e os recursos de alto desempenho.
Tópicos Relacionados
Configurar o seu Sistema de Desenvolvimento PHP
Para configurar seu sistema de desenvolvimento para que seu aplicativo PHP possa aproveitar a disponibilidade contínua e os recursos de alto desempenho de um Autonomous Database, execute estas etapas.
- Faça download do PHP e instale-o.
- Faça download do Oracle Instant Client e instale-o.
- Faça download do OCI8 para PHP e instale-o.
- Faça download das credenciais do cliente do banco de dados e torne-as disponíveis para o Oracle Instant Client.
Antes de Começar
Seu sistema de desenvolvimento deve atender a determinados critérios para configurá-lo com sucesso.
-
Deve ter acesso à Internet.
-
Ele deve ter acesso de rede ao Autonomous Database.
Consulte Configurando um Sistema de Desenvolvimento para Acessar o Banco de Dados para saber como garantir que seu sistema de desenvolvimento atenda a esse requisito.
Fazer Download e Instalar o PHP
Faça download do PHP para o sistema operacional e a arquitetura do seu sistema e instale-o:
-
Oracle Linux:
Execute estes comandos para fazer download e instalar o PHP e para fazer download e instalar o PEAR para obter o comando de gerenciamento de pacotes pecl do PHP:
sudo dnf install -y oracle-release-el8 oracle-php-release-el8 sudo dnf install -y php php-devel php-xml dtrace-utils wget http://pear.php.net/go-pear.phar sudo php go-pear.phar
-
Outras OSes e arquiteturas:
Vá para a página Instalação e Configuração do PHP e siga as instruções para o sistema operacional e a arquitetura do seu sistema.
Fazer Download e Instalar o Oracle Instant Client
Faça download do pacote básico do Oracle Instant Client para o sistema operacional e a arquitetura do seu sistema e instale-o:
-
Oracle Linux:
Execute estes comandos para fazer download e instalar o pacote básico do Oracle Instant Client:
sudo dnf -y install oracle-release-el8 sudo dnf -y install oracle-instantclient21.13-basic oracle-instantclient21.13-devel
(Se você quiser ver uma lista de todos os pacotes do Instant Client, acesse
http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html
.) -
Outras OSes e arquiteturas:
-
Vá para a página Downloads do Oracle Instant Client e selecione o download para o sistema operacional e a arquitetura do seu sistema.
-
Na página de download, aceite o Contrato de Licença do Oracle Technology Network, faça download das versões mais recentes do Pacote Básico e do Pacote SDK e, em seguida, instale-os seguindo as instruções na parte inferior da página de download.
-
Fazer Download e Instalar o OCI8 para PHP
Faça download da extensão OCI8 para PHP do seu sistema operacional e arquitetura e instale-o:
-
Oracle Linux:
Execute estes comandos para fazer download e instalar a versão mais recente da extensão OCI8:
sudo PHP_DTRACE=yes pecl install oci8 sudo sh -c "echo extension=oci8.so > /etc/php.d/20-oci8.ini" sudo sh -c "echo oci8.events = On > /etc/php.d/20-oci8.ini"
Se seus aplicativos precisarem de variáveis de ambiente Oracle, adicione-as ao arquivo de configuração
/etc/sysconfig/httpd
, por exemplo:NLS_LANG=AMERICAN_AMERICA.AL32UTF8 NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS' ORA_SDTZ=UTC
Se você adicionar essas variáveis, reinicie o servidor Apache HTTP para ler as novas variáveis:
sudo systemctl restart httpd
-
Outras OSes e arquiteturas:
-
Execute este comando
pecl install oci8
-
Adicione as seguintes linhas ao arquivo
php.ini
da sua instalação do PHP:extension=oci8.so oci8.events = On
-
Fazer Download e Instalar Credenciais do Cliente para o Banco de Dados
-
Faça download do arquivo zip que contém credenciais do cliente do seu banco de dados para um diretório seguro no seu computador.
Esse arquivo zip está disponível para download da página Detalhes do banco de dados na console do Oracle Cloud. Se você tiver uma conta de usuário do Oracle Cloud que permita acessar esta página, faça download das credenciais da seguinte forma. Se você não tiver essa conta, precisará obter o arquivo zip do administrador do banco de dados, juntamente com a senha que foi usada para proteger o arquivo zip.
-
No seu navegador da Web, acesse o Oracle Cloud e navegue até a página Detalhes do Autonomous Database.
-
Clique em Conexão do BD.
-
Na página Conexão do Banco de Dados clique em Fazer Download.
-
Na caixa de diálogo Download da Wallet, digite uma senha da wallet no campo Senha e confirme a senha no campo Confirmar Senha.
A senha deve ter pelo menos 8 caracteres e deve incluir pelo menos 1 letra e 1 número ou 1 caractere especial.
-
Clique em Download para salvar o arquivo zip de credenciais do cliente em um diretório seguro.
-
-
Depois de fazer download do arquivo zip, siga estas etapas:
-
Descompacte o arquivo zip de credenciais do cliente.
-
Edite o arquivo
sqlnet.ora
fornecido nas credenciais do cliente, substituindo"?/network/admin"
pelo caminho completo do diretório no qual você descompactou as credenciais do cliente; por exemplo, altere:(DIRECTORY="?/network/admin")
para:
(DIRECTORY="/users/jdoe/adbcredentials")
-
Crie a variável de ambiente
TNS_ADMIN
, definindo seu valor para o caminho completo do diretório no qual você descompactou as credenciais do cliente.
-
Codificar Conexões do Banco de Dados e Instruções SQL
Depois de configurar seu sistema de desenvolvimento para oferecer suporte à conectividade do aplicativo PHP com um Autonomous Database, siga estas diretrizes para obter alto desempenho e disponibilidade contínua das conexões do seu aplicativo com o banco de dados:
- Use pools de conexão.
- Ative a FAN (Fast Application Notification).
- Use o serviço de banco de dados predefinido que melhor corresponda às operações que você executará. Para obter informações sobre os serviços de banco de dados predefinidos, consulte Nomes de Serviço de Banco de Dados Predefinidos para Autonomous Database.
Para PHP, você ativará o FAN quando adicionar a linha oci8.events = On
ao arquivo php.ini
como parte do download e da instalação da extensão OCI8 do Oracle para PHP.
A interface OCI8 não expõe chamadas de pooling específicas. Em vez disso, ela usa o pooling internamente. Para perceber os benefícios do pooling, use a função oci_pconnect()
para criar ou reutilizar uma conexão persistente que permanece nas solicitações HTTP.
Por exemplo:
$connection = oci_pconnect("appuser", getenv("MY_PASSWORD_ENV_VAR"), "tp_tls");
Este exemplo cria uma conexão persistente com o serviço de banco de dados tp_tls
.
Recursos Adicionais
Para obter informações sobre a extensão OCI8 do Oracle para PHP, consulte a página Oracle OCI8.
Para obter informações sobre como usar o PHP com o Oracle Database, consulte The Underground PHP and Oracle Manual.