{"title":"O framework de verificação do sistema.","version":"1.9","locale":"pt-br","docname":"ref/checks","url":"/pt-br/1.9/ref/checks/","canonical":"https://djangodocs.dev/pt-br/1.9/ref/checks/","summary":"O framework de verificação do sistema é um conjunto de verificações estáticas para validação de projetos Django. Ele detecta problemas comuns e fornece dicas de…","html":"

O framework de verificação do sistema.Link para este cabeçalho#

\n

O framework de verificação do sistema é um conjunto de verificações estáticas para validação de projetos Django. Ele detecta problemas comuns e fornece dicas de como arrumá-los. O framework é extensível e você pode facilmente adicionar suas próprias validações.

\n

Para detalhes de como adicionar suas próprias verificações e integrar isso com os sistema de verificação do Django, veja o Tópico sistema de verificação do giua..

\n
\n

Referência da APILink para este cabeçalho#

\n
\n

CheckMessageLink para este cabeçalho#

\n
\n
\nclass CheckMessage(level, msg, hint, obj=None, id=None)Link para esta definição#
\n
\n\n

Os alertas e erros emitidos pelo sistema de verificação devem ser uma instância de CheckMessage. Uma instância encapsula um único erro ou aviso. Ele também fornece contexto e dicas aplicáveia a mensagem, e um identificador único que é usado para propósitos de filtragem.

\n

Os argumentos do Construtor são:

\n
\n
level

A gravidade da mensagem. Use um dos valores pré-definidos: DEBUG, INFO, WARNING, ERROR, CRITICAL. Se o nível é maior ou igual a ERROR`, então o Django irá impedir que comandos de gerenciamento sejam exeutados. Mensagens com nível menor que ``ERROR (ex. alertas) são reportados no console, mas pode ser silenciados.

\n
\n
msg

Uma string curta (menor que 80 caracetres) descrevendo o problema. A string não deve conter outras linhas.

\n
\n
hint

Uma string de uma única linha que forneça uma dica para arrumar o problema. Se não pode ser fornecida uma dica, ou a dica é auto-evidente baseado na mensagem de erro, a dica pode ser omitida, ou o valor None pode ser usado.

\n
\n
obj

Opcional. Um objeto que fornece um contexto para a mensagem (por exemplo, o modelo onde o problema foi descoberto). O objeto deve ser um modelo, campo, ou “manager” ou outro objeto que define o método __str__ (no Python 2 você precisa definir o método __unicode__). O método é usado enquanto relata todas as mesagens e seus resultados precedem a mensagem.

\n
\n
id

String opcional. Um identificador único para esse problema. Identificadores devem seguir o formato padrão applabel.X001, onde X é uma das letras de CEWID, indicando a gravidade da mensagem (C para crítico, E para erro e assim por diante). O número pode ser alocado pela aplicação, mas deve ser único dentro daquela aplicação.

\n
\n
\n

Existem subclasses para tornar a criação de mensagens de níveis comuns mais fácil. Quando usá-los você pode omitir o argumento level porque ele está implícito no nome da classe.

\n
\n
\nclass Debug(msg, hint, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\nclass Info(msg, hint, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\nclass Warning(msg, hint, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\nclass Error(msg, hint, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\nclass Critical(msg, hint, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\n
\n

Verificações embutidasLink para este cabeçalho#

\n
\n

Tags embutidasLink para este cabeçalho#

\n

As verificações do sistema do Django estão organizadas usando as seguintes tags:

\n\n

Algumas verificações talvez sejam registradas com múltiplas tags.

\n
\n
\n

Verificações do núcleo do sistemaLink para este cabeçalho#

\n
\n

ModelsLink para este cabeçalho#

\n
    \n

  • models.E001: <swappable> não está no formato app_label.app_name.

    • \n

  • models.E002: <SETTING> referencia <model>, o qual nao foi instalado, ou é abstrato.

    • \n

  • models.E003: O modelo tem duas relações muitos-para-muitos através de um modelo intermediário <app_label>.<model>.

    • \n

  • models.E004: id somente pode ser usado como nome de um campo se o campo também definir primary_key=True.

    • \n

  • models.E005: O campo <field name> do modelo pai <model> colide com o campo <field name> do modelo pai <model>.

    • \n

  • models.E006: O campo colide com o campo <field name> do modelo <model>.

    • \n

  • models.E007: Campo <field name> tem o nome de coluna <column name> que é usado por outro campo.

    • \n

  • models.E008: index_together deve ser uma lista de tuplas.

    • \n

  • models.E009: Todos os elementos index_together devem ser uma lista de tuplas.

    • \n

  • models.E010: unique_together deve ser uma lista de tuplas.

    • \n

  • models.E011: Todos os elementos de unique_together devem ser uma lista de tuplas.

    • \n

  • models.E012: index_together/unique_together referenciam ao campo não existente <field name>.

    • \n

  • models.E013: index_together/unique_together referen-se a um ManyToManyField <field name>, mas ManyToManyFields não são suportados para aquela opção.

    • \n

  • models.E014: ordering deve ser uma tupla ou listat (mesmo que você queira ordernar por um único campo).

    • \n

  • models. E015: ordering referencia ao campo não existente <field name>.

    • \n

  • models.E016: index_together/unique_together refere-se ao campo <field_name> o qual não é local ao modelo <model>.

    • \n

  • models.E017: O modelo proxy <model> cotém campos de modelo.

    • \n

  • models.E018: Nome de coluna gerado automaticamente é muito longo para o campo <field>. O comprimento máximo é <maximum length> para o banco de dados <alias>.

    • \n

  • models.E019: Nome de campo gerado automaticamente para o campo M2M <M2M field> é muito longo. O comprimento máximo é <maximum length> para o banco de dados <alias>.

    • \n

  • models.E020: The <model>.check() método da classe está neste momento sobrescrito.

    • \n

  • models.E021: ordering e order_with_respect_to não podem ser usados juntos.

    • \n
\n
\n
\n

CamposLink para este cabeçalho#

\n
    \n

  • fields.E001: Nomes de campos não devem terminar com “underscore”.

    • \n

  • fields.E002: nome de campos não devem conter "__".

    • \n

  • fields.E003: pk é uma palavra reservada que não pode ser usada como nome de campo.

    • \n

  • fields.E004: choices deve ser um iterável (ex.:uma lista de tuplas).

    • \n

  • fields.E005: choices deve ser um iterável que retorne tuplas (actual value, human readable name).

    • \n

  • fields.E006: db_index deve ser None, True ou False.

    • \n

  • fields.E007: Chaves-primárias não devem ter null=True.

    • \n

  • fields.E100: AutoFields devem setar primary_key=True.

    • \n

  • fields.E110: BooleanFields não aceita valores nulos.

    • \n

  • fields.E120: CharFields deve definir um atributo max_length.

    • \n

  • fields.E121: max_length deve ser um inteiro positivo.

    • \n

  • fields.W122: max_length é ignorado quando usado com IntegerField.

    • \n

  • fields.E130: DecimalFields deve definir um atributo decimal_places.

    • \n

  • fields.E131: decimal_places deve ser um inteiro não negativo.

    • \n

  • fields.E132: DecimalFields deve ter um atributo max_digits.

    • \n

  • fields.E133: max_digits deve ser um inteiro não negativo.

    • \n

  • fields.E134: max_digits deve ser igual ou maior que decimal_places.

    • \n

  • fields.E140: FilePathFields deve ter allow_files ou allow_folders definidos como True.

    • \n

  • fields.E150: GenericIPAddressFields não podem aceitar valores em branco se valores nulos não são permitidos, uma vez que valores em branco são armazenados como nulos.

    • \n

  • fields.E160: As opções auto_now, auto_now_add, e default são mutualmente exclusivas. Somente uma destas opções deve estar presente.

    • \n

  • fields.W161: Fornecido um valor fixo padrão.

    • \n

  • fields.E900: IPAddressField foi removido exceto para suportar migrações históricas.

    • \n

  • fields.W900: IPAddressField está obsoleto. O suporte para este (exceto para histórico de migrações) será removido no Django 1.9. Esta verificação apareceu em Django 1.7 and 1.8.

    • \n
\n
\n
\n

Campos para arquivo.Link para este cabeçalho#

\n
    \n

  • fields.E200: unique não é um argumento válido para um FileField.

    • \n

  • fields.E201: primary_key não é um argumento válido para um FileField.

    • \n

  • fields.E210: Não é possível usar ImageField porque o Pillow não está instalado.

    • \n
\n
\n
\n

Campos relacionadosLink para este cabeçalho#

\n
    \n

  • fields.E300: Campo define uma relação com o modelo <model>, o qual ou não está instalado, ou é abstrato.

    • \n

  • fields.E301: Campo define uma relação com o modelo <model> o qual foi trocado.

    • \n

  • fields.E302: o método de acesso ao campo <field name> colide com o campo <field name>.

    • \n

  • fields.E303: O “reverse query name” para o campo <field name> colide com o campo <field name>.

    • \n

  • fields.E304: O nome do campo <field name> colide com o método de acesso a <field name>.

    • \n

  • fields.E305: Nome do campo <field name> colide com o “reverse query name” para <field name>.

    • \n

  • fields.E306: O nome relacionado deve ser um indentificador Python ou terminar com um '+'.

    • \n

  • fields.E310: Nenhum subconjunto dos campos <field1>, <field2>, … no modelo <model> é único. Adicione unique=True em qualquer um daqueles campos ou adicione pelo menos um subconjunto deles a uma regra de unique_together.

    • \n

  • fields.E311: <model> deve definir unique=True porque isso é referenciado por uma ForeignKey.

    • \n

  • fields.E320: Campo especifica on_delete=SET_NULL, mas não pode ser nulo.

    • \n

  • fields.E321: O campo especifíca on_delete=SET_DEFAULT, mas não tem um valor padrão.

    • \n

  • fields.E330: ManyToManyFields não pode ser único.

    • \n

  • fields.E331: O campo especifíca uma relação como muitos-para-muitos através do modelo <model>, o qual não foi instalado.

    • \n

  • fields.E332: Campos muitos-para-muitos com tabelas intermediárias não podem ser simétricas.

    • \n

  • fields.E333: O modelo é usado como um modelo intermediário pelo <model>, mas este tem mais de duas chaves estrangeiras para <model>, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento through_fields.

    • \n

  • fields.E334: O modelo é usado como um modelo intermediário pelo <model>, mas este tem mais de uma chave estrangeira para <model>, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento through_fields.

    • \n

  • fields.E335: O modelo é usado como um modelo intermediário pelo <model>, mas este tem mais de uma chave estrangeira para <model>, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento through_fields.

    • \n

  • fields.E336: O modelo é usado como um modelo intermediário pelo <model>, mas este não tem uma chave-estrangeira para <model> ou <model>.

    • \n

  • fields.E337: O campo especifíca through_fields mas não fornece os nomes dos dois campos de ligação que deve ser usados para a relação através do <model>.

    • \n

  • fields.E338: O modelo intermediário <through model> não tem o campo <field name>.

    • \n

  • fields.E339: <model>.<field name> não é uma chave estrangeira para <model>.

    • \n

  • fields.W340: null não tem efeito no ManyToManyField.

    • \n

  • fields.W341: ManyToManyField não dá suporte para validators.

    • \n

  • fields.W342: Definir unique=True para uma ForeignKey tem o mesmo efeito quanto usar um OneToOneField.

    • \n
\n
\n
\n

SignalsLink para este cabeçalho#

\n
    \n

  • signals.E001: <handler> estava conectado ao sinal <signal> com uma referência preguiçosa para o emissor <model>, o qual não foi instalado.

    • \n
\n
\n
\n

Comaptibilidades com versões anterioresLink para este cabeçalho#

\n

As seguintes verificações são executadas para alertar o usuário de qualquer problema potencial que possa ocorrer como resultado de uma atualização de versão.

\n
    \n

  • 1_6.W001: Alguns testes unitários do projeto podem não ser executados como esperado. Esta verificação foi removida do Django 1.8 devido a falsos positivos.

    • \n

  • 1_6.W002: BooleanField não tem um valor padrão. Esta verificação foi removida do Django 1.8 devido a falsos positivos.

    • \n

  • 1_7.W001: Django 1.7 mudou os valores padrão para as MIDDLEWARE_CLASSES. django.contrib.sessions.middleware.SessionMiddleware, django.contrib.auth.middleware.AuthenticationMiddleware, e django.contrib.messages.middleware.MessageMiddleware foram removidas dos valores padrão. Se seu projeto precisa dessas definições você deve configurar essa definição. Essa verificação foi removida no Django 1.9.

    • \n

  • 1_8.W001: A definição autônoma TEMPLATE_* está obsoleta no Django 1.8 e o dicionário TEMPLATES tem precedência. Você deve colocar os valores das seguintes definições nos seus valores padrão de TEMPLATES dict: TEMPLATE_DIRS, ALLOWED_INCLUDE_ROOTS, TEMPLATE_CONTEXT_PROCESSORS, TEMPLATE_DEBUG, TEMPLATE_LOADERS, TEMPLATE_STRING_IF_INVALID.

    • \n
\n
\n
\n
\n

AdminLink para este cabeçalho#

\n

Verificações do Admin são todas realizadas como parte da etiqueta admin.

\n

As seguintes verificações sào realizadas em qualquer ModelAdmin (ou subclasse) que está registrada com o site Admin:

\n\n
\n

ModelAdminLink para este cabeçalho#

\n

A verificações seguintes são realizadas para qualquer ModelAdmin que é registrada com site Admin:

\n
    \n

  • admin.E101: O valor de save_as deve ser um booleano.

    • \n

  • admin.E102: O valor de save_on_top deve ser um booleano.

    • \n

  • admin.E103: O valor de inlines deve ser uma lista de tuplas.

    • \n

  • admin.E104: <InlineModelAdmin class> deve herdar de BaseModelAdmin.

    • \n

  • admin.E105: <InlineModelAdmin class> deve ter um atributo model.

    • \n

  • admin.E106: O valor de <InlineModelAdmin class>.model deve ser um Model.

    • \n

  • admin.E107: O valor de list_display deve ser uma lista de tuplas.

    • \n

  • admin.E108: O valor de list_display[n] referencia a <label>, o qual não é um “callable”, um atributo de <ModelAdmin class>, ou um atributo ou método do <model>.

    • \n

  • admin.E109: O valor de list_display[n] não deve ser um ManyToManyField.

    • \n

  • admin.E110: O valor de list_display_links deve ser uma lista, uma tupla, ou None.

    • \n

  • admin.E111: O valor de list_display_links[n] referencia a <label>, o qual não é definido na list_display.

    • \n

  • admin.E112: O valor de list_filter deve ser uma lista de tuplas.

    • \n

  • admin.E113: O valor de list_filter[n] deve herdar de ListFilter.

    • \n

  • admin.E114: O valor de list_filter[n] não deve herdar de FieldListFilter.

    • \n

  • admin.E115: O valor de list_filter[n][1] deve herdar de FieldListFilter.

    • \n

  • admin.E116: O valor de list_filter[n] refere a <label>, o qual não refere a um campo.

    • \n

  • admin.E117: O valor de list_select_related deve ser um booleano, tuplas ou lista.

    • \n

  • admin.E118: O valor de list_per_page deve ser um inteiro.

    • \n

  • admin.E119: O valor de list_max_show_all deve ser um inteiro.

    • \n

  • admin.E120: O valor de list_editable deve ser uma lista de tuplas.

    • \n

  • admin.E121: O valor de list_editable[n] referencia a <label>, o qual não é um atributo de <model>.

    • \n

  • admin.E122: O valor de list_editable[n] refere a <label>, o qual não está contido em list_display.

    • \n

  • admin.E123: O valor de list_editable[n] não pode estar em ambos list_editable e list_display_links.

    • \n

  • admin.E124: O valor de list_editable[n] refere ao primeiro campo em list_display (<label>), o qual não pode ser usado a menos que list_display_links seja definido.

    • \n

  • admin.E125: O valor de list_editable[n] refere a <field name>, o qual não é editável através do admin.

    • \n

  • admin.E126: O valor de search_fields deve ser uma lista de tuplas.

    • \n

  • admin.E127: O valor de date_hierarchy referencia a <field name>, o qual não é um atributo de <model>.

    • \n

  • admin.E128: O valor de date_hierarchy deve ser um DateField ou DateTimeField.

    • \n
\n
\n
\n

InlineModelAdminLink para este cabeçalho#

\n

As verificações seguintes são realizadas em qualquer InlineModelAdmin que esteja registrado como uma “inline” na ModelAdmin.

\n
    \n

  • admin.E201: Não pode excluir o campo <field name>, porque ele é a chave-estrangeira para o modelo <app_label>.<model>.

    • \n

  • admin.E202: <model> não tem ForeignKey para <parent model>./ <model> tem mais de um ForeignKey para <parent model>.

    • \n

  • admin.E203: O valor de extra deve ser um inteiro.

    • \n

  • admin.E204: O valor de max_num deve ser um inteiro.

    • \n

  • admin.E205: O valor de min_num deve ser um inteiro.

    • \n

  • admin.E206: O valor de formset deve herdar de BaseModelFormSet.

    • \n
\n
\n
\n

GenericInlineModelAdminLink para este cabeçalho#

\n

As seguintes verificações são realizadas sobre qualquer GenericInlineModelAdmin que esteja registrado como “inline” no ModelAdmin.

\n
    \n

  • admin.E301: 'ct_field' referencia a <label>, o qual não é um campo no <model>.

    • \n

  • admin.E302: 'ct_fk_field' referencia <label>, o qual não é um campo no <model>.

    • \n

  • admin.E303: <model> não tem GenericForeignKey.

    • \n

  • admin.E304: <model> não tem GenericForeignKey usando o campo de tipo de conteúdo <field name> e um campo de ID do objeto <field name>.

    • \n
\n
\n
\n
\n

AutenticaçãoLink para este cabeçalho#

\n\n
\n
\n

Tipos de ConteúdoLink para este cabeçalho#

\n

As verificação seguintes são realizadas quando um modelo contém um GenericForeignKey ou GenericRelation:

\n\n
\n
\n

SegurançaLink para este cabeçalho#

\n

As verificações de segurança, não tornam o seu site seguro. Elas não auditam código, não fazem detecção de intrusos ou nada complexo. Ao invés disso, elas ajudam a realizar uma verificação automática dos “frutos mais fáceis de colher”. Elas ajudam a lembrar de coisas simples que melhoram a segurança do seu site.

\n

Algumas dessas verificações talvez não sejam apropriadas para uma configuração de implantação particular. Por exemlo, se você faz redirecionamento do HTTP para HTTPS em um balanceador de carga, isso pode ser irritante de ser constantemente alertado sobre não ter habilitado o SECURE_SSL_REDIRECT. Use o SILENCED_SYSTEM_CHECKS para silenciar verificações desnecessárias.

\n

As seguintes verificações são executadas se você usa a opção check --deploy:

\n\n
\n
\n

SitesLink para este cabeçalho#

\n

As verificações seguintes são realizadas em qualquer modelo usando uma CurrentSiteManager:

\n\n
\n
\n

Banco de dadosLink para este cabeçalho#

\n
\n

MySQLLink para este cabeçalho#

\n

Se você estiver usando MySQL, as seguintes verificações são realizadas:

\n
    \n

  • mysql.E001: MySQL não permite o CharFields único ter max_length > 255.

    • \n
\n
\n
\n
\n

TemplatesLink para este cabeçalho#

\n

As verificações seguintes averiguam se sua definição de TEMPLATES está corretamente configurada.

\n\n
\n
\n

CachesLink para este cabeçalho#

\n

As verificações seguintes averiguam se seu CACHES está configurado corretamente:

\n\n
\n
\n

URLsLink para este cabeçalho#

\n

As verificações seguintes são realizadas na sua configuração de URL:

\n\n
\n
","rootId":"system-check-framework","toc":[{"title":"Referência da API","anchor":"api-reference","children":[{"title":"CheckMessage","anchor":"checkmessage","children":[]}]},{"title":"Verificações embutidas","anchor":"builtin-checks","children":[{"title":"Tags embutidas","anchor":"builtin-tags","children":[]},{"title":"Verificações do núcleo do sistema","anchor":"core-system-checks","children":[{"title":"Models","anchor":"models","children":[]},{"title":"Campos","anchor":"fields","children":[]},{"title":"Campos para arquivo.","anchor":"file-fields","children":[]},{"title":"Campos relacionados","anchor":"related-fields","children":[]},{"title":"Signals","anchor":"signals","children":[]},{"title":"Comaptibilidades com versões anteriores","anchor":"backwards-compatibility","children":[]}]},{"title":"Admin","anchor":"admin","children":[{"title":"ModelAdmin","anchor":"modeladmin","children":[]},{"title":"InlineModelAdmin","anchor":"inlinemodeladmin","children":[]},{"title":"GenericInlineModelAdmin","anchor":"genericinlinemodeladmin","children":[]}]},{"title":"Autenticação","anchor":"auth","children":[]},{"title":"Tipos de Conteúdo","anchor":"content-types","children":[]},{"title":"Segurança","anchor":"security","children":[]},{"title":"Sites","anchor":"sites","children":[]},{"title":"Banco de dados","anchor":"database","children":[{"title":"MySQL","anchor":"mysql","children":[]}]},{"title":"Templates","anchor":"templates","children":[]},{"title":"Caches","anchor":"caches","children":[]},{"title":"URLs","anchor":"urls","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Referência da API","url":"/pt-br/1.9/ref/"}],"prev":{"docname":"ref/applications","title":"Aplicações","url":"/pt-br/1.9/ref/applications/"},"next":{"docname":"ref/class-based-views/index","title":"API nativa de views baseadas em classes","url":"/pt-br/1.9/ref/class-based-views/"},"formats":{"html":"/pt-br/1.9/ref/checks/","markdown":"/pt-br/1.9/ref/checks.md","json":"/pt-br/1.9/ref/checks.json"},"source":"https://github.com/django/django/blob/stable/1.9.x/docs/ref/checks.txt","official":"https://docs.djangoproject.com/pt-br/1.9/ref/checks/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","fr","ja","id","pt-br","es"]}