dl

FunctionParams and return types changed in PHP 8.0

Loads a PHP extension at runtime.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

dl Function synopsis

dl(string $extension_filename): bool

Parameters

$extension_filename

Typestring

This parameter is only the filename of the extension to load which also depends on your platform. For example, the sockets extension (if compiled as a shared module, not the default!) would be called sockets.so on Unix platforms whereas it is called php_sockets.dll on the Windows platform.

Return value

Typebool

Returns true on success, false on failure If the functionality of loading modules is not available or has been disabled (by setting enable_dloff in php.ini) an E_ERROR is emitted and execution is stopped. If dl fails because the specified library couldn't be loaded, in addition to false an E_WARNING message is emitted.

Changes to the dl Function

PHP 8.0

  • Return type added: bool
  • Parameter type added for parameter #1 ($extension_filename): string
- dl($extension_filename)
+ dl(string $extension_filename): bool

dl Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes