# Uma Instalação Local de PHP

Começando: Sua Primeira Saída PHP

Ambientes de codificação online como o Replit oferecem uma maneira rápida de experimentar com PHP. Quando você executa um arquivo PHP no Replit, o código dentro de tags especiais – <?php e ?> – é tratado como instruções PHP, distinto de qualquer HTML circundante. Clicar no botão "Run" inicia um servidor web dentro do Replit que processa seu código PHP e exibe o resultado. Em vez de ver a saída no console, você provavelmente verá "Hello World" renderizado como uma página web simples dentro da aba Webview.

 Uma representação visual da saída no painel Replit Webview

Replit publica temporariamente seu código para um endereço *.replit.dev, permitindo que você visualize sua página web fora do ambiente Replit. Você pode acessar isso clicando na barra de endereço na parte superior do painel Webview, copiando a URL fornecida e colando-a em uma nova aba do navegador. Isso demonstra uma página web PHP básica hospedada de forma independente. Considere isso seu primeiro passo em direção à construção de websites com tecnologia PHP!

Nota Importante: Embora o Replit seja conveniente para o aprendizado inicial, projetos mais avançados mais adiante neste guia podem exigir configuração adicional dentro do Replit. Detalhes sobre essas configurações podem ser encontrados no Apêndice C.

Por que Trabalhar Localmente? Configurando Seu Próprio Ambiente

Embora editores baseados na nuvem como o Replit sejam úteis, eles podem ser lentos, ter limitações nos níveis gratuitos e depender de uma conexão de internet estável. Muitos desenvolvedores preferem a flexibilidade e a velocidade de trabalhar localmente – diretamente em seus próprios computadores.

O primeiro passo em direção ao desenvolvimento local é instalar o PHP em si. Se você ainda não o fez, consulte o Apêndice A para instruções detalhadas sobre como baixar e instalar a versão mais recente do PHP apropriada para o seu sistema operacional (Windows, macOS ou Linux).

Uma vez que o PHP esteja instalado, você está pronto para configurar um ambiente de desenvolvimento. Uma parte crucial disso é usar um Ambiente de Desenvolvimento Integrado (IDE). Um IDE é mais do que apenas um editor de texto; é uma ferramenta poderosa que oferece recursos como um terminal integrado, capacidades avançadas de busca e substituição, verificação automatizada de código e até sugestões para padrões de codificação comuns. Pense nisso como seu centro de comando de programação! Existem muitos IDEs excelentes disponíveis, então explore e encontre um que se adapte ao seu fluxo de trabalho.

Configurando Seu Ambiente de Desenvolvimento PHP Local com PhpStorm

Para aprender e construir aplicações PHP de forma eficaz, é crucial ter um ambiente de desenvolvimento no seu computador. Esta seção irá guiá-lo através da configuração de um ambiente local usando PhpStorm, um Ambiente de Desenvolvimento Integrado (IDE) poderoso e amplamente utilizado da JetBrains. PhpStorm oferece um período de teste gratuito de 30 dias, e vários grupos, incluindo estudantes, educadores e participantes em bootcamps de programação, frequentemente podem se qualificar para licenças gratuitas. Você pode baixar PhpStorm de [https://www.jetbrains.com/phpstorm/](https://www.jetbrains.com/phpstorm/) e seguir as instruções de instalação fornecidas.

Enquanto PhpStorm é altamente recomendado, IDEs gratuitos alternativos como Visual Studio Code, Eclipse e Apache NetBeans também são opções viáveis e oferecem plugins para suportar o desenvolvimento PHP.

Seu Primeiro Script PHP: "Olá, mundo!"

Vamos criar um script PHP básico "Olá, mundo!" usando PhpStorm. Este exemplo espelha a funcionalidade do modelo padrão de PHP CLI encontrado em plataformas como Replit.

1. Inicie PhpStorm.

2. Selecione "Novo Projeto".

3. Escolha "Projeto PHP Em Branco" como o modelo do projeto.

4. Especifique um local no seu computador para armazenar os arquivos do projeto, e dê ao seu projeto um nome descritivo. É uma boa prática incluir uma barra ( / ) antes do nome do projeto no caminho do local (por exemplo, /meu_projeto_php).

5. Clique em "Criar".

PhpStorm então gerará uma nova pasta com o nome do seu projeto escolhido no local designado. Esta pasta abrigará todos os arquivos do projeto. À medida que seus projetos crescerem em complexidade, você provavelmente usará subpastas para organizar diferentes aspectos de sua aplicação, como código fonte, arquivos de dados e configurações.

Após a criação, PhpStorm exibirá a visão de edição do projeto, fornecendo um espaço de trabalho para seu código. Esta visão tipicamente consiste em três painéis principais:

- Painel de Conteúdo do Projeto: Localizado no canto superior esquerdo, este painel exibe a estrutura de pastas do seu projeto, permitindo que você navegue e gerencie arquivos.

- Painel de Edição de Código/Arquivo: Localizado no canto superior direito, é aqui que você escreverá e editará seu código PHP e outros arquivos de dados.

- Interface de Linha de Comando (CLI) Terminal: Para acessar um terminal de linha de comando, clique no ícone Terminal (frequentemente representado como >_) na coluna da esquerda da janela do PhpStorm. Este terminal aparecerá na parte inferior da janela do aplicativo, permitindo que você execute comandos diretamente dentro do seu ambiente de desenvolvimento.

Executando Seu Primeiro Script PHP

Agora que seu ambiente PHP local está configurado, vamos criar e executar um programa simples. Isso irá verificar se tudo está funcionando corretamente e irá apresentar você ao fluxo de trabalho básico.

Primeiro, crie um novo arquivo PHP dentro do seu projeto. No seu IDE (como PhpStorm), navegue até a pasta do seu projeto no painel do explorador de arquivos. Então, selecione Arquivo > Novo > Arquivo PHP da barra de menu. Dê o nome de arquivo hello – o IDE adicionará automaticamente a extensão .php, então o nome de arquivo completo será hello.php. Uma vez criado, o arquivo deverá aparecer na listagem de arquivos do projeto e abrir para edição. Você provavelmente descobrirá que o editor já preencheu o arquivo com a tag de abertura PHP: <?php.

Agora, adicione o seguinte código para o arquivo hello.php:

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

Este código é direto: ele imprime a frase "Hello, world!" seguido por um caractere de nova linha. A nova linha garante que a saída apareça em sua própria linha no terminal.

print vs. echo

Você pode ter notado que o código usa print em vez de echo para exibir o texto. Embora tanto print quanto echo sejam usados para exibir texto em PHP, eles são amplamente intercambiáveis para iniciantes. Pense neles como funcionalmente equivalentes por enquanto. Algumas bases de código PHP mais antigas, ou aquelas escritas por programadores familiarizados com versões mais antigas do PHP, podem favorecer echo. No entanto, print argumentavelmente reflete melhor a ação de exibir texto. Em última análise, a escolha entre eles é uma questão de preferência pessoal.

Uma diferença fundamental (embora não crucial para agora) é que em muitas linguagens de programação, as funções de saída exigem parênteses ao redor do texto a ser exibido. Por exemplo, em Python, você pode ver print("Hello"). Em PHP, no entanto, print e echo são estruturas da linguagem, não funções, portanto, os parênteses são opcionais. Você pode usá-los, mas não precisa usá-los.

Executando Seu Script

Para executar seu script recém-criado, abra o painel do terminal dentro do seu IDE. Se o terminal não estiver aberto, talvez seja necessário abri-lo explicitamente do menu do IDE. Na linha de comando, digite o seguinte e pressione Enter:

php hello.php

Este comando diz ao interpretador PHP para executar o arquivo hello.php. Você deverá então ver a saída, "Olá, mundo!", exibida na janela do terminal. Parabéns, você acabou de executar seu primeiro programa PHP!

Executando Seu Código PHP: Múltiplos Métodos & Um Servidor Web Local

PhpStorm oferece algumas maneiras convenientes de executar seus scripts PHP diretamente dentro do ambiente de desenvolvimento. Além da funcionalidade de depuração, você pode executar um script clicando no botão "Executar", representado por uma seta verde, localizado próximo ao canto superior direito da janela do aplicativo. Quando você faz isso, PhpStorm tentará executar o arquivo atualmente aberto. Se um menu aparecer apresentando opções para executar o script com PHP ou JavaScript, certifique-se de selecionar a opção PHP.

Executar um script desta maneira geralmente exibirá um painel "Executar" na parte inferior da tela. Este painel fornece informações valiosas, incluindo o motor PHP específico que está sendo usado e o caminho completo para o script executado. Isto é particularmente útil se você tiver várias versões do PHP instaladas no seu sistema, permitindo que você verifique a compatibilidade entre diferentes ambientes. O painel também mostrará a saída do programa e um código de saída final. Um código de saída de 0 geralmente significa que o script foi concluído com sucesso.

Configurando um Servidor Web Local com PHP

Quando você instala PHP, você também recebe um servidor web embutido, projetado primariamente para desenvolvimento e teste local. Uma maneira simples de confirmar que este servidor web está funcionando e para coletar detalhes sobre sua instalação do PHP é utilizar a função phpinfo(). Esta função gera um relatório HTML detalhado contendo uma riqueza de informações sobre o ambiente PHP, como o número da versão, extensões configuradas e configurações do servidor.

Para começar, crie um novo projeto dentro do PhpStorm (ou seu IDE preferido). Um nome de pasta adequado para este projeto poderia ser web_project_1. Dentro deste projeto, crie um novo arquivo chamado index.php. O nome index.php é significativo porque designa este arquivo como o documento padrão servido pelo servidor web quando nenhum arquivo específico é solicitado.

Aqui está o código que você colocará dentro de index.php:

<?php
phpinfo();
?>

Este script simples chama a função phpinfo() e exibe sua saída. Você pode visualizar esta informação como uma página web formatada executando o script através do seu navegador web. Dentro do PhpStorm, você pode usar o menu "Visualizar", selecionando "Abrir no Navegador" e depois "Visualização Integrada", ou você pode clicar no ícone dedicado que aparece quando seu cursor está posicionado dentro do editor de arquivos. Isso irá automaticamente lançar o arquivo index.php no seu navegador web padrão, mostrando o relatório abrangente phpinfo().

Executando Seu Código PHP com o Servidor Web Integrado

Uma das maneiras mais simples de testar seu código PHP é usando o servidor web integrado do PHP. Este método é particularmente útil quando você está apenas começando ou não tem um ambiente de servidor web mais complexo configurado. Ambientes de desenvolvimento integrado (IDEs) como PhpStorm frequentemente fornecem um recurso de visualização conveniente para exibir sua saída PHP diretamente no IDE. Se você iniciou a visualização, você deve ver os resultados do seu script index.php renderizados em uma janela do navegador.

Você pode explorar as informações exibidas executando phpinfo(). Esta função fornece uma riqueza de detalhes sobre sua instalação do PHP, incluindo a versão do PHP, a localização do arquivo de configuração (php.ini), quais extensões de banco de dados estão habilitadas e os nomes dos principais colaboradores do projeto PHP. É uma ótima maneira de se familiarizar com a configuração do PHP do seu sistema.

Embora a visualização do IDE seja útil, você também pode visualizar a saída do seu script em um navegador web padrão como Chrome ou Firefox. Isso é frequentemente a única opção se você estiver usando um ambiente de desenvolvimento diferente. Para fazer isso, abra o terminal do IDE (ou um terminal no seu sistema) e execute o seguinte comando:

Vamos analisar o que este comando faz. php invoca o interpretador PHP. A flag -S diz ao PHP para iniciar seu servidor web embutido. localhost:8000 especifica o endereço e a porta onde o servidor será acessível. localhost refere-se ao seu próprio computador, e 8000 é o número da porta. Toda aplicação que precisa se comunicar através de uma rede requer um número de porta único—pense nelas como caixas de correio específicas dentro de um escritório de correios maior. Para desenvolvimento local, as portas 8000 e 8080 são escolhas comuns; servidores web de produção normalmente usam a porta 80. Eu pessoalmente prefiro usar a porta 8000 para desenvolvimento local.

Uma vez que o servidor esteja em execução, simplesmente abra seu navegador da web e insira localhost:8000 na barra de endereço. Você verá a saída do seu script PHP, assim como você veria se estivesse usando um servidor web completo.

Para parar o servidor web embutido, retorne à janela do terminal onde você o iniciou e pressione Ctrl+C. Isso termina o processo do servidor de forma graciosa.

E é isso! Você iniciou e usou com sucesso o servidor web embutido do PHP para testar seu código. Esta é uma habilidade fundamental para qualquer desenvolvedor PHP.