Commit 3c951d94 authored by Gabriel Hurley's avatar Gabriel Hurley
Browse files

[1.2.X] Fixed #14775 -- Backports the changes in [13772], which documented an...

[1.2.X] Fixed #14775 -- Backports the changes in [13772], which documented an undocumented feature from 1.0. Thanks to jweyrich for the report, and timo and leovitch for the patch (again).

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@14748 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent a647d0b8
Loading
Loading
Loading
Loading
+2 −0
Original line number Diff line number Diff line
.. _howto-deployment-modpython:

============================================
How to use Django with Apache and mod_python
============================================
+18 −3
Original line number Diff line number Diff line
@@ -35,6 +35,21 @@ All attributes except ``session`` should be considered read-only.

    Example: ``"/music/bands/the_beatles/"``

.. attribute:: HttpRequest.path_info

    Under some web server configurations, the portion of the URL after the host
    name is split up into a script prefix portion and a path info portion
    (this happens, for example, when using the ``django.root`` option
    with the :ref:`modpython handler from Apache <howto-deployment-modpython>`).
    The ``path_info`` attribute always contains the path info portion of the
    path, no matter what web server is being used. Using this instead of
    attr:`~HttpRequest.path` can make your code much easier to move between test
    and deployment servers.

    For example, if the ``django.root`` for your application is set to 
    ``"/minfo"``, then ``path`` might be ``"/minfo/music/bands/the_beatles/"``
    and ``path_info`` would be ``"/music/bands/the_beatles/"``.

.. attribute:: HttpRequest.method

    A string representing the HTTP method used in the request. This is
+19 −0
Original line number Diff line number Diff line
@@ -869,3 +869,22 @@ permalink()
The :func:`django.db.models.permalink` decorator is useful for writing short
methods that return a full URL path. For example, a model's
``get_absolute_url()`` method. See :func:`django.db.models.permalink` for more.

get_script_prefix() 
------------------- 
 
.. function:: get_script_prefix() 
 
.. versionadded:: 1.0 
 
Normally, you should always use :func:`~django.core.urlresolvers.reverse` or 
:func:`~django.db.models.permalink` to define URLs within your application. 
However, if your application constructs part of the URL hierarchy itself, you 
may occasionally need to generate URLs. In that case, you need to be able to 
find the base URL of the Django project within its web server 
(normally, :func:`~django.core.urlresolvers.reverse` takes care of this for  
you). In that case, you can call ``get_script_prefix()``, which will return the 
script prefix portion of the URL for your Django project. If your Django 
project is at the root of its webserver, this is always ``"/"``, but it can be 
changed, for instance  by using ``django.root`` (see :ref:`How to use 
Django with Apache and mod_python <howto-deployment-modpython>`). 
 No newline at end of file