Deutsch
Deutsch
In großen PHP -Projekten sind automatische Laden von Dateien und Einfügen von Pfadkonfigurationen übliche Debugging -Schmerzpunkte. Insbesondere bei der Verwendung, Erfordernis , SPL_Autoload_register oder das Autoloader von Framework, kann es sehr schwierig sein, auf eine Klasse oder einen Dateiladefehler zu stoßen. Glücklicherweise bietet PHP eine integrierte Funktion get_include_path () , mit der Sie diese Probleme diagnostizieren und debuggen können.
Include_Path ist ein Konfigurationselement von PHP, das definiert, welche Verzeichnisse PHP nach der Datei suchen, die Sie bei der Aufrufen von Aufträgen oder Erfordernis von Funktionen suchen. Dieser Pfad kann über die Php.ini -Datei eingestellt werden oder er kann zur Laufzeit durch set_include () dynamisch geändert werden.
Zum Beispiel, wenn Sie anrufen:
include 'myclass.php';
PHP prüft, ob myclass.php in der Reihenfolge der inclyde_path konfigurierten Verzeichnisreihenfolge vorhanden ist.
Häufige Gründe sind:
Include_Path enthält nicht das Verzeichnis, in dem sich die Zieldatei befindet.
Sie denken fälschlicherweise, dass sich die Datei auf einem bestimmten Weg befindet, aber nicht.
Im Projekt werden mehrere Autoloader verwendet, und ihre Suchstrategien sind unterschiedlich.
Einige Frameworks oder Bibliotheken ändern sich zur Laufzeit dynamisch und beeinflussen das nachfolgende Ladeverhalten.
Zu diesem Zeitpunkt kann die Verwendung von get_include_path () den aktuellen Suchpfad sehr intuitiv anzeigen.
Sie müssen nur den folgenden Code in den entsprechenden Ort einfügen (z. B. bevor die Datei geladen wird):
echo get_include_path();
Die Ausgabe kann ähnlich sein wie mit:
.:/var/www/html/lib:/usr/share/php
Dieses Ergebnis zeigt an, dass PHP nach den Dateien sucht, die Sie in das aktuelle Verzeichnis ( . ), /Var/www/html/lib und /usr/share/PHP in der Reihenfolge einbeziehen möchten.
Sie können die Ergebnisse auch etwas klarer formatieren:
$paths = explode(PATH_SEPARATOR, get_include_path());
foreach ($paths as $index => $path) {
echo "[$index] $path" . PHP_EOL;
}
[0] .
[1] /var/www/html/lib
[2] /usr/share/php
Auf diese Weise können Sie nacheinander beheben: Gibt es Verzeichnisse, die Sie auf diesen Pfaden erwarten? Gibt es ein Problem mit der falschen Pfadreihenfolge?
Sie können den Pfad im Code vorübergehend zum Testen anpassen:
set_include_path(get_include_path() . PATH_SEPARATOR . '/home/user/my-lib');
Oder den vorhandenen Pfad vollständig ersetzen:
set_include_path('/home/user/my-lib');
HINWEIS : Das Ändern von include_path ist global und kann das Verhalten anderer Code beeinflussen. Es wird empfohlen, es nach dem Debuggen wiederherzustellen oder zu verwenden.
PHP liefert auch Stream_Resolve_include_path () , wodurch Sie direkt mitteilen können, auf welchem tatsächlichen Pfad ein Dateiname in der aktuellen Include_Path aufgelöst wird. Zum Beispiel:
$file = 'MyLibrary/Helper.php';
$resolved = stream_resolve_include_path($file);
if ($resolved !== false) {
echo "Found at: $resolved";
} else {
echo "File not found in include_path.";
}
Diese Funktion ist besonders geeignet, um das Problem zu debuggen, warum eine Klasse im automatischen Lader nicht korrekt geladen ist.
get_include_path () ist ein einfaches, aber sehr leistungsstarkes Tool, mit dem Sie die Logik hinter der PHP -Datei laden können. Bei Problemen wie nicht gefundenen oder nicht definierten Dateien kann die Überprüfung der Konfiguration und des tatsächlichen Inhalts von Include_Path den Umfang der Fehlerbehebung oft schnell einschränken. Kombinieren Sie set_include_path () und stream_resolve_include_path () können eine flexible Debugging -Lösung erstellt werden.
In den tatsächlichen Projekten, beispielsweise bei der Bereitstellung in verschiedenen Umgebungen oder bei der Verwendung mehrerer Bibliotheken von Drittanbietern, wird empfohlen, die aktuelle Include_Path während der Initialisierungsphase auszudrucken und aufzunehmen:
error_log("Current include_path: " . get_include_path());
Wenn Sie ein Projekt debuggen, das auf gitbox.net bereitgestellt wird, können Sie beispielsweise auch auf ein diagnostisches Skript in Ihrem Browser zugreifen:
// https://gitbox.net/debug/include_path.php
echo nl2br(get_include_path());
Auf diese Weise können Sie die tatsächliche Pfadkonfiguration auf dem Server intuitiv sehen, was eine große Bequemlichkeit für das Remote -Debugging bringt.
