2. Configurar um ambiente de desenvolvimento

Os scripts foram escritos e testados no seguinte ambiente:

um ambiente com servidor web Apache / SGBD MySQL / PHP 7.3 denominado Laragon;
o IDE de desenvolvimento NetBeans 10.0;

2.1. Instalação do Laragon

O Laragon é um pacote que combina vários componentes de software:

um servidor web Apache. Iremos utilizá-lo para escrever scripts web em PHP;
o sistema de gestão de bases de dados MySQL;
a linguagem de script PHP;
um servidor Redis que fornece cache para aplicações web:

O Laragon pode ser descarregado (março de 2019) no seguinte endereço:

https://laragon.org/download/

A instalação [1-5] resulta na seguinte estrutura de diretórios:

em [6] a pasta de instalação do PHP;

Ao iniciar o [Laragon], é apresentada a seguinte janela:

[1]: o menu principal do Laragon;
[2]: o botão [Start All] inicia o servidor web Apache e a base de dados MySQL;
[3]: o botão [WEB] exibe a página web [http://localhost], que corresponde ao ficheiro PHP [<laragon>/www/index.php], onde <laragon> é a pasta de instalação do Laragon;
[4]: o botão [Database] permite-lhe gerir a base de dados MySQL utilizando a ferramenta [phpMyAdmin]. Deve instalar esta ferramenta previamente;
[5]: O botão [Terminal] abre um terminal de comandos;
[6]: O botão [Root] abre uma janela do Explorador do Windows posicionada na pasta [<laragon>/www], que é o diretório raiz do site [http://localhost]. É aqui que deve colocar todas as aplicações web geridas pelo servidor Apache do Laragon;

Vamos abrir um terminal do Laragon [5]:

em [1], o tipo de terminal. Estão disponíveis três tipos de terminais em [6];
em [2, 3]: o diretório atual;
Em [4], digite o comando [echo %PATH%], que exibe a lista de diretórios pesquisados ao procurar um executável. Todas as pastas principais do Laragon estão incluídas neste caminho de executáveis, o que não seria o caso se abrisse uma janela do prompt de comando [cmd] no Windows. Neste documento, quando lhe for pedido que digite comandos para instalar um determinado software, esses comandos são geralmente digitados num terminal do Laragon;

2.2. Instalação do IDE NetBeans 10.0

O IDE NetBeans 10.0 pode ser descarregado a partir do seguinte endereço (março de 2019):

https://netbeans.apache.org/download/index.HTML

O ficheiro descarregado é um ficheiro ZIP que apenas precisa de ser descompactado. Assim que o NetBeans estiver instalado e iniciado, pode criar o seu primeiro projeto PHP.

Em [1], selecione a opção Ficheiro / Novo Projeto;
Em [2], selecione a categoria [PHP];
em [3], selecione o tipo de projeto [Aplicação PHP];

Em [4], atribua um nome ao projeto;
Em [5], escolha uma pasta para o projeto;
Em [6], selecione a versão do PHP descarregada;
em [7], selecione a codificação UTF-8 para os ficheiros PHP;
Em [8], selecione o modo [Script] para executar scripts PHP no modo de linha de comandos. Selecione [Servidor WEB Local] para executar um script PHP num ambiente web;
Em [9,10], especifique o diretório de instalação para o interpretador PHP do pacote Laragon:

Selecione [Concluir] para concluir o assistente de criação do projeto PHP;

em [11], o projeto é criado com um script [index.php];
em [12], escreva um script PHP mínimo;
em [13], execute [index.php];

em [14], os resultados na janela [output] do NetBeans;
Em [15], crie um novo script;
em [16], o novo script;

O leitor pode criar todos os scripts que se seguem em pastas diferentes dentro do mesmo projeto PHP. O código-fonte dos scripts deste documento está disponível na seguinte estrutura de diretórios do NetBeans:

Os scripts deste documento estão localizados no diretório do projeto [scripts-console] [1]. Também utilizaremos bibliotecas PHP que serão colocadas na pasta [<laragon-lite>/www/vendor] [2], onde <laragon-lite> é o diretório de instalação do software Laragon. Para que o NetBeans reconheça as bibliotecas em [2] como parte do projeto [scripts-console], precisamos de incluir a pasta [vendor] [2] no [Include Path] [3] do projeto. Vamos configurar o NetBeans para que a pasta [<laragon-lite>/www/vendor] [2] seja incluída em todos os novos projetos PHP, e não apenas no projeto [scripts-console]:

Em [1-2], aceda às opções do NetBeans;
Em [3-4], configure as opções do PHP;
Em [5-7], configure o [Global Include Path] do PHP: as pastas listadas em [7] são automaticamente incluídas no [Include Path] de todos os projetos PHP;

Em [9], aceda às propriedades do ramo [Include Path];
Em [10-11], as novas bibliotecas exploradas pelo NetBeans. O NetBeans analisa o código PHP nessas bibliotecas e armazena as suas classes, interfaces, funções, etc., a fim de prestar assistência ao programador;

em [12], um trecho de código utiliza a classe [PhpMimeMailParser\Parser] da biblioteca [vendor/php-mime-mail-parser];
em [13], o NetBeans sugere os métodos desta classe;
Em [14-15], o NetBeans apresenta a documentação do método selecionado;

O conceito de [Include Path] é específico do NetBeans. O PHP também possui este conceito, mas, em princípio, trata-se de dois conceitos diferentes.

Agora que o ambiente de desenvolvimento está configurado, podemos abordar os conceitos básicos do PHP.