mirror of
https://github.com/sinatra/sinatra
synced 2023-03-27 23:18:01 -04:00
Konstantin Haase
commit
5a4d8b5565
2 changed files with 103 additions and 34 deletions
117
README.fr.md
117
README.fr.md
|
|
@ -14,10 +14,15 @@ get '/' do
|
|||
end
|
||||
```
|
||||
|
||||
Installez la gem et lancez avec :
|
||||
Installez la gem Sinatra :
|
||||
|
||||
``` shell
|
||||
gem install sinatra
|
||||
```
|
||||
|
||||
Puis lancez votre programme :
|
||||
|
||||
``` shell
|
||||
ruby mon_application.rb
|
||||
```
|
||||
|
||||
|
|
@ -138,7 +143,15 @@ delete '/' do
|
|||
end
|
||||
|
||||
options '/' do
|
||||
.. apaiser quelquechose ..
|
||||
.. paramétrer quelque chose ..
|
||||
end
|
||||
|
||||
link '/' do
|
||||
.. relier quelque chose ..
|
||||
end
|
||||
|
||||
unlink '/' do
|
||||
.. séparer quelque chose ..
|
||||
end
|
||||
```
|
||||
|
||||
|
|
@ -161,6 +174,9 @@ paramètres du bloc comme ceci :
|
|||
|
||||
``` ruby
|
||||
get '/bonjour/:nom' do |n|
|
||||
# répond aux requêtes "GET /bonjour/foo" et "GET /bonjour/bar"
|
||||
# params[:nom] est 'foo' ou 'bar'
|
||||
# n contient params[:nom]
|
||||
"Bonjour #{n} !"
|
||||
end
|
||||
```
|
||||
|
|
@ -1010,7 +1026,7 @@ json[:baz] = key
|
|||
Les options `:callback` et `:variable` peuvent être utilisées pour décorer
|
||||
l’objet retourné.
|
||||
|
||||
```
|
||||
``` ruby
|
||||
var resource = {"foo":"bar","baz":"qux"}; present(resource);</pre>
|
||||
```
|
||||
|
||||
|
|
@ -1332,6 +1348,14 @@ hash avec des options lors de la configuration de `sessions` :
|
|||
set :sessions, :domain => 'foo.com'
|
||||
```
|
||||
|
||||
Pour que les différents sous-domaines de foo.com puisse partager une session,
|
||||
vous devez préfixer le domaine par *.* :
|
||||
|
||||
``` ruby
|
||||
set :sessions, :domain => '.foo.com'
|
||||
```
|
||||
|
||||
|
||||
### Halt
|
||||
|
||||
Pour arrêter immédiatement la requête dans un filtre ou un gestionnaire de
|
||||
|
|
@ -1501,17 +1525,30 @@ fermeront malgré tout le flux :
|
|||
# interrogation prolongée
|
||||
|
||||
set :server, :thin
|
||||
connections = []
|
||||
connexions = []
|
||||
|
||||
get '/' do
|
||||
# conserve le flux ouvert
|
||||
stream(:keep_open) { |out| connections << out }
|
||||
get '/souscrire' do
|
||||
# abonne un client aux évènements du serveur
|
||||
stream(:keep_open) { |out| connexions << out }
|
||||
|
||||
# purge les connexions abandonnées
|
||||
connexions.reject!(&:closed?)
|
||||
|
||||
# compte-rendu
|
||||
"abonné"
|
||||
end
|
||||
|
||||
post '/' do
|
||||
# écrit dans tous les flux ouverts
|
||||
connections.each { |out| out << params[:message] << "\n" }
|
||||
"message sent"
|
||||
post '/message' do
|
||||
connexions.each do |out|
|
||||
# prévient le client qu'un nouveau message est arrivé
|
||||
out << params[:message] << "\n"
|
||||
|
||||
# indique au client de se connecter à nouveau
|
||||
out.close
|
||||
end
|
||||
|
||||
# compte-rendu
|
||||
"message reçu"
|
||||
end
|
||||
```
|
||||
|
||||
|
|
@ -1728,7 +1765,7 @@ end
|
|||
|
||||
Si vous souhaitez utilisez un ETag faible, utilisez l'option <tt>:kind</tt> :
|
||||
|
||||
```
|
||||
``` ruby
|
||||
etag '', :new_resource => true, :kind => :weak
|
||||
```
|
||||
|
||||
|
|
@ -1815,7 +1852,7 @@ get '/foo' do
|
|||
# verbes HTTP)
|
||||
request.form_data? # false
|
||||
request["UN_ENTETE"] # valeur de l'entête UN_ENTETE
|
||||
request.referer # référant du client ou '/'
|
||||
request.referrer # référant du client ou '/'
|
||||
request.user_agent # user agent (utilisé par la condition :agent)
|
||||
request.cookies # tableau contenant les cookies du navigateur
|
||||
request.xhr? # requête AJAX ?
|
||||
|
|
@ -1824,8 +1861,7 @@ get '/foo' do
|
|||
request.ip # adresse IP du client
|
||||
request.secure? # false
|
||||
request.forwarded? # vrai (si on est derrière un proxy inverse)
|
||||
request.env # tableau brut de l'environnement fourni par
|
||||
# Rack
|
||||
request.env # tableau brut de l'environnement fourni par Rack
|
||||
end
|
||||
```
|
||||
|
||||
|
|
@ -1984,20 +2020,23 @@ end
|
|||
Lancé si l'environnement (variable d'environnement RACK_ENV) est défini comme
|
||||
`:production` :
|
||||
|
||||
``` ruby
|
||||
configure :production do
|
||||
...
|
||||
end
|
||||
```
|
||||
|
||||
Lancé si l'environnement est `:production` ou
|
||||
`:test` :
|
||||
Lancé si l'environnement est `:production` ou `:test` :
|
||||
|
||||
``` ruby
|
||||
configure :production, :test do
|
||||
...
|
||||
end
|
||||
```
|
||||
|
||||
Vous pouvez accéder à ces paramètres via `settings` :
|
||||
|
||||
```
|
||||
``` ruby
|
||||
configure do
|
||||
set :foo, 'bar'
|
||||
end
|
||||
|
|
@ -2034,6 +2073,16 @@ protection :
|
|||
set :protection, :except => [:path_traversal, :session_hijacking]
|
||||
```
|
||||
|
||||
Par défaut, il faut que `:sessions` soit activé pour que Sinatra mette en place
|
||||
un système de protection au niveau de la session. Dans le cas où vous gérez
|
||||
vous même les sessions, vous devez utiliser l'option `:session` pour que cela
|
||||
soit le cas :
|
||||
|
||||
``` ruby
|
||||
use Rack::Session::Pool
|
||||
set :protection, :session => true
|
||||
```
|
||||
|
||||
### Paramètres disponibles
|
||||
|
||||
<dl>
|
||||
|
|
@ -2197,7 +2246,17 @@ RACK_ENV=production ruby my_app.rb
|
|||
```
|
||||
|
||||
Vous pouvez utiliser une des méthodes `development?`, `test?` et `production?`
|
||||
pour déterminer quel est l'environnement en cours.
|
||||
pour déterminer quel est l'environnement en cours :
|
||||
|
||||
``` ruby
|
||||
get '/' do
|
||||
if settings.development?
|
||||
"développement !"
|
||||
else
|
||||
"pas en développement !"
|
||||
end
|
||||
end
|
||||
```
|
||||
|
||||
## Gérer les erreurs
|
||||
|
||||
|
|
@ -2302,16 +2361,22 @@ La sémantique de `use` est identique à celle définie dans le DSL de
|
|||
(le plus souvent utilisé dans un fichier rackup). Par exemple, la méthode
|
||||
`use` accepte divers arguments ainsi que des blocs :
|
||||
|
||||
```
|
||||
``` ruby
|
||||
use Rack::Auth::Basic do |login, password|
|
||||
login == 'admin' && password == 'secret'
|
||||
end
|
||||
```
|
||||
|
||||
Rack est distribué avec une bonne variété de middlewares standards pour les
|
||||
logs, débuguer, faire du routage URL, de l'authentification, gérer des
|
||||
sessions. Sinatra utilise beaucoup de ces composants automatiquement via la
|
||||
configuration, donc pour ceux-ci vous n'aurez pas à utiliser la méthode `use`.
|
||||
Rack est distribué avec de nombreux middlewares standards pour loguer, débuguer,
|
||||
faire du routage URL, de l'authentification ou gérer des sessions. Sinatra gère
|
||||
plusieurs de ces composants automatiquement via son système de configuration, ce
|
||||
qui vous dispense de faire un `use` en ce qui les concerne.
|
||||
|
||||
Vous trouverez d'autres middlewares intéressants sur
|
||||
[rack](https://github.com/rack/rack/tree/master/lib/rack),
|
||||
[rack-contrib](https://github.com/rack/rack-contrib#readm),
|
||||
[CodeRack](http://coderack.org/) ou en consultant le
|
||||
[wiki de Rack](https://github.com/rack/rack/wiki/List-of-Middleware).
|
||||
|
||||
## Tester
|
||||
|
||||
|
|
@ -2665,7 +2730,7 @@ qui [étend l'objet principal](https://github.com/sinatra/sinatra/blob/ca06364/l
|
|||
|
||||
Les applications Sinatra peuvent être lancées directement :
|
||||
|
||||
``` ruby
|
||||
``` shell
|
||||
ruby mon_application.rb [-h] [-x] [-e ENVIRONNEMENT] [-p PORT] [-o HOTE] [-s SERVEUR]
|
||||
```
|
||||
|
||||
|
|
@ -2762,7 +2827,7 @@ stable.
|
|||
Pour cela, la méthode la plus simple est d'installer une gem de prerelease que
|
||||
nous publions de temps en temps :
|
||||
|
||||
``` ruby
|
||||
``` shell
|
||||
gem install sinatra --pre
|
||||
```
|
||||
Ce qui permet de bénéficier des toutes dernières fonctionnalités.
|
||||
|
|
|
|||
20
README.md
20
README.md
|
|
@ -496,7 +496,11 @@ Available Options:
|
|||
|
||||
Templates are assumed to be located directly under the `./views` directory. To
|
||||
use a different views directory:
|
||||
`set :views, settings.root + '/templates'`
|
||||
|
||||
``` ruby
|
||||
set :views, settings.root + '/templates'
|
||||
```
|
||||
|
||||
|
||||
One important thing to remember is that you always have to reference templates
|
||||
with symbols, even if they're in a subdirectory (in this case, use:
|
||||
|
|
@ -1547,7 +1551,7 @@ end
|
|||
For generating URLs you should use the `url` helper method, for instance, in
|
||||
Haml:
|
||||
|
||||
``` haml
|
||||
``` ruby
|
||||
%a{:href => url('/foo')} foo
|
||||
```
|
||||
|
||||
|
|
@ -1940,8 +1944,7 @@ configure :production do
|
|||
end
|
||||
```
|
||||
|
||||
Run when the environment is set to either `:production` or
|
||||
`:test`:
|
||||
Run when the environment is set to either `:production` or `:test`:
|
||||
|
||||
```ruby
|
||||
configure :production, :test do
|
||||
|
|
@ -1988,7 +1991,8 @@ set :protection, :except => [:path_traversal, :session_hijacking]
|
|||
|
||||
By default, Sinatra will only set up session based protection if `:sessions`
|
||||
has been enabled. Sometimes you want to set up sessions on your own, though. In
|
||||
that case you can get it to set up session based protections by passing the `:session` option:
|
||||
that case you can get it to set up session based protections by passing the
|
||||
`:session` option:
|
||||
|
||||
``` ruby
|
||||
use Rack::Session::Pool
|
||||
|
|
@ -2466,7 +2470,7 @@ end
|
|||
|
||||
Start with:
|
||||
|
||||
``` ruby
|
||||
``` shell
|
||||
ruby my_app.rb
|
||||
```
|
||||
|
||||
|
|
@ -2480,7 +2484,7 @@ run MyApp
|
|||
|
||||
Run:
|
||||
|
||||
``` ruby
|
||||
``` shell
|
||||
rackup -p 4567
|
||||
```
|
||||
|
||||
|
|
@ -2696,7 +2700,7 @@ being [extending the main object](https://github.com/sinatra/sinatra/blob/ca0636
|
|||
|
||||
Sinatra applications can be run directly:
|
||||
|
||||
``` ruby
|
||||
``` shell
|
||||
ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
|
||||
```
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue