# Dois Métodos para Executar PHP

Começando: Duas Maneiras de Executar Seu Código PHP

Aprender uma nova linguagem de programação pode ser emocionante, e uma ótima maneira de começar é executando código e vendo os resultados imediatamente. Esta lição introduz duas abordagens primárias para executar programas PHP: usando um ambiente de codificação online e configurando um ambiente de desenvolvimento local no seu próprio computador. Vamos explorar ambos, permitindo que você escolha o método que melhor se adapta ao seu estilo de aprendizado e necessidades do projeto. Ao longo deste guia, você é incentivado a experimentar ambos os métodos enquanto cobrimos conceitos fundamentais de PHP como exibir saída, trabalhar com variáveis e entender diferentes tipos de dados.

Codificação Online com Replit

Uma das maneiras mais simples de começar a codificar em PHP é aproveitar uma plataforma online que lida com as complexidades da infraestrutura subjacente. Esses ambientes eliminam a necessidade de instalar e configurar software, permitindo que você se concentre na escrita de código. Nós estaremos usando Replit (https://replit.com), um serviço online popular e gratuito, para esta exploração inicial.

O que é um REPL?

O nome "Replit" é derivado de "REPL," que significa "Read-Evaluate-Print Loop." Um REPL é um tipo de ambiente de computação interativo onde você insere um comando ou expressão, o sistema o processa imediatamente, exibe o resultado e, então, espera pela sua próxima entrada. Pense nisso como um terminal de linha de comando—você digita um comando, e o terminal o executa e retorna uma resposta.

Configurando um Projeto Replit

Para começar, visite o site da Replit e crie uma conta gratuita. Uma vez que você esteja logado, você está pronto para criar seu primeiro projeto PHP.

Replit oferece modelos pré-configurados especificamente projetados para desenvolvimento PHP. Dois modelos são particularmente úteis:

- PHP CLI (Interface de Linha de Comando): Ideal para projetos que geram principalmente saída de texto ou processam arquivos de dados. Este modelo é perfeito para aprender o básico sem a sobrecarga de um servidor web.

- PHP Servidor Web: Projetado para projetos de desenvolvimento web, permitindo que você crie e teste aplicativos PHP que interagem com um servidor web.

Vamos criar um projeto PHP CLI simples para começar. Da página inicial do Replit, clique no botão "Criar Repl". Uma caixa de pesquisa aparecerá; digite "PHP" na caixa de pesquisa. Você verá os modelos oficiais Replit PHP CLI e PHP Web Server listados. (Você também pode ver outros modelos criados por usuários.)

Selecione o modelo "PHP CLI" e forneça um nome para o seu projeto. Você pode usar o nome aleatório sugerido, se preferir. Clique em "Criar Repl" para lançar seu novo projeto.

Replit então inicializará seu projeto, o que inclui a criação dos arquivos e pastas do projeto e o início de uma máquina virtual na nuvem. Este processo leva alguns momentos. Uma vez que o projeto esteja totalmente carregado, você verá uma interface de três colunas.

Executando Seu Primeiro Script PHP

Quando você cria um novo projeto PHP no Replit, você é tipicamente apresentado com uma configuração de projeto básica. Isso inclui um arquivo pré-preenchido, frequentemente chamado main.php, que contém um script simples "Olá, mundo!". Este script inicial serve a um propósito vital no processo de aprendizado. É uma prática comum ao explorar um novo idioma de programação pela primeira vez, fornecendo uma maneira rápida de confirmar que seu ambiente está configurado corretamente e para se familiarizar com os fundamentos.

A interface do projeto no Replit geralmente divide a tela em três áreas principais. À esquerda, você encontrará um explorador de arquivos, permitindo que você navegue pelos arquivos e pastas do projeto. O painel central oferece um editor de código onde você escreverá e modificará seu código PHP. Finalmente, o lado direito exibe a saída do console, fornecendo um terminal e uma interface de shell para interagir com o computador virtual que o Replit criou. Pressionar o botão "Run" inicia o interpretador PHP, e qualquer saída do seu script aparecerá no console.

Um projeto PHP típico é composto por um ou mais arquivos. Estes arquivos contêm o seu código PHP e são distinguidos pela extensão .php. O arquivo main.php no seu projeto inicial fornece um ponto de partida.

Aqui está o código padrão que você provavelmente verá em main.php:

<?php
echo "Hello, world!\n";

Vamos analisar o que este código faz. O <?php no início é chamado de tag de abertura PHP. É essencial; ele diz ao interpretador PHP que as linhas seguintes devem ser tratadas como código PHP. A declaração echo é um comando PHP central usado para exibir texto no console. Neste caso, ele exibe "Olá, mundo!" seguido por um caractere de nova linha (\n), que insere uma quebra de linha após a mensagem. Executar com sucesso este script simples confirma que seu ambiente PHP está configurado e funcionando corretamente.

Entendendo Como Seu Código PHP é Executado

Quando você vê texto exibido na tela a partir do seu código PHP, é o resultado de uma série de etapas. O texto em si, como "Olá, mundo!", é representado como uma string – uma sequência de caracteres. Vamos nos aprofundar em strings e caracteres especiais mais tarde, mas, por enquanto, é importante saber que strings são sempre envolvidas em aspas duplas. A linha de código que produz esta saída é uma declaração, que é uma instrução única dizendo ao computador para fazer algo. Cada declaração PHP deve terminar com um ponto e vírgula (;) – pense nisso como o sinal de pontuação que sinaliza o fim da instrução. Sem ele, o PHP não reconhecerá a declaração como completa.

O Papel do Motor PHP

Quando você clica no botão "Executar" no Replit, o que realmente acontece? PHP é uma linguagem scriptada. Isso significa que, em vez de ser traduzido para código de máquina antecipadamente (como linguagens como C++ ou Swift), o código é interpretado e executado em tempo real. Um programa chamado intérprete lida com este processo; no caso do PHP, ele é conhecido como o motor PHP. O motor PHP lê seu arquivo .php e traduz seu conteúdo em instruções que o computador pode entender e executar.

Isto contrasta com linguagens compiladas. Nessas, uma etapa de compilação separada ocorre antes da execução, transformando o código fonte em um arquivo executável. Linguagens scriptadas como PHP, Python e JavaScript oferecem uma abordagem diferente para a execução de programas.

Executando PHP a partir da Linha de Comando

O botão "Executar" no Replit oferece uma maneira simples de executar código PHP, mas não é a única opção. Você também pode invocar o motor PHP diretamente da linha de comando. Esta é uma habilidade muito útil, especialmente ao trabalhar fora de um ambiente de desenvolvimento como o Replit.

Para experimentar isso, mude para a aba "Shell" no seu projeto Replit. Isso abre uma interface de linha de comando. No prompt $ digite o seguinte e pressione Enter:

php main.php

Você deve ver "Hello, world!" impresso no terminal.

Este comando instrui o motor PHP a processar e executar o arquivo main.php. Este método funciona não apenas no Replit, mas também no seu próprio computador, permitindo que você execute scripts PHP independentemente de qualquer ambiente de desenvolvimento baseado na web. Exploraremos o fluxo de controle, que determina a ordem em que as declarações são executadas, à medida que cobrimos condicionais e loops em lições futuras.

Configurando um Projeto Web Básico com PHP

Como PHP é usado com mais frequência para construir aplicações web, vamos criar um projeto web simples usando o modelo PHP Web Server integrado do Replit. Para fazer isso, retorne ao seu painel do Replit e crie um novo projeto. Quando solicitado, procure e selecione o modelo "PHP Web Server". Isso configurará um ambiente básico pronto para desenvolvimento web em PHP.

Você notará um único arquivo, chamado index.php, já presente na estrutura de arquivos do projeto. Este arquivo index.php tem um significado especial no desenvolvimento web. Ele funciona como a página padrão exibida quando um usuário visita o URL raiz (a página inicial) de um website. Mergulharemos nas complexidades de como isso funciona mais tarde, quando cobrirmos os fundamentos da programação web. Por enquanto, entenda que é o ponto de partida para sua aplicação web.

O conteúdo de index.php é exibido no painel do editor. Você também encontrará abas de Console e Shell no lado direito da interface do Replit. Uma aba de Webview aparecerá aqui assim que você executar o servidor web, permitindo que você visualize a página web renderizada.

Vamos examinar o código dentro de index.php:

<html>
<head>
<title>PHP Test</title>
</head>
<body>
  <?php echo '<p>Hello World</p>'; ?>
</body>
</html>

A maioria do arquivo é escrita em HTML, que fornece a estrutura e o layout para uma página web padrão. Você provavelmente está familiarizado com as tags HTML como <html>, <head>, <title>, e <body>. As tags <html> de abertura e fechamento marcam o começo e o fim do documento HTML inteiro. À medida que explorarmos mais, você verá que scripts PHP frequentemente misturam código PHP dinâmico com conteúdo estático como HTML.

A linha chave aqui é o código PHP: <?php echo '<p>Hello World</p>'; ?>. Esta linha usa a declaração echo para exibir o texto "Hello World" dentro de tags de parágrafo HTML (<p>). As tags <?php e ?> delimitam o bloco de código PHP, instruindo o servidor a interpretar esta seção como PHP. Quando o servidor web é executado, este código PHP será executado e o HTML resultante será enviado para o navegador do usuário.

Executando PHP: Duas Abordagens

Embora ambientes online como Replit sejam convenientes para exploração inicial, entender como executar código PHP é crucial. Existem primariamente duas maneiras de executar scripts PHP: usando um ambiente de servidor web e configurando um ambiente de desenvolvimento local.

#### Executando com um Servidor Web (Exemplo Replit)

Quando você utiliza o Replit para executar seu código PHP, a plataforma lança automaticamente um servidor web. Este servidor hospeda seu arquivo index.php e ativa o motor PHP necessário para processar o código dentro. Em vez de ver a saída diretamente no console, você agora é apresentado a uma página web simples exibindo "Hello World" no painel Webview.

Uma característica única do servidor web do Replit é que ele publica páginas web temporárias acessíveis através de uma URL terminando em .replit.dev. Você pode acessar esta página web diretamente clicando na barra de endereço no painel Webview. Um pop-up revelará a URL única. Copiar e colar esta URL em um navegador web padrão (como Chrome, Firefox ou Safari) renderizará a mensagem "Hello World" como uma página web independente, completamente separada da interface do Replit em si. Isso demonstra seu primeiro, embora simples, site alimentado por PHP sendo publicado online.

Nota: À medida que você avança para projetos mais complexos mais tarde neste guia, você pode encontrar situações onde configuração adicional é necessária dentro do Replit. Instruções detalhadas para essas configurações podem ser encontradas no Apêndice C.

#### Ambiente de Desenvolvimento PHP Local

Editores de código online proporcionam facilidade de acesso, mas podem ser limitados por desempenho mais lento (especialmente nos níveis gratuitos) e uma dependência de uma conexão de internet estável. Muitos desenvolvedores preferem um ambiente de desenvolvimento local—executando PHP diretamente em seus próprios computadores.

O primeiro passo ao configurar um ambiente local é instalar o PHP. Se você ainda não fez isso, consulte o Apêndice A para instruções adaptadas ao seu sistema operacional específico para instalar a versão mais recente do PHP.

Uma vez que o PHP está instalado, você está pronto para escolher um Ambiente de Desenvolvimento Integrado (IDE). Um IDE é mais do que apenas um editor de texto; é uma ferramenta poderosa equipada com recursos projetados para otimizar o processo de desenvolvimento. Esses recursos frequentemente incluem um terminal integrado, capacidades avançadas de busca e substituição, preenchimento automático de código, detecção de erros e até mesmo geração automatizada de código para tarefas de programação comuns. Escolher um IDE que se adapte ao seu fluxo de trabalho aumentará significativamente sua produtividade.

Configurando Seu Ambiente de Desenvolvimento com PhpStorm

Esta seção irá guiá-lo através da configuração de um ambiente de desenvolvimento local usando PhpStorm, um Ambiente de Desenvolvimento Integrado (IDE) amplamente utilizado da JetBrains. Embora uma licença totalmente paga esteja disponível, PhpStorm oferece um teste gratuito de 30 dias, e muitos indivíduos – incluindo estudantes, educadores, participantes de bootcamps e contribuintes para iniciativas de código aberto – são elegíveis para uma licença gratuita permanente. Você pode baixar o PhpStorm e encontrar detalhes de licenciamento em [https://www.jetbrains.com/phpstorm/](https://www.jetbrains.com/phpstorm/). Siga as instruções de instalação fornecidas para colocá-lo em execução em seu sistema.

Se PhpStorm não lhe agradar, não se preocupe! Vários outros IDEs gratuitos, como Visual Studio Code, Eclipse e Apache NetBeans, fornecem plugins para suportar o desenvolvimento PHP.

Criando seu Primeiro Projeto "Olá, mundo!"

Vamos começar criando um projeto básico "Olá, mundo!" dentro do PhpStorm. Isso espelha a simplicidade de um modelo PHP CLI padrão frequentemente encontrado em ambientes online como Replit. Para começar, inicie o PhpStorm e selecione "Novo Projeto". Das opções disponíveis, escolha "Projeto PHP Vazio". Você então será solicitado a selecionar um local para armazenar seus arquivos do projeto e a dar um nome a ele. É uma boa prática incluir uma barra (/) antes do nome do projeto no caminho do local – por exemplo, /meu-projeto-php. Clique em "Criar" para finalizar a configuração do projeto.

PhpStorm agora irá gerar uma nova pasta, nomeada de acordo com o nome do projeto escolhido, na localização designada. Esta pasta atua como o repositório central para todos os arquivos do projeto. À medida que seus projetos crescem em complexidade, você provavelmente irá organizá-los ainda mais usando subpastas para gerenciar dados, lógica de programa, configurações e outros ativos relacionados. Uma vez que a pasta seja criada, PhpStorm abrirá a visão do projeto, que fornece a interface de edição principal.

A interface do PhpStorm é tipicamente dividida em três painéis principais:

- Painel de Conteúdo do Projeto (Canto Superior Esquerdo): Esta área exibe a estrutura de arquivos e pastas do seu projeto, permitindo que você navegue e gerencie os recursos do seu projeto.

- Painel de Edição de Código/Arquivo (Canto Superior Direito): Este é o local onde você vai passar a maior parte do seu tempo, já que é a área onde você escreve e edita seu código PHP e outros arquivos do projeto.

- Terminal de Linha de Comando (Parte Inferior): Para acessar um terminal de linha de comando, clique no botão "Terminal" (frequentemente representado por um símbolo >_) localizado na coluna da esquerda da janela do PhpStorm. Este terminal fornece uma maneira poderosa de interagir com seu projeto e sistema.

Executando Seu Script PHP: A Abordagem do Terminal

Agora que você criou um novo arquivo PHP, é hora de executá-lo e ver os resultados. Um método comum é usar o terminal, também conhecido como linha de comando. Seu ambiente de desenvolvimento provavelmente tem uma janela de terminal que se abre automaticamente e está focada no diretório do seu projeto.

Vamos criar um programa simples para começar. Usaremos o exemplo clássico "Olá, mundo!". Dentro do seu projeto, crie um novo arquivo chamado hello.php. PhpStorm (ou sua IDE escolhida) adicionará automaticamente a extensão .php. O editor deve preencher automaticamente o arquivo com a tag de abertura PHP: <?php.

Aqui está o código que você vai inserir em hello.php:

<?php
print "Hello, world!\n";

Esta linha instrui o PHP a exibir o texto "Hello, world!" seguido por um caractere de nova linha. O caractere de nova linha (\n) garante que a saída apareça em sua própria linha no terminal.

print vs. echo: Exibindo Saída

Você pode ter notado o uso de print neste exemplo. O PHP também oferece echo como uma forma alternativa de exibir texto. Embora existam diferenças técnicas sutis, para programação introdutória, você pode, em grande parte, considerá-los intercambiáveis. A escolha geralmente se resume à preferência pessoal. Alguns desenvolvedores preferem print porque a palavra melhor reflete a ação de exibir algo. Outros podem usar echo devido à sua prevalência em código PHP mais antigo.

Uma distinção fundamental é que, ao contrário de funções em muitas outras linguagens, print e echo em PHP não são tecnicamente funções. Isso significa que você não precisa envolver o texto que deseja exibir entre parênteses, embora seja perfeitamente aceitável fazê-lo.

Executando Seu Script do Terminal

Para executar seu script hello.php, navegue até o painel do terminal dentro do seu ambiente de desenvolvimento. Então, digite o seguinte comando e pressione Enter:

php hello.php

Este comando diz ao interpretador PHP para processar e executar o arquivo hello.php. Você deverá então ver a saída:

Hello, world!

exibido na janela do terminal. Parabéns, você acabou de executar seu primeiro script PHP!

Executando Scripts PHP: Métodos Alternativos e Servidores Web Locais

Além das ferramentas de depuração, PhpStorm (e a maioria das outras IDEs) oferece outra maneira direta de executar seu código PHP. Simplesmente localize o botão verde "Executar" – frequentemente situado perto do ícone de depuração – no topo da janela do aplicativo. Clicar neste botão normalmente executará o arquivo atualmente aberto. Se um menu suspenso aparecer apresentando opções entre execução de PHP e JavaScript, certifique-se de selecionar a opção PHP.

Quando você executa um script desta forma, um painel dedicado "Executar" aparecerá na parte inferior da sua tela. Este painel exibe informações críticas, incluindo o motor PHP específico que está sendo utilizado e o caminho completo para o script que está sendo processado. Isso é particularmente valioso se você tiver múltiplas versões do PHP instaladas no seu sistema, permitindo que você verifique facilmente a compatibilidade. O painel também mostrará a saída do script, e um código de saída final – um valor de 0 significa que o script foi executado com sucesso.

Utilizando o Servidor Web Integrado do PHP

Instalações do PHP incluem um servidor web conveniente e integrado, projetado especificamente para desenvolvimento e testes locais. Para confirmar rapidamente que este servidor web está funcionando corretamente e para obter informações sobre seu ambiente PHP, use a função phpinfo(). Esta função gera um relatório HTML abrangente detalhando inúmeros aspectos da sua configuração do PHP. Executar um script contendo phpinfo() é um passo inicial padrão ao configurar qualquer projeto web baseado em PHP, seja na sua máquina local ou em um servidor remoto.

Vamos colocar isso em prática. Crie uma pasta de projeto nova chamada web_project_1 dentro do seu IDE. Dentro desta pasta, crie um arquivo novo chamado index.php. O nome index.php é significativo porque servidores web frequentemente servem este arquivo por padrão quando nenhum arquivo específico é solicitado. Preencha este arquivo com o seguinte código:

<?php
phpinfo();
?>

Este trecho de código, começando com a tag de abertura PHP <?php, chama a função phpinfo() e exibe sua saída. Você pode agora visualizar este relatório detalhado como uma página web formatada. Dentro do PhpStorm, selecione "Visualizar" então "Abrir no Navegador" e escolha "Visualização Integrada". Alternativamente, um pequeno ícone dentro do painel de edição também pode iniciar a visualização web.

Executando Seu Código PHP: Duas Abordagens Simples

Quando você cria um arquivo PHP, você precisa de uma maneira de executá-lo e ver os resultados. Felizmente, existem algumas abordagens simples para fazer isso, particularmente úteis durante o desenvolvimento. Vamos explorar estas abordagens.

Usando o Servidor Web Integrado do PhpStorm

PhpStorm, um ambiente de desenvolvimento integrado (IDE) popular, oferece um servidor web integrado conveniente para testar seus projetos PHP. Quando você utiliza este recurso, o PhpStorm lança automaticamente um servidor web em miniatura e exibe a saída do seu arquivo index.php dentro de uma janela de navegador de exemplo diretamente dentro do IDE. Esta é uma maneira rápida e fácil de ver como seu código se comporta sem precisar configurar nada externamente.

É altamente recomendável explorar a página web exibida. Esta página frequentemente contém informações valiosas sobre o seu ambiente PHP, incluindo a versão do interpretador PHP, a localização do crucial ficheiro de configuração php.ini, uma lista de extensões de base de dados ativadas (se houver), e agradecimentos aos principais desenvolvedores por trás do PHP.

Usando o Servidor Web PHP na Linha de Comando

Alternativamente, pode executar o servidor web incorporado do PHP diretamente a partir do seu terminal ou prompt de comandos. Esta é uma opção independentemente do seu IDE e é frequentemente a única opção se não estiver a usar PhpStorm ou um IDE similar com um servidor incorporado.

Para iniciar o servidor, abra o terminal do seu IDE (ou a linha de comando do seu sistema) e digite o seguinte comando:

php -S localhost:8000

Vamos analisar o que este comando faz. php invoca o interpretador PHP. A flag -S diz ao PHP para iniciar seu servidor web integrado. localhost:8000 especifica o endereço e a porta que o servidor irá escutar. localhost refere-se ao seu próprio computador, e 8000 é o número da porta. Pense em números de porta como canais específicos para comunicação; cada aplicação que precisa enviar ou receber dados requer uma porta única. Para desenvolvimento local, portas como 8000 ou 8080 são escolhas comuns, enquanto servidores de produção tipicamente usam a porta 80. Eu pessoalmente prefiro usar a porta 8000 para desenvolvimento local.

Uma vez que o servidor está em execução, abra seu navegador web preferido (como Chrome ou Firefox) e insira localhost:8000 na barra de endereço. Você deverá então ver a saída do seu script PHP.

Para parar o servidor, simplesmente retorne à janela do terminal onde você o iniciou e pressione Ctrl+C. Isso irá terminar o processo do servidor web de forma elegante.

Isso conclui nossa análise de duas maneiras simples de executar e testar seu código PHP. Experimente com ambos os métodos para encontrar aquele que melhor se adapta ao seu fluxo de trabalho.