Criar um Aplicativo PHP
Para criar um aplicativo PHP que tenha acesso a um Autonomous AI Database, você começa configurando seu sistema de desenvolvimento para oferecer suporte ao acesso do banco de Dados que pode aproveitar os recursos contínuos de disponibilidade e alto desempenho do Autonomous AI 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.
Configurar o seu Sistema de Desenvolvimento PHP
Para configurar seu sistema de desenvolvimento de forma que o aplicativo PHP possa se beneficiar da disponibilidade contínua e dos recursos de alto desempenho de um Autonomous AI Database, você realiza 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 à rede para o Autonomous AI 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
-
Outros SOs 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, vá para http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)
-
Outros SOs 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 do download, aceite o Acordo de Licença da Oracle Technology Network, faça download das versões mais recentes do Pacote Básica e do Pacote SDK e instale-os seguindo as instruções na parte inferior da página do 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
-
Outros SOs e arquiteturas:
-
Execute este comando:
pecl install oci8 -
Adicione as seguintes linhas ao arquivo
php.inida 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 do usuário Oracle Cloud que lhe permita acessar esta página, faça download das credenciais da seguinte forma. Se você não tiver uma conta desse tipo, 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 Web browser, acesse o Oracle Cloud e navegue até a página Detalhes do Autonomous AI Database.
-
Clique em Conexão do BD.
-
Na página Conexão de Banco de Dados, clique em Fazer Download.
-
No diálogo Fazer Download da Wallet, informe uma senha da wallet no campoSenha e confirme a senha no campoConfirmar 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 Fazer 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.orafornecido 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
Após configurar seu sistema de desenvolvimento para oferecer suporte à conectividade de aplicativo PHP com um Autonomous AI 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 o Autonomous AI 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.
Conteúdo Relacionado
-
Para obter informações sobre a extensão OCI8 do Oracle para PHP, consulte a página Oracle OCI8.
-
For information about using PHP with Oracle Database, see The Underground PHP and Oracle Manual.