Instalação
A instalação do AdonisJs é um processo simples e levará apenas alguns minutos.
Requisitos do sistema
As únicas dependências do framework são Node.js
e npm
.
Certifique-se de que suas versões dessas ferramentas correspondem aos seguintes critérios:
- Node.js >= 8.0.0
- npm >= 3.0.0
- git
DICA
Você pode usar ferramentas como nvm para ajudar a gerenciar várias versões do Node.js e npm ao mesmo tempo.
Instalando o AdonisJs
Via AdonisJs CLI
AdonisJs CLI é uma ferramenta de linha de comando para ajudar você a instalar o AdonisJs.
Instale-o globalmente via npm
assim:
npm i -g @adonisjs/cli
DICA
Você também pode usar npx
para evitar instalar a CLI globalmente.
Certifique-se de adicionar o diretório node_modules/.bin
de todo o sistema npm
ao seu $PATH
para poder acessar o binário instalado.
Depois de instalado, você pode usar o comando adonis new
para criar novas instalações do AdonisJs.
Por exemplo, para criar um novo aplicativo chamado yardstick
, simplesmente:
adonis new yardstick
NOTA
Por padrão, o fullstack blueprint é clonado do Github. Você pode personalizar isso usando as opções --api-only
ou --slim
.
Você também pode especificar seu próprio blueprint usando a opção --blueprint=<github-org/repo>
.
Via Git
Alternativamente, você pode usar git
diretamente para buscar nossos boilerplates:
# Fullstack
> git clone --dissociate https://github.com/adonisjs/adonis-fullstack-app
# API
> git clone --dissociate https://github.com/adonisjs/adonis-api-app
# Slim
> git clone --dissociate https://github.com/adonisjs/adonis-slim-app
Após clonar um boilerplate, instale todas as dependências executando npm install
.
Servindo o aplicativo
Depois que o processo de instalação for concluído, você pode cd
no seu novo diretório de aplicativo e executar o seguinte comando para iniciar o servidor HTTP:
adonis serve --dev
Este comando inicia o servidor na porta definida dentro do arquivo raiz .env
.