Download the PHP package phpmx/datalayer without Composer
On this page you can find all versions of the php package phpmx/datalayer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phpmx/datalayer
More information about phpmx/datalayer
Files in phpmx/datalayer
Package datalayer
Short Description Camada de conexão com banco de dados para aplicações PHPMX
License MIT
Informations about the package datalayer
PHPMX - Datalayer
Camada de conexão com banco de dados para aplicações PHPMX.
Dependência
Instalação
A instalação pode ser feita em um projeto vazio ou junto ao phpmx-core, utilizando apenas dois comandos no terminal:
Para verificar se tudo está pronto, execute:
Configuração do Banco de Dados
Para começar a utilizar o datalayer, defina nas variáveis de ambiente a(s) conexão(ões) com o banco de dados.
O padrão das variáveis é:
SQLite
Os arquivos do banco ficam em storage/sqlite (já gitignorados). Por padrão, o datalayer usa o nome da conexão como nome do arquivo. Para definir um arquivo diferente:
MySQL / MariaDB
Para alterar a porta padrão:
Múltiplos Bancos
Você pode declarar múltiplos bancos de dados para o projeto. Os bancos podem ser de tipos diferentes, mas devem ter nomes distintos.
Casos de uso
O DataLayer pode ser utilizado de duas formas, dependendo do nível de compatibilidade entre o banco de dados e a arquitetura PHPMX:
- Modo compatível: voltado para leitura/escrita em bancos existentes, externos ou compartilhados, sem controle estrutural.
- Modo nativo: recomendado para bancos dedicados ao projeto, utilizando toda a automação, validações e consistência do ecossistema.
Recurso | Compatível | Nativo |
---|---|---|
Múltiplos bancos | ✅ | ✅ |
Query builder | ✅ | ℹ️ |
Migrations automáticas | ❌ | ✅ |
Exportação / Importação | ❌ | ✅ |
Controle de índices | ❌ | ✅ |
Drivers automáticos | ❌ | ✅ |
Actions (create/update/delete) | ❌ | ✅ |
Requisições inteligentes | ❌ | ✅ |
Relacionamento entre múltiplos bancos | ❌ | ✅ |
Leitura via fontes externas | ✅ | ✅ |
Gravação via fontes externas | ✅ | ⚠️ |
❌ Sem suporte a recursos avançados no modo compatível: não há controle de schema, migrations, índices ou relacionamento. O uso é manual e limitado. O DataLayer apenas consome o banco de dados.
ℹ️ Query Builder no modo nativo: continua disponível, mas seu uso é desencorajado. A maior parte das queries são geradas automaticamente com base nos drivers e ações declaradas no projeto.
⚠️ Atenção: No uso nativo, o banco de dados é controlado pela aplicação. Alterações feitas fora da estrutura declarada (ex: scripts SQL, ferramentas gráficas, dumps manuais) podem comprometer a integridade dos dados e do sistema. Se for necessário modificar o banco diretamente, faça com consciência dos riscos.
Você pode combinar os dois estilos no mesmo projeto, usar um banco principal de forma nativa e um banco legado de forma compatível, apenas para leitura de dados antigos.
Importante: Não existe uma configuração para "ativar" ou "desativar" o modo compatível ou nativo. O que define o modo é o conjunto de recursos que você utiliza: se usar apenas leitura/escrita manual, estará no modo compatível; se usar automações, validações e drivers, estará no modo nativo. Basta escolher os recursos conforme a necessidade de cada banco.
Veja a documentação de cada um dos modos do datalayer
- Modo compativel
- Modo nativo
phpmx | phpmx-core | phpmx-server | phpmx-datalayer | phpmx-view