Tutoriel Ruby on Rails

Rails a été créé par David Heinemeier Hansson, plus connu sous le nom de DHH. C'est l'un des outils les plus influents et les plus populaires pour le développement d'applications web. Il est utilisé par des sites majeurs tels qu'Airbnb, GitHub et Shopify.

Pourquoi rails ?

Avant d'installer la chaîne d'outils, il est utile de comprendre pourquoi Rails reste un choix populaire pour le développement de navires.ping Applications web rapidement.

• Rails est distribué sous forme de gem Ruby, et vous pouvez l'utiliser pour créer une grande variété d'applications.
• Il vous permet de créer des applications web classiques, des sites de commerce électronique, des systèmes de gestion de contenu, et bien plus encore.
• Rails est un framework complet qui inclut tout ce dont vous avez besoin pour créer une application web pilotée par une base de données en utilisant le modèle Modèle-Vue-Contrôleur (MVC).
• Toutes les couches sont conçues pour fonctionner ensemble de manière transparente, de sorte que les projets Rails nécessitent généralement moins de lignes de code que les projets équivalents dans d'autres frameworks.

Comment télécharger et installer Ruby sur Windows

Le processus d'installation dépend de votre système d'exploitation. Les sections suivantes expliquent comment installer Ruby on Windows, Mac et Linux.

Étape 1) Téléchargez RubyInstaller.
Le moyen le plus simple d'installer Ruby sur votre Windows L'ordinateur est accessible via Ruby Installer, disponible à l'adresse suivante : https://rubyinstaller.org/.

Une fois le téléchargement terminé, exécutez le programme d'installation.

Étape 2) Cliquez sur le fichier d'installation téléchargé.
Double-cliquez sur le fichier d'installation téléchargé, par exemple rubyinstaller-2.4.1-2-x64.exe.

Étape 3) Acceptez la licence.
Sélectionnez l’option « J’accepte le permis » et cliquez sur « Suivant ». L’écran ci-dessous devrait s’afficher.

Étape 4) Cochez les deux premières cases.
Cochez les deux premières cases pour faciliter l'exécution des scripts Ruby.

Cliquez sur le bouton « Installer » pour lancer l’installation. L’écran ci-dessous devrait s’afficher une fois l’installation terminée.

Étape 5) Cliquez sur Terminer.
Ne décochez pas l'option d'installation de MSYS2. Cliquez sur « Terminer » pour achever l'installation. Une fenêtre d'invite de commandes s'ouvre, comme illustré ci-dessous.

Étape 6) Installez MSYS2.
Cette étape installe MSYS2, une plateforme de compilation dotée d'un gestionnaire de paquets facilitant l'installation de paquets sur Windows.

Appuyez sur Entrée pour installer tous les composants, car ils sont tous nécessaires au bon fonctionnement de l'environnement de développement Ruby on Rails. Windows.

Installation des rails

Vous devriez avoir installé Ruby comme indiqué dans la section précédente. Ensuite, installez Rails. Vous pouvez installer Rails à l'aide d'un package disponible sur [lien manquant]. RailsInstallateurmais le paquet ne contient souvent pas la dernière version de toutes les dépendances requises.

Si vous avez déjà installé la dernière version de Ruby ainsi que les RubyGems et extensions de base, il vous suffit d'exécuter la commande suivante dans l'invite de commandes pour installer Rails sur votre système : gem install rails.

Vous devrez également installer Node.js si vous ne l'avez pas déjà, car certaines bibliothèques dont Rails dépend nécessitent un JavaL'environnement d'exécution du script doit fonctionner correctement. Téléchargez Node à l'adresse suivante : https://nodejs.org.

Une approche plus courante et préférée sur Windows est d'utiliser le Windows Sous-système pour Linux. Il fournit un environnement GNU/Linux avec des outils en ligne de commande, des utilitaires et des applications courantes directement intégrés. Windows.

Installer Ruby sur Mac

Ruby est déjà préinstallé sur votre Mac. Cependant, la version préinstallée est souvent obsolète ; il est donc conseillé d’installer une version plus récente.

La méthode la plus simple consiste à utiliser un gestionnaire de paquets tel que HomebrewVous devrez peut-être d'abord installer Homebrew en exécutant la commande ci-dessous dans le Terminal.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Un avertissement s'affiche et vous invite à saisir votre mot de passe. Saisissez votre mot de passe Mac (les caractères ne s'affichent pas pendant la saisie) et appuyez sur Entrée. Exécutez ensuite cette commande Homebrew pour installer Ruby sur votre Mac.

brew install ruby

Exécutez ensuite cette commande :

echo 'export PATH="/usr/local/bin:/usr/local/sbin:$PATH"' >> ~/.bash_profile

Cela configure la nouvelle installation de Ruby comme version par défaut de Ruby sur votre système, au lieu de la version préinstallée.

Pour vérifier que l'installation a réussi, exécutez la commande suivante dans le Terminal :

ruby --version

Ceci affiche le numéro de version de Ruby installé. Le résultat ressemble à ceci :

ruby 2.6.0p0 (2018-12-25 revision 66547) [x86_64-darwin18]

Installer Ruby sur Ubuntu (Linux)

La méthode la plus simple pour installer Ruby sur Ubuntu L'installation se fait via le gestionnaire de paquets apt. Exécutez les commandes suivantes dans le Terminal pour installer la dernière version de Ruby depuis le dépôt. Ubuntu référentiels.

• mise à jour de sudo apt – Ceci met à jour la valeur par défaut Ubuntu référentiels.
• sudo apt install ruby-full – Ceci télécharge et installe la dernière version de Ruby.

Pour confirmer l'installation, exécutez ruby –versionCeci affiche la version de Ruby que vous avez installée.

Installation de rails sur Ubuntu (Linux)

Suivez les étapes ci-dessous pour installer Rails sur votre machine Linux.

Étape 1) Mettez à jour votre gestionnaire de gemmes en exécutant la commande suivante : mise à jour des gemmes –système dans le terminal ou l'invite de commandes.

Étape 2) Courir Gem installer des rails pour installer la dernière version de Rails sur votre ordinateur.

Étape 3) Installez la gem Bundler pour une gestion simplifiée des dépendances des gems dans votre application Rails. Exécutez-la. bundler d'installation de gem.

Deux principes des rails

Rails suit les principes de conception logicielle de base et vous encourage à les utiliser également.

Les deux plus courants sont :

• Ne vous répétez pas (DRY) – ce qui permet d'obtenir un code concis, cohérent et facile à maintenir.
• Convention sur la configuration Rails est préconfiguré avec des valeurs par défaut judicieuses qui correspondent à la plupart des usages courants. Cela accélère le développement d'applications et réduit la quantité de code à maintenir.

Rails – Structures de fichiers de projet

Une fois Rails installé sur votre système, créez une application Rails. Les sections suivantes présentent un exemple Ruby on Rails : la création d’une application de liste de tâches. Exécutez la commande suivante dans votre terminal pour créer l’application :

rails new todo_app

Cette commande crée un répertoire nommé application de tâches dans le répertoire courant avec la structure de dossiers de base d'une application web Rails, comme indiqué ci-dessous.

Voici les principaux répertoires générés pour le projet :

appli – regroupe les sous-répertoires pour l'interface utilisateur/la mise en page (vues et fonctions d'assistance), le contrôleur (fichiers de contrôleur) et les modèles (logique métier/applicative).

application/contrôleurs – stocke les fichiers de contrôleur utilisés par Rails pour traiter les requêtes du client.

application/actifs – contient les fichiers statiques nécessaires au front-end de l'application, regroupés par type : Javascénario fichiers, images et feuilles de style.

application/aides – contient des fonctions d'assistance qui permettent de garder la logique de votre modèle d'application, de votre vue et de votre contrôleur ciblée, compacte et épurée.

application/modèles – contient les fichiers qui modélisent la base de données de votre application. Les classes du modèle facilitent grandement l'utilisation de la base de données.

application/vues – Contient les fichiers de modèle/mise en page avec lesquels l'utilisateur de votre application interagit. Ces modèles combinent du HTML avec des données provenant de la base de données.

coffre – Contient les scripts Rails qui lancent votre application. Il peut également inclure d'autres scripts utilisés pour configurer et mettre à jour l'application.

config – contient des fichiers de configuration tels que base de données.yml, environnement.rb, routes.rb, etc., dont votre application a besoin pour fonctionner.

db – contient les fichiers et scripts utilisés pour gérer la base de données de votre application.

lib – contient des modules étendus pour votre application.

enregistrer – contient des fichiers journaux tels que server.log, development.log, test.log et production.log, utilisé pour déboguer ou surveiller votre application.

public – contient des fichiers statiques et des ressources compilées, tels que des fichiers HTML, JavaFichiers de script, images et feuilles de style.

tester – contient les fichiers de test que vous écrivez pour tester les fonctionnalités de votre application.

tmp – contient des fichiers temporaires tels que les fichiers cache et les fichiers PID.

vendeur – contient des bibliothèques tierces.

Fichier gemme – spécifie les gems de base nécessaires au fonctionnement de votre application web. Vous pouvez les regrouper en environnements de développement, de test ou de production, et Rails saura quand inclure chaque gem.

Gemfile.lock Contrairement au Gemfile, qui liste explicitement les gems que vous souhaitez utiliser dans votre application, le fichier Gemfile.lock contient également d'autres gems dont dépendent celles listées dans le Gemfile. Ces gems sont installées automatiquement pour satisfaire les dépendances.

Lisez-moi.md – Utilisez ce fichier pour partager les informations essentielles concernant votre application, telles que sa fonction et la manière de l'installer et de l'exécuter.

Fichier rake – contient diverses définitions de tâches Rake qui permettent d'automatiser les tâches d'administration quotidiennes de votre application.

config.ru – un fichier de configuration Rack qui fournit une interface au serveur web pour démarrer votre application.

Changez de répertoire pour accéder au application de tâches répertoire Rails généré et exécuté serveur de rails pour démarrer l'application. Taper localhost: 3000 dans la barre d'adresse de votre navigateur web. Si tout s'est bien passé, vous devriez voir l'écran ci-dessous.

Ceci est la page d'accueil par défaut de votre application. Vous la modifierez plus loin dans ce tutoriel Ruby on Rails. Vous pouvez arrêter le serveur en appuyant sur Ctrl + C.

Rails – Générer des commandes

La commande `generate` de Rails utilise des modèles pour créer de nombreux éléments utiles dans votre application. Ces générateurs permettent un gain de temps considérable.

Ils écrivent le code standard nécessaire au fonctionnement de votre application web. Exécuter rails génère Utilisez la commande `ls` dans l'invite de commandes ou le Terminal pour afficher la liste des générateurs disponibles, comme indiqué ci-dessous.

Vous pouvez aussi courir rails génère Pour consulter la description de la fonction de la commande, vous trouverez une liste des options utiles et un exemple d'utilisation. La figure ci-dessous illustre le résultat de l'exécution. contrôleur de génération de rails.

Utilisez la commande `rails generate scaffold` pour créer automatiquement le modèle, la vue et le contrôleur de l'application de liste de tâches que vous développez. Exécutez la commande suivante dans votre terminal (assurez-vous d'être toujours dans le terminal). application de tâches annuaire):

rails generate scaffold todo_list title:string description:text

Cela crée une interface web CRUD (Créer, Lire, Mettre à jour, Supprimer) complète pour la table TodoLists.

Une autre commande utile à connaître est les rails détruisentCela inverse tout ce qui rails génère t.

Rails – Routage

Le système de routage de Rails, appelé routeur Rails, gère toutes les requêtes entrantes adressées à votre application web. Il examine les URL de chaque requête et l'associe à l'action du contrôleur responsable de son traitement, en utilisant la syntaxe spécifiée dans le fichier de routes (config / routes.rb).

Le fichier de routes contrôle tout URL aspect de votre application web. Rails utilise une conception RESTful basée sur le style architectural REST, qui fournit une carteping entre les verbes HTTP et la requête URLs aux actions du contrôleur.

Le fichier de routes a été généré lorsque vous avez exécuté rails neufs Pour poursuivre le développement de votre application Todo, exécutez la commande suivante :

rails db:migrate

Assurez-vous d'être toujours à la racine de l'application (le application de tâches annuaire).

Redémarrez le serveur avec serveur de rails. Type http://localhost:3000/todo_lists/ Saisissez « Créez une page web » dans votre navigateur et appuyez sur Entrée. Vous devriez obtenir une page web similaire à celle ci-dessous.

Il s'agit de la vue des listes de tâches générée par la commande scaffold, et elle est contrôlée par le TodoListsController. indice l'action.

Ajoutez une liste de tâches en cliquant sur « Nouvelle liste de tâches » sur la page. L'écran ci-dessous devrait s'afficher.

Notez le URL est maintenant http://localhost:3000/todo_lists/newVoici la page permettant de créer une nouvelle liste de tâches, et elle est contrôlée par le contrôleur TodoListsController. New méthode.

Saisissez le titre et la description de votre liste de tâches dans le formulaire, puis cliquez sur « Créer une liste de tâches ». URL devrait changer en http://localhost:3000/todo_lists/1, comme indiqué ci-dessous.

Ceci est la page d'affichage d'une liste de tâches, contrôlée par le contrôleur TodoListsController. montrer méthode. Si vous revenez à http://localhost:3000/todo_lists/Vous devriez maintenant voir l'écran ci-dessous avec la nouvelle liste de tâches ajoutée.

Rails a pu associer chaque requête à l'action correspondante du contrôleur TodoListsController en utilisant la définition de route dans config / routes.rb.

Si vous jetez un coup d'œil à ce fichier, vous verrez une seule ligne ressources : listes_de_tâches, ce qui est la méthode par défaut de Rails pour écrire des routes RESTful. Cette simple ligne crée sept routes, toutes mappées.ping au contrôleur TodoLists.

Par convention, chaque action du contrôleur correspond à une opération CRUD (Créer, Lire, Mettre à jour, Supprimer) spécifique dans la base de données.

Courir itinéraires ferroviaires Dans votre ligne de commande, consultez les différentes routes disponibles pour votre application. La figure ci-dessous illustre le résultat de l'exécution de cette commande. itinéraires ferroviaires.

Rails – Vues

La couche de présentation est l'un des composants du modèle MVC et est chargée de générer la réponse HTML pour chaque requête adressée à votre application. Rails utilise par défaut ERB (Embedded Ruby), un système de modèles puissant pour Ruby.

ERB facilite l'écriture et la maintenance des modèles en combinant du texte brut avec du code Ruby pour la substitution de variables et le contrôle de flux. Un modèle ERB utilise le .html.erb extension.

Vous utiliserez principalement deux marqueurs de balise, chacun entraînant un traitement et une gestion spécifiques du code intégré.

Une étiquette avec un signe égal <%= %> indique que le code intégré est une expression et que le résultat du code doit être substitué dans la sortie lors du rendu du modèle.

L'autre balise sans signe égal <% %> indique au moteur de rendu que le résultat du code ne doit pas être substitué ni imprimé dans la sortie.

Chaque contrôleur de votre application Rails possède un sous-répertoire correspondant dans application/vueset chaque action d'un contrôleur a un correspondant .html.erb fichier dans ce sous-répertoire.

Jetez un oeil à application/vues de l'application Todo que vous développez. Vous y trouverez un sous-répertoire nommé listes de tâches comprenant .html.erb fichiers dont les noms correspondent aux actions dans le Listes de tâches contrôleur.

Rails – ActiveRecord, Active Record Pattern et ORM

ActiveRecord est l'implémentation Ruby du modèle Active Record. Dans ce modèle, une classe représente une table de base de données, et une instance de cette classe représente une ligne de cette table.

ActiveRecord est communément appelé ORM (Object Relational Map).pingLa couche `layer` est une technique qui vous permet de gérer votre base de données à l'aide du langage avec lequel vous êtes le plus à l'aise. Elle est indépendante de toute base de données, vous pouvez donc facilement passer d'une base de données à l'autre — par exemple, SQLite, MySQL, PostgreSQL, SQL Server, ou Oracle — en utilisant le même code et la même logique.

Par exemple, pour obtenir un tableau contenant toutes les listes de tâches de votre application, vous n'avez pas besoin d'écrire de code qui ouvre une connexion, exécute une requête SQL SELECT et convertit le résultat.

Il vous suffit de taper Liste de tâches.tout, et ActiveRecord renvoie le tableau rempli d'objets TodoList que vous pouvez utiliser à votre guise.

Il vous suffit de configurer les paramètres dans config/base de données.ymlActiveRecord gère les différences entre les systèmes de bases de données. Lorsque vous passez d'une base de données à une autre, vous n'avez pas besoin de réécrire votre code.

Vous vous concentrez sur la logique applicative, et ActiveRecord gère les détails techniques de connexion à votre base de données. Il utilise des conventions de nommage pour associer les modèles aux tables de la base de données.

Rails utilise le pluriel pour nommer les classes de votre modèle afin de trouver la table de base de données correspondante. Ainsi, pour une classe, Liste de choses à faireActiveRecord utilise une table de base de données appelée listes de tâches.

Rails – Migrations

Une migration Rails est un script permettant de faire évoluer la base de données de votre application. Elle sert à configurer ou à modifier votre base de données sans écrire manuellement de requêtes SQL.

Il utilise Ruby pour définir les modifications apportées au schéma de la base de données et permet d'utiliser le contrôle de version pour maintenir la synchronisation de votre base de données entre les environnements.

Les migrations Rails utilisent un langage spécifique au domaine (DSL) Ruby. Celui-ci agit comme un absolutraction et permet d'utiliser ou de modifier votre moteur de base de données en fonction de vos besoins.

Les migrations peuvent être partagées avec tous les utilisateurs de l'application et annulées pour revenir à la version précédente. Ce mécanisme de sécurité robuste vous protège contre tout risque d'endommagement permanent de votre base de données.

Rails – Associations ActiveRecord

Une connexion entre deux modèles ActiveRecord est appelée une association. Les associations facilitent grandement les opérations sur les enregistrements liés dans votre code. Il en existe quatre catégories courantes.

Un à un : Un enregistrement contient précisément une instance d'un autre modèle. Un bon exemple est le profil utilisateur : un utilisateur ne possède qu'un seul profil. Il utilise le a_un mot-clé.

Un à plusieurs : L'association la plus courante : un modèle comporte zéro ou plusieurs instances d'un autre modèle. Utilisez le a_plusieurs mot-clé pour désigner cette association.

Plusieurs à plusieurs: C'est un peu plus compliqué. ActiveRecord propose deux solutions : a_et_appartient_à_beaucoup et a_plusieurs :à travers, ce qui vous donne accès au modèle de jointure défini dans une table séparée.

Polymorphisme un-à-plusieurs : Une association plus avancée dans Rails. Elle définit un modèle qui peut appartenir à plusieurs modèles différents au sein d'une même association.

Rails – Validations ActiveRecord

La validation permet de garantir l'exactitude des données, car travailler avec des données erronées est risqué et peut coûter de l'argent à votre entreprise.

La validation offre également une couche de sécurité supplémentaire contre les utilisateurs malveillants qui tenteraient d'insérer des données nuisibles dans votre base de données. Rails propose une API claire d'assistants de validation dans ActiveRecord qui garantissent une base de données propre, sécurisée et sans erreurs.

Les validations ActiveRecord s'exécutent sur les objets du modèle avant leur enregistrement dans la base de données, ce qui les rend plus fiables et conformes aux bonnes pratiques.

Les méthodes ActiveRecord suivantes déclenchent des validations lorsqu'elles sont appelées sur des objets de modèle : créez, créez !, enregistrez, enregistrez !, mettez à jour et mettez à jour !.Les versions bang (Créez ! Enregistrez ! et mettez à jour !) lève une exception si l'enregistrement est invalide, tandis que les versions sans point d'exclamation renvoient plutôt la valeur false.

Les assistants de validation ActiveRecord les plus courants sont :

• Confirmation: Cette fonction vérifie que deux champs ont la même valeur, par exemple le mot de passe et sa confirmation. Elle est utilisée conjointement avec l'assistant de validation de présence.
• Présence: vérifie que le champ n'est pas vide.
• Unicité: garantit une valeur unique pour un champ, par exemple un nom d'utilisateur.
• Durée : impose une limite à la longueur des caractères d'un champ.

Vous pouvez également créer votre propre validation personnalisée en utilisant valider méthode et en lui passant le nom d'une méthode de validation personnalisée.

Vérifiez le modèle erreurs Cet objet permet de comprendre pourquoi une validation a échoué. Vous disposez ainsi de toutes les informations nécessaires pour rendre votre application plus sécurisée et mieux contrôlée, en n'autorisant que les données valides dans votre base de données.

Rails – ActionController

Le contrôleur Rails est le centre de votre application Web. Il facilite et coordonne la communication entre l'utilisateur, les modèles et les vues.

Vos classes de contrôleur héritent de Contrôleur d'application, qui contient du code pouvant être exécuté dans tous les autres contrôleurs, et qui hérite à son tour de ActionController::Base.

Le contrôleur fournit les éléments suivants à votre application :

• Il achemine les requêtes externes vers des actions internes.
• Il gère la mise en cache, ce qui améliore les performances de votre application.
• Il gère les méthodes d'assistance qui étendent les capacités des modèles de vue et gère également les sessions utilisateur, offrant ainsi aux utilisateurs une expérience fluide.

Rails – Configurations

Vous pouvez configurer des composants tels que les initialiseurs, les ressources, les générateurs et les middlewares à l'aide des fichiers d'initialisation et de configuration de votre application Rails. config répertoire. Fichiers comme config/application.rb, config/environments/development.rb et config/environments/test.rb sont utilisés ici. Vous pouvez également ajouter des paramètres personnalisés pour votre application.

Rails – Débogage

Au fur et à mesure que vous développez votre application, vous devrez déboguer votre code. Rails facilite cette tâche grâce à… byebug gem. Vous pouvez démarrer une session de débogage en plaçant le mot-clé byebug n'importe où dans le code de votre application.

Cela interrompt temporairement l'exécution à cet endroit. La gem byebug propose plusieurs commandes. Les plus utiles sont :

• suivant: passe à la ligne de code suivante, ignorerping toutes les méthodes invoquées par la ligne actuelle.
• étape: similaire à nextmais détaille chaque méthode invoquée.
• Pause: interrompt l'exécution du code.
• continuer: Poursuit l'exécution du code.

D'autres outils de débogage sont disponibles, tels que : faire levierIls offrent tous des fonctionnalités similaires, avec une syntaxe légèrement différente. Les gems de débogage ne doivent pas être utilisées en production, car elles présentent des risques pour votre application et dégradent l'expérience utilisateur.

Les fichiers journaux peuvent être analysés pour détecter les erreurs en production et traitées en conséquence. Il est également recommandé d'adopter une approche de développement pilotée par les tests (TDD) lors de la conception de votre application afin de garantir son bon fonctionnement avant le déploiement en production.

FAQ