Guias do Ruby on Rails

Comece aqui

Começando com o Rails: Tudo o que você precisa saber para instalar o Rails e criar sua primeira aplicação.

Modelos

Noções básicas do Active Record: Active Record permite que seus modelos interajam com o banco de dados da aplicação. Este guia irá te ajudar a começar com modelos Active Record e persistência no banco de dados.
Migrações do Active Record: As migrações são uma funcionalidade do Active Record que permite evoluir o esquema do seu banco de dados ao longo do tempo. Em vez de escrever modificações de esquema em SQL puro, as migrações permitem que você use uma DSL Ruby para descrever as alterações em suas tabelas.
Validações do Active Record: As validações são usadas para garantir que apenas dados válidos sejam salvos em seu banco de dados. Este guia ensina como validar o estado dos objetos antes de serem inseridos no banco de dados, usando o recurso de validações do Active Record.
Callbacks do Active Record: Callbacks tornam possível escrever código que será executado sempre que um objeto for criado, atualizado, destruído, etc. Este guia ensina como se conectar a esse ciclo de vida do objeto de objetos Active Record.
Associações do Active Record: No Active Record, uma associação é uma conexão entre dois modelos Active Record. Este guia abrange todas as associações fornecidas pelo Active Record.
Interface de Consulta do Active Record: Em vez de usar SQL bruto para encontrar registros de banco de dados, o Active Record fornece maneiras melhores de realizar as mesmas operações. Este guia aborda diferentes maneiras de recuperar dados do banco de dados usando o Active Record.
Noções básicas do Active Model: Active Model permite que você crie objetos Ruby simples que se integram com o Action Pack, mas não precisam do Active Record para persistência no banco de dados. Active Model também ajuda a construir ORMs personalizados para uso fora do framework Rails. Este guia fornece tudo o que você precisa para começar a usar classes Active Model.

Visualizações

Visão Geral do Action View: Action View é responsável por gerar o HTML para respostas web. Este guia fornece uma introdução ao Action View.
Layouts e Renderização no Rails: Este guia abrange os recursos básicos de layout do Action Controller e Action View, incluindo renderização e redirecionamento, uso de blocos content_for e trabalho com parciais.
Helpers de Visualização de Ação: O Action View possui helpers para lidar com tudo, desde a formatação de datas e a criação de links para imagens, até a sanitização e localização de conteúdo. Este guia apresenta alguns dos helpers mais comuns do Action View.
Action View Form Helpers: Os formulários HTML podem se tornar rapidamente tediosos de escrever e manter devido à necessidade de lidar com a nomenclatura dos controles do formulário e seus inúmeros atributos. O Rails elimina essa complexidade fornecendo ajudantes de visualização para gerar a marcação do formulário.

Controladores

Visão Geral do Action Controller: Os Controladores de Ação são o núcleo de uma solicitação web no Rails. Este guia aborda como os controladores funcionam e como eles se encaixam no ciclo de solicitação da sua aplicação. Ele inclui sessões, filtros, cookies, streaming de dados e lidar com exceções geradas por uma solicitação, entre outros tópicos.
Roteamento do Rails de fora para dentro: O roteador do Rails reconhece URLs e as envia para uma ação do controlador. Este guia aborda as funcionalidades voltadas para o usuário do roteamento do Rails. Se você deseja entender como usar o roteamento em suas próprias aplicações Rails, comece por aqui.

Outros componentes

Extensões Principais do Active Support: Active Support fornece extensões e utilitários para a linguagem Ruby. Ele enriquece a linguagem Ruby para o desenvolvimento de aplicações Rails e para o desenvolvimento do próprio Ruby on Rails.
Noções básicas do Action Mailer: Este guia fornece tudo o que você precisa para começar a enviar e-mails a partir do seu aplicativo, e muitos detalhes internos do Action Mailer.
Noções básicas do Action Mailbox: Este guia descreve como usar o Action Mailbox para receber emails.
Visão geral do Action Text: Este guia descreve como usar o Action Text para lidar com conteúdo de texto rico.
Noções básicas do Active Job: Active Job é um framework para declarar trabalhos em segundo plano e fazê-los rodar em uma variedade de backends de fila. Este guia fornece tudo o que você precisa para começar a criar, enfileirar e executar trabalhos em segundo plano.
Visão geral do Active Storage: O Active Storage facilita o upload de arquivos para um serviço de armazenamento em nuvem, transformando uploads e extraindo metadados. Este guia aborda como anexar arquivos aos seus modelos Active Record.
Visão geral do Action Cable: Action Cable integra WebSockets com o restante da sua aplicação Rails. Ele permite que recursos em tempo real sejam escritos em Ruby no mesmo estilo e formato que o restante da sua aplicação Rails. Este guia explica como o Action Cable funciona e como usar WebSockets para criar recursos em tempo real.
Webpacker: Este guia irá mostrar como instalar e usar o Webpacker para empacotar JavaScript, CSS e outros recursos para o lado do cliente da sua aplicação Rails.

Aprofundando-se mais

API de Internacionalização (I18n) do Rails: Este guia aborda como adicionar internacionalização às suas aplicações. Sua aplicação será capaz de traduzir conteúdo para diferentes idiomas, alterar regras de pluralização, usar formatos de data corretos para cada país, e assim por diante.
Testando Aplicações Rails: Este é um guia bastante abrangente sobre os vários recursos de teste no Rails. Ele abrange tudo, desde 'O que é um teste?' até Testes de Integração. Aproveite.
Segurança de Aplicações Rails: Este guia descreve problemas comuns de segurança em aplicações web e como evitá-los com o Rails.
Relatório de Erros em Aplicações Rails: Este guia apresenta maneiras de gerenciar exceções que ocorrem em aplicações Ruby on Rails.
Depurando Aplicações Rails: Este guia descreve como depurar aplicações Rails. Ele abrange as diferentes maneiras de fazer isso e como entender o que está acontecendo "nos bastidores" do seu código.
Configurando Aplicações Rails: Este guia abrange as configurações básicas de configuração para uma aplicação Rails.
A Linha de Comando do Rails: Existem alguns comandos que são absolutamente essenciais para o uso diário do Rails. Este guia abrange as ferramentas de linha de comando fornecidas pelo Rails.
O Pipeline de Ativos: O pipeline de ativos fornece uma estrutura para concatenar e minificar ou compactar ativos JavaScript, CSS e imagens. Ele também adiciona a capacidade de escrever esses ativos em outros idiomas e pré-processadores, como CoffeeScript, Sass e ERB.
Trabalhando com JavaScript no Rails: Este guia explica como usar import maps ou jsbundling-rails para incluir JavaScript em aplicações Rails, e aborda os conceitos básicos de trabalhar com Turbo no Rails.
O Processo de Inicialização do Rails: Este guia explica os detalhes internos do processo de inicialização no Rails. É um guia extremamente detalhado e recomendado para desenvolvedores avançados do Rails.
Autoloading e Recarregamento de Constantes: Este guia documenta como o carregamento automático e o recarregamento de constantes funcionam (modo Zeitwerk).
Guia de migração do modo "classic" para o modo "zeitwerk": Este guia documenta como migrar aplicações Rails do modo `classic` para o modo `zeitwerk`.
Caching com Rails: Uma Visão Geral: Este guia é uma introdução para acelerar sua aplicação Rails com cache.
Instrumentação do Active Support: Este guia explica como usar a API de instrumentação dentro do Active Support para medir eventos dentro do Rails e outros códigos Ruby.
Usando Rails para Aplicações Apenas de API: Este guia explica como usar o Rails de forma eficaz para desenvolver uma aplicação de API JSON.
Active Record e PostgreSQL: Este guia aborda o uso específico do PostgreSQL com o Active Record.
Múltiplos Bancos de Dados com Active Record: Este guia aborda o uso de múltiplos bancos de dados em sua aplicação.
Criptografia do Active Record: Este guia aborda a criptografia das informações do seu banco de dados usando o Active Record.

Estendendo o Rails

Os Conceitos Básicos de Criação de Plugins Rails: Este guia aborda como construir um plugin para estender a funcionalidade do Rails.
Rails no Rack: Este guia aborda a integração do Rails com o Rack e a interface com outros componentes do Rack.
Criando e Personalizando Geradores e Modelos Rails: Este guia aborda o processo de adicionar um novo gerador à sua extensão ou fornecer uma alternativa a um elemento de um gerador embutido do Rails (como fornecer stubs de teste alternativos para o gerador de scaffold).
Introdução aos Engines: Motores podem ser considerados aplicativos em miniatura que fornecem funcionalidades adicionais às suas aplicações hospedeiras. Neste guia, você aprenderá como criar seu próprio motor e integrá-lo a uma aplicação hospedeira.
Modelos de Aplicativos Rails: Os modelos de aplicação são arquivos Ruby simples contendo DSL para adicionar gems, inicializadores, etc. ao seu projeto Rails recém-criado ou a um projeto Rails existente.
Threading e Execução de Código no Rails: Este guia descreve as considerações necessárias e as ferramentas disponíveis ao trabalhar diretamente com concorrência em uma aplicação Rails.

Contribuindo

Contribuindo para o Ruby on Rails: Rails não é "o framework de outra pessoa". Este guia abrange uma variedade de maneiras pelas quais você pode se envolver no desenvolvimento contínuo do Rails.
Diretrizes de Documentação de API: Este guia documenta as diretrizes de documentação da API do Ruby on Rails.
Diretrizes do Guia Ruby on Rails: Este guia documenta as diretrizes dos guias do Ruby on Rails.
Instalando as Dependências Principais de Desenvolvimento do Rails: Este guia aborda como configurar um ambiente para o desenvolvimento central do Ruby on Rails.

Políticas

Política de Manutenção para Ruby on Rails: Quais versões do Ruby on Rails estão atualmente suportadas e quando esperar novas versões.

Notas de Lançamento

Atualizando o Ruby on Rails: Este guia fornece os passos a serem seguidos ao atualizar suas aplicações para uma versão mais recente do Ruby on Rails.
Ruby on Rails 7.1 Notas de Lançamento: Notas de lançamento para o Rails 7.1.
Ruby on Rails 7.0 Notas de Lançamento: Notas de lançamento para o Rails 7.0.
Notas de Lançamento do Ruby on Rails 6.1: Notas de lançamento para o Rails 6.1.
Notas de lançamento do Ruby on Rails 6.0: Notas de lançamento para o Rails 6.0.
Notas de lançamento do Ruby on Rails 5.2: Notas de lançamento para o Rails 5.2.
Notas de lançamento do Ruby on Rails 5.1: Notas de lançamento para o Rails 5.1.
Ruby on Rails 5.0 Notas de Lançamento: Notas de lançamento para o Rails 5.0.
Ruby on Rails 4.2 Notas de Lançamento: Notas de lançamento para o Rails 4.2.
Ruby on Rails 4.1 Notas de Lançamento: Notas de lançamento para o Rails 4.1.
Ruby on Rails 4.0 Notas de Lançamento: Notas de lançamento para o Rails 4.0.
Ruby on Rails 3.2 Notas de Lançamento: Notas de lançamento para Rails 3.2.
Ruby on Rails 3.1 Notas de Lançamento: Notas de lançamento para o Rails 3.1.
Notas de lançamento do Ruby on Rails 3.0: Notas de lançamento para o Rails 3.0.
Ruby on Rails 2.3 Notas de Lançamento: Notas de lançamento para o Rails 2.3.
Ruby on Rails 2.2 Notas de Lançamento: Notas de lançamento para o Rails 2.2.

Feedback

Você é incentivado a ajudar a melhorar a qualidade deste guia.

Por favor, contribua se encontrar algum erro de digitação ou factual. Para começar, você pode ler nossa contribuição à documentação seção.

Você também pode encontrar conteúdo incompleto ou desatualizado. Por favor, adicione qualquer documentação ausente para o principal. Certifique-se de verificar Guias Edge primeiro para verificar se os problemas já foram corrigidos ou não no branch principal. Verifique as Diretrizes dos Guias do Ruby on Rails para estilo e convenções.

Se por algum motivo você encontrar algo para corrigir, mas não puder corrigi-lo você mesmo, por favor abra uma issue.

E por último, mas não menos importante, qualquer tipo de discussão sobre a documentação do Ruby on Rails é muito bem-vinda no Fórum oficial do Ruby on Rails.

Guias do Ruby on Rails (75b9e4f)