Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.

com

Gestin de archivos en PHP

Autores del manual Este manual ha sido realizado por los siguientes colaboradores de DesarrolloWeb.com: Rubn Alvarez Miguel Angel Alvarez Rene Sterling Neira
Redactor de DesarrolloWeb.com http://www.desarrolloweb.com (4 captulos) Director de DesarrolloWeb.com http://www.desarrolloweb.com (5 captulos) Webmaster de Blasten.com http://www.blasten.com (2 captulos) (1 captulo)

Alfredo Anaya

Director Tcnico de ADR Formacion http://www.adrformacion.com (1 captulo)

Emmanuel Garca De Caro

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Gestin de archivos por PHP

El tratamiento de archivos resulta ser una prctica muy comn en cualquier sitio web. Muy a menudo nos vemos en la necesidad de procesar un texto para cambiarle el formato, buscar una cadena en su interior o cualquier otro tipo de operacin. PHP propone un sinfn de funciones para la gestin de archivos que van desde las ms elementales de apertura, lectura y cierre a otras ms rebuscadas como el clculo de espacio en el disco duro, tamao del archivo, gestin de derechos de acceso... En este artculo pretendemos mostraros cules son las funciones ms esenciales para el tratamiento de archivos para posteriormente ejemplificarlas en un par de scripts que os pueden resultar tiles: Funciones de gestin de archivos Funci n copy rename Copia un archivo Cambia el nombre del archivo de $antes a $despues Descripcin Sintaxis copy($origen,$destino) rename($antes, $despues) unlink($archivo)

unlink Borra el archivo

Funciones para la lectura de archivos Funcin fopen fgets fwrite fseek feof Descripcin Abre un archivo y le asigna un identificador id. Veremos el modo ms adelante Lee una lnea de un archivo hasta un numero mximo de caracteres Escribe una cadena dentro del archivo Avanza o retrocede el puntero del archivo un cierto numero de posiciones Comprueba si el puntero que lee el archivo ha llegado al final Sintaxis $id = Fopen($archivo, $modo) fgets($id,$max) fwrite($id, $cadena) fseek($id,$posiciones) feof($id) fpassthru($id) fclose($id)

fpassthr lee completamente el archivo y lo muestra u fclose Cierra el archivo abierto previamente

Las operaciones ms elementales, copia, borrado y cambiar el nombre, requieren nicamente el nombre (y path) del archivo sobre el cual se ejerce la operacin. Para operaciones ms complejas, como la lectura de lneas o la escritura de texto dentro del archivo, se requiere de una previa apertura del archivo al cual le asignaremos un indentificador $id. Una vez abierto el archivo, podremos desplazarnos a lo largo de l por medio de un puntero imaginario que avanza o retrocede por las lneas de texto y mediante el cual nos situaremos en el lugar escogido para insertar, modificar o simplemente copiar una cadena. Existen distintos modos de apertura que nos permiten definir las acciones que podemos realizar sobre el archivo. Aqu os mostramos los diferentes modos que, como veris, son de lo ms variado: Modos de apertura de archivos Sintaxi Descripcin
2

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

s 'r' 'r+' 'w' 'w+' 'a' 'a+' Slo lectura Lectura y escritura Slo escritura Lectura y escritura. Suprime el contenido anterior si se escribe. El archivo es creado si no existe. Slo escritura. El archivo es creado si no existe y el puntero se coloca al final. Lectura y escritura. El archivo es creado si no existe y el puntero se coloca al final.

A notar que si tratamos con archivos en binario hemos de colocar una b delante del modo (ej. ba, bw+,...) Recordamos que esta lista no es ms que una recopilacion y que muchas otras funciones relacionadas pueden sernos tambin tiles.
Nota:Tambin puedes profundizar ms en la gestin de archivos con nuestro manual Gestin de archivos en PHP

Artculo por Rubn Alvarez

Lectura secuencial de archivos con PHP

Sigamos con nuestro aprendizaje prctico del uso de ficheros en PHP. Ya hemos visto cmo abrir un archivo por medio de la funcin fopen con un ejemplo prctico de cmo verificar una URL. El paso siguiente es aprender a leer el contenido del archivo, tarea que llevaremos a cabo por medio de la funcin fgets. Esta funcin se encarga de leer lnea a lnea el contenido de un archivo texto por lo que su utilizacin ha de ser incluida dentro de una estructura de tipo bucle. En el ejemplo que os mostramos a continuacin nos hemos servido de esta lectura secuencial para localizar dentro del texto una cadena cualquiera a la que, a continuacin, le cambiamos el formato para ponerla en negrita por medio de la etiqueta <b>. Esto nos puede resultar til si llevamos a cabo bsquedas internas en nuestro sitio y queremos resaltar la cadena de bsqueda en el texto de la pgina encontrada. Evidentemente, la utilidad de fgets resulta ser mucho ms amplia. Podemos emplearla, por ejemplo, con archivos remotos para extraer las etiquetas meta o para muchas otras cosas que se nos puedan ocurrir. Aqu os proponemos el script: <? function negrita($path,$cadena) { //Iniciamos la variable $texto = ""; //Abrimos el archivo en modo lectura $fp = fopen($path,"r");
Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin. 3

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

//Leemos linea por linea el contenido del archivo while ($linea= fgets($fp,1024)) { //Sustituimos las ocurrencias de la cadena que buscamos $linea = str_replace($cadena,"<b>$cadena</b>", $linea); //Anadimos la linea modificada al texto $texto .= $linea; } return $texto; } //Definimos el path y la cadena $path="escribe el camino de acceso a tu archivo"; $cadena = "escribe tu cadena"; //Llamamos la funcion $texto = negrita ($path,$cadena); //Mostramos el texto echo $texto; ?> Podis ver el resultado de esta funcin en una variante del script donde hemos incluido un formulario para recibir el parmetro cadena y que busca las ocurrencias dentro del texto de este mismo articulo: Introduce la cadena de bsqueda:
Buscar!

El script es utilizado en forma de funcin para facilitaros su empleo y almacenamiento. Su modo de actuar es el siguiente: Inicializa la variable texto en la cual iremos almacenando las lneas ledas en el bucle. Abre el archivo (local o remoto) en modo lectura por medio de la funcin fopen. Lee una por una las lneas del archivo hasta una longitud de 1024 caracteres y remplaza las posibles ocurrencias de la cadena de bsqueda por la misma cadena colocada entre las etiquetas <b> y </b> por medio de la funcin str_replace. El texto, modificado o no, es almacenado en la variable texto. Devolvemos la variable texto como resultado de la funcin.

El resto de script es simplemente un ejemplo de llamada a la funcin donde los parmetros path y cadena han de ser especificados. Artculo por Rubn Alvarez

Escritura en archivos con PHP

Siguiendo con la gestin de archivos por medio de PHP, en este artculo veremos los pasos
Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin. 4

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

elementales para la creacin y escritura de un archivo texto por medio de esta tecnologa de lado servidor. Tras haber visto como funciona la lectura secuencial de un archivo, podemos imaginar que escribir sobre ste no debe de resultar mucho ms complicado. Por otra parte, las posibilidades que estas dos operaciones nos pueden ofrecer conjuntamente son realmente sorprendentes. Sin ir ms lejos, y guardando las distancias, escribir y leer archivos puede en cierta manera sustituir muy primariamente a una base de datos. En efecto, si por diversas razones (hosting, presupuesto, conocimientos...) nos resulta difcil la puesta en marcha de una base de datos elemental, siempre podremos solventar el inconveniente almacenando nuestros datos en archivos que luego podrn ser ledos. Por supuesto, este mtodo no tiene nada de seguro ni de verstil y slo es valido para un sitio sin informacin confidencial y con poca cantidad de datos. Podemos pensar tambin en crear documentos dinmicos a partir de datos introducidos en un formulario: cartas, pginas HTML y otros. Otro ejemplo particularmente prctico es la creacin dinmica de archivos que nos ahorren recursos de servidor. Imaginemos que tenemos una pgina, o archivo, en nuestro sitio que carga muy frecuentemente y que realiza constantemente llamadas a bases de datos o ejecuta scripts medianamente largos. Si el contenido que estamos mostrando es el mismo para todos los usuarios y no tiene necesidad de ser actualizado constantemente, podemos contentarnos con crear un script accesorio que ejecute una nica vez el script principal y que almacene su resultado en forma de archivo HTML que ser en realidad el que mostraremos a nuestros visitantes. De esta forma, evitamos por una parte la ejecucin masiva de un mismo script con el consiguiente ahorro de recursos y por otra automatizamos la actualizacin de una determinada pgina o seccin ejecutando peridicamente el script accesorio. La escritura de archivos pasa, como es de esperar, por la previa apertura de archivo en un modo apropiado. Una vez abierto, el paso siguiente ser introducir por medio de la funcin fwrite, o su alias fputs, la cadena que deseamos incluir en nuestro archivo. Para ejemplificar esta nueva funcin de escritura y combinarla con la de lectura, fgets, os proponemos este contador inspirado en una nota de la pgina oficial de PHP: <? function incremento_contador($archivo) { // $archivo contiene el numero que actualizamos $contador = 0; //Abrimos el archivo y leemos su contenido $fp = fopen($archivo,"r"); $contador = fgets($fp, 26); fclose($fp); //Incrementamos el contador ++$contador; //Actualizamos el archivo con el nuevo valor $fp = fopen($archivo,"w+"); fwrite($fp, $contador, 26); fclose($fp);

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

echo "Este script ha sido ejecutado $contador veces"; } ?> Aqu podis ver el resultado producido cuando llamamos a esta funcin. Como en otros ejemplos, el script es expresado en forma de funcin para que sea ms sencilla su reutilizacin. Las etapas que llevamos a cabo son verdaderamente cortas y comprensibles: Iniciamos nuestra variable contador. Abrimos el archivo en modo lectura y extraemos el valor actual del contador leyendo la primera y nica lnea. Cerramos el archivo. Aumentamos de una unidad el valor de contador. Abrimos el archivo y lo sobrescribimos (modo +w) con el valor contador modificado.

Ni que decir tiene que para que este tipo de scripts funcionen, el archivo al que queremos acceder ha de estar autorizado para lectura y escritura. La funcin fwrite puede ser utilizada tambin para enviar datos en otros tipos de aperturas como son las de sockets o de programas. Pero esto ya es otra historia... Artculo por Rubn Alvarez

Gestin de directorios por PHP

Siguiendo con la saga de artculos referentes a la explotacin de archivos por medio de PHP, vamos a presentar algunas funciones que nos pueden ser muy tiles en la navegacin por directorios. Este tipo de funciones podran, por ejemplo, servirnos para crear exploradores de archivos en nuestro navegador. Descripcin Sintaxis $dir = opendir($path) readdir($dir) rmdir($dir) mkdir($path, $derechos) rewinddir($dir) closedir($dir)

nciones de gestin de directorios

uncin

pendir Abre un directorio situado en $path y le asigna un identificador $dir Lee un elemento del directorio $dir abierto previamente con opendir y desplaza el puntero al elemento siguiente Elimina el directorio $dir Crea un directorio situado en $path con los derechos de acceso $derechos (entero)

eaddir

mdir

mkdir

winddi Vuelve el puntero de lectura del directorio $dir al primer elemento r

osedir Cierra el directorio $dir abierto previamente con opendir

La forma de tratar con estas funciones es la similar a la que ya hemos visto para le lectura secuencial de archivos. Podemos distinguir tres etapas elementales: Apertura del directorio por medio de la funcin opendir asignndole al mismo tiempo un
6

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

identificador Realizacin de las tareas necesarias en relacin con ese directorio Clausura del identificador por medio de la funcin closedir

A notar que, para que un directorio pueda ser borrado, hace falta previamente haber eliminado cada uno de los elementos contenidos dentro del directorio. Para esto, nos podemos servir de la funcin unlink, presentada en otor artculo. Por otra parte, la creacin de un directorio por medio de la funcin mkdir requiere la definicin de los derechos de acceso por medio de un numero entero. Esperamos poder explicar en qu consisten estos derechos prximamente. Como ejemplo sencillo de lo que podemos hacer con estas funciones, aqu os presentamos un pequeo script de lectura que os permite visualizar el contenido de un directorio: <? //definimos el path de acceso $path = "mi/camino"; //abrimos el directorio $dir = opendir($path); //Mostramos las informaciones while ($elemento = readdir($dir)) { echo $elemento."<br>"; } //Cerramos el directorio closedir($dir); ?> Otra forma de abordar la gestin de directorios es por medio de la clase dir que permite la creacin de un objeto sobre el cual podremos aplicar toda una serie de mtodos equivalentes a las funciones previamente vistas. Si estas familiarizado con la programacin orientada a objetos, puede que esta modalidad te resulte mas intuitiva. Si no sabes en qu consiste la programacin orientada a objetos, puedes visitar este artculo. En este caso, la forma de operar es anloga a la ya vista: Creamos un objeto $dir con la instruccin: $dir = dir($path) Realizamos las tareas necesarias llamando a los mtodos de la clase dir Cerramos el directorio con el mtodo close

Algunos de los mtodos que podemos utilizar con esta clase son los siguientes: Mtodos de la clase dir Mtodo path read rewind Descripcin Indica el path del directorio Lee un elemento del directorio Vuelve el puntero de lectura del directorio al primer elemento Sintaxis $objeto->path $objeto->read $objeto>rewind

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

close Cierra el directorio

$objeto->close

Como ejemplo, he aqu el script equivalente al abordado para el caso de las funciones, esta vez usando la clase dir: <? //definimos el path de acceso $path="mi/camino/"; //instanciamos el objeto $dir=dir($path); //Mostramos las informaciones echo "Directorio ".$dir>path.":<br><br>"; while ($elemento = $dir->read()) { echo $elemento."<br>"; } //Cerramos el directorio $dir->close(); ?> Los scripts propuestos no son ms que ejemplos sencillos de lo que estas funciones pueden ofrecernos. En vuestras manos queda el combinar estas funciones con otras vistas en este mismo taller de manera a crear aplicaciones que gestionen los archivos y directorios de vuestro servidor. Recordamos que esta lista no es ms que una recopilacin y que muchas otras funciones relacionadas pueden sernos tambin tiles. Artculo por Rubn Alvarez

Upload de archivos con PHP

En PHP tenemos muchas funcionalidades desarrolladas desde el principio y sin necesidad de instalar ningn aadido en nuestro servidor. Es el caso de subir archivos a un servidor web por HTTP y a travs de una pgina con un formulario, donde se permite seleccionar el archivo que queremos cargar de nuestro disco duro. El ejemplo se encuentra bien documentado en un montn de pginas para desarrolladores, sin ir ms lejos en la pgina de la propia tecnologa: http://www.php.net/manual/es/features.fileupload.php. Nosotros en este caso vamos a intentar ir un poco ms all, realizando un par de comprobaciones al subir el fichero y combinando en el mismo formulario campos de tipo file y tipo text. El formulario para subir seleccionar los archivos

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Es un formulario cualquiera, pero tiene una serie de particularidades y campos file, que no solemos utilizar habitualmente.
<form action="subearchivo.php" method="post" enctype="multipart/form-data"> <b>Campo de tipo texto:</b> <br> <input type="text" name="cadenatexto" size="20" maxlength="100"> <input type="hidden" name="MAX_FILE_SIZE" value="100000"> <br> <br> <b>Enviar un nuevo archivo: </b> <br> <input name="userfile" type="file"> <br> <input type="submit" value="Enviar"> </form>

Para empezar vemos que se ha colocado un nuevo atributo en el formulario: enctype="multipart/form-data", necesario para subir en un mismo formulario datos y archivos. Tambin tenemos el campo hidden MAX_FILE_SIZE, que sirve para indicar el tamao en bytes de los archivos a subir. Este campo algunos navegadores no tienen porqu entenderlo o hacerle caso. Adems, es fcil saltarse esa proteccin, por lo que deberemos en las propias pginas PHP comprobar que el archivo tenga el tamao que deseamos. Por ltimo, tenemos el campo tipo file, donde se seleccionar el archivo a subir. Tambin hemos colocado un campo de tipo text, para subir datos por POST de tipo texto acompaados a los datos binarios del archivo. Pgina que sube los archivos Esta pgina debe hacer las comprobaciones necesarias para saber si las caractersticas del archivo a subir son las que deseamos y realizar la copia del archivo en un directorio del servidor. Para hacer las comprobaciones, PHP nos crea una serie de variables que podemos acceder con la informacin del archivo enviado. $HTTP_POST_FILES['userfile']['name'] El nombre original del fichero en la mquina cliente. $HTTP_POST_FILES['userfile']['type'] El tipo mime del fichero (si el navegador lo proporciona). Un ejemplo podra ser "image/gif". $HTTP_POST_FILES['userfile']['size'] El tamao en bytes del fichero recibido. $HTTP_POST_FILES['userfile']['tmp_name'] El nombre del fichero temporal que se utiliza para almacenar en el servidor el archivo recibido.
<? //tomo el valor de un elemento de tipo texto del formulario $cadenatexto = $_POST["cadenatexto"]; echo "Escribi en el campo de texto: " . $cadenatexto . "<br><br>";

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

//datos del arhivo $nombre_archivo = $HTTP_POST_FILES['userfile']['name']; $tipo_archivo = $HTTP_POST_FILES['userfile']['type']; $tamano_archivo = $HTTP_POST_FILES['userfile']['size']; //compruebo si las caractersticas del archivo son las que deseo if (!((strpos($tipo_archivo, "gif") || strpos($tipo_archivo, "jpeg")) && ($tamano_archivo < 100000))) { echo "La extensin o el tamao de los archivos no es correcta. <br><br><table><tr><td><li>Se permiten archivos .gif o .jpg<br><li>se permiten archivos de 100 Kb mximo.</td></tr></table>"; }else{ if (move_uploaded_file($HTTP_POST_FILES['userfile']['tmp_name'], $nombre_archivo)){ echo "El archivo ha sido cargado correctamente."; }else{ echo "Ocurri algn error al subir el fichero. No pudo guardarse."; } } ?>

Para empezar, recogemos el campo de texto enviado por POST, de la forma habitual. Aunque esto no tenga nada que ver con subir archivos, es muy normal que en el mismo formulario deseemos mezclar varios tipos de informacin. Luego se recogen los datos necesarios del archivo, como su nombre, extensin y tamao para, en el siguiente if, comprobar que la extensin sea .gif o .jpg y que el tamao menor que 100000 bytes. Si el archivo tena las caractersticas deseadas, se puede subir al servidor. Para ello se utiliza la funcin move_uploaded_file(), que recibe el nombre del archivo temporal que se desea subir y el nombre del archivo que se desea dar. Cuando se sube el archivo, el servidor lo copia en una localizacin temporal para que seamos nosotros los que elijamos la posicin definitiva donde queremos que se almacene. Si no lo copiamos a ningn sitio, despus de la ejecucin de la pgina, se borra de su localizacin temporal. La funcin move_uploaded_file() se utiliza para mover el archivo a la posicin definitiva. Recibe por un lado el nombre temporal del fichero y por otro el nombre que deseamos colocarle definitivamente y, si se desea, la ruta para llegar al directorio donde queremos guardarlo. En el caso del ejemplo slo se indica el nombre del archivo, por ello el fichero se subir al mismo directorio donde estn las pginas PHP que hacen el upload. Esta funcin devuelve un boleano que indica si hubo o no xito al subir el archivo.
Nota: Es importante sealar que el upload de archivos es un proceso crtico que puede dar lugar a errores y agujeros de seguridad. Por ejemplo, si los directorios destino estn protejidos contra escritura, nos dar un error. Podemos ver los errores comunes relatados en la pgina de PHP.

Recomendamos una vez ms ampliar esta informacin en la pgina de PHP: http://www.php.net/manual/es/features.file-upload.php Se pueden descargar los cdigos del ejemplo en este enlace. Artculo por Miguel Angel Alvarez

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

10

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Personalizacion de documentos con PHP

GENERAR CONTRATOS Este script sirve basicamente para remplazar varios textos que esten en la base de datos por unas respuestas dadas y almacenadas en una tabla.
<? /* CABEZA DEL FORMULARIO FUNCTION*/ cabeza_selector(); /* SEGMENTO PARA GUARDAS CLAUSULAS ASOCIADAS A LAS RESPUESTAS EN UNA TEMPORAL*/ $claves = mysql_query("select tem_claves.id_respuesta, tem_claves.id_pregunta, respuestas.detalle_respuesta, cuestionario.pregunta from tem_claves, respuestas, cuestionario where tem_claves.clave_excluyente = $id and respuestas.id_r_2 = tem_claves.id_respuesta and cuestionario.id = tem_claves.id_pregunta"); $numero = mysql_num_rows($claves); $claves2 = mysql_query("select tem_claves.id_respuesta, tem_claves.id_pregunta, respuestas.detalle_respuesta, cuestionario.pregunta from tem_claves, respuestas, cuestionario where tem_claves.clave_excluyente = $id and respuestas.id_r_2 = tem_claves.id_respuesta and cuestionario.id = tem_claves.id_pregunta"); while($rowr = mysql_fetch_array($claves2)) { $clausulas = mysql_query("select * from asociacion_clausulas, clausulas where asociacion_clausulas.id_respuesta = '$rowr[0]' and clausulas.id = asociacion_clausulas.id_clausula"); while($rowc = mysql_fetch_array($clausulas)) { $ingresar = mysql_query("insert into tem_clausulas (id_clausula, id_respuesta, clausula, clave_excluyente) values ($rowc[1], $rowr[0], '$rowc[5]', $id)"); } }

/*SEGMENTO PARA REEMPLAZAR PARRAFOS, 1. ASOCIAR LOS PARRAFOS EN EL LUGAR DE LA CLAUSULA QUE SE DESEE PARA QUE SEA BUSCADA Y REMPLAZA POR LA RESPUESTA SELECCIONADA

2. ES IMPORTANTE CREAR UNA CLAVE IGUAL A LA RESPUESTA E INCLUIR ESTA CLAVE EN LA CLAUSULA, DE ESTA MANERA EL BUSCADOR ENCONTRARA ESTA CLAVE, BUSCARA EL PARRAFO CON ID DE LA CLAVE LO TRAERA Y LO REEMPLAZARA POR EL PARRAFO EJEMPLO: TENEMOS UNA CLAUSULA PREAMBULO LA CUAL TIENE QUE ESTAR ARMADA POR UN PARRAFO, PERO ESTE PARRAFO DEPENDE DE UNA RESPUESTA SELECCIONADA PREAMBULO CON PARRAFO 'ESTE ES UN EJEMPLO' SI LA RESPUESTA DADA ES QUE EJEMPLO Y ESTA RESPUETA GENERA LA CLAVE -1254- ENTONCES EN LA CLAUSULA PREAMBULO ASOCIAMOS 01 PREAMBULO -1254*/
/* $clave2 = mysql_query("select distinct parrafos.id, parrafos.detalle from tem_claves, asociar_parrafos, parrafos where tem_claves.clave_excluyente = $id and asociar_parrafos.id_respuesta = tem_claves.id_respuesta and parrafos.id = asociar_parrafos.id_parrafo"); */ $clave2 = mysql_query("select distinct parrafos.id, parrafos.detalle from parrafos"); while($rowcl = mysql_fetch_array($clave2))

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

11

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

{ $modificar1 = mysql_query("select clausula from tem_clausulas where clave_excluyente = $id order by id_respuesta"); $cantidad = mysql_num_rows($modificar1) -1; $i = 0; for($i;$i<= $cantidad;$i++) { $r = mysql_result($modificar1,$i); $cm2 = str_replace('-par'.$rowcl[0].'-', $rowcl[1], $r); $ing = mysql_query("update tem_clausulas set clausula = '$cm2' where clave_excluyente = $id and clausula = '$r'"); } } /* EL RESULTADO ES

01 PREAMBULO 'ESTE ES UN EJEMPLO' DIGAMOS QUE EL PARRAFO Y LA CLAUSULA LE ASOCIAMOS UNA CLAVE PARA SER REEMPLAZADA POR OTRA RESPUESTA EJEM 01 PREAMBULO -1684'ESTE ES UN EJEMPLO -1896-' Y ESTA CLAVES PERTENECEN AL RESPUESTA: -1684- = HOLA -1896- = MUNDO /*SEGMENTO PARA REEMPLAZAR CLAVES UNA VEZ INCLUIDO EL PARRAFO */
$clave2 = mysql_query("select * from tem_claves where clave_excluyente = $id"); while($rowcl = mysql_fetch_array($clave2)) { $modificar1 = mysql_query("select clausula from tem_clausulas where clave_excluyente = $id order by id_respuesta"); $cantidad = mysql_num_rows($modificar1) -1; $i = 0; for($i;$i<= $cantidad;$i++) { $r = mysql_result($modificar1,$i); $cm2 = str_replace('-'.$rowcl[0].'-', $rowcl[2], $r); $ing = mysql_query("update tem_clausulas set clausula = '$cm2' where clave_excluyente = $id and clausula = '$r'"); } }

/* EL RESULTADO ES

01 01 PREAMBULO HOLA 'ESTE ES UN EJEMPLO MUNDO' SEGMENTO PARA IMPRIMIR CONTRATO */

$genera_contrato= mysql_query("select distinct clausulas.numero_clausula, clausulas.titulo, clausulas.tipo_clausula, tem_clausulas.clausula from tem_clausulas, clausulas where tem_clausulas.clave_excluyente = $id and clausulas.id = tem_clausulas.id_clausula order by clausulas.numero_clausula");

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

12

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

while($cont = mysql_fetch_array($genera_contrato)) {?> <form method='POST' action='--WEBBOT-SELF--'> <table border='0' cellpadding='0' cellspacing='0' style='border-collapse: collapse' bordercolor='#111111' width='100%' id='AutoNumber1'> <tr> <td width='50%'><font color="#FF9933"><? echo $cont[0].' '.$cont[1]; ?></font></td> </tr> <tr> <td width='50%'><? echo $cont[3];?> </td> </tr> <tr> <td width='50%' height="31"></td> </tr> <? } ?> </table> </form> </form> <? pie_selector(); ?>

Artculo por Rene Sterling Neira

Generar documentos de Word RTF con php

En muchos desarrollos web surge la necesidad de crear documentos que proceden de la combinacin de un documento origen con los datos almacenados en la Intranet/Extranet de la empresa, algo parecido a lo que se consigue con la combinacin de correspondencia de Word. Ejemplos prcticos pueden ser los siguientes: Generacin de etiquetas a partir de una base de datos de clientes o artculos Certificados o diplomas para los alumnos de un curso Listados de participantes en un evento. El control de la impresin desde un documento HTML es algo bastante complejo, por lo que generar un documento DOC, o mejor dicho RTF, nos permitir resolver nuestro problema de una manera muy efectiva. En este artculo desarrollaremos un ejemplo prctico, el de obtener un certificado de asistencia para cada uno de los alumnos que asisten a un curso. La estrategia: Nuestra estrategia se fundamenta en los siguientes pasos: Partimos del documento en formato de Word que queremos obtener. Convertimos el formato .DOC en .RTF. (Los archivos .RTF son de texto legible) Introducimos en el documento .RTF unos cdigos manuales que sern sustituidos por los datos procedentes de la base de datos. Creamos una aplicacin en PHP que lea el archivo .RTF y sustituya los cdigos introducidos por los datos buscados.

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

13

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Primer paso, Preparar la plantilla: Para nuestro ejemplo partimos de un documento .DOC que certifica que un alumno ha realizado un curso. En la siguiente imagen vemos un certificado tipo.

Ser preciso crear un certificado para cada uno de los alumnos que ha realizado un curso, los datos que vara son los del alumno y los del curso realizado. Una vez abierto el documento con Word, lo guardamos en formato RTF y sustituimos cada dato variable por unos cdigos fcilmente reconocibles. Ojo, el formato RTF es muy puetero, por lo que ser preciso escribir los cdigos sin confundirse para que no se introduzcan caracteres raros.

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

14

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

En el caso del ejemplo utilizamos la # y el * de tal manera que por ejemplo, sustituimos el nombre del alumno por #*NOMBRE*# Guardaremos el documento con el nombre de plantilla.rtf Segundo paso, El programa PHP: Crearemos dos funciones auxiliares, la primera se llama leef().

Esta funcin como se puede ver, recibe como argumento el nombre del fichero RTF, lo abre y almacena el contenido en la variable de texto $todo. Esta funcin por tanto devuelve el contenido de un fichero. La siguiente funcin, rtf(), es la que crea un RTF a partir de una plantilla y sustituyendo los cdigos por los datos de la Intranet.

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

15

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Esta funcin recibe cuatro argumentos: $sql: la sentencia sql que devuelve los datos que se necesitan $plantilla: la plantilla RTF con los cdigos $fsalida: el nombre del fichero resultado $matequivalencias: una matriz con las equivalencias entre los datos procedentes de la sentencia sql y los campos del certificado. Vamos a comentar lnea por lnea el programa: Las lneas 13 y 14 determinan el nombre y la ruta del fichero de salida, utilizamos la funcin time() para asegurarnos de que no se producirn dos ficheros con el mismo nombre. En la lnea 17 se almacena el contenido de la plantilla en la variable $txtplantilla En las lneas de la 19 a la 24 se extrae el cuerpo del documento RTF, el cuerpo del documento es lo que se repite, para extraerlo primero obtenemos la cabecera del documento, la cabecera queda determinada por la etiqueta rtf sectd. Un documento rtf termina siempre en }, con esa informacin extraemos el cuerpo. En el paso 3, a partir de la lnea 26 vamos escribiendo el archivo resultado.

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

16

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

En la lnea 27 escribimos la cabecera del documento En la lnea 28 ejecutamos la consulta y en la 29 entramos un un bucle, en cada ciclo obtendremos los datos de un alumno y crearemos un certificado. En la lnea 30 creamos una copia del cuerpo del documento llamada $despues, sobre esa copia realizaremos los cambios. En la lnea 31 entramos en un bucle que recorre la matriz de equivalencias, la lnea 32 obtiene de la base de datos el dato, la lnea 34 obtiene de la matriz el cdigo a sustituir en la plantilla y la lnea 35 sustituye el dato por el cdigo. Una vez sustituidos todos los campos la lnea 37 escribe el certificado del alumno y las lneas 38 y 39 generan un salto de pgina para volver a escribir el siguiente certificado. Una vez que hemos salido del While que va extrayendo los datos, la lnea 41 cierra el documento rtf y la 42 la escritura del fichero. Tercer paso, Llamada a la funcin RTF: Una vez hemos creado estas dos funciones ya podemos llamar a la funcin rtf() y generar el documento.

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

17

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Comentamos las lneas: En la lnea 48 especificamos cual es la plantilla. En la lnea 49 establecemos la sentencia SQL que extrae los datos, en el caso del ejemplo es un poco compleja pues extrae los datos de varias tablas. En las lneas desde la 50 a la 71 creamos la matriz de equivalencias, se trata de una matriz de dos dimensiones que relaciona el cdigo que se encontrar en el archivo RTF con el campo de la sentencia SQL. La lnea 72 llama a la funcin rtf() Y por fin las lneas 73 y 74 generan un enlace al archivo resultado. Mejoras y comentarios. Todo en esta vida es susceptible de ser mejorado, en este caso me queda pendiente el generar el archivo de salida directamente al navegador, con el objeto de no tenerlo que escribir en el disco duro. Adems tenemos desarrollados ejemplos de listados y de etiquetas que podemos documentar en posteriores artculos. Un aspecto importante para seguir progresando en este tema es conocer la sintaxis de los documentos rtf, se trata de un trabajo un poco durillo que tambin podemos abordar en posteriores artculos. Artculo por Alfredo Anaya

Creando archivos PDF en PHP

Las funciones PDF en PHP pueden crear archivos PDF utilizando la librera PDFlib creada por Thomas Merz. La documentacin en esta seccin solamente es una descripcin de las funciones de la librera PDFlib y no debera considerarse una referencia exhaustiva. Se ha de consultar la documentacin incluida en el cdigo fuente de la distribucin de PDFlib para una completa y detallada explicacin de cada funcin. Proporciona muy buena descripcin de las capacidades de PDFlib y contiene actualizada la documentacin de todas las funciones. Todas las funciones de PDFlib y del mdulo PHP tienen nombres iguales para las funciones y parmetros. Se necesitar entender algunos de los conceptos bsicos de PDF y PostScript para un eficiente uso de esta extensin. Todas las longitudes y coordenadas se mesuran en puntos PostScript. Generalmente hay 72 puntos PostScript por pulgada, pero esto depende de la resolucin de salida. Se puede consultar la documentacin incluida en la distribucin de PDFlib para una detallada explicacin del sistema de coordenadas utilizado. Hay que tener en cuenta que la mayora de las funciones PDF requieren un primer parmetro pdfdoc. En los siguientes ejemplos hay ms informacin.

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

18

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Nota: Si se est interesado en alternativas de generadores gratis de PDF que no utilizen liberas externas PDF, mirar este FAQ relacionado.

Requerimientos PDFlib est disponible para descargar en http://www.pdflib.com/products/pdflib/index.html, pero requiere la compra de una licencia para uso comercial. Se requieren las libreras JPEG y TIFF para compilar esta extensin. Compatibilidad con versiones antiguas de PDFlib Cualquier versin de PHP despus del 9 de Marzo del 2000 no soporta versiones de PDFlib anteriores a la 3.0. PDFlib 3.0 o superior es compatible desde PHP 3.0.19 en adelante. Instalacin Para los datos de la instalacin, os adjunto aqu unas notas extradas de la propia documentacin de la librera:
To get these functions to work, you have to compile PHP with --with-pdflib[=DIR]. DIR is the PDFlib base install directory, defaults to /usr/local. In addition you can specify the jpeg, tiff, and pnglibrary for PDFlib to use, which is optional for PDFlib 4.x. To do so add to your configure line the options --with-jpegdir[=DIR] --with-png-dir[=DIR] --with-tiff-dir[=DIR]. When using version 3.x of PDFlib, you should configure PDFlib with the option --enable-shared-pdflib.

Configuracin en tiempo de ejecucin Esta extensin no tiene directivas de configuracin en php.ini. Confusiones con antiguas versiones de PDFlib Desde PHP 4.0.5, la extensin PHP para PDFlib es oficialmente soportada por PDFlib GmbH. Esto significa que todas las funciones descritas en el manual de PDFlib (V3.00 o superior) son soportadas por PHP 4 con el mismo funcionamiento y parmetros. Slo los valores devueltos pueden variar en el manual PDFlib, ya que PHP adopt la convencin de devolver FALSE. Por razones de compatibilidad, PDFlib an soporta las antiguas funciones, pero deberan reemplazarlas en sus nuevas versiones. PDFlib GmbH no dar soporte a cualquier problema causado por el uso de estas funciones obsoletas. Ejemplos La mayora de las funciones son bastante fciles de utilizar. La parte ms difcil probablemente es la creacin de un primer documento PDF. El siguiente ejemplo debera ayudar para comenzar. El ejemplo crea el archivo test.pdf en una pgina. La pgina contiene el texto "Times Roman outlined" en un contorno, con fuente de 30pt. El texto tambin est subrayado. Ejemplo 1. Creando un documento PDF con PDFlib
<?php $pdf = pdf_new(); pdf_open_file($pdf, "test.pdf"); pdf_set_info($pdf, "Author", "Javier Tacon"); pdf_set_info($pdf, "Title", "Test for PHP wrapper of PDFlib 2.0"); pdf_set_info($pdf, "Creator", "See Author"); pdf_set_info($pdf, "Subject", "Testing"); pdf_begin_page($pdf, 595, 842); pdf_add_outline($pdf, "Page 1"); $font = pdf_findfont($pdf, "Times New Roman", "winansi", 1); pdf_setfont($pdf, $font, 10); pdf_set_value($pdf, "textrendering", 1); pdf_show_xy($pdf, "Times Roman outlined", 50, 750); pdf_moveto($pdf, 50, 740); Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin. 19

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

pdf_lineto($pdf, 330, 740); pdf_stroke($pdf); pdf_end_page($pdf); pdf_close($pdf); pdf_delete($pdf); echo "<A HREF=getpdf.php>finished</A>"; ?>

El script getpdf.php simplemente devuelve el documento pdf. Ejemplo 2. Mostrando un documento PDF precalculado
<?php $len = filesize($filename); header("Content-type: application/pdf"); header("Content-Length: $len"); header("Content-Disposition: inline; filename=foo.pdf"); readfile($filename);

?>

La distrubucin PDFlib contiene un ejemplo ms complejo para crear un reloj analgico en una pgina. Aqu se utiliza el mtodo de creacin en memoria de PDFlib para no tener que crear un archivo temporal. El ejemplo se ha convertido a PHP desde uno de PDFlib (El mismo ejemplo est disponible en la documentacin ClibPDF.) Ejemplo 3. Ejemplo pdfclock de la distribucin PDFlib
<?php $radius = 200; $margin = 20; $pagecount = 10; $pdf = pdf_new(); if (!pdf_open_file($pdf, "")) { echo error; exit; }; pdf_set_parameter($pdf, "warning", "true"); pdf_set_info($pdf, "Creator", "pdf_clock.php"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); pdf_set_info($pdf, "Title", "Analog Clock"); while ($pagecount-- > 0) { pdf_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); pdf_set_parameter($pdf, "transition", "wipe"); pdf_set_value($pdf, "duration", 0.5); pdf_translate($pdf, $radius + $margin, $radius + $margin); pdf_save($pdf); pdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); /* minute strokes */ pdf_setlinewidth($pdf, 2.0); for ($alpha = 0; $alpha < 360; $alpha += 6) { pdf_rotate($pdf, 6.0); pdf_moveto($pdf, $radius, 0.0); pdf_lineto($pdf, $radius-$margin/3, 0.0); pdf_stroke($pdf); Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin. 20

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

} pdf_restore($pdf); pdf_save($pdf); /* 5 minute strokes */ pdf_setlinewidth($pdf, 3.0); for ($alpha = 0; $alpha < 360; $alpha += 30) { pdf_rotate($pdf, 30.0); pdf_moveto($pdf, $radius, 0.0); pdf_lineto($pdf, $radius-$margin, 0.0); pdf_stroke($pdf); } $ltime = getdate(); /* draw hour hand */ pdf_save($pdf); pdf_rotate($pdf,-(($ltime['minutes']/60.0)+$ltime['hours']-3.0)*30.0); pdf_moveto($pdf, -$radius/10, -$radius/20); pdf_lineto($pdf, $radius/2, 0.0); pdf_lineto($pdf, -$radius/10, $radius/20); pdf_closepath($pdf); pdf_fill($pdf); pdf_restore($pdf); /* draw minute hand */ pdf_save($pdf); pdf_rotate($pdf,-(($ltime['seconds']/60.0)+$ltime['minutes']-15.0)*6.0); pdf_moveto($pdf, -$radius/10, -$radius/20); pdf_lineto($pdf, $radius * 0.8, 0.0); pdf_lineto($pdf, -$radius/10, $radius/20); pdf_closepath($pdf); pdf_fill($pdf); pdf_restore($pdf); /* draw second hand */ pdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); pdf_setlinewidth($pdf, 2); pdf_save($pdf); pdf_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); pdf_moveto($pdf, -$radius/5, 0.0); pdf_lineto($pdf, $radius, 0.0); pdf_stroke($pdf); pdf_restore($pdf); /* draw little circle at center */ pdf_circle($pdf, 0, 0, $radius/30); pdf_fill($pdf); pdf_restore($pdf); pdf_end_page($pdf); # to see some difference sleep(1);

pdf_close($pdf); $buf = pdf_get_buffer($pdf); $len = strlen($buf); header("Content-type: application/pdf"); header("Content-Length: $len");

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

21

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

header("Content-Disposition: inline; filename=foo.pdf"); echo $buf; pdf_delete($pdf); ?>

Artculo por Emmanuel Garca De Caro

Funciones Bsicas de Archivos PHP

Cambiar los permisos de un archivo
chmod ('El_archivo.xxx',0777);

Cambiar el nombre del propietario de un archivo

chown ('El_archivo.xxx','Mi nombre');

Copiar un archivo
copy('El_archivo.xxx','/nuevo_directorio/');

Optener el directorio inicial de un archivo o subdirectorio

dirname('directorio_raiz/subdirectorio');

Obtener el espacio disponible en un directorio en Bytes.

disk_free_space('directorio');

Verificar si un archivo existe

file_exists ('archivo.xxx');

Obtener la hora del ultimo acceso a un archivo

fileatime('archivo.xxx');

Obtener la hora de la ultima modificacin de un archivo

filemtime('archivo.xxx');

Obtener el dueo de una archivo

fileowner ('archivo.xxx');

Obtener los permisos de una archivo

fileperms ('archivo.xxx');

Obtener el tamao en bytes de un archivo

filesize('archivo.xxx');

Obtener el tipo de archivo

filetype('archivo.xxx');

Abrir un archivo o direccin URL

fopen ('archivo.xxx','r');

Saber si un archivo es ejecutable

is_executable('archivo.xxx');

Indicar si el archivo se puede leer

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin. 22

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

is_readable('archivo.xxx');

Indica si un archivo fue subido mediante HTTP POST upload

is_uploaded_file ('archivo.xxx');

Saber si un archivo se puede escribir

is_writable ('archivo.xxx');

Crea un directorio con permisos.

mkdir('/nuevo_directorio',0777);

Mover un archivo cargado a travs de HTTP POST de un directorio a otro predefinido move_uploaded_file ('directorio/archivo.xxx','directorio2/archivo.xxx'); Leer el contenido resultante de archivo file_get_contents('el_archivo.xx'); Renombrar un archivo o directorio
rename("/tmp/archivo_temp.txt", "/home/usuario/login/docs/mi_archivo.txt");

ELIMINAR UN DIRECTORIO
rmdir('/directorio');

CREAR UN ARCHIVO TEMPORAL tmpfile(); ELIMINAR UN ARCHIVO

unlink('ARCHIVO.XXX'); Importante: Alguna de estas funciones requieren tener permisos 0777 chmod para poder trabajar correctamente.

La mayora de ellas devuelven un booleano, por lo cual se puede imprimir un resultado en pantalla de la siguiente manera:
if(unlink('el_archivo.txt') echo 'se ha eliminado el archivo'; else echo 'Imposible eliminar el archivo, compruebe que el fichero exista y que tenga permiso xxx.'; ?>

Recuerda que para establecer permisos a directorios o archivos se deben emplear 4 cifras no 3 como usualmente se hace y produce error. Ejemplos: 0777, 0755, 0666, etc Esto se debe a que el nmero para especificar el permiso debe incluirse en octal (Base 8). En PHP y otros lenguajes de programacin. Los nmeros en Base 8 se escriben con un 0 delante para diferenciarlos de los nmeros en Base 10 o sistema decimal.

Trabajando con archivos

Otras de las gran ventajas de PHP, es la manipulacin de archivos internos y remotos. Para ello se utiliza una funcin esencial fopen(); que se encarga de abrir un archivo o URL, Basndose en una serie de parmetros que iremos describiendo.

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

23

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

La sintaxis de esta funcin con la que trabajaremos es la siguiente: fopen ('archivo.xxx','Modo'); Donde archivo es el nombre del mismo y (.xxx) su extensin, cabe destacar que si la llamada de este archivo se hace de la siguiente forma: esquema://, se asume que es una URL y Php buscara un gestor de protocol para tal esquema. Recordemos que los protocoles pueden ser (http, https, ftp, ftps, pop, pop3, y otros), si Php no encuentra una o ms envolturas registradas para dicho protol, se emitir un mensaje de error. Modo, se refiere a la forma en que abrimos el archivos (bajo que recursos). Por ejemplo: Si queremos hacer una apertura para solo lectura, o lectura y escritura u otro. Estos modos se designan con Letras predefinidas en Php, que son las siguientes: 'r' Apertura para slo lectura; ubica el apuntador de archivo al comienzo del mismo. 'r+' Apertura para lectura y escritura; ubica el apuntador de archivo al comienzo del mismo. 'w' Apertura para slo escritura; ubica el apuntador de archivo al comienzo de ste y lo trunca a una longitud de cero. Si el archivo no existe, intenta crearlo. 'w+' Apertura para lectura y escritura; ubica el apuntador de archivo al comienzo de ste y lo trunca a una longitud cero. Si el archivo no existe, intenta crearlo. 'a' Apertura para slo escritura; ubica el apuntador de archivo al final del mismo. Si el archivo no existe, intenta crearlo. 'a+' Apertura para lectura y escritura; ubica el apuntador de archivo al final del mismo. Si el archivo no existe, intenta crearlo. 'x' Creacin y apertura para slo escritura; ubica el apuntador de archivo al comienzo de ste. Si el archivo ya existe, la llamada a fopen() fallar devolviendo FALSE y generando un error de nivel E_WARNING. Si el archivo no existe, intenta crearlo. Esto es equivalente a especificar las banderas O_EXCL|O_CREAT en la llamada de sistema open(2) interna. Esta opcin es soportada en PHP 4.3.2 y versiones posteriores, y slo funciona con archivos locales. 'x+' Creacin y apertura para lectura y escritura; ubica el apuntador de archivo al comienzo de ste. Si el archivo ya existe, la llamada a fopen() fallar devolviendo FALSE y generando un error de nivel E_WARNING. Si el archivo no existe, intenta crearlo. Esto es equivalente a especificar las banderas O_EXCL|O_CREAT en la llamada de sistema open(2) interna. Esta opcin es soportada en PHP 4.3.2 y versiones posteriores, y slo funciona con archivos locales. Un ejemplo:
<? $archivo= fopen("documento.txt" , "r"); if ($archivo) { while (!feof($archivo)) { echo fgets($archivo, 255).'<br>'; } } fclose ($archivo); ?>

Explicando:
Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin. 24

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Primero abrimos el archivo en modo de lectura y lo agrupamos a la variable $archivo, si se puede realizar la apertura (sea si fopen() devuelve TRUE), Ejecutamos un bucle WHILE y en el argumento introducimos la funcin feof(), Encargada de verificar si el apuntador a un fichero esta al final del mismo. Luego la funcin fgets(), se encarga de imprimir la lnea del fichero apuntado. y finalmente cerramos el archivo con fclose(); Otro Ejemplo:
<? $archivo=fopen("documento.txt" , "w"); if ($archivo) { fputs ($archivo, "Resulto el script"); } fclose ($archivo); ?>

Explicando: Abrimos el archivo nuevamente pero esta vez en modo de solo Escritura. Si se puede ejecutar ese proceso if($archivo), agregamos una lnea con fputs(), que tendr como contenido Resulto el script. El ultimo paso en esta oportunidad como ya conocemos es cerrar el archivo. Cabe destacar que para que este ultimo ejemplo funcione, obviamente el archivo documento.txt, requiere tener PERMISO DE ESCRITURA, preferiblemente 0777 CHMOD.
Ms informacin:http://www.php.net/manual/es/ref.filesystem.html

Artculo por Emmanuel Garca De Caro

Comprobar la existencia de un fichero en el servidor con PHP

Vamos a ver cmo se puede comprobar mediante PHP si un fichero existe o no en el sistema de archivos del servidor, es decir, dentro del disco duro del servidor. Esta es una tarea que se debera comprobar antes de realizar acciones con cualquier fichero del servidor, porque, si no existe el fichero, las acciones a realizar sobre l no tendran sentido. En PHP existe una funcin que nos ayudar con la tarea de comprobar si existe o no un fichero en el servidor. Nosotros solamente tenemos que hacer uso de ella para saber si existe ese archivo y por tanto, podemos operar con l. file_exists(nombre_del_fichero) La funcin devuelve un boleano, indicando con true que existe el fichero y con false que no existe. Recibe una cadena de caracteres que es el nombre del fichero que se desea comprobar. En principio, si slo se indica un nombre de un fichero, se supone que se debe buscar su existencia dentro del mismo directorio donde se aloja la pgina PHP. Ejemplos
Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin. 25

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Vamos a ver si existe un archivo llamado "mifichero.txt" en el mismo directorio que la pgina PHP:
if (file_exists("mifichero.txt")){ echo "El fichero existe"; }else{ echo "El fichero no existe"; }

Si quisiramos comprobar si existe ese fichero dentro de un directorio determinado, bastara con que escribisemos la ruta de directorios sobre la que deseamos buscar el fichero. file_exists("datos/mifichero.txt") Esta funcin buscara el archivo "mifichero.txt" dentro del subdirectorio "datos". Este subdirectorio "datos" estara contenido dentro del directorio donde colocamos el script PHP. Indicando rutas absolutas Tambin podramos buscar un archivo indicando una ruta absoluta dentro del sistema de archivos del servidor. En este caso habra que comprobar si desde PHP tenemos permisos para acceder a la ruta en la que se pretende buscar el archivo, sobretodo si la ruta es externa al directorio de publicacin del servidor. file_exists("c:/mif.txt") Esta funcin buscara el archivo mif.txt en el directorio raz del disco c:. Habra que ver si tenemos permisos para acceder al directorio raz del disco. Podemos averiguar la ruta del directorio de publicacin de la pgina con la variable del entorno del servidor $_SERVER["DOCUMENT_ROOT"]. Podemos utilizar esta variable para generar la ruta absoluta a un archivo que pretendamos comprobar su existencia.
file_exists($_SERVER["DOCUMENT_ROOT"] . "\mifichero.txt")

Esta funcin buscara el archivo "mifichero.txt" dentro de la raz del directorio de publicacin.
Nota:Como se puede ver, hemos utilizado el carcter "\" (contrabarra) para separar los directorios en la ruta de un archivo. Esto es porque estas lneas estn extradas de ejemplos de PHP realizados sobre el sistema Windows. En Windows se utilizan contrabarras para escribir rutas, mientras que en Linux se utiliza el carcter "/" (barra normal). Hay que tener cuidado para saber qu barra debemos utilizar en cada sistema, de lo contrario, podemos equivocarnos y entonces PHP puede tener problemas para localizar un fichero determinado.

Ejemplo: si existe un fichero, abrirlo y si no existe, crearlo Ahora vamos a mostrar un cdigo muy tpico que sirve para abrir un fichero con un nombre dado. Primero habra que comprobar si existe o no existe ese fichero. Si existe, entonces lo abrimos tal cual est y si no existe, lo crearemos previamente a abrirlo.
if (file_exists("mifichero.txt")){ echo "El fichero existe. Lo abro"; $reffichero = fopen("mifichero.txt", "a"); }else{ echo "El fichero no existe. Lo creo y abro.";

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

26

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

$reffichero = fopen("mifichero.txt", "w+"); }

En este cdigo, primero se comprueba la existencia del fichero. Si existe (caso afirmativo del if), se abre con el modo "a", que indica que se desea aadir informacin al fichero. Si no existe fichero (caso else del if), se abre con el modo "w+", que indica lectura y escritura y adems indica que si no existe el fichero, se crear en el sistema de archivos en la ruta indicada. Despus de este cdigo, el fichero est abierto para escritura, con lo cual, podemos operar sobre el fichero (escribiendo informacin) y luego deberamos cerrarlo. El cdigo sera como este:
//operar con el fichero fwrite ($reffichero,"nuevo texto!!!!"); //cerrar el fichero fclose ($reffichero);

Artculo por Miguel Angel Alvarez

Contar el nmero de lneas y caracteres en archivo PHP

Vamos a continuar con nuestro manual de gestin de archivos con PHP con un sencillo script para realizar una cuenta del nmero de lneas y de caracteres de un archivo de texto. Es un script que puede resultarnos til, por lo menos para practicar un poco con las funciones de manejo de archivos en PHP. Como hemos dicho, se trata de hacer una cuenta del nmero de lneas de un archivo y adems el nmero de caracteres que tiene. Para realizar esta cuenta debemos leer el archivo de texto lnea a lnea acumular uno por cada lnea en una variable, as como acumular en otra variable el nmero de caracteres de cada lnea. El cdigo sera el siguiente:
<? //abro el archivo para lectura $archivo = fopen ("miarchivo.txt", "r"); //inicializo una variable para llevar la cuenta de las lneas y los caracteres $num_lineas = 0; $caracteres = 0; //Hago un bucle para recorrer el archivo lnea a lnea hasta el final del archivo while (!feof ($archivo)) { //si extraigo una lnea del archivo y no es false if ($linea = fgets($archivo)){ //acumulo una en la variable nmero de lneas $num_lineas++; //acumulo el nmero de caracteres de esta lnea $caracteres += strlen($linea); } } fclose ($archivo); echo " Lneas: " . $num_lineas; echo " Caracteres: " . $caracteres; ?> Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin. 27

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

El script est comentado, pero daremos unas explicaciones adicionales. Primero abrimos el archivo para lectura. El fichero se llama "miarchivo.txt" y se supone que est en el mismo directorio que este script PHP. Luego creamos un par de variables para llevar la cuenta de las lneas y de los caracteres. Seguidamente hacemos un bucle para recorrer el archivo. El bucle iterar mientras que no se llegue al final del fichero. En cada iteracin del bucle extraigo una lnea, a la vez que compruebo que lo que he extrado tiene validez (Con fgets() se extrae una lnea de texto y si hay un error la funcin devuelve false). Si se extrajo correctamente la lnea de texto se acumula 1 en la variable que cuenta el nmero de lneas y se acumula el nmero de caracteres que tenga en la variable que cuenta los caracteres del archivo. Una vez finalizado el bucle, porque se ha llegado al final del fichero, se muestran los contenidos de las variables con el nmero de lneas y caracteres. Artculo por Miguel Angel Alvarez

Listar directorios y subdirectorios con PHP

En PHP existen muchas funciones para el manejo del sistema de archivos del servidor. Con su ayuda se pueden hacer fcilmente todo tipo de acciones sobre la estructura de ficheros y directorios del servidor. Hemos visto ya interesantes ejemplos sobre estas funciones en nuestro Manual de gestin de ficheros con PHP. En este taller veremos una manera de hacer un listado de los directorios que cuelgan de una carpeta dada. La funcin que vamos a realizar recibe una ruta y simplemente hace un listado de los directorios que cuelgan de esa ruta. A su vez, esos directorios pueden tener otros subdirectorios dentro y estos a su vez otros, en la tpica estructura de rbol. El script debe recorrer todos los subdirectorios del rbol y listarlos. Para realizar esto, lo ms habitual es hacer una funcin recursiva, que es una funcin que se llama a si misma para hacer todo el trabajo. En nuestro caso, como se deca, vamos a utilizar unas cuantas funciones de PHP para facilitarnos la tarea. Son las siguientes: is_dir() que recibe una ruta y devuelve un boleano. True si es un directorio y flase si no lo es. opendir() que recibe la ruta de un directorio y genera un gestor de directorio, que utilizaremos luego para extraer los subdirectorios. readdir() recibe un gestor de directorio devuelto por opendir() y sirve para leer todo el contenido de un directorio, tanto archivos como subdirectorios. Nosotros lo utilizaremos para obtener cada uno de los subdirectorios que contiene una ruta. En la primera llamada devuelve el primer archivo o subdirectorio, en la siguiente devuelve en segundo. Es decir, cuando se vuelve a llamar devuelve siempre el siguiente fichero y contina hasta que se acaban, devolviendo false cuando no queda ninguno. closedir() recibe un gestor de directorio y lo cierra.

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

28

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Ahora veamos la funcin, que est comentada.

function listar_directorios_ruta($ruta){ // abrir un directorio y listarlo recursivo if (is_dir($ruta)) { if ($dh = opendir($ruta)) { while (($file = readdir($dh)) !== false) { //esta lnea la utilizaramos si queremos listar todo lo que hay en el directorio //mostrara tanto archivos como directorios //echo "<br>Nombre de archivo: $file : Es un: " . filetype($ruta . $file); if (is_dir($ruta . $file) && $file!="." && $file!=".."){ //solo si el archivo es un directorio, distinto que "." y ".." echo "<br>Directorio: $ruta$file"; listar_directorios_ruta($ruta . $file . "/"); } } closedir($dh); } }else echo "<br>No es ruta valida"; }

La funcin recibe una ruta. Por ejemplo, si queremos que liste los directorios de la carpeta donde est el archivo la llamaramos con:
listar_directorios_ruta("./");

Lo primero que se hace es comprobar si la ruta recibida es un directorio.

if (is_dir($ruta)) {

Si lo es realizaremos las acciones, pero si no lo es, mostraremos un mensaje diciendo que no es una ruta vlida. En el siguiente if extraemos el gestor de directorio y lo guardamos en una variable $dh
if ($dh = opendir($ruta))

Con un bucle while recorreremos cada elemento de ese directorio.

while (($file = readdir($dh)) !== false)

Dentro del bucle hacemos un if para saber si el elemento es un directorio

if (is_dir($ruta . $file) && $file!="." && $file!="..")

En caso que sea un directorio, simplemente escribimos en la pgina. Adems, tenemos que ver si ese directorio contiene a su vez otros directorios. Para eso llamamos a la funcin de nuevo pasndole ese nuevo directorio. As la funcin se llama a si misma para mostrar todo el rbol de carpetas. Por ltimo se cierra el gestor de directorio abierto previamente.
closedir($dh);

Artculo por Miguel Angel Alvarez

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

29

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Leer un archivo trado por FTP con PHP

La gestin de archivos por PHP incluye la conexin por FTP o HTTP para abrir un archivo. Esto significa que se puede indicar una URL, en vez de la ruta del archivo en el sistema de archivos del servidor local. Con ello podremos abrir un archivo remoto, que se encuentra en otro servidor. Para abrir un archivo debemos utilizar la funcin del sistema de archivos (Filesystem function) fopen. Esta funcin la describimos con detalle en el manual sobre gestin de archivos por PHP. En este caso vamos a realizar un uso especial para conectar con ese archivo por FTP. Antes que nada hay que decir que para que esto funcione, es decir, para poder conectar por FTP o por HTTP con un archivo remoto, tenemos que tener habilitada la directiva allow_url_fopen en el PHP.ini (allow_url_fopen = on). La diferencia fundamental a la hora de conectar un archivo que se encuentra en un servidor remoto est en la lnea del fopen:
$archivo = fopen ("ftp://usuario:[email protected]/html/archivo.txt", "r");

Simplemente indicamos la ruta del archivo con una URL por el protocolo FTP. En dicha URL se indican los siguientes datos. ftp:// es el protocolo. usuario:clave es el usuario y la clave del acceso FTP que estemos utilizando. Si fuera un ftp annimo podramos omitir estos datos. @ para separar lo que es el usuario y la clave del nombre del servidor. Tambin se debera omitir en el caso de un servidor annimo. ftp.servidor.com es el nombre del servidor FTP al que estamos conectando /html/archivo.txt es la ruta desde el directorio raz del FTP hacia el archivo que se desea abrir.

Luego trataramos el archivo de manera similar a como hemos visto en otros casos en el manual sobre gestin de archivos por PHP. Veamos un ejemplo completo de conexin por FTP para abrir, leer y mostrar un fichero de texto remoto:
<?php $archivo = fopen ("ftp://user:[email protected]/html/probando.txt", "r"); if (!$archivo) { echo "<p>No puedo abrir el archivo para lectura</p>"; exit; } $texto=""; while ($linea = fgets($archivo,1024)) { if ($linea) $texto .= $linea; } echo $texto; fclose ($archivo); ?>

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

30

Tu mejor ayuda para aprender a hacer webs www.desarrolloweb.com

Artculo por Miguel Angel Alvarez

Gestin de archivos en PHP: http://www.desarrolloweb.com/manuales/75/ Los manuales de DesarrolloWeb.com tienen el copyright de sus autores. No reproducir sin autorizacin.

31