dl
(PHP 4, PHP 5, PHP 7, PHP 8)
dl — Lädt eine PHP-Erweiterung (Extension) zur Laufzeit
Beschreibung
dl
( string $library
) : bool
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()).
Warnung
Diese Funktion wurde von den meisten SAPIs in PHP 5.3.0 entfernt,
und von PHP-FPM in PHP 7.0.0.
Parameter-Liste
-
library
-
Dieser 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:
-
ob PHP mit
--enable-debug
erstellt wurde oder nicht
-
ob PHP mit (experimentellem) ZTS (Zend Thread Safety) Unterstützung
erstellt wurde oder nicht
-
der aktuellen internen
ZEND_MODULE_API_NO
(Zend
interne Modul API Nummer, welche im Grunde das Datum der letzten
größeren Modul API Änderung darstellt, z.B.
20010901
).
Das obige in Betracht gezogen, ist das standardmäßige Verzeichnis
<php-install-directory>/lib/php/extension/<debug-or-not>-<zts-or-not>-ZEND_MODULE_API_NO
,
z.B.
/usr/local/php/lib/php/extensions/debug-non-zts-20010901
oder
/usr/local/php/lib/php/extensions/no-debug-zts-20010901.
Rückgabewerte
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 (durch Deaktivieren von enable_dl
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.
Beispiele
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);
}
?>
Anmerkungen
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.