(PHP 4, PHP 5, PHP 7)
dl — Lädt eine PHP-Erweiterung (Extension) zur Laufzeit
$library
) : bool
Lädt die mittels dem Parameter library angegebene
PHP-Erweiterung.
Verwenden Sie extension_loaded() um zu testen, ob die gewünschte Erweiterung bereits verfügbar ist oder nicht. Dies funktioniert sowohl bei eingebauten, als auch bei dynamisch geladenen Erweiterungen (entweder durch php.ini, oder mittels dl()).
Diese Funktion wurde von den meisten SAPIs in PHP 5.3.0 entfernt, und von PHP-FPM in PHP 7.0.0.
libraryDieser Parameter ist nur der Dateiname der zu ladenden Erweiterung (Extension), welcher von Ihrer Plattform abhängig ist. Z.B. würde die Extension sockets (wenn als shared module kompiliert, nicht standardmäßig!) auf Unix Plattformen sockets.so, und auf Windows Plattformen php_sockets.dll heißen.
Das Verzeichnis, von wo aus die Erweiterung geladen wird, hängt von Ihrer Plattform ab:
Windows - Wenn nicht explizit in der php.ini angegeben, wird die Erweiterung standardmäßig von c:\php5\ geladen.
Unix - Wenn nicht explizit in der php.ini angegeben, hängt das standardmäßige Verzeichnis ab von:
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. Ist die Funktionalität des Ladens von Modulen nicht
verfügbar, oder wurde sie deaktiviert (entweder durch Deaktivieren von enable_dl oder durch Aktivieren von Safe Mode
in der php.ini), wird ein E_ERROR ausgegeben, und die
Ausführung gestoppt. Scheitert dl() weil die angegebene
Erweiterung nicht geladen werden konnte, wird zusätzlich zu FALSE eine
E_WARNING Meldung ausgegeben.
Beispiel #1 dl() Beispiele
<?php
// Beispiel für das Laden einer Extension je nach Betriebssystem
if (!extension_loaded('sqlite')) {
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
dl('php_sqlite.dll');
} else {
dl('sqlite.so');
}
}
// Oder unter Verwendung der PHP_SHLIB_SUFFIX Konstante
if (!extension_loaded('sqlite')) {
$prefix = (PHP_SHLIB_SUFFIX === 'dll') ? 'php_' : '';
dl($prefix . 'sqlite.' . PHP_SHLIB_SUFFIX);
}
?>
| Version | Beschreibung |
|---|---|
| 7.0.0 | dl() wurde in PHP-FPM deaktiviert. |
| 5.3.9 | dl() wurde in PHP-FPM aktiviert; allerdings wird davon abgeraten. |
| 5.3.0 | dl() ist nun in einigen SAPIs aufgrund von Stabilitätsproblemen deaktiviert. Die einzigen SAPIs, die dl() erlauben, sind CLI und Embed. Statt dessen sollten die Direktiven zum Laden von Extensions verwendet werden. |
Hinweis:
dl() wird nicht unterstützt, wenn PHP mit ZTS-Unterstützung erstellt wurde. Statt dessen müssen die Direktiven zum Laden von Extensions verwendet werden.
Hinweis:
dl() unterscheidet auf Unix-Plattformen zwischen Groß- und Kleinschreibung.
Hinweis: Diese Funktion steht im Safe Mode nicht zur Verfügung.