Skip to content

4. Instalação de um servidor NestJS

Nota: A seguir, às vezes se faz referência a um servidor PHP, o mencionado no curso [Introduction to the PHP7 Language Through Examples]. O servidor NestJS implementa os mesmos serviços que esse servidor PHP.

Trataremos das funções HTTP do TypeScript — as funções que permitem consultar um servidor web. Para os nossos testes, precisamos de um servidor web. Usaremos o desenvolvido na seção “Estudo de caso”: o servidor de cálculo de imposto em NestJS. Esse servidor hospeda um serviço jSON que oferece os seguintes serviços:

  • [init-session] — GET main.php?action=init-session&type=json — informa ao servidor que queremos respostas jSON;
  • [authenticate-user] — POST main.php?action=authenticate-user: Os dois parâmetros enviados via POST [user, password] determinam se a conexão ao serviço jSON é autorizada ou não. Por padrão, as credenciais são [admin, admin];
  • [calculate-tax] — POST main.php?action=calculate-tax: Os parâmetros enviados via POST [married, children, salary] são usados para calcular um imposto:
    • married: “yes” se casado, “no” caso contrário;
    • children: número de filhos do contribuinte;
    • salary: o salário anual do contribuinte;
  • [list-simulations] — GET main.php?action=list-simulations — lista as simulações realizadas desde o início da sessão;
  • [delete-simulation] — GET main.php?action=delete-simulation&number=x — exclui a simulação nº x da lista de simulações;
  • [get-admindata] — GET main.php?action=get-admindata — recupera todo o banco de dados associado ao servidor em um objeto jSON;
  • [end-session] — GET main.php?action=end-session: encerra a sessão. Para iniciar uma nova, o usuário deve emitir o comando “init-session” descrito acima;

Descreveremos agora como instalar este servidor. Se você não quiser instalá-lo, vá direto à seção “As funções HTTP do TypeScript”. Você não poderá testar os scripts em um ambiente real, mas poderá examinar o código.

4.1. Instalação do Laragon

Em setembro de 2026, a ferramenta Laragon está disponível na URL [Download Laragon – Fast & Modern Dev Environment ]. O Laragon inclui ferramentas que permitem instalar um servidor PHP e o SGBD MySQL:

Image

  • em [1], um servidor web Apache;
  • em [2], o SGBD MySQL;
  • em [3], uma ferramenta de mensageria que não usaremos;
  • [4] inicia todos os serviços (Apache, MySQL, MailPit);
  • [5] exibe a página web na URL [http://localhost]. Por padrão, essa URL aponta para a pasta <laragon-install>\www, onde <laragon-install> é a pasta de instalação do Laragon;
  • em [6], inicia a ferramenta HeidiSQL, que permite gerenciar bancos de dados MySQL. Usaremos essa ferramenta para criar o banco de dados usado pelo servidor de cálculo de imposto;
  • em [7], abre um terminal; todos os binários necessários ao Laragon estão no PATH;
  • em [8], abre o Explorador de Arquivos do Windows na pasta associada à URL [http://localhost];

A pasta de instalação do Laragon contém os seguintes itens:

 
  • Em [1], a pasta [bin] contém diversos aplicativos:
  • Em [1], o servidor web Apache;
  • em [2], um terminal de linha de comando;
  • em [3], um cliente [git] que permite gerenciar as diferentes versões de um projeto;
  • em [4], um gerenciador de banco de dados;
  • [5], um gerenciador de e-mails;
  • em [6], o SGBD MySQL;
  • [7], outro servidor web;
  • em [8], [node.js] para executar scripts JavaScript;
  • [9], um editor de texto;
  • em [10], o interpretador PHP;
  • em [11], o interpretador [Python];
  • [12], um servidor de cache;

O Laragon traz um ambiente de desenvolvimento completo. Neste curso, usaremos apenas o SGBD MySQL [6] e o [heidisql] para gerenciá-lo graficamente;

4.2. Instalação e configuração do servidor NestJS

Um servidor NestJS para um cálculo de imposto bastante simplificado pode ser encontrado na pasta nestjs-case-study dentro do diretório de scripts deste curso:

nestjs-case-study/
├── package.json
├── nest-cli.json
├── .env.example
├── create_dbtaxes.sql
├── src/
│   ├── main.ts
│   ├── main.controller.ts
│   ├── app.module.ts
│   ├── actions/
│   ├── config/
│   ├── entities/
│   ├── filters/
│   ├── model/
│   ├── responses/
│   ├── session/
│   └── utilities/
└── views/

Se você já instalou as dependências de toda a árvore de diretórios (com npm install no diretório raiz, por meio dos workspaces do npm descritos na introdução deste documento), a pasta nestjs-case-study já contém o seu node\_modules. Caso contrário, vá até essa pasta e execute:

npm install
Nota: Se você seguiu a instalação em lote descrita na introdução (executando `npm install` na raiz de `typescript-nestjs-course-scripts`), esta etapa já está concluída: passe diretamente à configuração abaixo.

O servidor precisa de um arquivo .env para especificar os parâmetros de conexão ao banco de dados MySQL criado pelo Laragon (veja acima), bem como a porta de escuta. Copie o arquivo .env.example fornecido para .env e depois personalize-o:

PORT=3000
TAX_DATA_SOURCE=mysql
DB_HOST=localhost
DB_PORT=3306
DB_NAME=dbtaxes-2019
DB_USER=admtaxes
DB_PASSWORD=pwdtaxes
CORS_ALLOWED=true
SESSION_SECRET=change-me-in-production
  • PORT: a porta de escuta do servidor NestJS (o padrão é 3000).
  • TAX_DATA_SOURCE: mysql para usar o banco de dados criado abaixo;
  • DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD: os parâmetros de conexão ao banco de dados dbtaxes-2019 que criaremos com o HeidiSQL (veja abaixo) — as mesmas credenciais definidas no script create_dbtaxes.sql mostrado na árvore de diretórios acima;
  • CORS_ALLOWED: permite chamadas CORS (cross-origin) de um cliente TypeScript executado em outra porta.
  • SESSION_SECRET: a chave usada para assinar o cookie de sessão — altere-a se o servidor for algum dia tornado acessível publicamente.

4.3. Criação do banco de dados

Para criar o banco de dados MySQL exigido pelo servidor NestJS, usamos uma opção do Laragon:

 
  • Em [1], todos os serviços devem estar iniciados;
  • em [2], a opção [Database] permite gerenciar o banco de dados;

A opção [Database] inicia um utilitário chamado HeidiSQL:

  • Em [1], você pode selecionar diversos SGBDs. O valor padrão é o SGBD MySQL. Isso é adequado;
  • em [2], você se conecta ao HeidiSQL;
  • Em [1-2], execute o arquivo SQL e depois selecione o arquivo [create_dbtaxes.sql], que você encontrará na pasta [nestjs-case-study]:

Image

A execução do arquivo [2] criará o banco de dados [dbtaxes-2019] usado pelo servidor de cálculo de imposto. Para visualizá-lo, pressione F5 no HeidiSQL para atualizar a exibição:

 

O banco de dados [dbtaxes-2019] foi criado.

4.4. Inicialização do servidor NestJS

Depois que o arquivo .env estiver no lugar (e o banco de dados tiver sido criado), abra um terminal na raiz da pasta [nestjs-case-study] e então compile e inicie o servidor:

npm run build
npm run start:prod

Para desenvolvimento, com reinicialização automática a cada alteração do código-fonte, use:

npm run start:dev

Nos dois casos, o console exibe:

[Nest] ... [NestFactory] Starting Nest application...
[Nest] ... [InstanceLoader] AppModule dependencies initialized
[Nest] ... [RoutesResolver] MainController {/}:
[Nest] ... [RouterExplorer] Mapped {/main.php, ALL} route
[Nest] ... [NestApplication] Nest application successfully started
Tax calculation server (NestJS) started on http://localhost:3000
JSON entry point: http://localhost:3000/main.php?action=init-session&type=json
HTML entry point: http://localhost:3000/main.php?action=init-session&type=html

O servidor NestJS tem um único ponto de entrada (main.php, mantido por compatibilidade, embora aqui se trate de NestJS) que recebe todas as requisições, e um parâmetro de requisição “action” que seleciona o processamento a ser realizado:

4.5. Testes HTML do servidor de cálculo de imposto

Se ainda não o fez, inicie todos os serviços do Laragon (para o MySQL) e o servidor NestJS (npm run start:prod ou npm run start:dev; veja acima). Em seguida, em um navegador, solicite a URL http://localhost:3000/main.php?action=init-session&type=html — é a mesma ação init-session do servidor PHP, com o mesmo parâmetro type=html , mas na porta 3000:

As credenciais são admin/admin, exatamente as mesmas do servidor PHP — são definidas da mesma forma, no código do servidor e não em config.json. Digite-as:

Preencha o formulário e envie-o. Você verá a página a seguir:

O resultado do cálculo do imposto é exibido — esta página usa de fato o banco de dados que acabamos de criar. O link “List of simulations” no menu à esquerda exibe o histórico de cálculos desta sessão:

Se você obteve esses resultados, o servidor NestJS de cálculo de imposto está funcionando corretamente com seu banco de dados MySQL. Agora estamos prontos para consultar o servidor com clientes TypeScript. Para isso, usaremos a versão jSON do servidor.

4.6. A API jSON do servidor de cálculo de imposto

4.6.1. Testes com o Postman

O servidor PHP foi testado com a ferramenta desktop Postman. A mesma coleção de requisições (tax-servers-tests.postman_collection.json, fornecida na pasta nestjs-course) funciona de forma idêntica com o servidor NestJS: a API jSON é exatamente a mesma — as mesmas ações, os mesmos parâmetros, os mesmos códigos de status. No Postman, basta alterar a porta de cada requisição (80 → 3000) ou, mais simplesmente, a URL base da coleção, se você a tiver definido como variável.

A ferramenta Postman está disponível na URL [https://www.postman.com/downloads/]. Talvez seja necessário criar uma conta.

Inicie todos os serviços do Laragon e depois abra o aplicativo desktop do Postman:

  • Em [1-2], crie uma requisição HTTP para consultar o servidor de cálculo de imposto;
 
  • Em [1], você pode dar um nome à sua requisição HTTP. Será possível salvá-la e recuperá-la;
  • Em [2]: informe a URL do servidor que deseja consultar;
  • em [3]: selecione o tipo de requisição HTTP. Usaremos dois deles a seguir: GET e POST;
  • em [4]: se a sua requisição tiver parâmetros do tipo [?param1=val1&param2=val2&…], você pode defini-los aqui;
  • em [5]: se o tipo de requisição for POST, é aqui que você define os valores enviados;

Em [nestjs-course], você encontrará uma coleção de requisições HTTP ao servidor de cálculo de imposto que pode ser importada no POSTMAN.

Image

Proceda assim. No Postman, execute [Ctrl-O]:

 
  • Use o link [1] para importar o arquivo [tax-servers-tests.postman_collection.json] da pasta [nestjs-course]:
 
  • Em [1], o nome da coleção importada;
  • em [2], seu conteúdo. É uma lista de requisições (HTTP) ao servidor de cálculo de imposto (jSON);

Vejamos, por exemplo, a requisição chamada [init-session-json-700]. Ela inicia uma sessão jSON com o servidor:

 
  • Em [1], a requisição HTTP é um GET;
  • em [2], a URL consultada. Ela solicita o início de um diálogo jSON com o servidor;
  • em [3-4], encontramos os parâmetros do GET;
  • em [5], para enviar a requisição ao servidor de cálculo de imposto;

Antes de enviar a requisição, certifique-se de ter iniciado os serviços do Laragon. A resposta jSON do servidor é a seguinte:

 

Use agora a requisição chamada [init-session-703]:

Image

A requisição [1-3] é inválida. Os parâmetros devem ser do tipo [?action=xx&type=yy], onde “type” pode ser “html”, “xml” ou “json”. O tipo “x” não será reconhecido. A resposta jSON do servidor é a seguinte:

 

Reenvie a requisição [init-session-json-700] para reiniciar uma sessão jSON. Depois envie a requisição [authenticate-user-200] para se autenticar:

  • Em [1], a requisição é um POST;
  • em [2], a URL da requisição de autenticação;
  • em [3], o corpo do POST, que contém os valores enviados;
  • [4-5], os dois valores enviados. São as credenciais do administrador da aplicação. Elas são definidas no arquivo [config.service.ts] do servidor;

Image

A resposta jSON do servidor é a seguinte:

 

Depois de autenticado, você pode realizar um cálculo de imposto. Para isso, use a requisição [calculate-tax-300]:

 
  • Em [1], trata-se de uma requisição POST;
  • em [2], a URL solicitada;
  • em [3-4], os três valores são enviados;

A resposta jSON é a seguinte:

 

Execute a requisição várias vezes, alterando os valores enviados a cada vez. Feito isso, execute a requisição [list-simulations-500], que exibirá a lista das simulações realizadas:

  • A requisição GET [1-4] tem apenas um parâmetro: [action]. A resposta jSON é a seguinte:
 

Esta é a lista das simulações que você realizou.

Use a requisição [delete-simulation-600] para excluir uma simulação:

  • Em [2], a URL é consultada com um GET. Ela inclui dois parâmetros [action, number]. [number] é o número da simulação que você deseja excluir da lista de simulações. Aqui, o número 0 refere-se à primeira simulação da lista;

A resposta jSON do servidor é a seguinte:

 

A resposta jSON é a lista das simulações restantes depois de excluir uma delas;

Por fim, você pode encerrar a sessão com a requisição [end-session-400]:

 

A URL da requisição [1-2] tem apenas o parâmetro [action] (3). A resposta jSON é a seguinte:

 

4.6.2. Testes com o curl

Também podemos usar a ferramenta [curl] para testar os serviços jSON do servidor. Todas as requisições a seguir usam a mesma sessão HTTP (a opção -b/-c cookies.txt do curl preserva o cookie de sessão entre as chamadas, exatamente como um navegador ou o Postman faria):

Vamos iniciar uma sessão jSON com a ação [init-session]:

curl -c cookies.txt "http://localhost:3000/main.php?action=init-session&type=json"
{
  "action": "init-session",
  "status": 700,
  "response": "session started with type [json]"
}

O código de status 700 confirma que a sessão foi iniciada — é o mesmo código retornado pelo servidor PHP. Agora vamos nos autenticar com a ação [authenticate-user] — uma requisição POST, com um único parâmetro na URL (action) e as credenciais enviadas:

curl -b cookies.txt -c cookies.txt -X POST "http://localhost:3000/main.php?action=authenticate-user" \
     -d "user=admin&password=admin"
{
  "action": "authenticate-user",
  "status": 200,
  "response": "Authentication successful [admin, admin]"
}

Agora você pode calcular impostos com a ação [calculate-tax], novamente uma requisição POST com os três parâmetros enviados: estado civil, filhos e salário:

curl -b cookies.txt -c cookies.txt -X POST "http://localhost:3000/main.php?action=calculate-tax" \
     -d "married=yes&children=2&salary=45000"
{
  "action": "calculate-tax",
  "status": 300,
  "response": {
    "married": "yes",
    "children": 2,
    "salary": 45000,
    "tax": 502,
    "surcharge": 0,
    "discount": 857,
    "reduction": 126,
    "rate": 0.14
  }
}

Os valores são exatamente os mesmos (€502 de imposto, um desconto de €857, uma redução de 126 € e uma alíquota de 14%) que os exibidos no navegador na seção anterior — as duas versões, HTML e jSON, compartilham o mesmo mecanismo de cálculo. A lista de simulações é obtida com a ação [list-simulations], um simples GET:

curl -b cookies.txt -c cookies.txt "http://localhost:3000/main.php?action=list-simulations"
{
  "action": "list-simulations",
  "status": 500,
  "response": [
    {
      "married": "yes", "children": 2, "salary": 45000,
      "tax": 502, "surcharge": 0, "discount": 857, "reduction": 126, "rate": 0.14
    }
  ]
}

Execute a requisição [calculate-tax] várias vezes alterando os valores enviados e depois use [delete-simulation] para remover uma simulação da lista (&number=x refere-se ao seu número de ordem) e [get-admindata] para recuperar todo o banco de dados em formato jSON (faixas de imposto e constantes de cálculo). Por fim, encerre a sessão com a ação [end-session]:

curl -b cookies.txt -c cookies.txt "http://localhost:3000/main.php?action=end-session"
{
  "action": "end-session",
  "status": 400,
  "response": "session deleted"
}

Agora você tem uma boa compreensão da API jSON exposta pelo servidor NestJS de cálculo de imposto — que é exatamente a mesma do servidor PHP. Podemos passar agora à escrita de scripts TypeScript que consultam esse servidor.