Feature/191 Step 3

[jaswrks]

Includes changes from:

• Convert line-delimited patterns to a regex; See: websharks/zencache#191 #155
• and changes introduced in the first draft of: Add inline documentation for new syntax; See: websharks/zencache#191 #162

---

• Includes additional changes that add support for *, **, ^, and $ in a list of custom URLs.
• Includes additional changes that add support for *, **, ^, and $ in calls to the new API Function: zencache::clearUrl($url)
• Improves support for *, **, ^, and $ in Sitemap URIs that should be cleared also.

[jaswrks]

@raamdev This is ready to be reviewed/merged now.

Note: Please merge this PR instead of #155, as this one includes all of the changes from that PR and then some.

---

Step 2 (i.e., inline documentation updates) are still being worked on in #162

[raamdev]

@jaswsinc Cool! I'll start testing and reviewing this now. :-)

[raamdev]

Tested ^/$, *, and ** with Custom URLs. All working as expected! Awesome! 💯 :-)

[raamdev]

@jaswsinc Just to confirm, this can be merged into 000000-dev despite #162 not being finished yet, correct?

[jaswrks]

I should note that any custom URLs that are listed (to be cleared automatically) are taken almost literally. Therefore, in a Multisite Network you will need to list URLs that you want to exclude, not URIs that apply to every site in the network. I think that's desirable anyway.

The same is true for domain mapping. If you want to clear URLs for a mapped domain, the URLs that you list should include the mapped domain.

With all of that being said, since wildcards are supported, you can also do something like this to cover all domains if you need to:

http://*/path/to/something/

[jaswrks]

The scheme (i.e., http:// or https:// is ignored), and both schemes are cleared automatically.

[jaswrks]

Just to confirm, this can be merged into 000000-dev despite #162 not being finished yet, correct?

Yep :-) Great!

[raamdev]

@jaswsinc @kristineds Merged! Thanks! :-)