diff options
| author | Michael Merickel <michael@merickel.org> | 2016-11-19 03:16:30 -0600 |
|---|---|---|
| committer | Michael Merickel <michael@merickel.org> | 2016-11-21 23:32:16 -0600 |
| commit | 7ba90759841b62cee5aee411f08772c753049338 (patch) | |
| tree | 9a37ec8d37ee45550d385bc2ed3dd0dec717759a /docs/narr/vhosting.rst | |
| parent | 3c5db5881058b730d9ce5ad0e49667c28ad63e25 (diff) | |
| download | pyramid-7ba90759841b62cee5aee411f08772c753049338.tar.gz pyramid-7ba90759841b62cee5aee411f08772c753049338.tar.bz2 pyramid-7ba90759841b62cee5aee411f08772c753049338.zip | |
remove the deprecated IContextURL
Diffstat (limited to 'docs/narr/vhosting.rst')
| -rw-r--r-- | docs/narr/vhosting.rst | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/docs/narr/vhosting.rst b/docs/narr/vhosting.rst index 0edf03353..e4cee9882 100644 --- a/docs/narr/vhosting.rst +++ b/docs/narr/vhosting.rst @@ -26,20 +26,20 @@ Hosting an Application Under a URL Prefix ``http://example.com/``). If you use a "pure Python" environment, this functionality can be provided by -Paste's `urlmap <http://pythonpaste.org/modules/urlmap.html>`_ "composite" WSGI -application. Alternatively, you can use :term:`mod_wsgi` to serve your +`rutter <http://rutter.readthedocs.io/en/latest/>`_, forming a "composite" +WSGI application. Alternatively, you can use :term:`mod_wsgi` to serve your application, which handles this virtual hosting translation for you "under the hood". -If you use the ``urlmap`` composite application "in front" of a :app:`Pyramid` +If you use the ``rutter`` composite application "in front" of a :app:`Pyramid` application or if you use :term:`mod_wsgi` to serve up a :app:`Pyramid` application, nothing special needs to be done within the application for URLs -to be generated that contain a prefix. :mod:`paste.urlmap` and :term:`mod_wsgi` +to be generated that contain a prefix. Rutter and :term:`mod_wsgi` manipulate the :term:`WSGI` environment in such a way that the ``PATH_INFO`` and ``SCRIPT_NAME`` variables are correct for some given prefix. Here's an example of a PasteDeploy configuration snippet that includes a -``urlmap`` composite. +``rutter`` composite. .. code-block:: ini :linenos: @@ -48,13 +48,13 @@ Here's an example of a PasteDeploy configuration snippet that includes a use = egg:mypyramidapp [composite:main] - use = egg:Paste#urlmap + use = egg:rutter#urlmap /pyramidapp = mypyramidapp This "roots" the :app:`Pyramid` application at the prefix ``/pyramidapp`` and serves up the composite as the "main" application in the file. -.. note:: If you're using an Apache server to proxy to a Paste ``urlmap`` +.. note:: If you're using an Apache server to proxy to a ``urlmap`` composite, you may have to use the `ProxyPreserveHost <http://httpd.apache.org/docs/2.2/mod/mod_proxy.html#proxypreservehost>`_ directive to pass the original ``HTTP_HOST`` header along to the |