La funci贸n require_once() incluye y evalua el fichero especificado durante la ejecuci贸n del script. Se comporta de manera similar a require(), con la 煤nica diferencia que si el c贸digo ha sido ya incluido, no se volver谩 a incluir. Consultar la documentaci贸n de la funci贸n require() para obtener m谩s informaci贸n.
require_once() deber铆a de usarse en casos en los que un mismo fichero puede ser incluido y evaluado m谩s de una vez durante la ejecuci贸n de un script, y se quiere estar seguro que se incluye una sola vez para evitar problemas con redefiniciones de funciones, valores de funciones, etc.
Para consultar ejemplos que usen require_once() y include_once(), ver el c贸digo de PEAR incluido con las 煤ltimas versiones de PHP.
Nota: require_once() fue incorporado en PHP 4.0.1pl2
Nota: El comportamiento de de require_once() y include_once() puede que no sea el esperado en sistemas operativos en los que may煤sculas y min煤sculas se traten igual (como en Windows)
Ejemplo 16-8. Con require_once() no importan las may煤sculas y min煤sculas en Windows
<?php
require_once("a.php"); // this will include a.php
require_once("A.php"); // this will include a.php again on Windows!
?>
| Aviso |
Versiones de PHP para Windows anteriores a 4.3.0, no soportan el acceso remoto a archivos para esta funci贸n, no funcionar谩 ni activando siquiera allow_url_fopen. |
Ver tambi茅n require(), include(), include_once(), get_required_files(), get_included_files(), readfile(), y virtual().