Différences explicites entre <Directory> et <DirectoryMatch> (et d'autres directives <* Match>)

Préface

Je suis très néophyte des serveurs Web. J'installe un serveur Apache2 et examine actuellement la documentation.

J'ai remarqué que la <Directory>, <Location>et les <Files>directives ont chacune une correspondante <*Match>directive: <DirectoryMatch>, <LocationMatch>et <FilesMatch>respectivement. La différence en surface est assez apparente:

• <*Match> les directives prennent une expression régulière comme argument
• Les directives non-Match prennent comme argument une chaîne simple ou un glob de style shell.

Curieusement, les directives non-Match peuvent également recevoir une expression régulière comme argument si elle est précédée d'un '~'. Ainsi, les deux lignes suivantes doivent être identiques:

# From the Apache2 docs
<Directory ~ "^/www/[0-9]{3}"> ... </Directory>
<DirectoryMatch "^/www/[0-9]{3}"> ... </DirectoryMatch>

Des questions

Ce que j'aimerais savoir, c'est s'il y a ou non des différences subtiles ou clés à savoir que les coredocuments d'Apache ne mentionnent pas. La <DirectoryMatch>section mentionne une différence subtile:

Compatibilité

Avant la 2.3.9 , cette directive s'appliquait implicitement aux sous-répertoires (comme <Directory>) et ne pouvait pas correspondre au symbole de fin de ligne ($). Dans 2.3.9 et versions ultérieures , seuls les répertoires qui correspondent à l'expression sont affectés par les directives jointes.

Au-delà, j'aimerais savoir:

• Existe-t-il d'autres différences entre les directives Match et non-Match?
• Quelle directive est plus préférable lorsqu'une expression régulière est requise?
• Avez-vous d'autres informations pertinentes?

Remarques

• <DirectoryMatch>et <Directory "~">sont au même niveau de fusion
• Bien qu'il ne soit pas explicitement mentionné, il <Directory "~">peut utiliser des groupes nommés et des références arrières, tout comme <DirectoryMatch>.

La différence réside dans le type de paramètre autorisé:

<Directory directory-path> ... </Directory>

contre

<DirectoryMatch regex> ... </DirectoryMatch>

DirectoryMatchest un sur-ensemble, en ce qui concerne les fonctionnalités, car vous pourrez coder n'importe quel chemin en tant que regex. L'inverse n'est pas vrai.

Directory ~est probablement un ajout tardif. Basé sur un commit trouvé dans le référentiel (commit 07b82419b59d1bb7ba8860b86a2d381d5d1090bc en novembre 1996), ce cas a été ajouté dans Apache 1.2

DirectoryMatch a ensuite été ajouté dans Apache 1.3 (commit a318749e61fda612e883a9ea594459a4517166b8 en juillet 1997) avec un ensemble de fonctionnalités plus riche.

Et la documentation mise à jour dans ce commit indique clairement que vous devriez privilégier la version de correspondance lorsque vous utilisez une expression régulière:

    <Directory ~ "^/www/.*/[0-9]{3}">
 </pre>

-would match directories in /www/ that consisted of three numbers.<p>
+would match directories in /www/ that consisted of three numbers. In
+Apache 1.3 and later, it is reccomended to use
+<a href="#directorymatch">&lt;DirectoryMatch&gt;</a> instead.<p>

(cette instruction "il est recommandé d'utiliser DirectoryMatch" a été supprimée plus tard dans un commit en août 1997)

DirectoryMatchest toujours supérieur car Directory ~ils ne sont traités qu'après des Directoryinstructions "normales" et DirectoryMatchvous permet de capturer des données que vous pourrez ensuite utiliser.

Lorsque vous utilisez une Matchexpression régulière , je privilégierais la variante car elle rend plus clair que vous utilisez une expression régulière, et non un cas spécifique de la variante non concordante. Outre les petites différences ci-dessus, cela ne ferait cependant pas une énorme différence.

UPDATE en fait probablement aucun changement de résultat puisque le code fait de même:

static const char *dirsection(cmd_parms *cmd, void *mconfig, const char *arg)
{

...

    if (!strcmp(cmd->path, "~")) {
        cmd->path = ap_getword_conf(cmd->pool, &arg);
        if (!cmd->path)
            return "<Directory ~ > block must specify a path";
        r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED|USE_ICASE);
        if (!r) {
            return "Regex could not be compiled";
        }
    }
    else if (thiscmd->cmd_data) { /* <DirectoryMatch> */
        r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED|USE_ICASE);
        if (!r) {
            return "Regex could not be compiled";
        }
    }

Exactement le même appel à r = ap_pregcomp(cmd->pool, cmd->path, AP_REG_EXTENDED|USE_ICASE);dans les deux cas.

Existe-t-il d'autres différences entre les directives Match et non-Match?

Pas strictement une différence entre les deux versions regex ( <Directory ~et <DirectoryMatch), mais certaines directives, telles que AllowOverrideet AllowOverrideList, ne sont autorisées que dans un <Directory>conteneur simple (non regex) . Donc, cela exclut les deux <Directory ~et <DirectoryMatch.

Référence:
https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride

Uniquement disponible dans les <Directory>sections
AllowOverride n'est valide que dans les <Directory>sections spécifiées sans expressions régulières, pas dans <Location>, <DirectoryMatch>ni dans les <Files>sections.