You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by bu...@apache.org on 2010/11/28 16:03:35 UTC

DO NOT REPLY [Bug 50354] New: clearify ModMimeUsePathInfo documentation

https://issues.apache.org/bugzilla/show_bug.cgi?id=50354

           Summary: clearify ModMimeUsePathInfo documentation
           Product: Apache httpd-2
           Version: 2.3-HEAD
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: Documentation
        AssignedTo: docs@httpd.apache.org
        ReportedBy: calestyo@scientia.net


The ModMimeUsePathInfo at
http://httpd.apache.org/docs/2.2/mod/mod_mime.html#modmimeusepathinfo should be
clarified:

The given example (/bar/foo.shtml) could be easily misunderstood that /bar/ is
a director containing the file foo.shtml.

It would be better to have something like "/bar.txt/additionPathinfo/type.html"
and to explain which of the two extensions are (txt and html) are now parsed
for the different things (type, charset, encoding, etc.) and which of them
overrides.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


DO NOT REPLY [Bug 50354] clearify ModMimeUsePathInfo documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50354

--- Comment #1 from Igor Galić <i....@brainsware.org> 2010-11-28 17:10:19 EST ---
I think the confusion starts with:

"""If you have a request for /bar/foo.shtml where /bar is a Location and
ModMimeUsePathInfo is On"""

Given that it's not linked to the <Location> documentation, and not put in
<code> either, but still written with a a capital ``L'' is very confusing.


I think the example would be much more clear if we added something like:

<Location /bar>
  AddOutputFilter INCLUDES .shtml
  ModMimeUsePathInfo On
</Location>

If /bar is part of your application, that for some obscure reason produces
.shtml output, httpd will now parse it.

Or how about:

<Location /bar>
    AddOutputFilter DEFLATE .html
    ModMimeUsePathInfo On
</Location>

Adding now .html to your fancy SEO URLs will have your content compressed on
the fly.


Of course the same is valid if you have Links like
/index.php/modulename/actionname/idnumber.html

<Files index.php>
  AddOutputFilter INCLUDES .shtml
  AddOutputFilter DEFLATE .html
  ModMimeUsePathInfo On
</Files>

etc...

Does that make more sense now? Should I add that to the docs?

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


DO NOT REPLY [Bug 50354] clearify ModMimeUsePathInfo documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50354

Igor Galić <i....@brainsware.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|REOPENED                    |RESOLVED
         Resolution|                            |FIXED

--- Comment #7 from Igor Galić <i....@brainsware.org> 2010-12-01 10:17:43 EST ---
r1041047.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


DO NOT REPLY [Bug 50354] clearify ModMimeUsePathInfo documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50354

--- Comment #3 from Igor Galić <i....@brainsware.org> 2010-11-28 18:11:49 EST ---
My only problem is making that damn thing work at all. (Knowing how it works
generally makes documenting it easier ;)

My config looks like this:

<VirtualHost *:80>
        DocumentRoot /home/i.galic/Projects/bomb.ground
        ServerName bomb.ground

        AddOutPutFilter INCLUDES .shtml

        <Directory /home/i.galic/Projects/bomb.ground>
                Options +MultiViews
                Require all granted
                DirectoryIndex index.php
                ModMimeUsePathInfo On
        </Directory>
        #FallBackResource /index.php
</VirtualHost>

Now, every request for an index.html or index.txt which look like this:

<html>
        <head>
                <title>Silly SSI</title>
        </head>
        <body>
<!--#echo var="DATE_GMT" -->
        </body>
</html>

ends in a 404.
Every request for index.php which has the echo line changed to:
<?php
echo '<!--#echo var="DATE_GMT" -->'. "\n"
?>

Ends in a blank page -- i.e.: No display of DATE_GMT.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


DO NOT REPLY [Bug 50354] clearify ModMimeUsePathInfo documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50354

Christoph Anton Mitterer <ca...@scientia.net> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |REOPENED
         Resolution|FIXED                       |

--- Comment #6 from Christoph Anton Mitterer <ca...@scientia.net> 2010-12-01 09:15:07 EST ---
Hi Igor.

Some words seems to be missing here:

>If you have a request for <code>/index.php/foo.shtml</code> where ><code>/index.php</code> ???????????????? <module>mod_mime</module> will

Cheers,
Chris.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


DO NOT REPLY [Bug 50354] clearify ModMimeUsePathInfo documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50354

--- Comment #2 from Christoph Anton Mitterer <ca...@scientia.net> 2010-11-28 17:51:53 EST ---
I guess it makes sense,... but not sure whether adding extra <Location>
sections here makes the example unnecessarily complicated for beginners.

If we take: http://httpd.apache.org/docs/2.2/mod/core.html#acceptpathinfo
They simply use "/test/here.html/more" and it's clear to everybody that
"/test/here.html" is the location (small "l"),... regardless of whether it's an
existing file, directory (with not "more" subdir", something defined via
Alias,Redirect,<Location>, etc.
... and that "more" is the "extra thingy".

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


DO NOT REPLY [Bug 50354] clearify ModMimeUsePathInfo documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50354

Igor Galić <i....@brainsware.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|                            |FIXED

--- Comment #5 from Igor Galić <i....@brainsware.org> 2010-12-01 08:36:04 EST ---
r1041003.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


DO NOT REPLY [Bug 50354] clearify ModMimeUsePathInfo documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50354

--- Comment #4 from Igor Galić <i....@brainsware.org> 2010-11-28 18:30:28 EST ---
That is, because I forgot AcceptPathInfo On
Now all files deliver nothing.. Great. BUT. If we do something like:

        <Directory /home/i.galic/Projects/bomb.ground>
                Options +MultiViews IncludesNoExec
                Require all granted
                AddOutputFilter Includes shtml
                DirectoryIndex index.php
                ModMimeUsePathInfo On
        </Directory>
        FallBackResource /index.php

Everything works as expected -- even better so: The request for
http://bomb.ground/foo/bar/baz.shtml will be "rewritten" (with
FallbackResource) to /index.php which produces SSI, which is interpreted by
httpd.

Proposed patch:

Index: mod/mod_mime.xml
===================================================================
--- mod/mod_mime.xml    (revision 1039792)
+++ mod/mod_mime.xml    (working copy)
@@ -693,13 +693,12 @@
       ModMimeUsePathInfo On
     </example>

-    <p>If you have a request for <code>/bar/foo.shtml</code> where
-    <code>/bar</code> is a Location and <directive
-    >ModMimeUsePathInfo</directive> is <code>On</code>,
-    <module>mod_mime</module> will treat the incoming request as
-    <code>/bar/foo.shtml</code> and directives like <code>AddOutputFilter
-    INCLUDES .shtml</code> will add the <code>INCLUDES</code> filter to the
-    request. If <directive>ModMimeUsePathInfo</directive> is not set, the
+    <p>If you have a request for <code>/index.php/foo.shtml</code> where
+    <code>/index.php</code> <module>mod_mime</module> will now treat the
+    incoming request as <code>/index.php/foo.shtml</code> and directives
+    like <code>AddOutputFilter INCLUDES .shtml</code> will add the
+    <code>INCLUDES</code> filter to the request. If <directive
+    >ModMimeUsePathInfo</directive> is not set, the
     <code>INCLUDES</code> filter will not be added.</p>
 </usage>
 <seealso><directive module="core">AcceptPathInfo</directive></seealso>

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org