Skip to content

devpt-org/site

Folders and files

NameName
Last commit message
Last commit date

Latest commit

19993c5 · Feb 21, 2025
Aug 27, 2023
Mar 5, 2023
Dec 23, 2022
Feb 25, 2023
Mar 4, 2023
Aug 27, 2023
Dec 23, 2022
Aug 27, 2023
Aug 27, 2023
Aug 27, 2023
Jun 1, 2023
Dec 23, 2022
Mar 4, 2023
Dec 23, 2022
Oct 14, 2023
Oct 14, 2023
Dec 23, 2022
Dec 29, 2022
Oct 14, 2023
Aug 27, 2023
Apr 19, 2023
Dec 23, 2022
Feb 25, 2023
Feb 25, 2023
Aug 27, 2023
Aug 27, 2023
Dec 23, 2022
Oct 14, 2023
Aug 27, 2023
Dec 23, 2022
Dec 23, 2022
May 4, 2023
Jun 1, 2023
Aug 27, 2023
Jan 20, 2023

Repository files navigation

devPT

Canal Youtube

Requisitos para desenvolvimento

Este projeto está otimizado para trabalhar em Docker - suportado por Linux, MacOS e Windows (em WSL2). Funciona de outras formas, mas esta é a suportada pelo desenvolvimento neste repositório.

Avançado: Como o Docker corre um pouco mais lento em MacOS e WSL2, uma forma de poupar algum tempo é usar o npm no sistema, e não dentro do Docker container. Assim, o npm install e npm run dev podem ser executados fora do container.

Como correr o projeto em ambiente local

Clonar o projeto na máquina

git clone https://github.com/devpt-org/site.git

Entrar na pasta do projeto e correr este comando. Via Docker, estamos a ir buscar as dependências do Composer, para termos acesso ao Laravel Sail.

cd site
docker run --rm \
  -u "$(id -u):$(id -g)" \
  -v "$(pwd):/app" -w /app \
  composer:2 \
  composer install --ignore-platform-reqs

Copiar o ficheiro .env.example para .env.

cp .env.example .env

Executar o Sail "up" para levantar os serviços necessários. Pode demorar alguns minutos, pois vai construir imagens se necessário. Ficará visível o output dos serviços.

./vendor/bin/sail up

Noutra sessão de terminal, corre este comando e ficas dentro de uma sessão no container.

./vendor/bin/sail bash

Executar estes comandos apenas a primeira vez:

php artisan key:generate
php artisan storage:link

Executar estes comandos cada vez que faças um pull, e haja alterações no package-lock.json (npm) ou composer.lock (composer).

composer install
npm install

Para abrir o projeto, no navegador abrir o endereço http://localhost ou http://localhost:APP_PORT se alteraste a APP_PORT no .env.

Para realizar a compilação em real-time (re-compila a cada alteração) dos recursos de JavaScript e CSS, executar:

npm run dev

FAQs

Recebo um erro que a porta está em uso.

Para outros sites que estejam em execução na porta 80, adiciona a propriedade APP_PORT no ficheiro .env para indicar que porta livre que deve ser usada pelo webserver do Sail. No exemplo mudamos para 8080.

APP_PORT=8080

Ao tentar executar o sail recebo um erro que diz que o docker não está em execução.

Certifica-te que tens o Docker a correr antes de executar o Sail.