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:
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 11-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().
