Viele Poster haben Probleme beim Debuggen ihrer RewriteRule- und RewriteCond-Anweisungen in ihren .htaccessDateien. Die meisten von ihnen verwenden einen gemeinsam genutzten Hosting-Dienst und haben daher keinen Zugriff auf die Root-Server-Konfiguration. Sie können die Verwendung von .htaccessDateien zum Umschreiben nicht vermeiden und können ein RewriteLogLevel nicht aktivieren ", wie viele Befragte vorschlagen. Außerdem gibt es viele .htaccessspezifische Fallstricke und Einschränkungen, die nicht gut abgedeckt sind. Das Einrichten eines lokalen Test-LAMP-Stapels erfordert für die meisten zu viel Lernaufwand .

Meine Frage hier ist also, wie wir empfehlen würden, dass sie ihre Regeln selbst debuggen . Ich gebe unten einige Vorschläge. Andere Vorschläge wären willkommen.

1. Verstehen Sie, dass die mod_rewrite-Engine .htaccessDateien durchläuft . Der Motor führt diese Schleife aus:

   do
     execute server and vhost rewrites (in the Apache Virtual Host Config)
     find the lowest "Per Dir" .htaccess file on the file path with rewrites enabled
     if found(.htaccess)
        execute .htaccess rewrites (in the user's directory)
   while rewrite occurred
   

   Ihre Regeln werden also wiederholt ausgeführt. Wenn Sie den URI-Pfad ändern, werden möglicherweise andere .htaccessDateien ausgeführt, sofern diese vorhanden sind. Stellen Sie daher sicher, dass Sie diese Schleife beenden, falls erforderlich, indem Sie zusätzliche hinzufügen, um das Auslösen RewriteCondvon Regeln zu stoppen. Löschen Sie auch alle .htaccessRegelsätze zum Umschreiben auf niedrigerer Ebene, es sei denn, Sie möchten ausdrücklich mehrstufige Regelsätze verwenden.

2. Stellen Sie sicher, dass die Syntax jedes Regexp korrekt ist, indem Sie anhand einer Reihe von Testmustern testen, ob diese eine gültige Syntax ist und mit einer Reihe von Test-URIs das tut, was Sie beabsichtigen. Siehe Antwort unten für weitere Details.

3. Erstellen Sie Ihre Regeln schrittweise in einem Testverzeichnis. Sie können die Funktion "Die tiefste .htaccessDatei auf dem Pfad ausführen " verwenden, um hier ein separates Testverzeichnis (Baum) einzurichten und Regelsätze zu debuggen, ohne Ihre Hauptregeln zu vermasseln und die Arbeit Ihrer Site zu stoppen. Sie müssen sie einzeln hinzufügen, da dies die einzige Möglichkeit ist, Fehler in einzelnen Regeln zu lokalisieren.

4. Verwenden Sie einen Dummy-Skript-Stub, um Server- und Umgebungsvariablen auszugeben . (Siehe Listing 2 ) Wenn Ihre App beispielsweise verwendet, blog/index.phpkönnen Sie diese kopieren test/blog/index.phpund zum Testen Ihrer Blog-Regeln im testUnterverzeichnis verwenden. Sie können auch Umgebungsvariablen verwenden, um sicherzustellen, dass die Rewrite-Engine die Substitutionszeichenfolgen korrekt interpretiert, z

   RewriteRule ^(.*) - [E=TEST0:%{DOCUMENT_ROOT}/blog/html_cache/$1.html]
   

   und suchen Sie nach diesen REDIRECT_ * -Variablen im phpinfo-Dump. Übrigens habe ich dieses verwendet und auf meiner Website festgestellt, dass ich es %{ENV:DOCUMENT_ROOT_REAL}stattdessen verwenden musste. Im Fall einer Redirector-Schleife listen die Variablen REDIRECT_REDIRECT_ * den vorherigen Durchgang auf. Etc..

5. Stellen Sie sicher, dass Sie nicht von Ihrem Browser gebissen werden, der falsche 301-Weiterleitungen zwischenspeichert . Siehe Antwort unten . Mein Dank geht an Ulrich Palha dafür.

6. Die Rewrite-Engine scheint empfindlich auf kaskadierte Regeln innerhalb eines .htaccessKontexts zu reagieren (hier RewriteRuleführt dies zu einer Substitution und dies fällt jedoch auf weitere Regeln), da ich Fehler mit internen Unteranforderungen (1) und eine falsche PATH_INFO- Verarbeitung gefunden habe, die häufig auftreten kann wird durch Verwendung der Flags [NS], [L] und [PT] verhindert.

Noch mehr Kommentare oder Vorschläge?

Listing 1 - phpinfo

<?php phpinfo(INFO_ENVIRONMENT|INFO_VARIABLES);

Hier sind einige zusätzliche Tipps zum Testen von Regeln, die das Debuggen für Benutzer auf Shared Hosting erleichtern können

1. Verwenden Sie einen Fake-User-Agenten

Fügen Sie beim Testen einer neuen Regel eine Bedingung hinzu, um sie nur mit einem fakeBenutzeragenten auszuführen , den Sie für Ihre Anforderungen verwenden. Auf diese Weise wirkt sich dies nicht auf andere Personen auf Ihrer Website aus.

z.B

#protect with a fake user agent
RewriteCond %{HTTP_USER_AGENT}  ^my-fake-user-agent$
#Here is the actual rule I am testing
RewriteCond %{HTTP_HOST} !^www\.domain\.com$ [NC] 
RewriteRule ^ http://www.domain.com%{REQUEST_URI} [L,R=302] 

Wenn Sie Firefox verwenden, können Sie mit dem User Agent Switcher die gefälschte User Agent-Zeichenfolge erstellen und testen.

2. Verwenden Sie 301 erst, wenn Sie mit dem Testen fertig sind

Ich habe so viele Posts gesehen, in denen Leute immer noch ihre Regeln testen und 301s verwenden. NICHT .

Wenn Sie auf Ihrer Website nicht Vorschlag 1 verwenden, sind nicht nur Sie, sondern alle Personen, die Ihre Website zu diesem Zeitpunkt besuchen, von der 301 betroffen.

Denken Sie daran, dass sie permanent sind und von Ihrem Browser aggressiv zwischengespeichert werden. Verwenden Sie stattdessen eine 302, bis Sie sicher sind, und ändern Sie sie dann in eine 301.

3. Denken Sie daran, dass 301 in Ihrem Browser aggressiv zwischengespeichert werden

Wenn Ihre Regel nicht funktioniert und für Sie richtig aussieht und Sie die Vorschläge 1 und 2 nicht verwendet haben, testen Sie sie erneut, nachdem Sie Ihren Browser-Cache geleert haben oder während Sie privat surfen.

4. Verwenden Sie ein HTTP-Erfassungstool

Verwenden Sie ein HTTP-Erfassungstool wie Fiddler , um den tatsächlichen HTTP-Verkehr zwischen Ihrem Browser und dem Server anzuzeigen.

Während andere sagen könnten, dass Sie es sind site does not look right, können Sie dies stattdessen sehen und melden all of the images, css and js are returning 404 errorsund das Problem schnell eingrenzen.

Während andere Ihnen dies melden, können Sie started at URL A and ended at URL Csehen, dass sie bei begonnen haben URL A, were 302 redirected to URL B and 301 redirected to URL C. Selbst wenn URL C das ultimative Ziel war, werden Sie wissen, dass dies schlecht für SEO ist und behoben werden muss.

Sie können Cache-Header anzeigen, die auf der Serverseite festgelegt wurden, Anforderungen wiedergeben, Anforderungsheader zum Testen ändern ....

Online-Test zum Umschreiben von .htaccess

Ich habe diese Googling for RegEx-Hilfe gefunden. Sie hat mir viel Zeit gespart, da ich bei .htaccessjeder kleinen Änderung neue Dateien hochladen musste .

von der Website:

htaccess-Tester

Um Ihre Regeln für das Umschreiben von htaccess zu testen, geben Sie einfach die URL ein, auf die Sie die Regeln anwenden, platzieren Sie den Inhalt Ihres htaccess im größeren Eingabebereich und klicken Sie auf "Jetzt prüfen".

Vergessen Sie nicht, dass es sich bei .htaccess-Dateien um eine relative URL handelt, die übereinstimmt.

In einer .htaccess-Datei stimmt die folgende RewriteRule niemals überein:

RewriteRule ^/(.*)     /something/$s

Stellen Sie sicher, dass die Syntax jedes Regexp korrekt ist

Testen Sie anhand einer Reihe von Testmustern, um sicherzustellen, dass dies eine gültige Syntax ist und dass Sie mit einer ganzen Reihe von Test-URIs das tun, was Sie beabsichtigen.

Sehen Datei regexpCheck.php finden Sie ein einfaches Skript, das Sie einem privaten / Testverzeichnis auf Ihrer Site hinzufügen können, um dies zu unterstützen. Ich habe mich eher kurz als hübsch gehalten. Fügen Sie dies einfach in eine Datei regexpCheck.phpin einem Testverzeichnis ein, um es auf Ihrer Website zu verwenden. Auf diese Weise können Sie reguläre Ausdrücke erstellen und diese anhand einer Liste von Testfällen testen. Ich verwende hier die PHP-PCRE-Engine, aber nachdem ich mir die Apache-Quelle angesehen habe, ist diese im Grunde identisch mit der in Apache verwendeten. Es gibt viele HowTos und Tutorials, die Vorlagen bereitstellen und Ihnen beim Aufbau Ihrer Regexp-Fähigkeiten helfen können.

Listing 1 - regexpCheck.php

<html><head><title>Regexp checker</title></head><body>
<?php 
    $a_pattern= isset($_POST['pattern']) ? $_POST['pattern'] : "";
    $a_ntests = isset($_POST['ntests']) ? $_POST['ntests'] : 1;
    $a_test   = isset($_POST['test']) ? $_POST['test'] : array();

    $res = array(); $maxM=-1; 
    foreach($a_test as $t ){
        $rtn = @preg_match('#'.$a_pattern.'#',$t,$m);
        if($rtn == 1){
            $maxM=max($maxM,count($m));
            $res[]=array_merge( array('matched'),  $m );
        } else {
            $res[]=array(($rtn === FALSE ? 'invalid' : 'non-matched'));
        }
    } 
?> <p>&nbsp; </p>
<form method="post" action="<?php echo $_SERVER['SCRIPT_NAME'];?>">
    <label for="pl">Regexp Pattern: </label>
    <input id="p" name="pattern" size="50" value="<?php echo htmlentities($a_pattern,ENT_QUOTES,"UTF-8");;?>" />
    <label for="n">&nbsp; &nbsp; Number of test vectors: </label>
    <input id="n" name="ntests"  size="3" value="<?php echo $a_ntests;?>"/>
    <input type="submit" name="go" value="OK"/><hr/><p>&nbsp;</p>
    <table><thead><tr><td><b>Test Vector</b></td><td>&nbsp; &nbsp; <b>Result</b></td>
<?php 
    for ( $i=0; $i<$maxM; $i++ ) echo "<td>&nbsp; &nbsp; <b>\$$i</b></td>";
    echo "</tr><tbody>\n";
    for( $i=0; $i<$a_ntests; $i++ ){
        echo '<tr><td>&nbsp;<input name="test[]" value="', 
            htmlentities($a_test[$i], ENT_QUOTES,"UTF-8"),'" /></td>';
        foreach ($res[$i] as $v) { echo '<td>&nbsp; &nbsp; ',htmlentities($v, ENT_QUOTES,"UTF-8"),'&nbsp; &nbsp; </td>';}
        echo "</tr>\n";
    }
?> </table></form></body></html>

Stellen Sie sicher, dass Sie das Prozentzeichen vor Variablen verwenden, nicht das Dollarzeichen.

Es ist %{HTTP_HOST}, nicht ${HTTP_HOST} . Es wird nichts im error_log geben, es wird keine internen Serverfehler geben, Ihr regulärer Ausdruck ist immer noch korrekt, die Regel stimmt einfach nicht überein. Dies ist wirklich abscheulich, wenn Sie viel mit Django / Genshi-Vorlagen arbeiten und eine ${}variable Substitution im Muskelgedächtnis haben.

Eine von ein paar Stunden, die ich verschwendet habe:

Wenn Sie alle diese Tipps angewendet haben und nur 500 Fehler auftreten, weil Sie keinen Zugriff auf das Serverfehlerprotokoll haben, liegt das Problem möglicherweise nicht im .htaccess, sondern in den Dateien, zu denen es umleitet.

Nachdem ich mein .htaccess-Problem behoben hatte, verbrachte ich noch zwei Stunden damit, es noch einmal zu beheben, obwohl ich einfach einige Berechtigungen vergessen hatte.

Legen Sie Umgebungsvariablen fest und verwenden Sie Header, um sie zu empfangen:

Sie können neue Umgebungsvariablen mit RewriteRule-Zeilen erstellen, wie von OP erwähnt:

RewriteRule ^(.*) - [E=TEST0:%{DOCUMENT_ROOT}/blog/html_cache/$1.html]

Aber wenn Sie ein serverseitiges Skript nicht zum Laufen bringen können, wie können Sie dann diese Umgebungsvariable lesen? Eine Lösung besteht darin, einen Header zu setzen:

Header set TEST_FOOBAR "%{REDIRECT_TEST0}e"

Der Wert akzeptiert Formatbezeichner , einschließlich des %{NAME}eBezeichners für Umgebungsvariablen (vergessen Sie nicht den Kleinbuchstaben e). Manchmal müssen Sie das REDIRECT_Präfix hinzufügen , aber ich habe nicht herausgefunden, wann das Präfix hinzugefügt wird und wann nicht.

Wenn Sie Umleitungen erstellen, testen Sie mit Curl , um Probleme beim Zwischenspeichern des Browsers zu vermeiden. Verwenden Sie -I, um nur http-Header abzurufen. Verwenden Sie -L, um alle Weiterleitungen zu verfolgen.

Ich habe diese Frage gefunden, als ich versucht habe, meine mod_rewrite-Probleme zu debuggen, und sie enthält definitiv einige hilfreiche Ratschläge. Am Ende ist es jedoch am wichtigsten, sicherzustellen, dass Ihre Regex-Syntax korrekt ist. Aufgrund von Problemen mit meiner eigenen RE-Syntax war die Installation des Skripts regexpCheck.php keine praktikable Option.

Da Apache jedoch PCREs (Perl-Compatible Regular Expressions) verwendet, sollte jedes Tool, das beim Schreiben von PCREs hilft, hilfreich sein. Ich habe in der Vergangenheit das Tool von RegexPlanet mit Java- und Javascript-REs verwendet und war froh, dass sie auch Perl unterstützen.

Geben Sie einfach Ihren regulären Ausdruck und eine oder mehrere Beispiel-URLs ein und Sie erfahren, ob der reguläre Ausdruck übereinstimmt (eine "1" in der Spalte "~ =") und gegebenenfalls übereinstimmende Gruppen (die Zahlen in der "Aufteilung"). Die Spalte entspricht den Zahlen, die Apache erwartet, z. B. $ 1, $ 2 usw.) für jede URL. Sie behaupten, die PCRE-Unterstützung sei "in der Beta", aber es war genau das, was ich brauchte, um meine Syntaxprobleme zu lösen.

http://www.regexplanet.com/advanced/perl/index.html

Ich hätte einer vorhandenen Antwort einfach einen Kommentar hinzugefügt, aber mein Ruf ist noch nicht auf diesem Niveau. Hoffe das hilft jemandem.

In Bezug auf 4. müssen Sie immer noch sicherstellen, dass Ihr "Dummy-Skript-Stub" tatsächlich die Ziel-URL ist, nachdem das Umschreiben abgeschlossen ist, sonst sehen Sie nichts!

Ein ähnlicher / verwandter Trick (siehe diese Frage ) ist das Einfügen einer temporären Regel wie:

RewriteRule (.*) /show.php?url=$1 [END]

Wo show.phpist ein sehr einfaches Skript, das nur seine anzeigt$_GET Parameter (Sie können auch Umgebungsvariablen anzeigen, wenn Sie möchten).

Dadurch wird das Umschreiben an dem Punkt gestoppt, an dem Sie es in den Regelsatz einfügen, ähnlich wie bei einem Haltepunkt in einem Debugger.

Wenn Sie Apache <2.3.9 verwenden, müssen Sie [L]statt verwenden [END], und Sie müssen möglicherweise Folgendes hinzufügen:

RewriteRule ^show.php$ - [L]

Ganz oben in Ihrem Regelsatz, wenn die URL /show.phpselbst neu geschrieben wird.

Einige Fehler, die ich beobachtet habe, passieren beim Schreiben .htaccess

Verwendung von ^(.*)$wiederholt in mehreren Regeln, mit^(.*)$ dass andere Regeln in den meisten Fällen machtlos sind, da sie mit der gesamten URL in einem einzigen Treffer übereinstimmen.

Wenn wir also eine Regel für diese URL verwenden sapmle/url, wird diese URL ebenfalls verwendet sapmle/url/string.

[L] Das Flag sollte verwendet werden, um sicherzustellen, dass unsere Regel verarbeitet wurde.

Sollte wissen über:

Unterschied in% n und $ n

%nwird während des %{RewriteCond}Teils abgeglichen und $nentspricht dem %{RewriteRule}Teil.

Funktionieren von RewriteBase

Die RewriteBase-Direktive gibt das URL-Präfix an, das für RewriteRule-Direktiven pro Verzeichnis (htaccess) verwendet werden soll, die einen relativen Pfad ersetzen.

Diese Anweisung ist erforderlich, wenn Sie einen relativen Pfad in einer Ersetzung im Kontext pro Verzeichnis (htaccess) verwenden, es sei denn, eine der folgenden Bedingungen ist erfüllt:

Die ursprüngliche Anforderung und die Ersetzung befinden sich unter dem DocumentRoot (im Gegensatz dazu, dass sie mit anderen Mitteln wie Alias ​​erreichbar sind). Der Dateisystempfad zu dem Verzeichnis, das die RewriteRule enthält, an das die relative Ersetzung angehängt ist, ist auch als URL-Pfad auf dem Server gültig (dies ist selten). In Apache HTTP Server 2.4.16 und höher kann diese Anweisung weggelassen werden, wenn die Anforderung über Alias ​​oder mod_userdir zugeordnet wird.

Wenn Sie mehr als nur eine Regelzeile in .htacesss schreiben möchten,
denken Sie nicht einmal daran, eine dieser Hotfix -Methoden zum Debuggen auszuprobieren .

Ich habe Tage damit verschwendet, mehrere Regeln ohne Feedback von LOGs festzulegen, um schließlich aufzugeben.
Ich habe Apache auf meinem PC installiert, die gesamte Site auf die Festplatte kopiert und den gesamten Regelsatz mithilfe der Protokolle sehr schnell aussortiert.
Dann überprüfte ich meine alten Regeln, die funktionierten. Ich sah, dass sie nicht wirklich das taten, was gewünscht wurde. Eine Zeitbombe mit einer etwas anderen Adresse.

Es gibt so viele Grubenstürze bei Umschreiberegeln, dass es überhaupt keine logische Sache ist.
Sie können Apache in zehn Minuten zum Laufen bringen, es ist 10 MB groß, eine gute Lizenz, * NIX / WIN / MAC bereit, auch ohne Installation.
Überprüfen Sie auch die Kopfzeilen Ihres Servers und holen Sie sich dieselbe Version von Apache aus dem Archiv, falls diese alt ist. Mein OP ist immer noch auf 2.0; Viele Dinge werden nicht unterstützt.

Ich werde das hier belassen , vielleicht ein offensichtliches Detail, aber ich habe stundenlang mit dem Kopf geschlagen: Sei vorsichtig, %{REQUEST_URI}denn was @Krist van Besien in seiner Antwort sagt, ist völlig richtig, aber nicht für die REQUEST_URI-Zeichenfolge , weil das Ergebnis ist TestString beginnt mit a /. Also pass auf dich auf:

RewriteCond %{REQUEST_URI} ^/assets/$  
                            ^
                            | check this pesky fella right here if missing

(Ähnlich wie bei der Doin-Idee) Um zu zeigen, was übereinstimmt, verwende ich diesen Code

$keys = array_keys($_GET);
foreach($keys as $i=>$key){
    echo "$i => $key <br>";
}

Speichern Sie es in r.php im Server-Stammverzeichnis und führen Sie dann einige Tests in .htaccess durch
. Beispielsweise möchte ich URLs abgleichen, die nicht mit einem Sprachpräfix beginnen

RewriteRule ^(?!(en|de)/)(.*)$ /r.php?$1&$2 [L] #$1&$2&...
RewriteRule ^(.*)$ /r.php?nomatch [L] #report nomatch and exit

Wie von @JCastell hervorgehoben, kann der Online-Tester einzelne Weiterleitungen anhand einer .htaccess-Datei gut testen. Interessanter ist jedoch die API , die zum Batch-Testen einer Liste von URLs mit einem JSON-Objekt verwendet werden kann. Um es jedoch nützlicher zu machen, habe ich eine kleine Bash-Skriptdatei geschrieben, die curl und jq verwendet , um eine Liste von URLs zu senden und die json-Antwort in eine CSV-formatierte Ausgabe zu analysieren, deren Zeilennummer und Regel in der htaccess-Datei übereinstimmen Zusammen mit der umgeleiteten URL ist es sehr praktisch, eine Liste von URLs in einer Tabelle zu vergleichen und schnell festzustellen, welche Regeln nicht funktionieren.

Wenn Sie mit URL arbeiten, möchten Sie möglicherweise überprüfen, ob Sie "Mod Rewrite aktivieren" aktivieren.