dl
(PHP 4, PHP 5, PHP 7, PHP 8)
dl — Lädt eine PHP-Erweiterung zur Laufzeit
Beschreibung
$extension_filename): bool
   Lädt die im Parameter extension_filename 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 die php.ini, oder mittels dl()).
Diese Funktion wurde in PHP 5.3.0 aus den meisten SAPIs entfernt, und in PHP 7.0.0 aus PHP-FPM.
Parameter-Liste
- 
extension_filename
- 
      Dieser Parameter ist nur der Dateiname der zu ladenden Erweiterung, welcher von der Plattform abhängig ist. Z.B. würde die Erweiterung sockets (wenn als shared module kompiliert, nicht standardmäßig!) auf Unix-Plattformen sockets.so heißen, und auf Windows-Plattformen php_sockets.dll. Das Verzeichnis, von wo aus die Erweiterung geladen wird, hängt von der 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-debugerstellt wurde oder nicht
- ob PHP mit (experimenteller) 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).
 <install-dir>/lib/php/extensions/<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.
- 
         
          ob PHP mit 
Rückgabewerte
   Gibt bei Erfolg true zurück. Bei einem Fehler 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 Erweiterung 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 Konstante PHP_SHLIB_SUFFIX
if (!extension_loaded('sqlite')) {
    $prefix = (PHP_SHLIB_SUFFIX === 'dll') ? 'php_' : '';
    dl($prefix . 'sqlite.' . PHP_SHLIB_SUFFIX);
}
?>
Anmerkungen
Hinweis:
dl() unterscheidet auf Unix-Plattformen zwischen Groß- und Kleinschreibung.
Siehe auch
- Direktiven zum Laden von Erweiterungen
- extension_loaded() - Prüft, ob eine Erweiterung geladen ist
 
                     
                     
                     
                     
                    
 
          