dl
(PHP 4, PHP 5, PHP 7)
dl — Lädt eine PHP-Erweiterung (Extension) zur Laufzeit
Beschreibung
$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.
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).
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 (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.
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);
}
?>
Changelog
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. |
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.
Hinweis: Diese Funktion steht im Safe Mode nicht zur Verfügung.
Siehe auch
- Direktiven zum Laden von Extensions
- extension_loaded() - Prüft ob eine Extension geladen ist
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-dl.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.