Pular para o conteúdo principal

Guia de Instalação

Este guia detalha os passos para instalar e configurar o VF Web em seu ambiente.

Requisitos do Sistema​

Requisitos mínimos​

  • PHP 7.4 ou superior
  • MySQL 5.7 ou MariaDB 10.4
  • Servidor web (Apache, Nginx ou IIS)
  • Extensões PHP: PDO, JSON, mbstring, curl

Requisitos recomendados​

  • PHP 8.1+
  • MySQL 8.0 ou MariaDB 10.11
  • SSL/TLS para ambiente de produção

Instalação Manual​

Passo 1: Preparação do Ambiente​

  1. Configure um servidor web (Apache/Nginx) com PHP 7.4+
  2. Crie um banco de dados MySQL/MariaDB
  3. Configure as credenciais de acesso ao banco

Passo 2: Clone o Repositório​

git clone <url_do_repositorio> /var/www/vfweb

Passo 3: Configure as Credenciais​

O sistema cria automaticamente o arquivo de constantes na primeira execução.

  1. Acesse o sistema pelo navegador
  2. O sistema redirecionará para privado/_Constante/criaConstante_login.html
  3. Preencha os dados do banco de dados
  4. O sistema criará o arquivo privado/constantes/constantes.vf

Passo 4: Configuração Manual (Opcional)​

Se preferir configurar manualmente, crie o arquivo privado/constantes/constantes.vf:

<?php
define('NOME_SISTEMA', 'VF Web - ERP');
define('NOME_EMPRESA', 'Sua Empresa');
define('DB_HOST', 'localhost');
define('DB_PORTA', '3306');
define('DB_NOME', 'vfweb');
define('DB_USUARIO', 'seu_usuario');
define('DB_SENHA', 'sua_senha');
define('COD_CLIENTE_SAC', '');
?>

Passo 5: Permissões​

Configure as permissões da pasta de uploads:

chmod -R 775 uploads
chmod -R 775 uploadsAgenda

Passo 6: Acesse o Sistema​

Abra o navegador e acesseo endereço do sistema. Use as credenciais padrão para criar o primeiro usuário.

Instalação com Docker​

Dockerfile​

O projeto inclui um Dockerfile (dockerfile) e configurações em docker/:

cd vWeb
docker build -t vfweb .
docker run -d -p 8080:80 vfweb

docker-compose.yml (sugestão)​

version: '3.8'
services:
  vfweb:
    build: .
    ports:
      - "8080:80"
    volumes:
      - ./uploads:/var/www/html/uploads
    environment:
      - DB_HOST=db
      - DB_PORT=3306
      - DB_NAME=vfweb
      - DB_USER=root
      - DB_PASSWORD=root
    depends_on:
      - db
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: vfweb
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

Configurações do Sistema​

Constantes Principais​

As constantes são definidas em privado/constantes/constantes.vf:

ConstanteDescrição
NOME_SISTEMANome exibido no sistema
NOME_EMPRESANome da empresa
DB_HOSTHost do banco de dados
DB_PORTAPorta do banco
DB_NOMENome do banco
DB_USUARIOUsuário do banco
DB_SENHASenha do banco

Parâmetros do Sistema​

Os parâmetros são configuráveis através do painel administrativo, na seção _Configuracoes.

Solução de Problemas​

"Unknown database"​

Se o banco de dados não existir, o sistema tentará criá-lo automaticamente (referência: Class/DB.class.php:341-361).

Erro de conexão MySQL​

Verifique:

  1. Credenciais do banco em privado/constantes/constantes.vf
  2. Se o servidor MySQL está em execução
  3. Se a porta está correta

Erro de permissão​

# Linux
chown -R www-data:www-data /var/www/vfweb

# Verificar uploads
chmod -R 775 uploads uploadsAgenda

Próximos Passos​