Guides Ruby on Rails

Commencez ici

Commencer avec Rails: Tout ce que vous devez savoir pour installer Rails et créer votre première application.

Modèles

Principes de base d'Active Record: Active Record permet à vos modèles d'interagir avec la base de données de l'application. Ce guide vous aidera à démarrer avec les modèles Active Record et la persistance vers la base de données.
Migrations Active Record: Les migrations sont une fonctionnalité d'Active Record qui vous permet d'évoluer votre schéma de base de données au fil du temps. Au lieu d'écrire des modifications de schéma en SQL pur, les migrations vous permettent d'utiliser un DSL Ruby pour décrire les changements apportés à vos tables.
Validations Active Record: Les validations sont utilisées pour garantir que seules des données valides sont enregistrées dans votre base de données. Ce guide vous apprend comment valider l'état des objets avant qu'ils ne soient enregistrés dans la base de données, en utilisant la fonctionnalité de validations d'Active Record.
Callbacks Active Record: Les rappels permettent d'écrire du code qui s'exécutera chaque fois qu'un objet est créé, mis à jour, détruit, etc. Ce guide vous apprend comment vous connecter à ce cycle de vie des objets Active Record.
Associations Active Record: Dans Active Record, une association est une connexion entre deux modèles Active Record. Ce guide couvre toutes les associations fournies par Active Record.
Interface de requête Active Record: Au lieu d'utiliser du SQL brut pour trouver des enregistrements de base de données, Active Record propose de meilleures façons d'effectuer les mêmes opérations. Ce guide couvre différentes façons de récupérer des données de la base de données en utilisant Active Record.
Principes de base d'Active Model: Active Model vous permet de créer des objets Ruby simples qui s'intègrent avec Action Pack, mais qui n'ont pas besoin d'Active Record pour la persistance en base de données. Active Model aide également à construire des ORM personnalisés pour une utilisation en dehors du framework Rails. Ce guide vous fournit tout ce dont vous avez besoin pour commencer à utiliser les classes Active Model.

Vues

Aperçu d'Action View: Action View est responsable de la génération du HTML pour les réponses web. Ce guide fournit une introduction à Action View.
Mises en page et rendu dans Rails: Ce guide couvre les fonctionnalités de base de Action Controller et Action View, y compris le rendu et la redirection, l'utilisation des blocs content_for et le travail avec les partiels.
Aide aux vues d'action: Action View dispose de helpers pour gérer tout, de la mise en forme des dates et des liens vers les images, à la désinfection et à la localisation du contenu. Ce guide présente quelques-uns des helpers Action View les plus courants.
Action View Form Helpers: Les formulaires HTML peuvent rapidement devenir fastidieux à écrire et à maintenir en raison de la nécessité de gérer les noms des contrôles de formulaire et leurs nombreux attributs. Rails simplifie cela en fournissant des assistants de vue pour générer le balisage du formulaire.

Contrôleurs

Aperçu du contrôleur d'action: Les contrôleurs d'actions sont au cœur d'une requête web dans Rails. Ce guide explique comment les contrôleurs fonctionnent et comment ils s'intègrent dans le cycle de traitement des requêtes de votre application. Il aborde les sessions, les filtres, les cookies, le streaming de données et la gestion des exceptions soulevées par une requête, entre autres sujets.
Rails Routing de l'extérieur vers l'intérieur: Le routeur Rails reconnaît les URL et les envoie vers une action du contrôleur. Ce guide couvre les fonctionnalités de routage de Rails destinées aux utilisateurs. Si vous souhaitez comprendre comment utiliser le routage dans vos propres applications Rails, commencez ici.

Autres composants

Extensions de base d'Active Support: Active Support fournit des extensions et des utilitaires pour le langage Ruby. Il enrichit le langage Ruby pour le développement d'applications Rails, ainsi que pour le développement de Ruby on Rails lui-même.
Action Mailer Basics: Ce guide vous fournit tout ce dont vous avez besoin pour commencer à envoyer des e-mails depuis votre application, ainsi que de nombreux détails internes sur Action Mailer.
Action Mailbox Basics: Ce guide décrit comment utiliser Action Mailbox pour recevoir des emails.
Aperçu d'Action Text: Ce guide décrit comment utiliser Action Text pour gérer du contenu enrichi en texte.
Principes de base d'Active Job: Active Job est un framework pour déclarer des tâches en arrière-plan et les exécuter sur une variété de backends de file d'attente. Ce guide vous fournit tout ce dont vous avez besoin pour commencer à créer, mettre en file d'attente et exécuter des tâches en arrière-plan.
Aperçu d'Active Storage: Active Storage facilite le téléchargement de fichiers vers un service de stockage en nuage, la transformation des téléchargements et l'extraction de métadonnées. Ce guide explique comment attacher des fichiers à vos modèles Active Record.
Aperçu d'Action Cable: Action Cable intègre les WebSockets avec le reste de votre application Rails. Il permet d'écrire des fonctionnalités en temps réel en Ruby, dans le même style et la même forme que le reste de votre application Rails. Ce guide explique comment Action Cable fonctionne et comment utiliser les WebSockets pour créer des fonctionnalités en temps réel.
Webpacker: Ce guide vous montrera comment installer et utiliser Webpacker pour regrouper JavaScript, CSS et autres ressources pour le côté client de votre application Rails.

Creuser plus profondément

API d'internationalisation de Rails (I18n): Ce guide explique comment ajouter l'internationalisation à vos applications. Votre application sera capable de traduire le contenu dans différentes langues, de modifier les règles de pluriel, d'utiliser les formats de date corrects pour chaque pays, et ainsi de suite.
Tester les applications Rails: Ceci est un guide assez complet sur les différentes installations de test dans Rails. Il couvre tout, de "Qu'est-ce qu'un test ?" aux tests d'intégration. Profitez-en.
Sécuriser les applications Rails: Ce guide décrit les problèmes de sécurité courants dans les applications web et comment les éviter avec Rails.
Rapports d'erreurs dans les applications Rails: Ce guide présente des façons de gérer les exceptions qui se produisent dans les applications Ruby on Rails.
Débogage des applications Rails: Ce guide décrit comment déboguer les applications Rails. Il couvre les différentes façons d'y parvenir et comment comprendre ce qui se passe "en coulisses" de votre code.
Configuration des applications Rails: Ce guide couvre les paramètres de configuration de base pour une application Rails.
La ligne de commande Rails: Il existe quelques commandes absolument essentielles pour votre utilisation quotidienne de Rails. Ce guide couvre les outils en ligne de commande fournis par Rails.
Le pipeline d'actifs: Le pipeline d'actifs fournit un cadre pour concaténer et compresser ou réduire la taille des actifs JavaScript, CSS et images. Il ajoute également la possibilité d'écrire ces actifs dans d'autres langages et préprocesseurs tels que CoffeeScript, Sass et ERB.
Travailler avec JavaScript dans Rails: Ce guide explique comment utiliser les import maps ou jsbundling-rails pour inclure du JavaScript dans les applications Rails, et couvre les bases de l'utilisation de Turbo dans Rails.
Le processus d'initialisation de Rails: Ce guide explique les détails internes du processus d'initialisation dans Rails. C'est un guide extrêmement approfondi et recommandé pour les développeurs Rails avancés.
Chargement automatique et rechargement des constantes: Ce guide documente le fonctionnement du chargement automatique et du rechargement des constantes (mode Zeitwerk).
Guide classique vers Zeitwerk HOWTO: Ce guide documente comment migrer les applications Rails du mode `classic` au mode `zeitwerk`.
Mise en cache avec Rails : Aperçu: Ce guide est une introduction à l'accélération de votre application Rails grâce à la mise en cache.
Instrumentation Active Support: Ce guide explique comment utiliser l'API d'instrumentation à l'intérieur d'Active Support pour mesurer les événements à l'intérieur de Rails et d'autres codes Ruby.
Utilisation de Rails pour les applications API-only: Ce guide explique comment utiliser efficacement Rails pour développer une application JSON API.
Active Record et PostgreSQL: Ce guide couvre l'utilisation spécifique de PostgreSQL avec Active Record.
Multiples bases de données avec Active Record: Ce guide couvre l'utilisation de plusieurs bases de données dans votre application.
Chiffrement d'Active Record: Ce guide couvre le chiffrement de vos informations de base de données en utilisant Active Record.

Extension de Rails

Les bases de la création de plugins Rails: Ce guide explique comment créer un plugin pour étendre les fonctionnalités de Rails.
Rails sur Rack: Ce guide couvre l'intégration de Rails avec Rack et l'interface avec d'autres composants Rack.
Création et personnalisation des générateurs et des modèles Rails: Ce guide couvre le processus d'ajout d'un tout nouveau générateur à votre extension ou de fournir une alternative à un élément d'un générateur intégré à Rails (comme fournir des stubs de test alternatifs pour le générateur de scaffold).
Commencer avec les moteurs: Les moteurs peuvent être considérés comme des applications miniatures qui fournissent des fonctionnalités supplémentaires à leurs applications hôtes. Dans ce guide, vous apprendrez comment créer votre propre moteur et l'intégrer à une application hôte.
Modèles d'application Rails: Les modèles d'application sont des fichiers Ruby simples contenant un DSL (Domain Specific Language) pour ajouter des gems, des initializers, etc. à votre projet Rails nouvellement créé ou à un projet Rails existant.
Threading et exécution de code dans Rails: Ce guide décrit les considérations nécessaires et les outils disponibles lors de la manipulation directe de la concurrence dans une application Rails.

Contribuer

Contribuer à Ruby on Rails: Rails n'est pas "le framework de quelqu'un d'autre". Ce guide couvre différentes façons dont vous pouvez vous impliquer dans le développement continu de Rails.
Directives de documentation de l'API: Ce guide documente les directives de documentation de l'API Ruby on Rails.
Directives de Ruby on Rails Guides: Ce guide documente les directives des guides Ruby on Rails.
Installation des dépendances de développement de Rails Core: Ce guide explique comment configurer un environnement pour le développement central de Ruby on Rails.

Politiques

Politique de maintenance pour Ruby on Rails: Quelles versions de Ruby on Rails sont actuellement prises en charge et quand peut-on s'attendre à de nouvelles versions ?

Notes de version

Mise à niveau de Ruby on Rails: Ce guide fournit les étapes à suivre lorsque vous mettez à jour vos applications vers une version plus récente de Ruby on Rails.
Notes de version de Ruby on Rails 7.1: Notes de version pour Rails 7.1.
Notes de version de Ruby on Rails 7.0: Notes de version pour Rails 7.0.
Notes de version de Ruby on Rails 6.1: Notes de version pour Rails 6.1.
Ruby on Rails 6.0 Notes de version: Notes de version pour Rails 6.0.
Notes de version de Ruby on Rails 5.2: Notes de version pour Rails 5.2.
Notes de version de Ruby on Rails 5.1: Notes de version pour Rails 5.1.
Notes de version de Ruby on Rails 5.0: Notes de version pour Rails 5.0.
Ruby on Rails 4.2 Notes de version: Notes de version pour Rails 4.2.
Ruby on Rails 4.1 Notes de version: Notes de version pour Rails 4.1.
Ruby on Rails 4.0 Notes de version: Notes de version pour Rails 4.0.
Notes de version de Ruby on Rails 3.2: Notes de mise à jour pour Rails 3.2.
Ruby on Rails 3.1 Notes de version: Notes de version pour Rails 3.1.
Ruby on Rails 3.0 Notes de version: Notes de version pour Rails 3.0.
Ruby on Rails 2.3 Notes de version: Notes de version pour Rails 2.3.
Ruby on Rails 2.2 Notes de version: Notes de version pour Rails 2.2.

Retour d'information

Vous êtes encouragé à contribuer à l'amélioration de la qualité de ce guide.

Veuillez contribuer si vous trouvez des fautes de frappe ou des erreurs factuelles. Pour commencer, vous pouvez lire notre contribution à la documentation section.

Vous pouvez également trouver du contenu incomplet ou des informations qui ne sont pas à jour. Veuillez ajouter toute documentation manquante pour la version principale. Assurez-vous de vérifier Edge Guides d'abord pour vérifier si les problèmes ont déjà été résolus ou non sur la branche principale. Consultez les Directives des guides Ruby on Rails pour le style et les conventions.

Si pour une raison quelconque vous repérez quelque chose à corriger mais ne pouvez pas le faire vous-même, veuillez ouvrir un problème.

Et enfin, toute discussion concernant la documentation de Ruby on Rails est la bienvenue sur le Forum officiel de Ruby on Rails.

Guides Ruby on Rails (75b9e4f)