Ruby on rails, connecter sa base MySQL à son projet

Si tu démarres un projet Ruby on Rails et que tu veux le connecter à MySQL, tu te poses sûrement la même question que beaucoup de développeurs au début : comment configurer la base de données proprement, sans te retrouver bloqué par une erreur de migration ou une mauvaise configuration du fichier database.yml ?

Concrètement, l’objectif est simple : faire en sorte que Rails utilise MySQL dès la création du projet, puis vérifier que la configuration de connexion est correcte pour éviter les erreurs les plus fréquentes. Dans la pratique, ce sujet paraît simple, mais il y a quelques détails techniques qui font toute la différence, surtout si tu débutes avec Rails et MySQL.

Créer un projet Ruby on Rails avec MySQL dès le départ

La méthode la plus propre, c’est de choisir MySQL au moment de la création du projet. C’est ce qui t’évite de partir sur SQLite par défaut, puis de devoir corriger la configuration après coup.

Dans la pratique, la commande à utiliser est la suivante :

rails new nom_projet -d mysql

Le paramètre -d mysql indique à Rails que tu veux utiliser MySQL comme système de gestion de base de données. Ce que cela change pour toi, c’est que Rails prépare automatiquement une base de configuration compatible avec mysql2, ce qui te fait gagner du temps et réduit les risques d’erreur.

Si tu es dans une situation où tu veux un environnement de développement proche de la production, c’est souvent le bon choix. Dans la majorité des cas, les équipes préfèrent éviter de développer sur SQLite si l’application finale doit tourner sur MySQL, parce que les comportements ne sont pas toujours identiques.

Pourquoi choisir MySQL dès le début ?

Parce que tu limites les ajustements inutiles. Quand tu démarres avec le bon SGBD, tu évites de découvrir trop tard qu’un type de colonne, une relation ou une migration ne se comporte pas exactement comme prévu.

En clair, si tu comptes déployer ton application sur une base MySQL, autant travailler avec le même moteur dès le départ. C’est plus cohérent, plus fiable, et souvent plus rassurant quand tu testes tes migrations.

Configurer le fichier config/database.yml

Une fois le projet créé, l’étape suivante consiste à ouvrir le fichier /config/database.yml. C’est lui qui définit comment Rails se connecte à ta base de données.

Tu devrais retrouver une configuration proche de celle-ci :

development:
  adapter: mysql2
  encoding: utf8
  reconnect: false
  database: database
  pool: 5
  username: root
  password: 
  host: localhost

Dans les faits, cette base de configuration est rarement suffisante telle quelle. Tu dois la remplacer par les valeurs réelles de ton environnement :

development:
  adapter: mysql2
  encoding: utf8
  reconnect: false 
  database: votre_database 
  pool: 5 
  username: root 
  password: votre_password 
  host: localhost 
  socket: adresse de votre socket

Ce que cela implique, c’est que Rails doit connaître précisément le nom de la base, l’utilisateur MySQL, le mot de passe et, dans certains cas, le socket. Si une seule de ces informations est incorrecte, la connexion échoue.

À quoi sert le socket MySQL ?

Le socket permet à Rails de communiquer avec MySQL via un fichier local plutôt que par une connexion réseau classique. En local, c’est parfois nécessaire selon ton installation, surtout sur certains environnements macOS ou Linux.

Concrètement, tu peux souvent retrouver cette information dans l’interface de phpMyAdmin, dans les informations de configuration de MySQL, ou via la documentation de ton installation. Si tu ne l’as pas besoin, il n’est pas toujours indispensable, mais quand MySQL le réclame, il faut le renseigner correctement.

Dans la pratique, si tu rencontres une erreur de connexion alors que le nom d’utilisateur et le mot de passe sont bons, le socket fait partie des premiers éléments à vérifier.

Attention à la syntaxe YAML

Le fichier database.yml est sensible à l’indentation et aux espaces. C’est un point qui piège beaucoup de débutants.

Par exemple :

Database : votre_database (Perfect)
Database :votre_database (Game over)

Dans la réalité, un espace mal placé peut suffire à casser la lecture du fichier. Si tu rencontres une erreur lors d’une migration ou au lancement de l’application, commence toujours par vérifier la structure du YAML avant de chercher un problème plus complexe.

On constate souvent que les erreurs les plus frustrantes viennent d’un détail invisible : une indentation incorrecte, une valeur mal alignée ou une clé mal écrite. C’est pour ça qu’il faut relire ce fichier ligne par ligne, calmement, avant de lancer les commandes Rails.

Que faire si tu as oublié de choisir MySQL à la création du projet ?

Si tu as créé ton projet sans préciser le moteur de base de données, ce n’est pas dramatique. Tu peux encore adapter ton projet pour qu’il utilise MySQL.

La première chose à faire est d’ouvrir le fichier Gemfile à la racine du projet. Si tu vois une référence à SQLite, tu peux la retirer et la remplacer par le support MySQL adapté à ton projet.

gem 'sqlite3-ruby', :require => 'sqlite3'

Ensuite, il faut revenir sur /config/database.yml et y mettre les bonnes valeurs, exactement comme vu plus haut. C’est cette combinaison qui permet à Rails de basculer proprement vers MySQL.

En pratique, si tu modifies seulement le fichier de configuration sans vérifier les dépendances du projet, tu risques de te retrouver avec une application qui ne démarre pas correctement. Il faut donc traiter les deux côtés : les gems et la configuration de connexion.

Erreur fréquente : modifier seulement database.yml

C’est une erreur classique. Beaucoup de personnes changent le fichier de configuration, puis s’étonnent que Rails continue d’afficher des messages d’erreur liés à SQLite ou à la base de données initiale.

Ce qu’il faut faire, c’est vérifier que le projet dispose bien du support MySQL dans ses dépendances, puis relancer l’installation des gems si nécessaire. Dans la majorité des cas, c’est cette étape qui permet de repartir sur une base saine.

Les vérifications à faire avant de lancer les migrations

Avant de lancer une migration ou de démarrer ton application, prends quelques minutes pour vérifier les points essentiels. C’est un petit contrôle qui t’évite souvent de longues heures de débogage.

• Le nom de la base de données est correct.
• L’utilisateur MySQL existe bien.
• Le mot de passe est exact.
• Le host est bien défini, souvent sur localhost en local.
• Le socket est renseigné si ton installation le demande.
• Le fichier YAML respecte l’indentation attendue.
• Le projet utilise bien le bon adaptateur, ici mysql2.

Dans la pratique, ce contrôle rapide fait gagner beaucoup de temps. Si tu rencontres un message d’erreur au lancement, tu sauras immédiatement où chercher au lieu de modifier au hasard plusieurs fichiers à la fois.

Bonnes pratiques pour éviter les problèmes de connexion

Si tu veux éviter les blocages les plus courants, il y a quelques réflexes simples à adopter dès le départ.

Utilise des identifiants cohérents

Le nom de la base, le nom d’utilisateur et le mot de passe doivent correspondre exactement à ce qui existe dans MySQL. Une faute de frappe suffit à empêcher la connexion.

Teste ton accès MySQL séparément

Avant même de lancer Rails, vérifie que tu peux te connecter à MySQL avec les mêmes identifiants. C’est un excellent moyen d’isoler le problème : si MySQL fonctionne seul mais pas avec Rails, tu sais que le souci vient de la configuration Rails.

Garde une configuration simple au début

Si tu débutes, évite de complexifier inutilement le fichier de configuration. Commence avec une configuration locale claire, puis ajoute les paramètres avancés seulement quand tu en as besoin.

Concrètement, une configuration simple et propre est plus facile à maintenir, surtout si tu dois corriger un bug plus tard. C’est aussi plus lisible si tu travailles en équipe.

Ce qu’il faut retenir si tu débutes avec Rails et MySQL

Si tu es dans cette situation, le plus important est de procéder dans l’ordre : créer le projet avec le bon moteur, vérifier les dépendances, puis ajuster database.yml avec les vraies valeurs de connexion. C’est cette méthode qui marche le mieux dans la pratique.

Et si tu bloques encore, reviens toujours aux bases : l’adaptateur MySQL, le nom de la base, les identifiants, le socket éventuel et l’indentation du fichier. Dans la plupart des cas, le problème se trouve là.

FAQ