Skip to content

README.md

Latest commit

 

History

History
197 lines (142 loc) · 5.3 KB

README.md

File metadata and controls

197 lines (142 loc) · 5.3 KB
Raw

PHP-PB - Comunidade PHP da Paraíba

PHP-PB Hero

Site WhatsApp License Laravel Livewire Filament Tailwind

Conectando desenvolvedores PHP na Paraíba desde 2012

Sobre

A PHP-PB é uma comunidade de desenvolvedores PHP do estado da Paraíba, Brasil. Nossa missão é promover a interatividade entre pessoas interessadas na linguagem de programação PHP, compartilhando conhecimento através de meetups, hangouts, artigos e eventos.

O que fazemos

  • Grupo no WhatsApp - Discussões diárias sobre PHP, Laravel, dúvidas técnicas
  • Meetups & Hangouts - Encontros presenciais e online com palestras
  • Blog - Artigos técnicos escritos pela comunidade
  • Vagas - Oportunidades de emprego compartilhadas
  • PHPeste - Organizamos junto com outras comunidades a maior conferência PHP do Nordeste

Stack

Tecnologia Versão Descrição
Laravel 12 Framework PHP
Livewire 4 Componentes reativos full-stack
Tailwind CSS 4 Framework CSS utility-first
Alpine.js 3 Interatividade (incluso no Livewire)
MySQL 8 Banco de dados
FilamentPHP 5 Painel administrativo e área de membro
Phosphor Icons - Ícones do design system
Pest - Testes automatizados

Estrutura do Projeto

php-pb.github.io/
├── site_novo/           # Projeto Laravel (TALL Stack)
│   ├── app/
│   ├── resources/
│   │   └── views/
│   │       └── components/
│   │           └── landing/    # Componentes Livewire da landing
│   ├── routes/
│   └── ...
├── site_antigo/         # Site Jekyll original (backup/referência)
├── docker-compose.yml   # Configuração Docker
├── README.md
└── CONTRIBUTING.md

Instalação

Com Docker (Recomendado)

# Subir os containers
docker-compose up -d

# Instalar dependências PHP
docker-compose exec app composer install

# Instalar dependências Node
docker-compose exec app npm install

# Gerar key da aplicação
docker-compose exec app php artisan key:generate

# Rodar migrations
docker-compose exec app php artisan migrate

# Build dos assets
docker-compose exec app npm run build

Acesse: http://localhost:8080

Sem Docker

cd site_novo

# Instalar dependências
composer install
npm install

# Configurar ambiente
cp .env.example .env
php artisan key:generate

# Banco de dados (SQLite para desenvolvimento)
touch database/database.sqlite
php artisan migrate

# Iniciar servidor
php artisan serve
npm run dev

Acesse: http://localhost:8000

Comandos Docker

# Subir containers
docker-compose up -d

# Parar containers
docker-compose down

# Ver logs
docker-compose logs -f app

# Acessar container
docker-compose exec app bash

# Rodar Artisan
docker-compose exec app php artisan <comando>

# Rodar NPM
docker-compose exec app npm run <comando>

Acesse: http://localhost:8080

Desenvolvimento

# Criar componente Livewire (v4 usa arquivos únicos)
php artisan make:livewire NomeComponente

# Criar Model com Migration
php artisan make:model NomeModel -m

# Rodar testes
php artisan test

# Build para produção
npm run build

# Modo desenvolvimento (com hot reload)
npm run dev

CI/CD

  • CI (.github/workflows/ci.yml): roda em todo push/PR na master - Pint (formatação), Larastan (análise estática) e a suíte de testes Pest.
  • Deploy (.github/workflows/deploy.yml): só dispara ao criar uma tag no formato v*.*.*. Builda os assets, empacota a aplicação e publica via SSH/SCP na Hostinger.
# Disparar um deploy em produção
git tag v1.0.0
git push origin v1.0.0

Comunidades Parceiras

Fazemos parte de uma rede de comunidades PHP do Nordeste:

Comunidade Estado
PHP-PB Paraíba
PHP-PI Piauí
PHP-MA Maranhão
PHP com Rapadura Ceará
PHP-PE Pernambuco
PHP-RN Rio Grande do Norte

Juntos organizamos o PHPeste - a maior conferência PHP do Nordeste brasileiro!

Links

Feito com amor pela comunidade PHP-PB