dl

Descripci贸n

int dl ( string biblioteca )

Carga la extensi贸n PHP dada por el par谩metro biblioteca. El par谩metro biblioteca es 煤nicamente el nombre de archivo de la extensi贸n a cargar, el cual tambi茅n depende de su plataforma. Por ejemplo, la extensi贸n sockets (si fue compilada como m贸dulo, 隆que no es el comportamiento predeterminado!) podr铆a llamarse sockets.so en plataformas Unix, mientras que se llama php_sockets.dll en la plataforma windows.

Devuelve TRUE si todo se llev贸 a cabo correctamente, FALSE en caso de fallo. Si la funcionalidad de carga de m贸dulos no est谩 disponible (ver Nota) o ha sido deshabilitada (ya sea mediante la desactivaci贸n de enable_dl o activando safe mode en php.ini) un E_ERROR es producido y se detiene la ejecuci贸n. Si dl() falla porque la biblioteca especificada no pudo ser cargada, se emite un mensaje E_WARNING en compa帽铆a del FALSE.

Use extension_loaded() para probar si una cierta extensi贸n ya se encuentra disponible o no. Esto funciona tanto con extensiones integradas como con las cargadas din谩micamente (ya sea mediante php.ini o dl()).

La funci贸n dl() es obsoleta a partir de PHP 5. Use el m茅todo de las Directivas de Carga de Extensiones en su lugar.

Ejemplo 1. Ejemplos de dl() <?php // Ejemplo de carga de una extension en base al SO if (!extension_loaded('sqlite')) {     if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {         dl('php_sqlite.dll');     } else {         dl('sqlite.so');     } } // O, usando la constante PHP_SHLIB_SUFFIX que esta disponible a // partir de PHP 4.3.0 if (!extension_loaded('sqlite')) {     $prefijo = (PHP_SHLIB_SUFFIX === 'dll') ? 'php_' : '';     dl($prefijo . 'sqlite.' . PHP_SHLIB_SUFFIX); } ?>

El directorio desde donde es cargada la extensi贸n depende de su plataforma:

Windows - Si no est谩 definida expl铆citamente en php.ini, la extensi贸n es cargada desde c:\php4\extensions\ por defecto.

Unix - Si no est谩 definida expl铆citamente en php.ini, el directorio de extensiones predeterminado depende de

• si PHP ha sido compilado con --enable-debug o no

• si PHP ha sido compilado con soporte ZTS (Zend Thread Safety) (experimental) o no

• el valor interno ZEND_MODULE_API_NO actual (n煤mero interno de API de m贸dulo Zend, el cual es b谩sicamente la fecha en la que ocurri茅 un cambio significativo en la API de m贸dulo, p.ej. 20010901)

Tomando en cuenta lo anterior, el directorio recibe el valor predeterminado de <dir-instalacion>/lib/php/extensions/ <debug-o-no>-<zts-o-no>-ZEND_MODULE_API_NO, p.ej. /usr/local/php/lib/php/extensions/debug-non-zts-20010901 o /usr/local/php/lib/php/extensions/no-debug-zts-20010901.

Vea tambi茅n Directivas de Carga de Extensi贸n y extension_loaded().