@hotwyl/init-docker-minimal-dev 1.0.0

package/template/README.md

@@ -0,0 +1,532 @@
+# 🐳 MinimalDev - Ambiente de Desenvolvimento Docker
+
+Um ambiente de desenvolvimento completo e moderno com **PHP**, **MySQL**, **Node.js**, **Apache** e **phpMyAdmin**, configurado para facilitar o desenvolvimento web.
+
+![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
+![PHP](https://img.shields.io/badge/PHP-777BB4?style=for-the-badge&logo=php&logoColor=white)
+![MySQL](https://img.shields.io/badge/MySQL-4479A1?style=for-the-badge&logo=mysql&logoColor=white)
+![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)
+![Apache](https://img.shields.io/badge/Apache-D22128?style=for-the-badge&logo=apache&logoColor=white)
+
+---
+
+## 📋 Índice
+
+- [Requisitos](#-requisitos)
+- [Instalação Rápida](#-instalação-rápida)
+- [Estrutura do Projeto](#-estrutura-do-projeto)
+- [Serviços Disponíveis](#-serviços-disponíveis)
+- [Comandos Úteis](#-comandos-úteis)
+- [Configuração do Banco de Dados](#-configuração-do-banco-de-dados)
+- [Trabalhando com PHP e Composer](#-trabalhando-com-php-e-composer)
+- [Trabalhando com Node.js e npm](#-trabalhando-com-nodejs-e-npm)
+- [Criando Novos Projetos](#-criando-novos-projetos)
+- [Debugging com Xdebug](#-debugging-com-xdebug)
+- [Dicas e Boas Práticas](#-dicas-e-boas-práticas)
+- [Solução de Problemas](#-solução-de-problemas)
+
+---
+
+## 🔧 Requisitos
+
+Antes de começar, você precisa ter instalado em sua máquina:
+
+### Windows
+
+1. **Docker Desktop** - [Download](https://www.docker.com/products/docker-desktop/)
+2. **Git** (opcional) - [Download](https://git-scm.com/downloads)
+3. **VS Code** (recomendado) - [Download](https://code.visualstudio.com/)
+
+### Instalando Docker Desktop no Windows
+
+1. Baixe o Docker Desktop do site oficial
+2. Execute o instalador
+3. **Importante**: Habilite o WSL 2 quando solicitado
+4. Reinicie o computador
+5. Abra o Docker Desktop e aguarde iniciar
+
+Para verificar se está funcionando, abra o terminal (PowerShell ou CMD) e digite:
+
+```bash
+docker --version
+docker-compose --version
+```
+
+---
+
+## 🚀 Instalação Rápida
+
+### Passo 1: Navegue até a pasta do projeto
+
+```powershell
+cd D:\laragon\www\3wonline\wiki\ambientes\minimaldev
+```
+
+### Passo 2: Iniciar os containers
+
+```bash
+# Construir e iniciar todos os serviços
+docker-compose up -d --build
+```
+
+> ⏳ **Primeira execução**: A primeira vez pode demorar alguns minutos, pois o Docker precisa baixar todas as imagens e construir o ambiente.
+
+### Passo 3: Acessar o ambiente
+
+- **Website**: http://localhost
+- **phpMyAdmin**: http://localhost:8080
+
+🎉 **Pronto!** Seu ambiente está funcionando!
+
+---
+
+## 📁 Estrutura do Projeto
+
+```
+minimaldev/
+├── 📄 docker-compose.yml    # Configuração dos containers
+├── 📄 Dockerfile            # Imagem personalizada PHP/Apache
+├── 📄 .env                  # Variáveis de ambiente
+├── 📄 README.md             # Este arquivo
+│
+├── 📁 config/               # Configurações dos serviços
+│   ├── 📁 php/
+│   │   └── php.ini          # Configurações do PHP
+│   ├── 📁 apache/
+│   │   └── 000-default.conf # Virtual host do Apache
+│   └── 📁 mysql/
+│       ├── my.cnf           # Configurações do MySQL
+│       └── 📁 init/
+│           └── 01-init.sql  # Script de inicialização do banco
+│
+├── 📁 www/                  # 🎯 SEUS PROJETOS AQUI!
+│   ├── index.php            # Página inicial do ambiente
+│   ├── phpinfo.php          # Informações do PHP
+│   ├── .htaccess            # Configurações do Apache
+│   └── 📁 errors/           # Páginas de erro personalizadas
+│
+└── 📁 logs/                 # Logs dos serviços
+    └── 📁 apache/           # Logs do Apache
+```
+
+---
+
+## 🌐 Serviços Disponíveis
+
+| Serviço          | Container             | Porta   | URL de Acesso         |
+| ---------------- | --------------------- | ------- | --------------------- |
+| **Apache + PHP** | minimaldev-web        | 80, 443 | http://localhost      |
+| **MySQL**        | minimaldev-mysql      | 3306    | localhost:3306        |
+| **phpMyAdmin**   | minimaldev-phpmyadmin | 8080    | http://localhost:8080 |
+| **Node.js**      | minimaldev-node       | -       | Via terminal          |
+
+### Versões Instaladas
+
+- **PHP**: 8.3 (última versão estável)
+- **Node.js**: LTS (última versão)
+- **MySQL**: 8.x (última versão)
+- **Apache**: 2.4
+- **Composer**: Última versão
+
+### Extensões PHP Instaladas
+
+- PDO, PDO_MySQL, MySQLi
+- GD (com suporte a JPEG, PNG, WebP)
+- Mbstring, iconv
+- Zip, Zlib
+- Intl, BCMath
+- OPcache, Redis
+- Xdebug (para debugging)
+- SOAP, XML
+- E muitas outras...
+
+---
+
+## 💻 Comandos Úteis
+
+### Gerenciamento dos Containers
+
+```bash
+# Iniciar todos os containers
+docker-compose up -d
+
+# Iniciar e reconstruir (após mudanças no Dockerfile)
+docker-compose up -d --build
+
+# Parar todos os containers
+docker-compose down
+
+# Parar e remover volumes (⚠️ APAGA DADOS DO BANCO!)
+docker-compose down -v
+
+# Ver status dos containers
+docker-compose ps
+
+# Ver logs em tempo real
+docker-compose logs -f
+
+# Ver logs de um serviço específico
+docker-compose logs -f web
+docker-compose logs -f mysql
+```
+
+### Acessando os Containers
+
+```bash
+# Acessar terminal do container PHP/Apache
+docker exec -it minimaldev-web bash
+
+# Acessar terminal do container Node.js
+docker exec -it minimaldev-node bash
+
+# Acessar terminal do MySQL
+docker exec -it minimaldev-mysql mysql -u root -p
+```
+
+### Reiniciar Serviços
+
+```bash
+# Reiniciar Apache (após mudanças de configuração)
+docker exec minimaldev-web service apache2 reload
+
+# Reiniciar todos os containers
+docker-compose restart
+```
+
+---
+
+## 🗄️ Configuração do Banco de Dados
+
+### Credenciais Padrão
+
+| Campo            | Valor                                                    |
+| ---------------- | -------------------------------------------------------- |
+| **Host**         | `mysql` (dentro dos containers) ou `localhost` (externo) |
+| **Porta**        | `3306`                                                   |
+| **Usuário Root** | `root`                                                   |
+| **Senha Root**   | `root`                                                   |
+| **Usuário Dev**  | `developer`                                              |
+| **Senha Dev**    | `developer123`                                           |
+| **Database**     | `minimaldev`                                             |
+
+### Conectando via PHP
+
+```php
+<?php
+// Conexão PDO (recomendado)
+$pdo = new PDO(
+    'mysql:host=mysql;dbname=minimaldev;charset=utf8mb4',
+    'developer',
+    'developer123',
+    [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
+);
+
+// Conexão MySQLi
+$mysqli = new mysqli('mysql', 'developer', 'developer123', 'minimaldev');
+```
+
+### Conectando via Software Externo (DBeaver, HeidiSQL, etc.)
+
+- **Host**: `127.0.0.1` ou `localhost`
+- **Porta**: `3306`
+- **Usuário**: `root` ou `developer`
+- **Senha**: Conforme tabela acima
+
+### Criar Novo Banco de Dados
+
+1. Acesse o phpMyAdmin: http://localhost:8080
+2. Clique em "Novo" no menu lateral
+3. Digite o nome do banco e clique em "Criar"
+
+Ou via terminal:
+
+```bash
+docker exec -it minimaldev-mysql mysql -u root -p -e "CREATE DATABASE meu_banco CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
+```
+
+---
+
+## 🐘 Trabalhando com PHP e Composer
+
+### Executar Composer
+
+```bash
+# Instalar dependências (composer install)
+docker exec -it minimaldev-web composer install
+
+# Adicionar pacote
+docker exec -it minimaldev-web composer require nome/pacote
+
+# Atualizar dependências
+docker exec -it minimaldev-web composer update
+
+# Criar novo projeto Laravel
+docker exec -it minimaldev-web composer create-project laravel/laravel meu-projeto
+```
+
+### Executar Scripts PHP
+
+```bash
+# Executar um arquivo PHP
+docker exec -it minimaldev-web php /var/www/html/meu-script.php
+
+# PHP interativo
+docker exec -it minimaldev-web php -a
+```
+
+---
+
+## 📦 Trabalhando com Node.js e npm
+
+O Node.js está disponível em um container separado, compartilhando a pasta `www/`.
+
+### Comandos npm
+
+```bash
+# Ver versão do Node.js
+docker exec -it minimaldev-node node -v
+
+# Ver versão do npm
+docker exec -it minimaldev-node npm -v
+
+# Instalar dependências
+docker exec -it minimaldev-node npm install
+
+# Adicionar pacote
+docker exec -it minimaldev-node npm install nome-pacote
+
+# Executar scripts
+docker exec -it minimaldev-node npm run build
+docker exec -it minimaldev-node npm run dev
+```
+
+### Trabalhando em um Projeto Específico
+
+```bash
+# Navegar para pasta do projeto e executar comandos
+docker exec -it minimaldev-node bash -c "cd /var/www/html/meu-projeto && npm install"
+docker exec -it minimaldev-node bash -c "cd /var/www/html/meu-projeto && npm run dev"
+```
+
+### Criar Projetos Frontend
+
+```bash
+# Criar projeto React
+docker exec -it minimaldev-node npx create-react-app meu-app
+
+# Criar projeto Vue.js
+docker exec -it minimaldev-node npm create vue@latest meu-app
+
+# Criar projeto Vite
+docker exec -it minimaldev-node npm create vite@latest meu-app
+```
+
+---
+
+## 🆕 Criando Novos Projetos
+
+### Projeto PHP Simples
+
+1. Crie uma pasta dentro de `www/`:
+
+   ```
+   www/meu-projeto/
+   ```
+
+2. Adicione um `index.php`:
+
+   ```php
+   <?php
+   echo "Olá, Mundo!";
+   ```
+
+3. Acesse: http://localhost/meu-projeto/
+
+### Projeto Laravel
+
+```bash
+# Criar projeto Laravel
+docker exec -it minimaldev-web composer create-project laravel/laravel www/meu-laravel
+
+# Acessar: http://localhost/meu-laravel/public/
+```
+
+### Projeto WordPress
+
+1. Baixe o WordPress em https://wordpress.org/download/
+2. Extraia para `www/wordpress/`
+3. Crie um banco de dados no phpMyAdmin
+4. Acesse http://localhost/wordpress/ e siga a instalação
+
+---
+
+## 🐛 Debugging com Xdebug
+
+O Xdebug já vem configurado e pronto para uso com VS Code.
+
+### Configuração VS Code
+
+1. Instale a extensão **PHP Debug** (felixfbecker.php-debug)
+
+2. Crie o arquivo `.vscode/launch.json` no seu projeto:
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Listen for Xdebug",
+      "type": "php",
+      "request": "launch",
+      "port": 9003,
+      "pathMappings": {
+        "/var/www/html": "${workspaceFolder}/www"
+      }
+    }
+  ]
+}
+```
+
+3. Pressione F5 para iniciar o debugger
+4. Adicione breakpoints no código
+5. Acesse a página no navegador
+
+---
+
+## 💡 Dicas e Boas Práticas
+
+### 1. Mantenha os Dados Seguros
+
+- Nunca commite senhas reais no `.env`
+- Use o `.gitignore` para ignorar arquivos sensíveis
+
+### 2. Backup do Banco de Dados
+
+```bash
+# Exportar banco
+docker exec minimaldev-mysql mysqldump -u root -proot minimaldev > backup.sql
+
+# Importar banco
+docker exec -i minimaldev-mysql mysql -u root -proot minimaldev < backup.sql
+```
+
+### 3. Limpar Espaço do Docker
+
+```bash
+# Remover containers parados
+docker container prune
+
+# Remover imagens não utilizadas
+docker image prune
+
+# Limpeza completa (cuidado!)
+docker system prune -a
+```
+
+### 4. Alterar Configurações
+
+- Após modificar `php.ini`, `my.cnf` ou `000-default.conf`, reinicie os containers:
+
+```bash
+docker-compose restart
+```
+
+### 5. Logs para Debug
+
+- Logs do PHP: `logs/apache/php_errors.log`
+- Logs do Apache: `logs/apache/error.log`
+- Logs do MySQL: `docker-compose logs mysql`
+
+---
+
+## 🔧 Solução de Problemas
+
+### ❌ Porta 80 já está em uso
+
+**Problema**: Outro serviço (Laragon, XAMPP, IIS, Skype) está usando a porta 80.
+
+**Solução**:
+
+1. Pare o outro serviço, OU
+2. Mude a porta no `docker-compose.yml`:
+
+```yaml
+ports:
+  - "8000:80" # Acesse via http://localhost:8000
+```
+
+### ❌ Container não inicia
+
+```bash
+# Ver logs de erro
+docker-compose logs web
+
+# Reconstruir a imagem
+docker-compose up -d --build --force-recreate
+```
+
+### ❌ Erro de permissão em arquivos
+
+```bash
+# Dentro do container, ajustar permissões
+docker exec -it minimaldev-web chown -R www-data:www-data /var/www/html
+docker exec -it minimaldev-web chmod -R 755 /var/www/html
+```
+
+### ❌ MySQL não conecta
+
+1. Verifique se o container está rodando:
+
+```bash
+docker-compose ps
+```
+
+2. Aguarde alguns segundos após iniciar (MySQL demora para inicializar)
+
+3. Verifique os logs:
+
+```bash
+docker-compose logs mysql
+```
+
+### ❌ Extensão PHP não encontrada
+
+Adicione a extensão no `Dockerfile` e reconstrua:
+
+```bash
+docker-compose up -d --build
+```
+
+### ❌ Composer muito lento
+
+O Composer pode ser lento na primeira execução. Use:
+
+```bash
+docker exec -it minimaldev-web composer config -g repo.packagist composer https://packagist.org
+```
+
+---
+
+## 📚 Recursos Adicionais
+
+- [Documentação Docker](https://docs.docker.com/)
+- [Documentação PHP](https://www.php.net/docs.php)
+- [Documentação MySQL](https://dev.mysql.com/doc/)
+- [Documentação Node.js](https://nodejs.org/docs/)
+- [Documentação Composer](https://getcomposer.org/doc/)
+
+---
+
+## 🤝 Contribuição
+
+Sinta-se à vontade para melhorar este ambiente! Sugestões e pull requests são bem-vindos.
+
+---
+
+## 📄 Licença
+
+Este projeto é livre para uso e modificação.
+
+---
+
+**Desenvolvido com ❤️ para facilitar a vida de desenvolvedores**

package/template/apache/.gitkeep

@@ -0,0 +1 @@
+# Placeholder para manter a pasta no Git

package/template/config/apache/000-default.conf

@@ -0,0 +1,39 @@
+<VirtualHost *:80>
+    ServerAdmin webmaster@localhost
+    DocumentRoot /var/www/html
+
+    <Directory /var/www/html>
+        Options Indexes FollowSymLinks MultiViews
+        AllowOverride All
+        Require all granted
+        DirectoryIndex index.php index.html index.htm
+    </Directory>
+
+    # Configuração de logs
+    ErrorLog ${APACHE_LOG_DIR}/error.log
+    CustomLog ${APACHE_LOG_DIR}/access.log combined
+
+    # Compressão GZIP
+    <IfModule mod_deflate.c>
+        AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript application/json
+    </IfModule>
+
+    # Cache de arquivos estáticos
+    <IfModule mod_expires.c>
+        ExpiresActive On
+        ExpiresByType image/jpg "access plus 1 month"
+        ExpiresByType image/jpeg "access plus 1 month"
+        ExpiresByType image/gif "access plus 1 month"
+        ExpiresByType image/png "access plus 1 month"
+        ExpiresByType image/webp "access plus 1 month"
+        ExpiresByType text/css "access plus 1 week"
+        ExpiresByType application/javascript "access plus 1 week"
+    </IfModule>
+
+    # Segurança básica
+    <IfModule mod_headers.c>
+        Header always set X-Content-Type-Options nosniff
+        Header always set X-Frame-Options SAMEORIGIN
+        Header always set X-XSS-Protection "1; mode=block"
+    </IfModule>
+</VirtualHost>

package/template/config/mysql/init/01-init.sql

@@ -0,0 +1,42 @@
+-- ============================================
+-- MinimalDev - Script de Inicialização
+-- Este script é executado automaticamente 
+-- quando o container MySQL é criado
+-- ============================================
+
+-- Criar banco de dados principal
+CREATE DATABASE IF NOT EXISTS `minimaldev` 
+    CHARACTER SET utf8mb4 
+    COLLATE utf8mb4_unicode_ci;
+
+-- Usar o banco de dados
+USE `minimaldev`;
+
+-- ============================================
+-- Tabela de exemplo para testes
+-- ============================================
+CREATE TABLE IF NOT EXISTS `users` (
+    `id` INT AUTO_INCREMENT PRIMARY KEY,
+    `name` VARCHAR(100) NOT NULL,
+    `email` VARCHAR(150) NOT NULL UNIQUE,
+    `password` VARCHAR(255) NOT NULL,
+    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- ============================================
+-- Inserir usuários de teste
+-- Senha padrão: password (hash bcrypt)
+-- ============================================
+INSERT INTO `users` (`name`, `email`, `password`) VALUES 
+    ('Admin', 'admin@localhost.com', '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi'),
+    ('Developer', 'dev@localhost.com', '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi');
+
+-- ============================================
+-- Garantir privilégios ao usuário developer
+-- ============================================
+GRANT ALL PRIVILEGES ON `minimaldev`.* TO 'developer'@'%';
+FLUSH PRIVILEGES;
+
+-- Confirmação
+SELECT 'Banco de dados inicializado com sucesso!' AS status;

package/template/config/mysql/my.cnf

@@ -0,0 +1,33 @@
+[mysqld]
+# ============================================
+# Configurações Gerais
+# ============================================
+character-set-server = utf8mb4
+collation-server = utf8mb4_unicode_ci
+default-time-zone = '-03:00'
+
+# ============================================
+# Performance
+# ============================================
+innodb_buffer_pool_size = 256M
+innodb_log_file_size = 64M
+max_connections = 150
+key_buffer_size = 32M
+
+# ============================================
+# Log de Queries Lentas
+# ============================================
+slow_query_log = 1
+slow_query_log_file = /var/log/mysql/slow.log
+long_query_time = 2
+
+# ============================================
+# Segurança
+# ============================================
+sql_mode = STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
+
+[mysql]
+default-character-set = utf8mb4
+
+[client]
+default-character-set = utf8mb4