Criando e Executando um Projeto FacturaScripts no ServBay

O FacturaScripts é uma solução ERP (Planejamento de Recursos Empresariais) e CRM (Gestão de Relacionamento com o Cliente) open source, poderosa e flexível, ideal para pequenas e médias empresas e profissionais autônomos. Com o ambiente local de desenvolvimento web intuitivo do ServBay, você pode criar, testar e rodar projetos FacturaScripts no macOS de forma simples, sem configurações complicadas.

Este guia detalhado irá acompanhá-lo passo a passo durante todo o processo de instalação e configuração local do FacturaScripts utilizando o ServBay.

Visão Geral do FacturaScripts

O FacturaScripts é um software ERP e CRM open source desenvolvido em PHP e utilizando o framework Bootstrap. Ele ajuda empresas a gerenciar processos essenciais, incluindo:

• Emissão e gestão de faturas
• Contabilidade
• Controle de estoque
• Gestão de clientes e fornecedores
• Gerenciamento de projetos
• E muito mais recursos disponíveis através de módulos e plugins...

Sendo um projeto open source ativo, o FacturaScripts conta com um comunidade forte, permitindo expansão e personalização das funcionalidades via plugins para adaptar-se às necessidades específicas de cada negócio.

Principais Características e Vantagens do FacturaScripts

• Open source e gratuito: Use, modifique e distribua livremente, sem custos de licenciamento.
• Completo em funcionalidades: Abrange a maioria das funções essenciais para a rotina de pequenas e médias empresas, oferecendo uma solução integrada.
• Fácil de usar: Interface amigável e intuitiva, sem curva de aprendizado acentuada.
• Altamente escalável: Possui marketplace de plugins robusto e API aberta, facilitando a adição de novos recursos e a integração com outros serviços.
• Acesso multiplataforma: Baseado em tecnologias web, pode ser acessado a partir de qualquer dispositivo com navegador moderno.
• Comunidade ativa: Suporte e ajuda disponíveis de uma comunidade global de desenvolvedores.
• Suporte multilíngue: Interface disponível em vários idiomas, facilitando o uso por usuários de diferentes regiões.

Vantagens de Executar o FacturaScripts com o ServBay

O ServBay é um ambiente local de desenvolvimento web projetado especialmente para desenvolvedores, fornecendo uma plataforma ideal para executar aplicativos PHP como o FacturaScripts. Ele reúne todos os componentes necessários – servidor web Apache/Nginx, múltiplas versões de PHP, bancos de dados MySQL/MariaDB/PostgreSQL, Redis e outras ferramentas populares – com gerenciamento unificado por uma interface gráfica intuitiva.

Os principais benefícios e etapas ao rodar o FacturaScripts localmente com o ServBay incluem:

• Ambiente integrado: O ServBay vem com todos os componentes essenciais (servidor web, PHP, banco de dados) pré-instalados e configurados, evitando a instalação manual separada de cada software.
• Gerenciamento de versões: Facilite o teste de compatibilidade com diferentes versões de PHP, atendendo ao requisito do FacturaScripts ou outras necessidades.
• Gestão de bancos de dados: O ServBay traz ferramentas embutidas como phpMyAdmin ou Adminer, facilitando a criação e o gerenciamento do banco de dados e usuários necessários para o FacturaScripts.
• Configuração simplificada de sites: Crie websites locais rapidamente, configure domínio, diretório raiz, servidor web e versão do PHP via interface gráfica do ServBay.
• Automação do arquivo Hosts: O ServBay gerencia automaticamente o arquivo Hosts do macOS, permitindo acesso fácil por domínio personalizado (como facturascripts.servbay.demo).
• Suporte a SSL: Configure SSL/HTTPS em ambientes locais facilmente, simulando produção, com CA interna do ServBay ou serviços ACME públicos.

O fluxo principal para rodar o FacturaScripts no ServBay é o seguinte:

1. Baixe o código do FacturaScripts.
2. Crie uma pasta para o projeto na raiz dos sites gerenciados pelo ServBay.
3. Crie o banco de dados MySQL e usuário necessários para o FacturaScripts.
4. Configure o servidor web (Apache ou Nginx) via ServBay, apontando para a pasta do projeto.
5. Verifique e ative extensões PHP requeridas.
6. Acesse o domínio local pelo navegador e complete o assistente de instalação do FacturaScripts.

Pré-requisitos

Antes de começar, certifique-se de atender estes requisitos:

• O ServBay foi baixado, instalado e está rodando no seu sistema macOS. Você encontra a versão mais recente no site oficial do ServBay.
• Os pacotes principais do ServBay (servidor web Apache ou Nginx de sua escolha, versão do PHP pretendida e MySQL ou MariaDB) estão iniciados e funcionando normalmente na interface do ServBay.
• Conhecimento básico em desenvolvimento web e noções de banco de dados.

Criando o Projeto FacturaScripts (Com Zip Download)

Este é um dos métodos mais simples e comuns para instalar o FacturaScripts localmente.

1. Baixar o FacturaScripts:

   • Acesse a página oficial de downloads do FacturaScripts em https://facturascripts.com/descargar.
   • Encontre o pacote .zip estável mais recente e faça o download para seu computador macOS.

2. Criar o diretório do projeto:

   • Abra o Finder e navegue até o diretório raiz utilizado pelo ServBay para arquivos de sites locais. O padrão e recomendado é /Applications/ServBay/www/.
   • Crie uma nova pasta dentro desse diretório para armazenar o projeto, por exemplo: facturascripts_project.
   • Exemplo de caminho completo: /Applications/ServBay/www/facturascripts_project

3. Descompactar os arquivos:

   • Localize o arquivo .zip baixado do FacturaScripts e dê um duplo clique para descompactar.
   • Copie ou mova todos os arquivos e pastas extraídos (como index.php, Core, Dinamic, Plugins etc.) para a pasta /Applications/ServBay/www/facturascripts_project criada anteriormente.

Configuração Inicial (Banco MySQL e Outros)

O FacturaScripts precisa de um banco de dados para armazenar todos os dados de negócio, usuários, configurações e demais informações. Usaremos o MySQL ou o MariaDB gerenciado pelo ServBay. Ambos são totalmente suportados.

1. Verifique se o pacote de banco está rodando:

   • Abra o ServBay.
   • No menu à esquerda, selecione “Pacotes” – “MySQL” ou “MariaDB” (conforme a sua preferência).
   • Certifique-se de que o pacote de banco selecionado está iniciado. Caso não esteja, clique no interruptor ao lado para iniciar.

2. Criar banco de dados e usuário:

   • Você pode usar a ferramenta de gerenciamento embutida (phpMyAdmin, normalmente instalada com MySQL/MariaDB) ou a linha de comando (via terminal do ServBay). Para iniciantes, o phpMyAdmin é mais intuitivo.
   • Usando o phpMyAdmin (recomendado):
     • Na interface do ServBay, encontre a seção “Banco de Dados”. Clique no ícone do phpMyAdmin ao lado do banco ativo (MySQL ou MariaDB). O ServBay abrirá o phpMyAdmin em seu navegador.
     • Faça login no phpMyAdmin. Normalmente, utilize o usuário padrão root e a senha definida ao inicializar o banco no ServBay. Se esqueceu a senha, o ServBay permite redefini-la nas configurações do pacote de banco.
     • Após o login, clique na aba “Bancos de dados”.
     • No campo “Criar banco de dados”, digite o nome desejado, preferencialmente relacionado ao projeto, por ex. facturascripts_servbay_db.
     • Escolha a codificação e collation adequadas. Recomenda-se utf8mb4_general_ci ou utf8mb4_unicode_ci para melhor suporte de caracteres e emojis.
     • Clique em “Criar”.
     • Criando usuário do banco (opcional, mas recomendado): Para maior segurança, evite conectar o FacturaScripts diretamente usando o usuário root. Crie um usuário dedicado:
       • Retorne à tela principal do phpMyAdmin, clique na aba “Contas de Usuário”.
       • Clique em “Adicionar conta de usuário”.
       • Informe um nome de usuário, por exemplo: facturascripts_servbay_user.
       • No campo host, selecione localhost ou 127.0.0.1, restringindo o acesso apenas à máquina local.
       • Gere ou digite uma senha forte e guarde-a.
       • Mais abaixo, você pode conceder privilégios. A opção mais simples é “Criar banco de dados com o mesmo nome do usuário e conceder todos os privilégios” (quando o nome for igual ao banco), ou, preferencialmente, escolha “Conceder permissões sobre banco específico”, selecione o banco criado (facturascripts_servbay_db) e marque privilégios totais (ALL PRIVILEGES).
       • Clique em “Executar” para salvar o usuário.

3. Anote as informações de conexão: Você precisará delas na instalação do FacturaScripts:

   • Nome do banco de dados (ex: facturascripts_servbay_db)
   • Usuário do banco (ex: facturascripts_servbay_user)
   • Senha do usuário do banco
   • Host do banco (normalmente localhost ou 127.0.0.1)
   • Porta do banco (padrão do MySQL/MariaDB: 3306, mas confira no ServBay qual está ativa)

Configurando o Servidor Web (Apache ou Nginx)

Agora, é preciso informar ao ServBay como acessar os arquivos do projeto FacturaScripts via servidor web. Apache e Nginx são totalmente suportados.

1. Verifique se o pacote do servidor web está rodando:

   • Na seção “Pacotes” do ServBay, confirme se o servidor Apache ou Nginx está iniciado.

2. Adicionar o site:

   • No menu esquerdo, vá em “Sites”.
   • Clique no botão “+” acima da lista de sites, para adicionar uma nova configuração.
   • Na janela de configuração, preencha:
     • Nome: Algo descritivo, como FacturaScripts Demo Site.
     • Domínio: O domínio local desejado, como recomendado pelo ServBay: facturascripts.servbay.demo.
     • Tipo do site: Selecione PHP, indicando um aplicativo dinâmico em PHP.
     • Diretório raiz: Clique em “Procurar” ou “Escolher” e selecione o diretório do projeto (/Applications/ServBay/www/facturascripts_project). Obs: Alguns frameworks exigem diretório raiz em subpastas como public ou web, mas no FacturaScripts geralmente pode ser o diretório principal. Confira na documentação oficial do FacturaScripts.
     • Versão do PHP: Escolha a que seja compatível com a versão baixada. Consulte os requisitos oficiais do FacturaScripts – em geral, PHP 8.1, 8.2 ou mais novo. O ServBay permite alternância fácil entre versões.
     • Outras configurações: O padrão geralmente é suficiente. O ServBay permite configurar SSL/HTTPS (ServBay User CA ou ACME), CORS e outros; ajuste se desejar.

3. Salve e atualize o Hosts:

   • Clique em “Adicionar” ou “Salvar”.
   • O ServBay criará as entradas necessárias no servidor web e pedirá permissão de administrador para alterar o arquivo hosts do sistema, apontando o domínio escolhido (ex: facturascripts.servbay.demo) para 127.0.0.1. Com isso, acesse o site pelo domínio, sem editar manualmente o arquivo.

4. Verifique/Ative extensões PHP:

   • O FacturaScripts pode precisar de extensões como pdo_mysql, gd (imagens), intl (internacionalização), zip, xml, curl (requisições web), etc. O ServBay frequentemente já traz muitas delas ativas, mas se o assistente de instalação do FacturaScripts apontar ausência de algo, ative manualmente pelo painel.
   • Como ativar no ServBay:
     • No menu esquerdo, vá em “Linguagens” – “PHP”.
     • Selecione a versão de PHP usada no seu site FacturaScripts (exemplo: 8.2).
     • Acesse a aba “Extensões”.
     • Veja na lista o que já está instalado/ativado. Caso esteja faltando alguma extensão (por ex. opcache), marque a caixa ao lado dela.
     • Clique em “Aplicar” ou “Salvar”. Algumas alterações exigem reiniciar o serviço PHP. Basta clicar no botão de reiniciar ao lado da versão correspondente.

Exemplo da interface de configuração de site no ServBay

Acesse o Site e Complete a Instalação do FacturaScripts

Seu ambiente ServBay está pronto para rodar o FacturaScripts. Vamos iniciar o assistente de instalação web.

1. Abra o navegador: Use o browser de sua preferência (Chrome, Firefox, Safari, etc.).

2. Digite o endereço: Informe o domínio local escolhido, ex: http://facturascripts.servbay.demo. Se você configurou SSL no ServBay, pode tentar com https://facturascripts.servbay.demo. Pressione Enter.

3. Assistente de Instalação FacturaScripts:

   • Se o site, arquivo Hosts, servidor web e PHP estiverem operando corretamente, será exibida a tela de boas-vindas ou o assistente do FacturaScripts.
   • Seleção de idioma: Escolha o idioma preferido para a interface.
   • Checagem do sistema: O instalador verifica automaticamente se o ambiente (PHP, extensões exigidas, permissões de escrita, etc.) está em ordem. Com configurações corretas, todos os itens devem aparecer em verde. Se aparecer alertas vermelhos ou amarelos, confira a versão/ extensões PHP, permissões de pastas (o diretório /Applications/ServBay/www/facturascripts_project deve ser gravável pelo usuário do servidor web).
   • Configuração do banco de dados: Informe os dados criados anteriormente:
     • Tipo do banco: Selecione MySQL.
     • Host: localhost ou 127.0.0.1.
     • Porta: 3306 (ou a em uso do seu MySQL/MariaDB).
     • Nome do banco: facturascripts_servbay_db (ou nome definido).
     • Usuário: facturascripts_servbay_user.
     • Senha: (a senha definida).
     • Prefixo das tabelas: Use o padrão fs_ ou personalize.
   • Conta de administrador: Defina usuário, senha e e-mail para acesso ao painel de administração. Use senhas seguras e guarde estas informações.
   • Instalar: Revise os dados e avance. O FacturaScripts criará as tabelas necessárias e gravará o arquivo de configuração.

4. Finalização da instalação:

   • Após instalar, o FacturaScripts pode sugerir que você exclua a pasta install (caso exista). Siga essa orientação por segurança.
   • Agora, acesse http://facturascripts.servbay.demo (ou via HTTPS) para acessar o login. Entre usando os dados do administrador e comece a explorar o FacturaScripts!

Perguntas Frequentes (FAQ)

• P: O assistente do FacturaScripts diz faltar extensões PHP. O que fazer?
  • R: Abra o ServBay, vá em “Linguagens” – “PHP”, selecione a versão usada pelo site, acesse “Extensões”, ative a(s) extensões faltantes (como opcache), clique em “Aplicar” e reinicie o serviço PHP.
• P: Ao acessar facturascripts.servbay.demo aparece “Forbidden” ou página em branco?
  • R: Primeiro, verifique se o servidor web (Apache/Nginx) e PHP estão rodando no ServBay. Depois, confira se o diretório raiz do site está correto (/Applications/ServBay/www/facturascripts_project). Páginas em branco geralmente apontam erros de PHP – verifique os logs do servidor web/PHP no ServBay. Mensagens “Forbidden” normalmente são problemas de permissão – garanta que o usuário do servidor web tem acesso de leitura aos arquivos e gravação em pastas como Dinamic.
• P: Falha de conexão com o banco de dados no FacturaScripts?
  • R: Verifique se o MySQL/MariaDB está rodando, a porta está correta (3306 ou a configurada), e se todas as credenciais informadas estão corretas e compatíveis com o que foi criado no ServBay.

Resumo

Graças ao ServBay, instalar e rodar o FacturaScripts localmente no macOS é rápido e simples. O ServBay oferece todos os componentes necessários (servidor web, PHP, banco de dados), automatizando a configuração via uma interface intuitiva. Seguindo este passo a passo, você terá um ambiente local de desenvolvimento ou testes FacturaScripts em minutos, podendo focar no gerenciamento de negócio e na exploração funcional da ferramenta. A flexibilidade e praticidade do ServBay elevam significativamente sua produtividade de desenvolvimento local.