Installation
| Autre langages : español | Japan | chinese | italiano | english |
Sommaire
Installation
Pour installer web.py, commencez par télécharger l’archive:
Décompressez l’archive et copier le dossier web dans le dossier de votre application. Ou, pour rendre web.py accessible par toutes les applications, exécutez:
python setup.py install
Note: sur certains systèmes Unix (ou Linux), il vous faudra vous connecter en tant que root (commande su) ou exécuter:
sudo python setup.py install
Une autre option est d’utiliser Easy Install. Une fois Easy Install correctement paramétré, exécutez:
easy_install web.py
Développement:
webpy intègre son propre serveur web. Apprenez comment écrire une application en suivant le tutoriel. Quand votre application est écrite, insérez votre code dans code.py et démarrez le serveur avec la commande:
python code.py
Ouvrez votre navigateur et allez à l’adresse http://localhost:8080/ pour visualiser la page. Pour spécifier un port différent, utilisez simplement python code.py 1234.
Production
Le serveur web intégré à web.py est bien pratique en phase de développement, mais pour un site en production, il vaut mieux prévoir quelque chose de plus sérieux. web.py fonctionne avec n’importe quel serveur http compatible avec WSGI.
WSGI est une API permettant la communication entre serveur web et applications, similaire à Java’s Servlet Interface. Pour faire fonctionner web.py avec CGI, FastCGI ou SCGI, il vous faudra installer flup (téléchargez ici), qui permet d’interfacer WSGI avec ces différentes API.
Pour utiliser une de ces variantes de CGI, ajoutez au début de votre code.py la ligne suivante :
#!/usr/bin/env python
N’oubliez pas de le rendre exécutable: chmod +x code.py.
LightTPD
.. avec FastCGI
FastCGI associé à lighttpd est la manière recommandée d’utiliser web.py en production. reddit.com gère des millions de visites de cette façon.
Votre configuration lighttpd doit ressemble à ceci:
server.modules = ("mod_fastcgi", "mod_rewrite")
server.document-root = "/path/to/root/"
fastcgi.server = ( "/code.py" =>
(( "socket" => "/tmp/fastcgi.socket",
"bin-path" => "/path/to/root/code.py",
"max-procs" => 1
))
)
url.rewrite-once = (
"^/favicon.ico$" => "/static/favicon.ico",
"^/static/(.*)$" => "/static/$1",
"^/(.*)$" => "/code.py/$1"
)
Avec certaines versions de lighttpd, il est important de s’assurer que la propriété “check-local” du paramètre fastcgi.server est bien positionné à “false”, surtout si votre code.py est situé en dehors de la racine.
Si vous recevez un message d’erreur indiquant qu’il n’est pas possible d’importer flup, installez-le en ligne de commande en utilisant la commande “easy_install flup”.
Depuis la revision 145, il est nécessaire de définir une variable “bin-environment” dans la configuration de fastcgi si votre code utilise des redirections. Par exemple, si votre code redirige vers http://domain.com/ et que vous voyez l’URL http://domain.com/code.py/ dans la barre de navigation, vous devrez modifier la configuration de fastcgi.server de la manière suivante:
fastcgi.server = ( "/code.py" =>
((
"socket" => "/tmp/fastcgi.socket",
"bin-path" => "/path/to/root/code.py",
"max-procs" => 1,
"bin-environment" => (
"REAL_SCRIPT_NAME" => ""
),
"check-local" => "disable"
))
)
Apache
.. avec CGI
Ajoutez les lignes suivante à httpd.conf ou apache2.conf.
Alias /foo/static/ /path/to/static
ScriptAlias /foo/ /path/to/code.py
.. avec CGI en utilisant .htaccess
CGI est facile à configurer mais ce n’est pas la meilleure des solutions pour les sites à très fort trafic.
Ajoutez les lignes suivantes à votre fichier .htaccess:
Options +ExecCGI
AddHandler cgi-script .py
Ouvrez votre navigateur et aller à l’URL http://example.com/code.py/. N’oubliez pas le slash final, sinon vous aurez droit à une ‘page non trouvée’. Pour que ça fonctionne sans avoir à indiquer code.py dans l’URL, il faut activer le ‘mod_rewrite’ dans votre fichier ‘.htaccess’ (voir en fin de document).
Note: la manière dont web.py est implémenté provoque une erreur du module cgitb à cause de la capture du stdout. Voici une façon de contourner le problème:
import cgitb; cgitb.enable()
import sys
# ... import web etc here...
def cgidebugerror():
"""
""" _wrappedstdout = sys.stdout
sys.stdout = web._oldstdout
cgitb.handler()
sys.stdout = _wrappedstdout
web.internalerror = cgidebugerror
.. avec FastCGI
FastCGI est facile à configurer et est aussi performant que ‘mod_python’.
Ajoutez les lignes suivantes à votre fichier .htaccess:
<Files code.py> SetHandler fastcgi-script
</Files>
Malheureusement, et contrairement à lighttpd, Apache ne donne aucune indication demandant à votre script web.py de fonctionner comme un serveur FastCGI, il faut donc l’indiquer à web.py de façon explicite, en ajoutant le code suivant dans votre script code.py, juste avant la ligne
if __name__ == "__main__": :
web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(func, addr)
.. avec SCGI
Téléchargez et installez le module mod_scgi
modifier le fichier ‘httpd.conf’:
LoadModule scgi_module Modules/mod_scgi.so
SCGIMount / 127.0.0.1:8080
redémarrez le serveur Apache et lancer votre ‘code.py’ avec la commande suivante:
python code.py 127.0.0.1:8080 scgi
lancez votre navigateur et visitez l’adresse suivante 127.0.0.1 C’est aussi simple que ça…enfin, si ça marche du premier coup ;-)
.. avec mod_python
mod_python est aussi performant que FastCGI, mais il n’est pas aussi évident à configurer. Suivez le guide:
Pour Python 2.5, procédez comme suit:
cd /usr/lib/python2.5/wsgiref
# or in windows: cd /python2.5/lib/wsgiref
wget -O modpython_gateway.py http://projects.amor.org/misc/browser/modpython_gateway.py?format=raw
# or fetch the file from that address using your browser
Pour Python <2.5, procéder plutôt ceci:
cd /usr/lib/python2.4/site-packages
# or in windows: cd /python2.4/lib/site-packages
svn co svn://svn.eby-sarna.com/svnroot/wsgiref/wsgiref
cd wsgiref
wget -O modpython_gateway.py http://projects.amor.org/misc/browser/modpython_gateway.py?format=raw
# or fetch the file from that address using your browser
renommez votre script code.py en quelque chose comme codep.py et ajoutez le code suivant:
main = web.wsgifunc(web.webpyfunc(urls, globals()))
Dans votre fichier .htaccess, ajoutez:
AddHandler python-program .py
PythonHandler wsgiref.modpython_gateway::handler
PythonOption wsgi.application codep::main
Vous aurez surement aussi besoin d’ajouter une RewriteRule pour rediriger / vers /codep.py/
.. avec mod_wsgi
mod_wsgi est un nouveau module Apache plus performant que mod_python pour l’hébergement d’applications WSGI, et très facile à mettre en place.
A la fin de votre script code.py, ajoutez la ligne suivante:
application = web.wsgifunc(web.webpyfunc(urls, globals()))
mod_wsgi offre plusieurs façons différentes de spécifier l’URL pointant vers une application WSGI, mais une manière simple peut être d’ajouter le code suivant dans votre fichier ‘.htaccess’:
<Files code.py>
SetHandler wsgi-script
Options ExecCGI FollowSymLinks
</Files>
Si vous recevez un message d’erreur du style “ImportError: No module named web” dans le fichier error.log d’Apache, vous pouvez essayer de spécifier un chemin absolu dans votre script ‘code.py’ avant l’instruction ‘import web’:
import sys, os
abspath = os.path.dirname(__file__)
sys.path.append(abspath)
os.chdir(abspath)
import web
Plus d’information dans la section “Application Working Directory” sur Common problems with WSGI application.
Encore une fois, votre application devrait-être accessible à l’URL suivante: http://example.com/code.py/ (sans oublier le slash final!!!).
mod_rewrite pour Apache
Si vous voulez que webpy soit accessible par l’URL ‘http://example.com’ au lieu de ‘http://example.com/code.py/’ ajoutez les directives suivantes dans votre fichier .htaccess:
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_URI} !^/icons
RewriteCond %{REQUEST_URI} !^/favicon.ico$
RewriteCond %{REQUEST_URI} !^(/.*)+code.py/
RewriteRule ^(.*)$ code.py/$1 [PT]
</IfModule>
Si le script code.py est situé dans le sous-répertoire myapp/, changez la directive RewriteBase / en RewriteBase /myapp/.
Si vous avez d’autres fichiers statiques à exclure de la règle de réécriture (fichiers CSS ou des images), indiquez-les également ici, en dupliquant et adaptant la ligne RewriteCond %{REQUEST_URI} !^/icons. ,par exemple, autant de fois que nécessaire.
Pour plus d’information sur le module mod_rewrite et l’utilisation du fichier .htaccess, je vous conseille l’excellent article [URL Rewriting pour les nuls] (http://seo.feuxi.com/URL-Rewriting-pour-les-nuls.html).