RibaSoft

Laravel - 07/01/2026

• • Criar ambiente de desenvolvimento WSL
  • Criar banco de dados
  • Iniciando aplicativo pela primeira vez
  • Comandos php artisan
  • GitHub
  • Passando de DEV para PROD
  • Atualizando o Sistema

Criar ambiente de desenvolvimento WSL:

• Extensões VS Code:

  WSL: by Microsoft GitHub Copilot Chat: by GitHub Laravel Blade Snippets: by Winnie Lin Portuguese (Brazil) Language Pack for VS Code: by Microsoft HTML CSS Support: by ecmel JavaScrip (ES6) code Snippets: by charalampos karypidis

• Criar Projeto:

  O Docker é um gerenciador de containers, ele tem um plugin chamado compose, mas esse plugin não será usado agora, oque será usado é um container chamado composer que criará a estrutura do Laravel que é um aplicativo em PHP, por isso ao se falar em app está se falando do Laravel.

  Então o Docker baixará e executará um container chamado compose que criará a estrutura do Laravel pelo comando "composer create-project laravel/laravel .".

  docker run --rm -v $(pwd):/app -w /app composer:latest composer create-project laravel/laravel .

  Obs. Quando o Projeto já existir o composer do php precisará ser executado novamente para instalar algumas dependencias do projeto que não são enviadas ao GitHub.

• Configuração:

  Depois de criada a estrutura do Laravel pelo composer do PHP, além de Instalar os requerimentos contidos no arquivo compose.json, o comando executado acima também espelha os aquivos de dentro do container do PHP para a pasta atual do projeto, pois é assim que é uma das formas de interagir com as configurações internas dos containers, por isso já se pode criar também o diretório para a configurações do php.ini.

  mkdir -p docker/php nano docker/php/php.ini

  Conteúdo:

  upload_max_filesize = 500M post_max_size = 500M memory_limit = 512M max_execution_time = 600 date.timezone = "America/Sao_Paulo"

• docker-compose.yml

  Configurar o docker-compose.yml para gerenciar a criação e configuração do container do PHP onde será definida o vínculo de pastas e arquivos externos com os internos, redes virtuais para comunicação com servidor e banco de dados, etc.

  Obs. A identação é fundamental definida a cada 2 espaços e não pode ser usado TAB.

  services: #PHP com Laravel app: build: . networks: - rede_global_nginx - rede_global_postgres container_name: laravel_ribasoft_app working_dir: /var/www volumes: - ./:/var/www - ./docker/php/php.ini:/usr/local/etc/php/conf.d/php.ini restart: unless-stopped networks: rede_global_nginx: external: true rede_global_postgres: external: true

• Dockerfile

  O Dockerfile tem configurações adicionais e comandos que serão executados no UP do container.

  Tambérm instalará os pacotes necessários e definirá privilérios de usuárias para evitar que os arquivos criados posteriormente sejam criados como root.

  FROM php:8.4-fpm #Pacotes Básicos RUN apt-get update && apt-get install -y libpq-dev zip unzip git ffmpeg python3 python3-pip python3-full && rm -rf /var/lib/apt/lists/* RUN python3 -m pip install --break-system-packages -U yt-dlp #Postgres RUN docker-php-ext-install pdo_pgsql pgsql #Composer COPY --from=composer:latest /usr/bin/composer /usr/bin/composer #Usuario RUN groupadd -g 1000 ribasoft && useradd -u 1000 -ms /bin/bash -g ribasoft ribasoft RUN chown -R ribasoft:ribasoft /var/www USER ribasoft #Diretorio de trabalho WORKDIR /var/www

• .env

  Aqui é definida as configuraçãos de conexão, por padrão ele não vai para o git, por isso deve ser recriado e reconfigurado quando passar do ambiente dev para o prod.

  cp .env.example .env

  Conteúdo para alterar:

  DB_CONNECTION=pgsql DB_HOST=postgres DB_PORT=5432 DB_DATABASE=nome_banco DB_USERNAME=usuario_banco DB_PASSWORD=senha_banco

• Fortify

  Para login, e autenticações de usuário será usado o Fortify.

  docker run --rm -v $(pwd):/app -w /app composer:latest composer require laravel/fortify docker compose up -d docker compose exec app bash php artisan vendor:publish --provider="Laravel\Fortify\FortifyServiceProvider"

  Após executar esses comandos é necessário registrar o fortify em bootstrap/providers.php:

  return [ App\Providers\AppServiceProvider::class, App\Providers\FortifyServiceProvider::class, ];

  Se ocorrer algum erro de config quebrada uma reinstalação do composer do PHP pode resolver.

  docker run --rm -v $(pwd):/app -w /app composer:latest composer install

Criar banco de dados:

• No diretório do servidor acesse o container do postgres, crie as redes virtuais para comunicação se ainda não foram criadas e crie o banco de dados, usuário e senha:

  docker network create rede_global_nginx docker network create rede_global_postgres docker compose exec postgres psql -U usuario -d banco CREATE USER usuario WITH PASSWORD 'senha'; CREATE DATABASE banco; GRANT ALL ON SCHEMA public TO usuario; GRANT ALL PRIVILEGES ON DATABASE banco TO usuario; ALTER DATABASE banco OWNER TO usuario;

  Ou caso já tenha um banco de dados basta realizar o restore:

  cat /var/www/site-ribasoft/storage/app/private/api/varejo/backups/backup.sql | docker compose exec -T postgres psql -U usuario -d banco

Iniciando aplicativo pela primeira vez:

• Agora subiremos o container, entraremos dentro dele e executaremos seu bash para configurar a aplicação via php artisan.

  docker compose up -d docker compose exec app bash

  Veja mais comandos Docker AQUI

  .

• Criar chave para criptografia, criar tabelas base do sistema no banco de dados alimentar com dados pré-definidos e prepara o sistema para o uso de APIs.

  php artisan key:generate php artisan migrate --seed php artisan install:api

Comandos php artisan:

• Caso algum arquivo criado e espelhado venha como dono root, execute o comando a seguir:

  sudo chown -R usuario:usuario . sudo chmod -R 775 .

• Criar um Controller:

  php artisan make:controller NomeController

• Criar um Model:

  php artisan make:model Cliente

• Criar um Migration:

  php artisan make:migration create_Clientes_table

• Criar um Seeder:

  php artisan make:seeder UsuariosSeeder

• Criar Tabelas dos Migrations e adicionar os dados dos Seeders:

  php artisan migrate --seed

• Apenas adicinar os dados dos Seeders quando as tabelas jé existirem:

  php artisan db:seed

• Recriar todas as tabelas e iniciar dados básicos:

  migrate:fresh --seed

• Limpesa quando algo está bugado:

  php artisan optimize:clear

• Gerar Cache para melhor velocidade em produção:

  php artisan optimize

• Criar chave para cripitografias funcionarem corretamente:

  php artisan key:generate

• Criar link simbólico:

  Expor o diretório storage/app/public no diretório public/storage, dessa forma os arquivos podem ser acessados de forma pública pelo browser.

  php artisan storage:link

GitHub:

• Adicione as restrições no .gitignore para evitar problemas:

  /public/storage /public/videos /public/arquivos /public/musicas /storage

• Configurar o GitHub:

  git init git branch -M main git config --global user.name "ribasoft" git config --global user.email "ribamarmsantos@gmail.com" git remote add origin git@github.com:RibaSoft/nome_projeto.git git status git add . git commit -m "Primeiro commit" git push -u origin main

Passando de DEV para PROD:

• GitHub

  No servidor Debian de produção após instalar e configurar o git e o docker, crie o diretório de projeto baixe o projeto do GitHub e instale o composer do php através do docker para criar o vendor dentre outras coisas:

  git clone git@github.com:RibaSoft/nome_projeto.git . docker run --rm -v $(pwd):/app -w /app composer:latest composer install

  Crie as redes virtuais, o arquivo .env, e a chave de criptografia.

  docker network create rede_global_nginx docker network create rede_global_postgres cp .env.example .env docker compose exec app bash php artisan key:generate php artisan migrate --seed

Atualizando o Sistema:

• Sempre que houver alterações no projeto no github execute:

  git pull