mirror of
https://github.com/sinatra/sinatra
synced 2023-03-27 23:18:01 -04:00
French README update.
Signed-off-by: Konstantin Haase <konstantin.mailinglists@googlemail.com>
This commit is contained in:
parent
54fb37fd9a
commit
644c26e287
1 changed files with 128 additions and 49 deletions
125
README.fr.rdoc
125
README.fr.rdoc
|
@ -36,6 +36,10 @@ Chaque route est associée à un bloc:
|
||||||
end
|
end
|
||||||
|
|
||||||
put '/' do
|
put '/' do
|
||||||
|
.. remplacer quelque chose ..
|
||||||
|
end
|
||||||
|
|
||||||
|
patch '/' do
|
||||||
.. changer quelque chose ..
|
.. changer quelque chose ..
|
||||||
end
|
end
|
||||||
|
|
||||||
|
@ -842,6 +846,19 @@ choix comme vous le feriez pour n'importe quel autre +middleware+ :
|
||||||
session[:valeur] = params[:valeur]
|
session[:valeur] = params[:valeur]
|
||||||
end
|
end
|
||||||
|
|
||||||
|
Pour renforcer la sécurité, les données de session dans le cookie sont signées
|
||||||
|
avec une clé secrète de session. Une clé secrète est générée pour vous au
|
||||||
|
hasard par Sinatra. Toutefois, comme cette clé change à chaque démarrage de
|
||||||
|
votre application, vous pouvez définir cette clé vous-même afin que toutes
|
||||||
|
les instances de votre application la partage:
|
||||||
|
|
||||||
|
set :session_secret, 'super secret'
|
||||||
|
|
||||||
|
Si vous souhaitez avoir plus de contrôle, vous pouvez également enregistrer un
|
||||||
|
+hash+ avec des options lors de la configuration de +sessions+:
|
||||||
|
|
||||||
|
set :sessions, :domain => 'foo.com'
|
||||||
|
|
||||||
== Halt
|
== Halt
|
||||||
|
|
||||||
Pour arrêter immédiatement la requête dans un filtre ou un gestionnaire de
|
Pour arrêter immédiatement la requête dans un filtre ou un gestionnaire de
|
||||||
|
@ -948,6 +965,31 @@ retour et les entêtes :
|
||||||
Comme +body+, +headers+ et +status+ peuvent être utilisés sans arguments
|
Comme +body+, +headers+ et +status+ peuvent être utilisés sans arguments
|
||||||
pour accéder à leurs valeurs.
|
pour accéder à leurs valeurs.
|
||||||
|
|
||||||
|
=== Journalisation (Logging)
|
||||||
|
|
||||||
|
Dans le contexte de la requête, la méthode utilitaire +logger+ expose une
|
||||||
|
instance de +logger+:
|
||||||
|
|
||||||
|
get '/' do
|
||||||
|
logger.info "chargement des données"
|
||||||
|
# ...
|
||||||
|
end
|
||||||
|
|
||||||
|
Ce +logger+ va automatiquement prendre en compte les paramètres de
|
||||||
|
configuration pour la journalisation de votre gestionnaire Rack. Si la
|
||||||
|
journalisation est désactivée, cette méthode renverra un objet factice et
|
||||||
|
vous n'avez pas à vous en inquiéter dans vos routes en le filtrant.
|
||||||
|
|
||||||
|
Notez que la journalisation est seulement activée par défaut pour
|
||||||
|
<tt>Sinatra::Application</tt>, donc si vous héritez de <tt>Sinatra::Base</tt>,
|
||||||
|
vous aurez à l'activer vous-même:
|
||||||
|
|
||||||
|
class MonApp < Sinatra::Base
|
||||||
|
configure(:production, :development) do
|
||||||
|
enable :logging
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
=== Types Mime
|
=== Types Mime
|
||||||
|
|
||||||
Quand vous utilisez <tt>send_file</tt> ou des fichiers statiques, vous
|
Quand vous utilisez <tt>send_file</tt> ou des fichiers statiques, vous
|
||||||
|
@ -1121,6 +1163,10 @@ de la requête (filtres, routes, gestionnaires d'erreur) au moyen de la méthode
|
||||||
|
|
||||||
# application tournant à l'adresse http://exemple.com/exemple
|
# application tournant à l'adresse http://exemple.com/exemple
|
||||||
get '/foo' do
|
get '/foo' do
|
||||||
|
t = %w[text/css text/html application/javascript]
|
||||||
|
request.accept # ['text/html', '*/*']
|
||||||
|
request.accept? 'text/xml' # true
|
||||||
|
request.preferred_type(t) # 'text/html'
|
||||||
request.body # corps de la requête envoyée par le client
|
request.body # corps de la requête envoyée par le client
|
||||||
# (voir ci-dessous)
|
# (voir ci-dessous)
|
||||||
request.scheme # "http"
|
request.scheme # "http"
|
||||||
|
@ -1339,9 +1385,7 @@ Vous pouvez accéder à ces paramètres via <tt>settings</tt> :
|
||||||
[public] dossier duquel les fichiers publics sont servis
|
[public] dossier duquel les fichiers publics sont servis
|
||||||
|
|
||||||
[reload_templates] si oui ou non les templates doivent être rechargés
|
[reload_templates] si oui ou non les templates doivent être rechargés
|
||||||
entre les requêtes. Activé en mode développement
|
entre les requêtes. Activé en mode développement.
|
||||||
et sur Ruby 1.8.6 (pour compenser un bug Ruby
|
|
||||||
occasionnant une fuite de mémoire).
|
|
||||||
|
|
||||||
[root] dossier racine du projet.
|
[root] dossier racine du projet.
|
||||||
|
|
||||||
|
@ -1669,6 +1713,46 @@ application Sinatra, ou n'importe quelle application basée sur Rack
|
||||||
get('/') { "Bonjour #{session['nom_utilisateur']}." }
|
get('/') { "Bonjour #{session['nom_utilisateur']}." }
|
||||||
end
|
end
|
||||||
|
|
||||||
|
=== Création dynamique d'applications
|
||||||
|
|
||||||
|
Il se peut que vous ayez besoin de créer une nouvelle application à l'exécution
|
||||||
|
sans avoir à les assigner à une constante, vous pouvez le faire grâce à
|
||||||
|
`Sinatra.new`:
|
||||||
|
|
||||||
|
require 'sinatra/base'
|
||||||
|
mon_app = Sinatra.new { get('/') { "salut" } }
|
||||||
|
mon_app.run!
|
||||||
|
|
||||||
|
L'application dont elle hérite peut être passé en argument optionnel:
|
||||||
|
|
||||||
|
require 'sinatra/base'
|
||||||
|
|
||||||
|
controleur = Sinatra.new do
|
||||||
|
enable :logging
|
||||||
|
helpers MyHelpers
|
||||||
|
end
|
||||||
|
|
||||||
|
map('/a') do
|
||||||
|
run Sinatra.new(controleur) { get('/') { 'a' } }
|
||||||
|
end
|
||||||
|
|
||||||
|
map('/b') do
|
||||||
|
run Sinatra.new(controleur) { get('/') { 'b' } }
|
||||||
|
end
|
||||||
|
|
||||||
|
C'est notamment utile pour tester des extensions à Sinatra ou bien pour
|
||||||
|
utiliser Sinatra dans votre propre bibliothèque.
|
||||||
|
|
||||||
|
Cela permet également d'utiliser très facilement Sinatra comme middleware:
|
||||||
|
|
||||||
|
require 'sinatra/base'
|
||||||
|
|
||||||
|
use Sinatra do
|
||||||
|
get('/') { ... }
|
||||||
|
end
|
||||||
|
|
||||||
|
run RailsProject::Application
|
||||||
|
|
||||||
== Contextes et Binding
|
== Contextes et Binding
|
||||||
|
|
||||||
Le contexte dans lequel vous êtes détermine les méthodes et variables
|
Le contexte dans lequel vous êtes détermine les méthodes et variables
|
||||||
|
@ -1702,6 +1786,7 @@ Vous avez le binding du contexte de l'application dans:
|
||||||
* Les méthodes définies par les extensions
|
* Les méthodes définies par les extensions
|
||||||
* Le bloc passé à `helpers`
|
* Le bloc passé à `helpers`
|
||||||
* Les procs/blocs utilisés comme argument pour `set`
|
* Les procs/blocs utilisés comme argument pour `set`
|
||||||
|
* Le bloc passé à <tt>Sinatra.new</tt>
|
||||||
|
|
||||||
Vous pouvez atteindre ce contexte (donc la classe) de la façon suivante:
|
Vous pouvez atteindre ce contexte (donc la classe) de la façon suivante:
|
||||||
|
|
||||||
|
@ -1776,21 +1861,8 @@ Les options sont:
|
||||||
|
|
||||||
== Configuration nécessaire
|
== Configuration nécessaire
|
||||||
|
|
||||||
Il est recommandé d'installer Sinatra sur Ruby 1.8.7, 1.9.2, JRuby ou
|
|
||||||
Rubinius.
|
|
||||||
|
|
||||||
Les versions suivantes de Ruby sont officiellement supportées :
|
Les versions suivantes de Ruby sont officiellement supportées :
|
||||||
|
|
||||||
[ Ruby 1.8.6 ]
|
|
||||||
Il n'est pas recommandé d'utiliser 1.8.6 pour Sinatra. Toutefois, ce sera
|
|
||||||
officiellement supporté jusqu'à l'arrivée Sinatra 1.3.0. Les templates RDoc
|
|
||||||
et CoffeeScript ne sont pas supportés par cette version de Ruby. 1.8.6
|
|
||||||
contient un défaut majeur de fuite de mémoire dans l'implémentation de Hash,
|
|
||||||
qui est déclenché par les versions de Sinatra antérieure à 1.1.1. La version
|
|
||||||
actuelle prévient explicitement ce risque au prix de la performance. Vous
|
|
||||||
devrez utiliser Rack 1.1.x dans la mesure où Rack >= 1.2 ne supporte plus
|
|
||||||
1.8.6.
|
|
||||||
|
|
||||||
[ Ruby 1.8.7 ]
|
[ Ruby 1.8.7 ]
|
||||||
1.8.7 est complètement supporté, toutefois si rien ne vous y retient, nous
|
1.8.7 est complètement supporté, toutefois si rien ne vous y retient, nous
|
||||||
vous recommandons de passer à 1.9.2 ou bien de passer à JRuby ou Rubinius.
|
vous recommandons de passer à 1.9.2 ou bien de passer à JRuby ou Rubinius.
|
||||||
|
@ -1801,14 +1873,18 @@ Les versions suivantes de Ruby sont officiellement supportées :
|
||||||
réputé causer des erreurs de segmentation lorque Sinatra est utilisé.
|
réputé causer des erreurs de segmentation lorque Sinatra est utilisé.
|
||||||
|
|
||||||
[ Rubinius ]
|
[ Rubinius ]
|
||||||
Rubinius est officiellement supporté (Rubinius >= 1.2.2), à l'exception
|
Rubinius est officiellement supporté (Rubinius >= 1.2.3), tout fonctionne,
|
||||||
des templates Textile.
|
y compris tous les langages de template.
|
||||||
|
|
||||||
[ JRuby ]
|
[ JRuby ]
|
||||||
JRuby est officiellement supporté (JRuby >= 1.5.6). Aucune anomalie avec
|
JRuby est officiellement supporté (JRuby >= 1.6.0). Aucune anomalie avec
|
||||||
des bibliothèques de templates tierces ne sont connues. Toutefois, si vous
|
des bibliothèques de templates tierces ne sont connues. Toutefois, si vous
|
||||||
choisissez JRuby, alors tournez vous vers des gestionnaires Rack JRuby car
|
choisissez JRuby, alors tournez vous vers des gestionnaires Rack JRuby car
|
||||||
le serveur Thin n'est pas (encore) supporté par JRuby.
|
le serveur Thin n'est pas complètement supporté par JRuby. Le support des
|
||||||
|
extensions C dans JRuby est encore expérimental, ce qui n'affecte que
|
||||||
|
RDiscount.
|
||||||
|
|
||||||
|
<b>Ruby 1.8.6 n'est plus supporté.</b>
|
||||||
|
|
||||||
Nous gardons également un oeil sur les versions Ruby à venir.
|
Nous gardons également un oeil sur les versions Ruby à venir.
|
||||||
|
|
||||||
|
@ -1816,15 +1892,18 @@ Les implémentations Ruby suivantes ne sont pas officiellement supportées mais
|
||||||
sont toujours connues comme permettant à Sinatra de fonctionner :
|
sont toujours connues comme permettant à Sinatra de fonctionner :
|
||||||
|
|
||||||
* Plus anciennes versions de JRuby et Rubinius
|
* Plus anciennes versions de JRuby et Rubinius
|
||||||
* MacRuby
|
* MacRuby, Maglev, IronRuby
|
||||||
* Maglev
|
|
||||||
* IronRuby
|
|
||||||
* Ruby 1.9.0 et 1.9.1
|
* Ruby 1.9.0 et 1.9.1
|
||||||
|
* Ruby 1.8.6 avec {backports}[https://github.com/marcandre/backports/#readme]
|
||||||
|
|
||||||
Ne pas être officiellement supporté signifie que si les choses se passent mal
|
Ne pas être officiellement supporté signifie que si les choses se passent mal
|
||||||
sur ces plateformes et non sur celles supportées, nous considérons que
|
sur ces plateformes et non sur celles supportées, nous considérons que
|
||||||
l'anomalie est de le ressort, pas du nôtre.
|
l'anomalie est de le ressort, pas du nôtre.
|
||||||
|
|
||||||
|
Nous faisons également notre intégration continue (CI) avec ruby-head (la
|
||||||
|
future 1.9.3), mais nous ne pouvons rien garantir étant donné que c'est
|
||||||
|
constant mouvement. Vous pouvez vous attendre à ce que 1.9.3p0 soit supporté.
|
||||||
|
|
||||||
Sinatra devrait fonctionner sur n'importe quel système d'exploitation
|
Sinatra devrait fonctionner sur n'importe quel système d'exploitation
|
||||||
supportant l'implémentation Ruby choisie.
|
supportant l'implémentation Ruby choisie.
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue