✎ rubyonrails [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Rails (ou Ruby on Rails dit aussi RoR) ======

Rails est un cadriciel libre orienté dans le développement d'applications web, et développé lui-même dans le langage [[:ruby|Ruby]]. Les versions concernées par cette documentation sont celles de Ubuntu Trusty Rails 3.2, et de Ubuntu Xenial Rails 4.2.

→ fournir une capture d'ecran de ror.

===== Pré-requis =====

* Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.

===== Installation =====

Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>rails|Rails]]** , qui installera en même temps toutes les dépendances necessaires dont le langage [[:ruby|Ruby]] et les fonctionnalités SQLite3.

===== Configuration =====

La configuration de Rails s'effectue automatiquement pour chaque application créée dans son dossier , voir ci-après.

Pour modifier le comportement de Rails lui-même, utilisez les options sur la ligne de commande :
<code>man rails </code>

que vous pouvez aussi obtenir avec juste la commande __rails__ ou :
<code>
$ rails new -h
Usage:
  rails new APP_PATH [options]

Options:
  -r, [--ruby=PATH]                                      # Path to the Ruby binary of your choice
                                                         # Default: /usr/bin/ruby
  -m, [--template=TEMPLATE]                              # Path to some application template (can be a filesystem path or URL)
      [--skip-gemfile], [--no-skip-gemfile]              # Don't create a Gemfile
  -B, [--skip-bundle], [--no-skip-bundle]                # Don't run bundle install
  -G, [--skip-git], [--no-skip-git]                      # Skip .gitignore file
      [--skip-keeps], [--no-skip-keeps]                  # Skip source control .keep files
  -O, [--skip-active-record], [--no-skip-active-record]  # Skip Active Record files
  -S, [--skip-sprockets], [--no-skip-sprockets]          # Skip Sprockets files
      [--skip-spring], [--no-skip-spring]                # Don't install Spring application preloader
  -d, [--database=DATABASE]                              # Preconfigure for selected database (options: mysql/oracle/postgresql/sqlite3/frontbase/ibm_db/sqlserver/jdbcmysql/jdbcsqlite3/jdbcpostgresql/jdbc)
                                                         # Default: sqlite3
  -j, [--javascript=JAVASCRIPT]                          # Preconfigure for selected JavaScript library
                                                         # Default: jquery
  -J, [--skip-javascript], [--no-skip-javascript]        # Skip JavaScript files
      [--dev], [--no-dev]                                # Setup the application with Gemfile pointing to your Rails checkout
      [--edge], [--no-edge]                              # Setup the application with Gemfile pointing to Rails repository
      [--skip-turbolinks], [--no-skip-turbolinks]        # Skip turbolinks gem
  -T, [--skip-test-unit], [--no-skip-test-unit]          # Skip Test::Unit files
      [--rc=RC]                                          # Path to file containing extra configuration options for rails command
      [--no-rc], [--no-no-rc]                            # Skip loading of extra configuration options from .railsrc file

Runtime options:
  -f, [--force]                    # Overwrite files that already exist
  -p, [--pretend], [--no-pretend]  # Run but do not make any changes
  -q, [--quiet], [--no-quiet]      # Suppress status output
  -s, [--skip], [--no-skip]        # Skip files that already exist

Rails options:
  -h, [--help], [--no-help]        # Show this help message and quit
  -v, [--version], [--no-version]  # Show Rails version number and quit

Description:
    The 'rails new' command creates a new Rails application with a default
    directory structure and configuration at the path you specify.

You can specify extra command-line arguments to be used every time
    'rails new' runs in the .railsrc configuration file in your home directory.

Note that the arguments specified in the .railsrc file don't affect the
    defaults values shown above in this help message.

Example:
    rails new ~/Code/Ruby/weblog

This generates a skeletal Rails installation in ~/Code/Ruby/weblog.
    See the README in the newly created application to get going.
</code>
===== Utilisation =====

==== Créez votre première application Rails (Hello, Rails !) ====

* Générez le squelette de l'application : cette commande créera un dossier nommé __weblog__ dans votre dossier personnel, et auto-configurera toutes les fonctionnalités nécessaires (base sqlite3, mini serveur web).
<code>$ rails new $HOME/weblog</code>
  * Lancez ensuite le serveur Rails pour exécuter l'application __weblog__
<code>$ cd $HOME/weblog
$ bin/rails server
</code>
<note>Dans la version de Ubuntu Trusty Rails 3.2 :
  * la base préconfigurée de l'application doit être activée
<code>$ cd $HOME/weblog
$ rake db:create</code>
  * l'exécution "rails server" s'effectue sans mentionner bin dans le chemin.
<code>$ rails server</code>
</note>
  * Lancez le navigateur web à l'adresse localhost:3000
<code>firefox http://localhost:3000</code>
→ fournir une capture d'ecran de Hello Rails

==== Utilisations avancées ====

Les utilisateurs et programmeurs avancés pourront configurer Rails avec d'autres serveurs web comme Apache :
  * modules [[https://www.phusionpassenger.com/|Phusion Passenger]] Rails et Rack pour Apache **[[apt>libapache2-mod-passenger]]** ,

ou d'autres moteurs de bases de données comme MySQL, PostgreSQL, ou via la connexion de bases JDBC. Lire soigneusement [[http://guides.rubyonrails.org/|les guides de rubyonrails]] et [[http://api.rubyonrails.org/|l'API]].
===== Désinstallation =====
 
Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
 
===== Voir aussi =====
 
  * **(en)** [[http://rubyonrails.org|Rails]]
  * **(fr)** [[https://fr.wikipedia.org/wiki/Ruby_on_Rails|Ruby on Rails sur Wikipédia]]
  * **(fr)** [[http://railspremierspas.humancoders.com|Vos premiers pas en Ruby on Rails]]
 
----
//Correcteur : [[utilisateurs:j5012|J5012]].//
 
//Basé sur [[http://guides.rubyonrails.org/getting_started.html|Getting Started with Rails]] par [[http://guides.rubyonrails.org/credits.html]].//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : V V Y Q F Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported