https://bz.apache.org/bugzilla/show_bug.cgi?id=70041
Bug ID: 70041
Summary: Apache mod_rewrite Technical Details:
Incoherent/outdated
Product: Apache httpd-2
Version: 2.5-HEAD
Hardware: PC
URL: https://httpd.apache.org/docs/trunk/en/rewrite/tech.ht
ml#InternalRuleset
Status: UNCONFIRMED
Severity: normal
Priority: P2
Component: Documentation
Assignee: [email protected]
Reporter: [email protected]
Target Milestone: ---
The Ruleset Processing section of the Apache mod_rewrite Technical Details page
contains a very interesting graphical representation of rewriting, which would
be nice to move to a prominent page.
Unfortunately, the diagram and the text are incoherent as they stand, with
themselves, with the rest of the page and with the mod_rewrite reference
documentation. The diagram may have been accurate when it was drawn (when httpd
was called “Apache”), but mod_rewrite is now a lot more complicated.
A few specific issues:
1. Figure 1 assumes a triggered rule makes a substitution.
2. Figure 1 assumes a single phase (unlike the API phases section).
3. Figure 1 assumes all rules are processed, ignoring some forms of
"substitution" (see the RewriteRule specification for “-” and externals URLs).
4. The final paragraph claims the pattern is matched against the URL.
5. The final paragraph claims the URL is replaced with Substitution.
Ticket #52181 comment 6 mentions a few more.
By the way, it would help to bring the diagram closer to UML activity diagram
conventions, notably the start and end symbols. Example:
https://www.lucidchart.com/pages/tutorial/uml-activity-diagram#section_5
There may be a simplification possible in the diagram, but overall, solving all
this would complexify the diagram. André Malo even suggested to split the
diagram, which I believe is a good suggestion.
I am afraid the sources may not be available or public, but see Daniel Gruno's
comment 7 on that ticket.
Given that this general situation has persisted for more than a decade,
realistically, this will not be fixed overnight. Suggested mitigations:
* Labeling the figure as a simplified overview
* Adding some call for help reviewing that page and presumably other rewriting
pages (see https://lists.apache.org/thread/hrwk9yo4wqz322vnqjn5pgr2ltm095vr )
🅭🄍: https://www.philippecloutier.com/Common+infrastructure+licensing#its
--
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
