/ /

Compatibilidade de Recursos do Laravel

Visão geral

Este guia descreve os recursos do Laravel suportados pelo Laravel MongoDB. Esta página discute a disponibilidade do recurso Laravel versão 12.x na Integração do Laravel.

As seções a seguir contêm tabelas que descrevem se recursos individuais estão disponíveis na integração com o Laravel.

Dica

Conceitos de SQL no MongoDB

Para saber como o MongoDB representa a terminologia, os conceitos e a funcionalidade SQL, consulte o Gráfico de mapeamento SQL para MongoDB.

Recursos do banco de dados

Funcionalidade de Banco de Dados	Disponibilidade
Configuração	✓
Conexões de leitura/gravação	Use a preferência de leitura .
Várias conexões de banco de dados	✓
Audição de eventos de query	✓
Monitoramento do tempo de query cumulativo	✓
Transações	✓ Consulte Executar uma transação de banco de dados.
Interface da linha de comando (CLI)	Use o MongoDB Shell (`mongosh`).
Inspeção do Banco de Dados	Não suportado
Monitoramento de banco de dados	Não suportado
Suporte a vários bancos de dados/vários esquemas	Não suportado O Laravel usa um separador de ponto (`.`) entre o esquema SQL e os nomes de tabela, mas o MongoDB permite caracteres `.` nos nomes de coleções, o que pode levar a uma análise inesperada do namespace.
Prefixos de nome de coleção e índice	Não suportado

Recursos de consulta

Os seguintes métodos do Eloquent não são compatíveis com a integração com o Laravel:

toSql()
toRawSql()
whereColumn()
orWhereColumn()
whereFulltext()
groupByRaw()
orderByRaw()
inRandomOrder()
union()
unionAll()
havingRaw()
having()
havingBetween()
orHavingRaw()
whereIntegerInRaw()
orWhereIntegerInRaw()
whereIntegerNotInRaw()
orWhereIntegerNotInRaw()

Recurso de query	Disponibilidade
Executando queries	✓
Agrupamento de resultados	✓
Agregados	✓
Selecionar declarações	✓
expressão brutas	Não suportado
Associações	Use o estágio de agregação `$lookup`. Para saber mais, consulte a referência $lookup no manual do servidor. O Laravel MongoDB fornece as operações de agregação para realizar agregações.
Sindicatos	Use o estágio de agregação `$unionWith`. Para saber mais, consulte a referência $unionWith no manual do servidor. O Laravel MongoDB fornece as operações de agregação para realizar agregações.
Cláusulas onde básicas	✓
Cláusulas adicionais onde	✓
Agrupamento lógico	✓
Cláusulas onde avançadas	✓
Subquery onde cláusulas	Não suportado
Encomenda	✓
Ordenação aleatória	Não suportado
Agrupamento	Use o estágio de agregação `$group`. Para saber mais, consulte a referência $group no manual do servidor. O Laravel MongoDB fornece as operações de agregação para realizar agregações.
Limite e deslocamento	✓
Cláusulas condicionais	✓
Inserir declarações	✓
IDs de incremento automático	Não suportado, pois o MongoDB usa ObjectIDs
Upserts	✓ Consulte Exemplo de upsert de um documento.
Atualizar declarações	✓
Atualizando colunas JSON	Não suportado
Valores de incremento e decremento	✓
Depuração	✓

Recursos de paginação

A integração com o Laravel oferece suporte a todos os recursos de paginação do Laravel.

Recursos de migração

A Integração do Laravel suporta todos os recursos de migração do Laravel, mas a implementação é específica para o modelo flexível de esquema do MongoDB.

Semeando recursos

A integração com o Laravel oferece suporte a todos os recursos de sementeira do Laravel.

Funcionalidades Eloquentes

Funcionalidade Eloquente	Disponibilidade
Modelos	✓
Chaves UUID e ULID	✓
Carimbos de data e hora	✓
Recuperando modelos	✓
Subqueries avançadas	Não suportado
Recuperando ou criando modelos	✓
Recuperando agregados	Parcialmente suportado
Inserindo e atualizando modelos	✓
Upserts	✓ Consulte Atualizar ou Inserir em uma única operação.
Excluindo modelos	✓
Exclusão suave	✓
Modelos de podada	✓

Dica

Para saber mais, consulte o guia Classe do modelo Eloquent .

Recursos de relacionamento do Eloquent

Funcionalidade Eloquente	Disponibilidade
Definindo relacionamentos	✓
Relacionamentos de muitos para muitos	✓
Relacionamentos polimórficos	✓
Relacionamentos dinâmicos	✓
Consultando relações	✓
Agregando modelos relacionados	✓
Inserindo e atualizando modelos relacionados	✓

Dica

Para saber mais, consulte o guia Relacionamentos do modelo Eloquent .

Recursos da coleção Eloquent

A integração do Laravel oferece suporte a todas as funcionalidades de collection do Eloquent.

Recursos do Mutador Eloquente

Funcionalidade Eloquente	Disponibilidade
Lança	✓
Fundição de array e JSON	✓ Você pode armazenar objetos e arrays no MongoDB sem serializar para JSON. A partir do Laravel MongoDB v5.8, o tipo de conversão `array` foi descontinuado. Para aprender mais, consulte Descontinuações da versão 5.8.
Fundição de data	✓
Fundição de Enum	✓
Transmissão criptografada	✓
Construções personalizadas	✓

Dica

Para saber mais, consulte o guia Classe do modelo Eloquent .

Recursos da fábrica de modelos da Eloquent

A integração com o Laravel suporta todos os recursos de fábrica do Eloquent.

Voltar

atualização

Problemas e ajuda