Función PHP file_get_contents()

En este artículo, veremos cómo leer el archivo completo en una string usando la función file_get_contents(), además de comprender su implementación a través del ejemplo.

La función file_get_contents() en PHP es una función incorporada que se usa para leer un archivo en una string. La función utiliza técnicas de mapeo de memoria que son compatibles con el servidor y, por lo tanto, mejoran el rendimiento, lo que la convierte en la forma preferida de leer el contenido de un archivo. La ruta del archivo a leer, que se envía como parámetro a la función y devuelve los datos leídos en caso de éxito y FALSO en caso de error.

Sintaxis:  

file_get_contents($path, $include_path, $context, 
                              $start, $max_length)

Parámetros: La función file_get_contents() en PHP acepta un parámetro obligatorio y cuatro parámetros opcionales.  

  • $ruta : especifica la ruta del archivo o directorio que desea verificar.
  • $include_path : es un parámetro opcional que busca un archivo en el archivo en include_path (en php.ini) también si está configurado en 1.
  • $context : es un parámetro opcional que se usa para especificar un contexto personalizado.
  • $start : es un parámetro opcional que se utiliza para especificar el punto de inicio en el archivo para la lectura.
  • $max_length : es un parámetro opcional que se utiliza para especificar la cantidad de bytes que se leerán.

Valor de retorno: Devuelve los datos leídos en caso de éxito y FALSO en caso de error.

Enfoque: para colocar el archivo en la string, usaremos la función file_get_contents(). Para el primer ejemplo, especificaremos el enlace URL como un argumento que redirigirá al sitio dado. Para el segundo ejemplo, genere el nombre de archivo «gfg.txt» que contiene los datos. Esta función leerá el archivo en una string y representará el contenido en consecuencia.

Errores y excepciones :  

  • Si desea abrir un archivo con caracteres especiales, como espacios, primero debe codificarse con urlencode().
  • La función file_get_contents() devuelve FALSO booleano, pero también puede devolver un valor no booleano que se evalúa como FALSO.
  • Se genera un error de nivel E_WARNING si no se puede encontrar el nombre de archivo, la longitud máxima es menor que cero o si falla la búsqueda del desplazamiento especificado en la secuencia.

Considere el siguiente ejemplo.

Input:  file_get_contents('https://www.geeksforgeeks.org/');
Output: A computer science portal for geeks

Input:  file_get_contents('gfg.txt', FALSE, NULL, 0, 14);
Output: A computer science portal for geeks

Ejemplo 1 : El siguiente ejemplo ilustra la función file_get_contents().

PHP

<!DOCTYPE html>
  
<body>
    <?php
        // Reading contents from the
        // geeksforgeeks homepage
        $homepage = file_get_contents(
            "https://www.geeksforgeeks.org/");
        echo $homepage;
    ?>
</body>
</html>

Salida :

PHP file_get_contents() Function

Ejemplo 2 : este ejemplo ilustra cómo colocar el archivo en una string.

PHP

<!DOCTYPE html>
<body>
    <?php
        // Reading 36 bytes starting from
        // the 0th character from gfg.txt
        $text = file_get_contents('gfg.txt', false, NULL, 0, 36);
        echo $text;
    ?>
</body>
</html>

Salida

A computer science portal for geeks

Referencia: http://php.net/manual/en/function.file-get-contents.php

Publicación traducida automáticamente

Artículo escrito por Shubrodeep Banerjee y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *