Modulo2 - Estructuras Del Lenguaje PHP

rea Tecnolgica de Educacin Virtual UTN FRC SEU
PHP, MySQL y E-Commerce Estructuras del lenguaje

Autor: Ing. Oscar R. Espeche

1

UNIVERSIDAD TECNOLGICA NACIONAL
Facultad Regional Crdoba

Secretaria de Extensin Universitaria

rea Tecnolgica de Educacin Virtual

Coordinador General de Educacin Virtual: Magster Leandro D.
Torres

Curso:
PHP, MySQL y E-Commerce EV
05400/11
Mdulo:
Estructuras del lenguaje

Tutor: Ing. Oscar R. Espeche


2
Mdulo2: Estructuras del lenguaje PHP

2.1 Estructuras de Control
2.2 Inclusin de cdigo
2.3 Funciones
2.4 Clases y Objetos
2.5 Proteger pginas con password en PHP
2.6 Cookies
2.7 Sesiones
2.8 Manejo de conexiones
2.9 Modo Seguro (Safe Mode)


3
2.1 Estructuras de Control
Todo archivo de comandos PHP se compone de una serie de sentencias. Una sentencia
puede ser una asignacin, una llamada a funcin, un bucle, una sentencia condicional e
incluso una sentencia que no haga nada (una sentencia vaca).

Las sentencias normalmente acaban con punto y coma. Adems, las sentencias se pueden
agrupar en grupos de sentencias encapsulando un grupo de sentencias con llaves. Un grupo
de sentencias es tambin una sentencia. A continuacin se describen los diferentes tipos de
sentencias.
La sentencia if
La construccin if es una de las ms importantes caractersticas de muchos lenguajes,
incluido PHP. Permite la ejecucin condicional de fragmentos de cdigo. PHP caracteriza una
estructura if que es similar a la de C:

if (expr)
sentencia

Como se describe en la seccin sobre expresiones, expr se evala a su valor condicional. Si
expr se evala como TRUE, PHP ejecutar la sentencia, y si se evala como FALSE - la
ignorar.

El siguiente ejemplo mostrara a es mayor que b si $a fuera mayor que $b:

if ($a > $b)
print "a es mayor que b";

A menudo, se desea tener ms de una sentencia ejecutada de forma condicional. Por
supuesto, no hay necesidad de encerrar cada sentencia con una clusula if. En vez de eso,
se pueden agrupar varias sentencias en un grupo de sentencias. Por ejemplo, este cdigo
mostrara a es mayor que b si $a fuera mayor que $b, y entonces asignara el valor de $a a
$b:

if ($a > $b) {
$b = $a;
}

Las sentencias if se pueden anidar indefinidamente dentro de otras sentencias if, lo cual
proporciona una flexibilidad completa para ejecuciones condicionales en las diferentes partes
de tu programa.
La sentencia else

4
A menudo queremos ejecutar una sentencia si se cumple una cierta condicin, y una
sentencia distinta si la condicin no se cumple. Esto es para lo que sirve else. else extiende
una sentencia if para ejecutar una sentencia en caso de que la expresin en la sentencia if
se evale como FALSE. Por ejemplo, el siguiente cdigo mostrara a es mayor que b si $a
fuera mayor que $b, y a NO es mayor que b en cualquier otro caso:

if ($a > $b) {
} else {
print "a NO es mayor que b";
}

La sentencia else se ejecuta solamente si la expresin if se evala como FALSE.
La sentencia elseif
elseif, como su nombre sugiere, es una combinacin de if y else. Como else, extiende una
sentencia if para ejecutar una sentencia diferente en caso de que la expresin if original se
evala como FALSE.

No obstante, a diferencia de else, ejecutar esa expresin alternativa solamente si la
expresin condicional elseif se evala como TRUE. Por ejemplo, el siguiente cdigo
mostrara a es mayor que b, a es igual a b o a es menor que b:

if ($a > $b) {
} elseif ($a == $b) {
print "a es igual que b";
} else {
}

Puede haber varios elseifs dentro de la misma sentencia if. La primera expresin elseif (si
hay alguna) que se evale como TRUE se ejecutara.

En PHP, tambin se puede escribir 'else if' (con dos palabras) y el comportamiento sera
idntico al de un 'elseif' (una sola palabra).

El significado sintctico es ligeramente distinto (si estas familiarizado con C, es el mismo
comportamiento) pero la lnea bsica es que ambos resultaran tener exactamente el mismo
comportamiento.

La sentencia elseif se ejecuta slo si la expresin if precedente y cualquier expresin elseif
precedente se evalan como FALSE, y la expresin elseif actual se evala como TRUE.
Sintaxis Alternativa de Estructuras de Control

5
PHP ofrece una sintaxis alternativa para alguna de sus estructuras de control; a saber, if,
while, for, y switch. En cada caso, la forma bsica de la sintaxis alternativa es cambiar abrir-
llave por dos puntos (:) y cerrar-llave por endif;, endwhile;, endfor;, or endswitch;,
respectivamente.

<?php if ($a==5): ?>
A es igual a 5
<?php endif; ?>

En el ejemplo de arriba, el bloque HTML "A = 5" se anida dentro de una sentencia if escrita
en la sintaxis alternativa. El bloque HTML se mostrara solamente si $a fuera igual a 5.
La sintaxis alternativa se aplica a else y tambin a elseif. La siguiente es una estructura if
con elseif y else en el formato alternativo:

if ($a == 5):
print "a es igual a 5";
print "...";
elseif ($a == 6):
print "a es igual a 6";
print "!!!";
else:
print "a no es ni 5 ni 6";
endif;

Mirar tambin while, for, e if para ms ejemplos.
La sentencia while
Los bucles while son los tipos de bucle ms simples en PHP. Se comportan como su
contrapartida en C. La forma bsica de una sentencia while es:

while (expr) sentencia

El significado de una sentencia while es simple. Le dice a PHP que ejecute la(s) sentencia(s)
anidada(s) repetidamente, mientras la expresin while se evale como TRUE. El valor de la
expresin es comprobado cada vez al principio del bucle, as que incluso si este valor cambia
durante la ejecucin de la(s) sentencia(s) anidada(s), la ejecucin no parar hasta el fin de
la iteracin (cada vez que PHP ejecuta las sentencias en el bucle es una iteracin).

A veces, si la expresin while se evala como FALSE desde el principio de todo, la(s)
sentencia(s) anidada(s) no se ejecutarn ni siquiera una vez.

Como con la sentencia if, se pueden agrupar mltiples sentencias dentro del mismo bucle
while encerrando un grupo de sentencias con llaves, o usando la sintaxis alternativa:


6
while (expr): sentencia ... endwhile;

Los siguientes ejemplos son idnticos, y ambos imprimen nmeros del 1 al 10:

/* ejemplo 1 */

$i = 1;
while ($i <= 10) {
print $i++; /* el valor impreso sera
$i antes del incremento
(post-incremento) */
}

/* ejemplo 2 */

$i = 1;
while ($i <= 10):
print $i;
$i++;
endwhile;
La sentencia do..while
Los bucles do..while son muy similares a los bucles while, excepto que las condiciones se
comprueban al final de cada iteracin en vez de al principio.

La principal diferencia frente a los bucles regulares while es que se garantiza la ejecucin de
la primera iteracin de un bucle do..while (la condicin se comprueba slo al final de la
iteracin), mientras que puede no ser necesariamente ejecutada con un bucle while regular
(la condicin se comprueba al principio de cada iteracin, si esta se evala como FALSE
desde el principio la ejecucin del bucle finalizar inmediatamente).

Hay una sola sintaxis para los bucles do..while:

$i = 0;
do {
print $i;
} while ($i>0);

El bucle de arriba se ejecutara exactamente una sola vez, despus de la primera iteracin,
cuando la condicin se comprueba, se evala como FALSE ($i no es ms grande que 0) y la
ejecucin del bucle finaliza.

La sentencia for

7
Los bucles for son los bucles ms complejos en PHP. Se comportan como su contrapartida en
C. La sintaxis de un bucle for es:

for (expr1; expr2; expr3) sentencia

La primera expresin (expr1) se evala (ejecuta) incondicionalmente una vez al principio del
bucle.

Al comienzo de cada iteracin, se evala expr2 . Si se evala como TRUE, el bucle contina
y las sentencias anidadas se ejecutan. Si se evala como FALSE, la ejecucin del bucle
finaliza.

Al final de cada iteracin, se evala (ejecuta) expr3.

Cada una de las expresiones puede estar vaca. Que expr2 est vaca significa que el bucle
debera correr indefinidamente (PHP implicitamente lo considera como TRUE, al igual que
C).

Esto puede que no sea tan intil como se podra pensar, puesto que a menudo se quiere
salir de un bucle usando una sentencia break condicional en vez de usar la condicin de for.
Considera los siguientes ejemplos. Todos ellos muestran nmeros del 1 al 10:

/* ejemplo 1 */

for ($i = 1; $i <= 10; $i++) {
print $i;
}

/* ejemplo 2 */

for ($i = 1;;$i++) {
if ($i > 10) {
break;
}
print $i;
}

/* ejemplo 3 */

$i = 1;
for (;;) {
if ($i > 10) {
break;
}
print $i;
$i++;

8
}

/* ejemplo 4 */

for ($i = 1; $i <= 10; print $i, $i++) ;

Por supuesto, el primer ejemplo parece ser el mas elegante (o quizs el cuarto), pero uno
puede descubrir que ser capaz de usar expresiones vacas en bucles for resulta til en
muchas ocasiones.

PHP tambin soporta la "sintaxis de dos puntos" alternativa para bucles for.

for (expr1; expr2; expr3): sentencia; ...; endfor;

Otros lenguajes poseen una sentencia foreach para traducir un array o una tabla hash. PHP3
no posee tal construccin; PHP4 s (ver foreach). En PHP3, se puede combinar while con las
funciones list() y each() para conseguir el mismo efecto. Mirar la documentacin de estas
funciones para ver un ejemplo.
La sentencia foreach
PHP4 (PHP3 no) incluye una construccin foreach, tal como perl y algunos otros lenguajes.
Esto simplemente da un modo fcil de iterar sobre arrays. Hay dos sintaxis; la segunda es
una extensin menor, pero til de la primera:

foreach(expresion_array as $value) sentencia
foreach(expresion_array as $key => $value) sentencia

La primera forma recorre el array dado por expresin_array. En cada iteracin, el valor del
elemento actual se asigna a $value y el puntero interno del array se avanza en una unidad
(as en el siguiente paso, se estar mirando el elemento siguiente).

La segunda manera hace lo mismo, salvo que la clave del elemento actual ser asignada a la
variable $key en cada iteracin.

Nota: Cuando foreach comienza su primera ejecucin, el puntero interno a la
lista (array) se reinicia automticamente al primer elemento del array. Esto
significa que no se necesita llamar a reset() antes de un bucle foreach.
Nota: Hay que tener en cuanta que foreach trabaja con una copia de la lista
(array) especificada y no la lista en si, por ello el puntero de la lista no es
modificado como en la construccin each.
Puede haber observado que las siguientes son funcionalidades idnticas:


9
reset( $arr );
while( list( , $value ) = each( $arr ) ) {
echo "Valor: $value<br>\n";
}

foreach( $arr as $value ) {
echo "Valor: $value<br>\n";
}

Las siguientes tambin son funcionalidades idnticas:

reset( $arr );
while( list( $key, $value ) = each( $arr ) ) {
echo "Key: $key; Valor: $value<br>\n";
}

foreach( $arr as $key => $value ) {
echo "Key: $key; Valor: $value<br>\n";
}

Algunos ejemplos ms para demostrar su uso:

/* foreach ejemplo 1: slo valor*/
$a = array(1, 2, 3, 17);

foreach($a as $v) {
print "Valor actual de \$a: $v.\n";
}

/* foreach ejemplo 2: valor (con clave impresa para ilustrar) */
$a = array(1, 2, 3, 17);

$i = 0; /* slo para propsitos demostrativos */

foreach($a as $v) {
print "\$a[$i++] => $v.\n";
}

/* foreach ejemplo 3: clave y valor */
$a = array(
"uno" => 1,
"dos" => 2,
"tres" => 3,
"diecisiete" => 17
);


10
foreach($a as $k => $v) {
print "\$a[$k] => $v.\n";
}
La sentencia break
break escapa de la estructuras de control iterante (bucle) actuales for, while, o switch.
break acepta un parmetro opcional, el cual determina cuantas estructuras de control hay
que escapar.

$arr = array ('uno', 'dos', 'tres', 'cuatro', 'stop', 'cinco');
while (list (, $val) = each ($arr)) {
if ($val == 'stop') {
break;
}
echo "$val<br>\n";
}

$i = 0;
while (++$i) {// este es un loop
switch ($i) {// este es otro loop
case 5:
echo "En 5<br>\n";
break 1;
case 10:
echo "En 10; salir<br>\n";
break 2;
default:
break;
}
}
La sentencia continue
continue se usa dentro de la estructura del bucle para saltar el resto de la iteracin actual
del bucle y continuar la ejecucin al comienzo de la siguiente iteracin.

continue accepta un parmetro opcional, el cual determina cuantos niveles (bluces) hay que
saltar antes de continuar con la ejecucin.

while (list($key,$value) = each($arr)) {//este es el loop
if ($key % 2) { // salta los miembros impares
continue;

11
}
hacer_algo ($value);
}

$i = 0;
while ($i++ < 5) {
echo "bucle externo<br>\n";
while (1) {
echo " bucle medio<br>\n";
while (1) {
echo " bucle interno<br>\n";
continue 3;
}
echo "Esto nunca se enva<br>\n";
}
echo "Esto tampoco<br>\n";
}


12
La sentencia switch
La sentencia switch es similar a una serie de sentencias IF.. ELSEIF. En muchas ocaciones,
se quiere comparar la misma variable (o expresin) con nuchos valores diferentes, y ejecutar
una parte de cdigo distinta dependiendo de a qu valor es igual. Para ello sirve la sentencia
switch.

Los siguientes dos ejemplos son dos modos distintos de escribir la misma cosa, uno usa una
serie de sentencias if, y el otro usa la sentencia switch:

if ($i == 0) {
print "i es igual a 0";
}
if ($i == 1) {
}
if ($i == 2) {
}

switch ($i) {
case 0:
break;
case 1:
break;
case 2:
break;
}

Es importante entender cmo se ejecuta la sentencia switch para evitar errores. La sentencia
switch ejecuta lnea por lnea (realmente, sentencia a sentencia). Al comienzo, no se ejecuta
cdigo. Slo cuando se encuentra una sentencia case con un valor que coincide con el valor
de la expresin switch PHP comienza a ejecutar las sentencias.

PHP contina ejecutando las sentencias hasta el final del bloque switch, o la primera vez que
vea una sentencia break. Si no se escribe una sentencia break al final de una lista de
sentencias case, PHP seguir ejecutando las sentencias del siguiente case. Por ejemplo:

switch ($i) {
case 0:
case 1:

13
case 2:
}

Aqu, si $i es igual a 0, PHP ejecutara todas las sentecias print! Si $i es igual a 1, PHP
ejecutara las ltimas dos sentencias print y slo si $i es igual a 2, se obtendra la conducta
'esperada' y solamente se mostrara 'i es igual a 2'.

As, es importante no olvidar las sentencias break (incluso aunque pueda querer evitar
escribirlas intencionadamente en ciertas circunstancias).

En una sentencia switch, la expresin se evala slo una vez y el resultado se compara a
cada sentencia case. En una sentencia elseif, la condicin se evala otra vez. Si tu condicin
es ms complicada que una comparacin simple y/o est en un bucle estrecho, un switch
puede ser ms rpido.

La lista de sentencias de un case puede tambin estar vaca, lo cual simplemente pasa el
control a la lista de sentencias del siguiente case.

switch ($i) {
case 0:
case 1:
case 2:
print "i es menor que 3, pero no negativo";
break;
case 3:
print "i es 3";
}

Un case especial es el default case. Este case coincide con todo lo que no coincidan los otros
case. Por ejemplo:

switch ($i) {
case 0:
break;
case 1:
break;
case 2:
break;
default:
print "i no es igual a 0, 1 o 2";
}


14
La expresin case puede ser cualquier expresin que se evale a un tipo simple, es decir,
nmeros enteros o de punto flotante y cadenas de texto. No se pueden usar aqu ni arrays ni
objetos a menos que se conviertan a un tipo simple.

La sintaxis alternativa para las estructuras de control est tambin soportada con switch.
Para ms informacin, ver Sintaxis alternativa para estructuras de control.

switch ($i):
case 0:
print "i es igual 0";
break;
case 1:
break;
case 2:
break;
default:
print "i no es igual a 0, 1 o 2";
endswitch;


15
2.2 Inclusin de cdigo
Las siguientes sentencias permiten incluir cdigo en una pgina PHP.
require()
La sentencia require() se sustituye a s misma con el archivo especificado, tal y como
funciona la directiva #include de C.

Un punto importante sobre su funcionamiento es que cuando un archivo se incluye con
include() o se requiere con require()), el intrprete sale del modo PHP y entra en modo
HTML al principio del archivo referenciado, y vuelve de nuevo al modo PHP al final. Por esta
razn, cualquier cdigo dentro del archivo referenciado que debiera ser ejecutado como
cdigo PHP debe ser encerrado dentro de etiquetas vlidas de comienzo y fin de PHP.

require() no es en realidad una funcin de PHP; es ms una construccin del lenguaje. Est
sujeta a algunas reglas distintas de las de funciones. Por ejemplo, require() no esta sujeto
a ninguna estructura de control contenedora. Por otro lado, no devuelve ningn valor;
intentar leer un valor de retorno de una llamada a un require() resulta en un error del
intrprete.

A diferencia de include(), require() siempre leer el archivo referenciado, incluso si la
lnea en que est no se ejecuta nunca.

Si se quiere incluir condicionalmente un archivo, se usa include(). La sentencia conditional
no afecta a require(). No obstante, si la lnea en la cual aparece el require() no se
ejecuta, tampoco se ejecutar el cdigo del archivo referenciado.

De forma similar, las estructuras de bucle no afectan la conducta de require(). Aunque el
cdigo contenido en el archivo referenciado est todava sujeto al bucle, el propio require()
slo ocurre una vez.

Esto significa que no se puede poner una sentencia require() dentro de una estructura de
bucle y esperar que incluya el contenido de un archivo distinto en cada iteracin. Para hacer
esto, usa una sentencia include().

require( 'cabecera.inc' );

Cuando un archivo es icorporado con require(), el cdigo de ste hereda el mbito de las
variables disponibles en la lnea donde se ejecuta require().

Si se ejecuta require() dentro de una funcin, todo el cdigo del archivo incorporado se
comporta como si fuese definido dentro de la funcin.

Se puede ejecutar require() para incorporar un archivo mediante una URL donde se podrn
opcionalmente enviar prmetros GET. En realidad lo que se incorpora es el resultado de la
ejecucin de la pgina PHP en el servidor.

16

require ("http://algunserver/archivo1.txt?varuno=1&vardos=2");

En PHP3, es posible ejecutar una sentencia return dentro de un archivo referenciado con
require(), en tanto en cuanto esa sentencia aparezca en el mbito global del archivo
requerido (require()). No puede aparecer dentro de ningn bloque (lo que siginifica dentro
de llaves({})).

En PHP4, no obstante, esta capacidad ha sido desestimada. Si se necesita esta funcionalidad,
vase include().

include()
La sentencia include() incluye y evala el archivo especificado.

Si "URL fopen wrappers" esta activada en PHP (como est en la configuracin inicial), se
puede especificar el archivo que se va a incluir usando una URL en vez de un archivo local
(con su Path) Ver Archivos remotos y fopen() para ms informacin.

Un punto importante sobre su funcionamiento es que cuando un archivo se incluye con
include() o se requiere con require(), el intrprete sale del modo PHP y entra en modo
HTML al principio del archivo referenciado, y vuelve de nuevo al modo PHP al final. Por esta
razn, cualquier cdigo dentro del archivo referenciado que debiera ser ejecutado como
cdigo PHP debe ser encerrado dentro de etiquetas vlidas de comienzo y fin de PHP.

Esto sucede cada vez que se encuentra la sentencia include(), as que se puede usar una
sentencia include() dentro de una estructura de bucle para incluir un nmero de archivos
diferentes.

$archivos = array ('primero.inc', 'segundo.inc', 'tercero.inc');
for ($i = 0; $i < count($archivos); $i++) {
include $archivos[$i];
}

include() difiere de require() en que la sentencia include se re-evala cada vez que se
encuentra (y slo cuando est siendo ejecutada), mientras que la sentencia require() se
reemplaza por el archivo referenciado cuando se encuentra por primera vez, se vaya a
evaluar el contenido del archivo o no (por ejemplo, si est dentro de una sentencia if cuya
condicin evaluada es falsa).
Debido a que include() es una construccin especial del lenguaje, se debe encerrar dentro
de un bloque de sentencias si est dentro de un bloque condicional.

/* Esto es ERRNEO y no funcionar como se desea. */


17
if ($condicion)
include($archivo);
else
include($otro);

/* Esto es CORRECTO. */

if ($condicion) {
include($archivo);
} else {
include($otro);
}

En ambos, PHP3 y PHP4, es posible ejecutar una sentencia return dentro de un archivo
incluido con include(), para terminar el procesado de ese archivo y volver al archivo de
comandos que lo llam.

Existen algunas diferencias en el modo en que esto funciona, no obstante. La primera es que
en PHP3, return no puede aparecer dentro de un bloque a menos que sea un bloque de
funcin, en el cual return se aplica a esa funcin y no al archivo completo. En PHP4, no
obstante, esta restriccin no existe.

Tambin, PHP4 permite devolver valores desde archivos incluidos con include(). Se puede
capturar el valor de la llamada a include() como se hara con una funcin normal. Esto
generara un error de intrprete en PHP3.

Asumamos la existencia del siguiente archivo (llamado test.inc) en el mismo directorio que el
archivo principal:
<?php
echo "Antes del return <br>\n";
if ( 1 ) {
return 27;
}
echo "Despus del return <br>\n";
?>
Asumamos que el archivo principal (main.html) contiene lo siguiente:
<?php
$retval = include( 'test.inc' );
echo "El archivo devolvi: '$retval'<br>\n";
?>
Cuando se llama a main.html en PHP3, generara un error del intrprete en la linea 2; no se

18
puede capturar el valor de un include() en PHP3.
En PHP4, no obstante, el resultado ser:
Antes del return
El archivo devolvi: '27'
Ahora, asumamos que se ha modificado main.html para que contenga lo siguiente:
<?php
include( 'test.inc' );
echo "De vuelta en main.html<br>\n";
?>
En PHP4, la salida ser:
Antes del return
De vuelta en main.html
No obstante, PHP3 dar la siguiente salida:
Antes del return
27De vuelta en main.html

Parse error: parse error in /home/torben/public_html/phptest/main.html on line 5
El error del intrprete es resultado del hecho de que la sentencia return est encerrada en
un bloque de no-funcin dentro de test.inc. Cuando el return se mueve fuera del bloque, la
salida es:
Antes del return
27De vuelta en main.html
El '27' espreo se debe al hecho de que PHP3 no soporta devolver valores con return desde
archivos como ese.
Cuando un archivo es icorporado con include(), el cdigo de ste hereda el mbito de las
variables disponibles en la lnea donde se ejecuta include().

Si se ejecuta include() dentro de una funcin, todo el cdigo del archivo incorporado se
comporta como si fuese definido dentro de la funcin.

Se puede ejecutar include() para incorporar un archivo mediante una URL donde se podrn
opcionalmente enviar prmetros GET. En realidad lo que se incorpora es el resultado de la
ejecucin de la pgina PHP en el servidor.


19
include ("http://algunserver/archivo1.txt?varuno=1&vardos=2");

require_once()
Es similar a require() salvo que asegura que la inclusin se realiza una sola vez en el script.
De esta forma se evitan las posibles redefiniciones de variables y funciones por ejemplo.
include_once()
Es similar a include() salvo que asegura que la inclusin se realiza una sola vez en el script.
De esta forma se evitan las posibles redefiniciones de variables y funciones por ejemplo.


20
2.3 Funciones
Veremos con ms detalle aspectos de las funciones en PHP.
Funciones definidas por el usuario
Una funcin se define con la siguiente sintaxis:

function algo ($arg_1, $arg_2, ..., $arg_n) {
......cuerpo de la funcin.......
return $retval;
}

Cualquier instruccin vlida de PHP puede aparecer en el cuerpo de la funcin, incluso otras
funiones y definiciones de clases.

En PHP3, las funciones deben definirse antes de que se referencien. En PHP4 no existe tal
requerimiento.

PHP no soporta la sobrecarga de funciones, y tampoco es posible redefinir u ocultar
funciones previamente declaradas.

PHP3 no soporta un nmero variable de parmetros, aunque s soporta parmetros por
defecto (ver Valores por defecto de de los parmetros para ms informacin).

PHP4 soporta ambos: ver Listas de longitud variable de parmetros y las referencias de las
funciones.
Parmetros de las funciones
La informacin puede suministrarse a las funciones mediante la lista de parmetros, una lista
de variables y/o constantes separadas por comas.

PHP soporta pasar parmetros por valor (el comportamiento por defecto), por referencia, y
parmetros por defecto.
Pasar parmetros por referencia
Por defecto, los parmetros de una funcin se pasan por valor (de manera que si cambias el
valor del argumento dentro de la funcin, no se ve modificado fuera de ella). Si deseas
permitir a una funcin modificar sus parmetros, debes pasarlos por referencia.

Si quieres que un parmetro de una funcin siempre se pase por referencia, puedes
anteponer un ampersand (&) al nombre del parmetro en la definicin de la funcin:


21
function algo(&$string) {
$string .= ' y algo ms.';
}

$str = 'Esto es una cadena, ';
algo($str);
echo $str; // Saca 'Esto es una cadena, y algo ms.'

Si deseas pasar una variable por referencia a una funcin que no toma el parmetro por
referencia por defecto, puedes anteponer un ampersand al nombre del parmetro en la
llamada a la funcin:

function algo($bar) {
$bar .= ' y algo ms.';
}

$str = 'Esto es una cadena, ';
algo ($str);
echo $str; // Saca 'Esto es una cadena, '

algo (&$str);
echo $str; // Saca 'Esto es una cadena, y algo ms.'
Parmetros por defecto
Una funcin puede definir valores por defecto para los parmetros escalares estilo C++:

function cafe($tipo = "cappucino") {
return "Hacer una taza de $tipo.\n";
}

echo cafe ();
echo cafe ("espresso");

La salida del fragmento anterior es:

Hacer una taza de cappucino.
Hacer una taza de espresso.

El valor por defecto tiene que ser una expresin constante, y no una variable o miembro de
una clase.


22
En PHP 4.0 tambin es posible especificar unset como parmetro por defecto. Esto significa
que el argumento no tomar ningn valor en absoluto si el valor no es suministrado.

Destacar que cuando se usan parmetros por defecto, estos tienen que estar a la derecha de
cualquier parmetro que no tenga valor por defecto; de otra manera las cosas no
funcionarn de la forma esperada. Considera el siguiente fragmento de cdigo:

function yogurt ($tipo = "acido", $gusto) {
return "Haciendo un bol $tipo con gusto a $gusto.\n";
}

echo yogurt ("mora"); // No funcionar de la manera esperada

La salida del ejemplo anterior es:

Warning: Missing argument 2 in call to yogurt() in
/usr/local/etc/httpd/htdocs/php3test/func.html on line 41
Haciendo un bol mora con gusto a.

Y ahora, compralo con:

function yogurt ($gusto, $tipo = "acido") {
return "Haciendo un bol $tipo con gusto a $gusto.\n";
}

echo yogurt ("mora"); // funciona como se esperaba

La salida de este ejemplo es:

Haciendo un bol acido con gusto a mora.
Lista de longitud variable de parmetros
PHP4 soporta las listas de longitud variable de parmetros en las funciones definidas por el
usuario.

No necesita de ninguna sintaxis especial, y las listas de parmetros pueden ser escritas en la
llamada a la funcin y se comportarn de la manera esperada.
Devolucin de valores
Los valores se retornan usando la instruccin opcional return. Puede devolverse cualquier
tipo de valor, incluyendo listas y objetos.


23
function cuadrado ($num) {
return $num * $num;
}

echo cuadrado (4); // saca '16'.

No puedes devolver mltiples valores desde una funcin, pero un efecto similar se puede
conseguir devolviendo una lista.

function numeros_pequeos() {
return array (0, 1, 2);
}

list ($cero, $uno, $dos) = numeros_pequeos();
Funciones variable
PHP soporta el concepto de funciones variable, esto significa que si una variable tiene unos
parntesis aadidos al final, PHP buscar una funcin con el mismo nombre que la
evaluacin de la variable, e intentar ejecutarla. Entre otras cosas, esto te permite
implementar retrollamadas (callbacks), tablas de funciones y dems.

<?php
function algo() {
echo "Dentro de algo()<br>\n";
}

function bar( $arg = '' ) {
echo "Dentro de bar(); el parmetro fue '$arg'.<br>\n";
}

$func = 'algo';
$func();
$func = 'bar';
$func( 'prueba' );
?>

24
Algunas funciones importantes de PHP
Funciones de ejecucin de programas
escapeshellcmd (PHP 3, PHP 4 )

enmascara los metacaracteres del intrprete de comandos

string escapeshellcmd (string command)

EscapeShellCmd() enmascara cualquier carcter en una cadena de caracteres que
pueda usarse para introducir fraudulentamente una orden al intrprete de rdenes
para que ste ejecute instrucciones arbitrarias. Esta funcin se debera usar para
asegurarse que cualquier dato que venga del usuario (variables remotas) se
enmascare antes de que ste se le pase a las funciones exec() o system(), o al
operador (apstrofe invertido) . Un uso habitual podra ser:

system(EscapeShellCmd($cmd))

Vase tambin exec(), popen(), system(), y el operador (apstrofe invertido).

exec (PHP 3, PHP 4 )

Ejecuta un programa externo

string exec (string command [, string array [, int return_var]])

exec() ejecuta la orden indicada en command, sin embargo no produce ninguna
salida. Simplemente devuelve la ltima lnea de la salida resultado de la orden. Si
necesita ejecutar una orden y obtener directamente todos los datos devueltos por la
orden sin ninguna interferencia, use la funcin PassThru().

Si el parmetro array existe, entonces el array especificado se rellenar con cada una
de las lneas de la salida producida por la orden. Notar que si el array ya contiene
algunos elementos, exec() los aadir al final del array. Si no quiere que la funcin
incorpore dichos elementos, haga un unset() sobre el array antes de pasrselo a
exec().

Si el parmetro return_var existe a la vez que el parmetro array, entonces el valor
de retorno de la orden ejecutada se guardar en dicha variable.

Destacar que si usted va a permitir que se pasen datos provenientes de usuarios a
esta funcin, entonces debera usar EscapeShellCmd() para asegurarse de que los
usuarios no pueden engaar al sistema para ejecutar instrucciones arbitrarias.

Vase tambin system(), PassThru(), popen(), EscapeShellCmd(), y el operador
(apstrofe invertido).

25

passthru (PHP 3, PHP 4 )

Ejecuta un programa externo y muestra su salida literal

string passthru (string command [, int return_var])

La funcin passthru() es similar a la funcin Exec() en que ejecuta una orden
(command). Si existe el parmetro return_var, el valor de estado devuelto por la
orden Unix se guardar ah. Esta funcin debera usarse en lugar de Exec() o
System() cuando la salida de la orden Unix sean datos binarios que deban ser
pasados directamente al navegador.

Un uso tpico de ello es ejecutar algo como las utilidades pbmplus las cuales pueden
dar como resultado directamente el flujo de datos de una imagen. Poniendo el
content-type a image/gif y llamando al programa pbmplus para mostrar un gif, usted
puede crear archivos de rdenes PHP que generen directamente imgenes.

Vase tambin exec(), system(), popen(), EscapeShellCmd(), y el operador

system(PHP 3, PHP 4 )

Ejecuta un programa externo y muestra su salida

string system (string command [, int return_var])

System() se parece a la versin C de la funcin de mismo nombre en que ejecuta la
orden indicada en command y muestra el resultado. Si se indica una variable como
segundo parmetro, el cdigo de estado devuelto por la orden ejecutada se guardar
en esta variable.

Destacar que si usted va a permitir que se pasen datos provenientes de usuarios a
esta funcin, entonces debera usar EscapeShellCmd() para asegurarse de que los
usuarios no pueden engaar al sistema para ejecutar instrucciones arbitrarias.

La llamada a System() tambin intenta vaciar automticamente el buffer de salida
del servidor web despus de cada lnea de salida si PHP est funcionando como un
mdulo del servidor.

Devuelve la ltima lnea de la orden en caso de xito, y falso en caso de fallo. Si
necesita ejecutar una orden y obtener de vuelta todo los datos del mismo sin
interferencias, use la funcin PassThru().

Vase tambin exec(), PassThru(), popen(), EscapeShellCmd(), y el operador


26
Funciones de manejo de archivos
Trataremos los siguientes temas referentes al manejo de archivos:
Abriendo un archivo de texto, lectura, escritura y aadido
Subir archivos al servidor
Forzar descarga de archivos al navegador
Trataremos el tema de los archivos y como se trabaja en ellos desde PHP. No va a ser
exhaustivo ni mucho menos, pretende proporcionar las bases para que experimenten por su
cuenta y riesgo. Vamos a aprender unas cuantas cosas tiles al respecto de los archivos, as
que, si estn listos, empezamos.
Abriendo un archivo de texto, lectura, escritura y aadido
Lo primero que vamos a hacer es escribir un sencillo archivo de texto. Lo abriremos,
escribiremos un par de lneas dentro de l y luego lo cerraremos. El cdigo que realiza esto
se puede ver a continuacin.
<?php
#Abrimos el archivo en modo de escritura
$DescriptorArchivo = fopen("archivo_prueba.txt","w");
#Escribimos la primera lnea dentro de l
$string1 = "Esta es la primera lnea de texto\r\n";
fputs($DescriptorArchivo,$string1);
#Escribimos la segunda lnea de texto
$string2 = "Y esta es la segunda lnea de texto\r\n";
#Cerramos el archivo
fclose($DescriptorArchivo);
?>
As pues, el script anterior lo nico que hace es abrir un archivo llamado
archivo_prueba.txt, y escribe dentro de l dos lneas de texto. Se habrn fijado en el \r\n
de detrs de las lneas de texto, en las variables $string1 y $string2. Esto se debe a que, si
no estuviese puesto, el programa escribira todo seguido. Con solo \n no sirve, al menos en
Windows 2000. En Linux, basta con un \n.
Otra de las cosas importantes del anterior script es algo que quizs no hayamos visto de
cerca. Fijmonos en la siguiente lnea:
La funcin fopen sirve para abrir un archivo en un modo. Los modos pueden ser seis y son
los siguientes. Adems de listarlos, explicar las diferencias (no siempre tan obvias), al
respecto de ellos.
Modo de Qu significa

27
apertura
r
Modo de solo lectura. Se abre el archivo y el cursor se coloca al principio del
mismo, permitiendo leerlo hasta el final.
r+
Modo de lectura/escritura. Se abre el archivo y el cursor se coloca al principio
del mismo, permitiendo leer o escribir en el archivo.
w
Modo de solo escritura. Se crea el archivo si no existiese, y, si existe, se borra
todo su contenido, se sita el cursor al principio del archivo permitindonos
escribir.
w+
Modo de escritura/lectura. Si el archivo no existe, se crea, y, si existiese, se
borra todo su contenido, se sita el cursor al principio del archivo
permitindonos escribir y leer.
a
Modo de aadido. Abre el archivo, sita el cursor al final del mismo y permite
escribir. Si el archivo no existe, lo crea, pero, en caso de existir, no borra su
contenido.
a+
Modo de aadido/lectura. Sita el cursor al final del archivo y permite escribir y
leer. Si el archivo no existe, lo crea, pero, si existe, no borra su contenido.
As pues, estos son los seis modos de abrir un archivo. Vamos ahora a ver un ejemplo de
cdigo del uso de los mismos. El siguiente script va a hacer las siguientes tareas:
Crear un archivo y escribir en l dos lneas de texto.
Abrir el archivo de nuevo, esta vez en modo aadido, y escribir otras dos lneas.
escribir2.php
<?php
#Abrimos el archivo en modo de escritura
#Escribimos la primera lnea dentro de l
$string1 = "Esta es la primera lnea de texto\r\n";
#Escribimos la segunda lnea de texto
$string2 = "Y esta es la segunda lnea de texto\r\n";
fclose($DescriptorArchivo);
#Volvemos a abrir el archivo, esta vez en modo de aadir
$Descriptor2 = fopen("archivo_prueba.txt","a");
#Aadimos la tercera lnea de texto
fputs($Descriptor2,"Esta es la tercera lnea, aadida con modo \"a\"\r\n");
#Aadimos la cuarta lnea de texto
fputs($Descriptor2,"Esta es la cuarta lnea, aadida con modo \"a\"\r\n");
fclose($Descriptor2);
?>

28

Como poden comprobar si se abre el archivo recin creado, ste contiene cuatro lneas, dos
de ellas escritas con modo "w" y otras dos con modo "a".
A continuacin vamos a pasar a ver dos funciones muy tiles para leer archivos de texto:
fgets() y feof(). A travs de fgets() podemos leer una lnea del archivo de texto cada vez.
feof() sirva para saber si hemos llegado al final del archivo. Para ver como funcionan,
crearemos un script que leer el archivo que hemos creado con los dos scripts anteriores.
leer.php
<?php
#Abrimos el archivo en modo lectura
$DescriptorArchivo = fopen("archivo_prueba.txt","r");
#Hasta que no lleguemos al final del archivo
while(!feof($DescriptorArchivo)){
#Capturamos 4096 caracteres dentro de la lnea (tamao del buffer reservado),
#o menos si hay un retorno de carro antes
#(\r\n en Win32, \n en UNIX)
$buffer = fgets($DescriptorArchivo,4096);
#Eviamos el texto, aadiendo <BR> detrs
echo $buffer."<BR>";
}
?>

Como ven, este script lee el archivo de texto lnea a lnea y lo va mostrando en el navegador.
La funcin feof() devuelve TRUE cuando ha llegado al final del archivo. fgets(), va, pues,
leyendo lnea a lnea y almacenndolo en una variable llamada $buffer.
Ahora vamos a ver como funcionan los modos w+, r+ y a+. Vern que son diferentes de los
anteriores en el sentido de que permiten dos operaciones, y tambin en el sentido de como
tratan los archivos. Empezaremos con w+. El siguiente script explica qu es lo que hace este
modo con los archivos.
leer_wmas.php
<?php
#Abrimos el archivo en modo w+
$Descriptor1 = fopen("nuevo_archivo.txt","w+");
#Vamos a escribir un par de lneas en el archivo
fputs($Descriptor1,"Esta es la primera lnea de texto\r\n");
fputs($Descriptor1,"Esta es la segunda lnea de texto\r\n");
#Ahora cerraremos el archivo
#Volvemos a abrirlo en modo w+

29
#Escribimos un par de lneas
fputs($Descriptor2,"Esta es la tercera lnea de texto\r\n");
fputs($Descriptor2,"Esta es la cuarta lnea de texto\r\n");
#Volvemos al principio del archivo
rewind($Descriptor2);
#Vamos leyendo lneas y mostrndolas
while(!feof($Descriptor2)){
$buffer = fgets($Descriptor2,4096);
}
?>

Como ven, al ejecutarlo, el resultado es el siguiente:
Esta es la tercera lnea de texto
Esta es la cuarta lnea de texto
Por qu no aparecen la primera y la segunda lnea escritas? Observemos lo que hemos
hecho. Primero abrimos el archivo y escribimos dentro de l dos lneas de texto. Tras esto, lo
cerramos y lo volvemos a abrir, en modo w+. Este modo BORRA EL CONTENIDO
ANTERIOR del archivo, por lo que en este solo aparecen las dos ltimas lneas. Como ven,
se puede utilizar este modo para leer desde el archivo con fgets().
Ahora vamos a ver un ejemplo con r+. Vamos a crear un script que haga lo mismo que el
anterior, pero en vez de abrir los archivos con w+, los abrir con r+.
leer_rmas.php
<?
#Abrimos el archivo en modo w
$Descriptor1 = fopen("nuevo_archivo.txt","w");
#Volvemos a abrirlo en modo r+
$Descriptor2 = fopen("nuevo_archivo.txt","r+");

30
}
?>

Si ejecutan el script, quizs observen, sorprendidos, que el resultado es el mismo que en el
anterior. Pero lo que ha sucedido, en cambio, no es lo mismo. Vamos a anlizarlo por partes.
Primero, hemos abierto el archivo en modo w (escritura, borra el contenido anterior), para
grabar dos lneas en el archivo. Tras esto, lo cerramos, y lo abrimos en modo r+
(lectura/escritura). Al abrirlo de este modo, el cursor se sita al principio del archivo, por lo
que al escribir las siguientes dos lneas, borra el contenido de las dos lneas anteriroes..
Antes de mostrar el contenido del archivo usamos la funcin rewind(), que rebobina el
cursor hasta el principio del archivo. Para aadir al final de archivo, necesitamos el modo a+,
como veremos en el siguiente ejemplo.
leer_amas.php
<?
#Abrimos el archivo en modo w+
#Volvemos a abrirlo en modo a+
$Descriptor2 = fopen("nuevo_archivo.txt","a+");
}
?>
El resultado de este mtodo es el esperado. Se abre el archivo en modo escritura y se
insertan las dos lneas de texto. Se cierra este descriptor, y se abre otro en modo a+. El
cursor se sita al final del archivo, y comienza a aadir el texto. El resultado son las cuatro
lneas dentro del archivo de texto.

31
Esto es todo en cuanto a modos de apertura. En la siguiente seccin vamos a ver como subir
archivos al servidor, algo muy til cuando se trata de pginas web.
Subir archivos al servidor
Envo de archivos con el mtodo POST
PHP es capaz de recibir envos de archivo de cualquier navegador que cumpla la norma RFC-
1867 (entre los que se incluyen Netscape Navigator 3 o posterior, Microsoft Internet Explorer
3 con un parche o posterior sin ste).

sta caracterstica permite que los usuarios envien archivos de texto y binarios. Mediante la
autentificacin y funciones de manejo de archivos de PHP, es posible un control total de
quin puede enviar archivos y que se hace con stos una vez recibidos.

Es importante destacar que PHP tambin soporta el mtodo PUT para envo de archivos tal y
como lo utiliza Netscape Composer y el cliente Amaya de W3C.

Una pgina de envo de archivos se puede crear mediante un formulario parecido a ste:

<form enctype="multipart/form-data" action="_URL_" method="post">
<input type="hidden" name="MAX_FILE_SIZE" value="1000">
Enviar el archivo: <input name="archivo" type="file">
<input type="submit" value="Enviar Archivo">
</form>

La _URL_ debe tener como destino un script PHP. El input oculto MAX_FILE_SIZE debe
encontrarse antes del input de tipo "file" para indicar el tamao mximo de archivo que se
puede enviar en bytes

Aviso
MAX_FILE_SIZE debe ser consultado por el navegador; aun as es sencillo saltarse este
mximo por lo tanto no se debe presuponer que el navegador siempre lo respetar. En
contrapartida, la configuracion de PHP relativa al tamao maximo no puede ser obviada.

Las variables definidas para el envo de archivos varian en funcin de la versin y
configuracin de PHP que se utilice.

Las variables de las que hablaremos a continuacin sern definidas en la pgina destino
despues de una recepcin de archivo correcta.

Cuando track_vars este activado, el array $HTTP_POST_FILES/$_FILES se inicializar.
Por ultimo, las variables relacionadas seran inicializadas como globales cuando
register_globals est habilitado. Cabe sealar que el uso de las variables globales no esta
recomendado en ningn caso.

32
Nota: track_vars esta activado siempre desde PHP 4.0.3. A partir de PHP
4.1.0 , $_FILES puede ser utilizado alternativamente a
$HTTP_POST_FILES. $_FILES es siempre global as que global no debe ser
usado con $_FILES en el mbito de funcin.
$HTTP_POST_FILES/$_FILES contienen la informacin sobre el archivo recibido.
A continuacin se describe el contenido de $HTTP_POST_FILES. Se ha tomado el nombre
'archivo' para el archivo recibido tal y como se usaba en el script de ejemplo anterior:

$HTTP_POST_FILES['archivo']['name']
El nombre original del archivo en la mquina cliente.

$HTTP_POST_FILES['archivo']['type']
El tipo mime del archivo (si el navegador lo proporciona). Un ejemplo podra ser
"image/gif".

$HTTP_POST_FILES['archivo']['size']
El tamao en bytes del archivo recibido.

$HTTP_POST_FILES['archivo']['tmp_name']
El nombre del archivo temporal que se utiliza para almacenar en el servidor el archivo
recibido.
Nota: A partir de PHP 4.1.0 se puede utilizar el variable corta $_FILES. PHP 3
no soporta $HTTP_POST_FILES.
Cuando register_globals se activa en el php.ini las siguientes variables son accesibles. Se
ha tomado el nombre 'archivo' para el archivo recibido tal y como se usaba en el script de
ejemplo del principio:
$archivo - El nombre del archivo temporal que se utiliza para almacenar en el
servidor el archivo recibido.
$archivo_name - El nombre original del archivo en la mquina cliente.
$archivo_size - El tamao en bytes del archivo recibido.
$archivo_type - El tipo mime del archivo (si el navegador lo proporciona). Un
ejemplo podra ser "image/gif".
Nota: register_globals = On se desaconseja por razones de seguridad y
rendimiento.
Por defecto, los archivos sern almacenados en el directorio temporal por defecto del
servidor a no ser que se especifique otra localizacion con la directiva upload_tmp_dir en
php.ini. El directorio temporal por defecto del servidor puede ser modificado cambiando el
valor de la variable de entorno TMPDIR en el contexto en que se ejecuta PHP. La
configuracin de las variables de entorno no se puede realizar en PHP a travs de la funcin
putenv(). Esta variable de entorno puede ser utilizada tambin para asegurarnos que otras
operaciones con archivos recibidos estn funcionando correctamente.


33
Los siguientes ejemplos son vlidos para versiones de PHP 4 superiores a la 4.0.2. Veanse
las funciones is_uploaded_file() y move_uploaded_file().
<?php
// En PHP 4.1.0 o superior, $_FILES debera usarse en vez de $HTTP_POST_FILES.
if (is_uploaded_file($HTTP_POST_FILES['archivo']['tmp_name'])) {
copy($HTTP_POST_FILES['archivo']['tmp_name'], "path_donde_copiar");
} else {
echo "posible intento de cargar un archivo en forma ilegal. nombre: " .
$HTTP_POST_FILES['archivo']['name'];
}

/* ...o... */
move_uploaded_file($HTTP_POST_FILES['archivo']['tmp_name'], "path_donde_mover");
?>

El script PHP que recibe el archivo, debe implementar la lgica necesaria para determinar
que debe ser realizado con el archivo.

Se puede utilizar, por ejemplo, la variable $HTTP_POST_FILES['archivo']['size'] para
descartar los archivos demasado chicos o demasado grandes; por otro lado, se puede usar
la variable $HTTP_POST_FILES['archivo']['type'] para descartar los que no se ajusten a
algun criterio de tipo. Cualquiera que sea la logica que utilicemos, se debe borrar o mover el
archivo del directorio temporal.

El archivo ser borrado del directorio temporal al final de la peticin si no se ha movido o
renombrado.
Errores comunes
A MAX_FILE_SIZE no se le puede dar un valor mayor que el valor que se haya
especificado en la directiva upload_max_filesize. Por defecto se tiene un lmite de 2
MegaBytes.

Si se ha activado el lmite de memoria, se deben especificar un valor alto para
memory_limit. En cualquier caso, se debe asegurar un valor suficientemente grande para
memory_limit.

Si max_execution_time tiene un valor muy pequeo, la ejecucin del script puede
exceder este valor. De esta forma, se debe asegurar un valor suficientemente grande para
max_execution_time.

Si post_max_size tiene un valor muy pequeo, los archivos mas grandes a este valor, no
podrn ser enviados. Por ello, se debe asegurar un valor suficientemente grande para
post_max_size.


34
No verificar que archivos se estan manipulando puede tener como consecuencia que los
usuarios puedan acceder a informacin sensible en otros directorios.
Envo de mltiples archivos
Es posible enviar varios archivos simultaneamente y tener organizada en arrays la
informacin. Para hacer esto, se utiliza la misma sintxis que cuando tenemos mltiples
"selects" o "checkboxes" en el formulario HTML:
Nota: El soporte para envo multiple de archivos fue aadido en la versin
3.0.10.
<form action="file-upload.php" method="post"
enctype="multipart/form-data">
Enviar estos archivos:<br>
<input name="archivo[]" type="file"><br>
<input name="archivo[]" type="file"><br>
<input type="submit" value="Enviar files">
</form>

Cuando el formulario del ejemplo es enviado, los arrays $HTTP_POST_FILES['archivo'],
$HTTP_POST_FILES['archivo']['name'] y $HTTP_POST_FILES['archivo']['size'] son
inicializados.

Cada uno de estos arrays tendr en los ndices numericos correspondientes los valores para
cada archivo recibido.

Por ejemplo, si tomamos como nombres de archivo enviados archivo1.html y archivo2.out.
Tendramos en $HTTP_POST_FILES['archivo']['name'][0] el valor de archivo1.html, y
en $HTTP_POST_FILES['archivo']['name'][1] tendramos archivo2.out; analogamente,
$HTTP_POST_FILES['archivo']['size'][0] contendra el tamao del archivo
archivo1.html, y as sucesivamente...
Otros ejemplos de manejo de archivos
En estos ejemplos usaremos las variables globales que se habilitan con la directiva
register_globals=On en php.ini.
Para ejemplificar la subida de archivos al servidor en archivos PHP, vamos a ver un script de
ejemplo que contiene variantes de los que vimos anteriormente. El script tiene dos partes; la
primera, el formulario, en el que se introduce el archivo a cargar, y la segunda parte, en la
que se procesa la subida y se informa al usuario del xito o fracaso de la carga. En los
siguientes ejemplos es necesario que est en On la variable register_globals de php.ini.
upload.php
<?php

35
if(!isset($cargar)){
?>
<!DOCTIPO HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>:: Formulario de carga de archivos ::</TITLE>
</HEAD>
<BODY>
<FORM NAME="elForm" METHOD="POST"
ACTION="<?php echo $PHP_SELF; ?>?cargar=1"
ENCTYPE="multipart/form-data">
<TABLE WIDTH="80%" STYLE="font-family:Arial;font-size:9pt;">
<TR>
<TD ALIGN="LEFT"><INPUT TYPE="FILE" NAME="elArchivo"></INPUT></TD>
</TR>
<TR>
<TD ALIGN="LEFT"><INPUT TYPE="SUBMIT" VALUE="Subir el archivo">
</TR>
</TABLE>
</FORM></BODY></HTML>
<?
}
#Aqu realizamos la carga del archivo
if(isset($cargar)){
#Le damos al archivo un nuevo nombre
$nuevositio = "nuevo_archivo_caragado.000"; //se podra indicar otro path
#Lo copiamos
if(!copy($elArchivo,$nuevositio)){
echo "NO SE HA PODIDO SUBIR EL ARCHIVO";
}
else{
echo "ARCHIVO SUBIDO CON XITO";
}

}
?>
Como vemos, el script realiza la carga del archivo. Veremos ahora la carga de mltiples
archivos. Se compondr de tres partes. La primera, en la que se pregunta al usuario el
nmero de archivos que desea introducir. La segunda, en la que aparecen todos los campos
de tipo archivo, y la tercera, en la que se procesa la carga. El cdigo es como sigue:
upload_multiple.php
<?php
/* Este script se encarga de subir mltiples archivos al servidor. */
#Formulario en el que se pregunta el nmero de archivos
if(!isset($arch) && !isset($cargar)){

36
$txt ="<HTML><HEAD>\n";
$txt.="<TITLE>:: Cuntos archivos quiere subir hoy? ::</TITLE>\n";
$txt.="</HEAD><BODY>\n";
$txt.="<FORM NAME=\"frmNumArchivos\"
METHOD=\"POST\"
ACTION=\"".$PHP_SELF."?arch=1\">\n";

$txt.="<BR><BR><BR><BR>\n";
$txt.="<DIV ALIGN=\"CENTER\">\n";
$txt.="<INPUT TYPE=\"TEXT\" NAME=\"numArchivos\">\n";
$txt.=" ";
$txt.="<B>Introduce el nmero de archivos</B>\n";
$txt.="<BR><BR>\n";
$txt.="<INPUT TYPE=\"SUBMIT\"
VALUE=\"Mostrar campos para subir archivos\">\n";
$txt.="<BR></DIV>\n";
$txt.="</FORM></BODY></HTML>\n";
echo $txt; //enva el texto HTML al navegador
}
#Formulario en el que se muestran los campos tipo archivo
if(isset($arch)){
$txt ="<HTML><HEAD>\n";
$txt.="<TITLE>:: Cuntos archivos quiere subir hoy? ::</TITLE>\n";
$txt.="</HEAD><BODY>\n";
$txt.="<FORM ENCTYPE=\"multipart-form/data\"
NAME=\"frmCargaArchivos\"
METHOD=\"POST\"
ACTION=\"".$PHP_SELF."?cargar=1&cantidad=".$HTTP_POST_VARS["numArchivos"]."\">\n";
for($i=0;$i<$HTTP_POST_VARS["numArchivos"];$i++){

$txt.="<INPUT TYPE=\"FILE\" NAME=\"archivo_$i\"><BR>\n";
}
$txt.="<INPUT TYPE=\"SUBMIT\" VALUE=\"cargar\">\n";
$txt.="</FORM></BODY></HTML>\n";

echo $txt; //enva el texto HTML
}
#Parte que gestiona el proceso de carga
if(isset($cargar)){

for($n=0;$n<$cantidad;$n++){
#Creamos la "variable variable"
$nomvar = "archivo_$n";
$valvar = ${$nomvar};
#Extraemos el nombre del archivo sin la ruta
$nomarchivo = basename($valvar); //rescatamos el nombre original del archivo
#Le damos al archivo su nombre, copindolo dentro del directorio /subidas
$nuevositio = "subidas/".$nomarchivo."";

37
#Lo copiamos
if(!copy($valvar,$nuevositio)){
echo "NO SE HA PODIDO SUBIR EL ARCHIVO: ".$nomarchivo;
}
else{
echo "ARCHIVO: .$nomarchivo. SUBIDO CON XITO";
}
}
}
?>

De este modo podemos cargar varios archivos al mismo tiempo. Tendrs que crear el
directorio /subidas manualmente. Vamos a terminar con esta seccin y pasar a la siguiente,
en la que se explica como forzar al cliente a descargarse el archivo en vez de verlo on-line.
Forzar descarga de archivos al navegador
A veces puede ser interesante que el usuario se descargue el archivo en vez de verlo on-line.
Para realizar esta operacin, solo necesitamos utilizar el siguiente cdigo que voy a explicar
a continuacin. El script consta de una sola parte. Vamos a descargarnos un archivo .html,
en vez de verlo en el navegador. El nombre del archivo ser prueba_descarga.html. El
cdigo es como sigue:
descargar.php
<?php
function descargar($ElArchivo){
$TheFile = basename($ElArchivo);

header( "Content-Tipo: application/octet-stream");
header( "Content-Length: ".filesize($ElArchivo));
header( "Content-Disposition: attachment; filename=".$TheFile."");
readfile($ElArchivo);
}

descargar("prueba_descarga.html"); //podra indicarse el path del archivo
?>

Como ves, el script se ejecuta y el archivo, pese a ser HTML, e interpretable por el
navegador, es forzado a ser descargado, igual que si hubiramos pulsado el botn derecho.
Otras funciones con archivos
PHP es uno de los lenguajes del lado del servidor ms completos y con mayor nmero de
funciones tiles. Veremos otras funciones (aunque ya vimos alguna de ellas) que permiten
trabajar con archivos, y en algunos casos con directorios.

38
basename()
Esta funcin devuelve el nombre simple del archivo. Es de utilidad cuando nos
interesa eliminar la ruta fsica de algn archivo y devolver slo el nombre de dicho
archivo y su extensin:
<?
$ruta = "/home/httpd/html/file.php";
$file = basename($ruta); //devuelve 'file.php'
?>
Como ves, la funcin basename devuelve el archivo resultante de la eliminacin de la
ruta fsica. Su utilizacin es demasiado bsica y no necesita de ninguna explicacin
amplia.
chmod()
Increblemente PHP permite cambiar los permisos de algn archivo o directorio
utilizando esta funcin. Obviamente est restringida y su aplicacin no es ms que un
intento por cambiar el valor chmod de algn archivo o carpeta, pero para que
verdaderamente funcione se requiere de soporte en el servidor.
La nica particularidad de esta funcin es que para otorgar permisos se debe
anteponer un 0 al valor del permiso. Por ejemplo, para 755 se debe escribir 0755.
La sintaxis de la funcin es:
<?
chmod("/directorio/archivo", permiso);
?>
En donde permiso, como ya mencionamos, debe ser el valor chmod que deseamos
otorgar, con un 0 anteponindolo.
Para dar a archivo.txt permisos 777 debemos utilizar la siguiente sintaxis:
<?
chmod("archivo.txt", 0777);
?>
copy()
Como su nombre lo indica, esta funcin permite copiar archivos dentro del servidor.
Muy til se deseamos hacer un back-up online de modo que tengamos los archivos
antiguos dentro del servidor evitando el peso de descargarlos todos. An as, las
aplicaciones son muchsimas.
<?

39
copy($archivo, $destino);
?>
copy() devuelve true si se ejecut el proceso correctamente y false si no se logr la
copia.
Podemos aprovechar esta capacidad para mostrar mensajes de error segn suceda:
<?
if(!copy("archivo.txt","backup1.txt")){
echo "Error al tratar de copiar el archivo.\n";
}
?>
Lo anterior mostrara un mensaje de error si no se logra la copia del archivo
archivo.txt a backup1.txt
dirname()
Devuelve el nombre del directorio de una ruta:
<?
$ruta = "/directorio/archivo";
$dirname = dirname($ruta); //devuelve '/directorio'
?>
diskfreespace()
Esta extraa funcin devuelve el nmero de bytes de espacio libre que hay en el
disco. Para verificar, por ejemplo, el espacio libre disponible en el directorio raz de un
sitio web se utiliza la sintaxis:
<?
$espacio = diskfreespace("/");
?>
readfile()
Lee un archivo completo, envindolo a la salida estndar y devuelve al final el nmero
de bytes ledos. Si no se logra abrir la conexin con el archivo devuelve error, salvo
que se ejecute como @filname().
<?
$archivo = readfile("archivo.txt");
echo $archivo; //escribe el numero de bytes leidos
?>
Esta es una forma muy fcil de leer archivos aunque el problema est en que
devuelve el nmero de bytes ledos, cosa que nadie deseara, para ello se utiliza ms

40
frecuentemente la funcin file() que devuelve un array con todas las lneas del
archivo. Ms adelante veremos cmo utilizarla.
fopen(), fclose(), fwrite(), fread()
fopen() crea una conexin a algn archivo, especificando el tipo de tratamiento que
se le dar al archivo, es decir, si ser de lectura, escritura o ambos. Por defecto, se
puede leer un archivo pero para lograr escribir en l se requieren permisos chmod
755.
fclose() cierra la conexin para liberar memoria.
La sintaxis de fopen es:
$archivo = fopen("archivo.txt",permiso)
permiso equivale a una letra identificadora del tipo de tratamiento que le daremos al
archivo. Existen tres bsicamente: r (solo lectura), w (escritura) y a (ambos). En el
caso de escritura el cursor se ubica al inicio del archivo por lo que la escritura afecta
todo el contenido del mismo, mientras que a ubica el cursor al final del archivo para
escribir nuevo contenido sin eliminar el existente.
Veremos un ejemplo de escritura en un archivo.
<?
$fp = fopen("archivo.txt","w"); //abrimos el archivo para escritura
fwrite($fp, "Estoy escribiendo en un archivo!!!");
fclose($fp); //cerramos la conexin y liberamos la memoria
?>
Ahora hemos introducido la funcin fwrite() que permite la escritura en un archivo,
segn la conexin creada.
La sintaxis es:
fwrite($conexion, textoaescribir)
Otra de las muchas formas de leer archivos es utilizar la funcin fread aunque sta
est un poco limitada, pues slo lee un archivo hasta determinado nmero de bytes,
para evitar esto se puede utilizar la funcin file_size para establecer el nmero de
bytes totales y as leer todo el archivo. Ms adelante encontrars informacin sobre
esta funcin.
<?
$fp = fopen("archivo.txt","r"); //abrimos el archivo como solo lectura
$contenido = fread($fp, 2000); //leemos 2000 bytes del archivo establecido en $fp
fclose($fp);
?>

41
file()
Esta funcin toma el contenido total de cualquier archivo y lo guarda lnea por lnea
en un array.
Es la ms til de todas las formas de lectura de archivos pues permite crear scripts
complejos que trabajen en lneas... por ejemplo un rotador de banners que tenga en
cada lnea un banner diferente para rotar.
De esta forma se puede procesar con mayor flexibilidad el contenido de un archivo de
texto con las mltiples funciones de procesamiento de arrays que dispone PHP.
la sintaxis de file no tiene problemas:
$archivo = file("archivo.txt")
Con lo anterior, $archivo ya es un array con todas las lneas de archivo.txt.

Como $archivo es un array con cada lnea de archivo.txt esto quiere decir que cada
elemento en el array equivale en una lnea, por ello se puede usar count()
facilmente.
Pero para aclararlo veamos un ejemplo:
<?
$archivo = file("archivo.txt"); //creamos el array con las lineas del archivo
$lineas = count($archivo); //contamos los elementos del array, es decir el total de lineas
for($i=0; $i < $lineas; $i++){
echo $archivo[$i];
}
?>
Como ves es muy sencillo. Primero abrimos el archivo y lo convertimos en vector
(array). Posteriormente guardamos su nmero total de elementos (que equivale al
nmero de lneas) en la variable $lineas.
Luego un bucle se encarga de recorrer cada lnea y escribirla en pantalla.
La ventaja de este mtodo es que podemos leer cualquier lnea fcilmente, pues
$archivo es un array. Si deseamos leer la primera lnea podemos utilizar $archivo[0] y
as sucesivamente.
file_exists()
Muy til funcin que verifica la existencia de un archivo, devolviendo true si
verdaderamente existe y false si no.
Veamos un ejemplo:

42
<?
$archivo = "archivo.txt";
if(file_exists($archivo)){
echo "El archivo $archivo existe.\n";
else{
echo "El archivo $archivo no existe.\n";
}
?>
Hemos hecho uso de una estructura condicional para mostrar un mensaje de acuerdo
a la existencia o no del archivo. Como PHP puede crear conexiones a servidores
externos, es posible verificar la existencia de una URL con file_exists() antes de
dirigir al usuario a dicha direccin.
fileatime()
Devuelve la fecha del ltimo acceso a un archivo, o false en caso de error.
<?
echo fileatime("archivo.txt");
?>
Escribira en pantalla la ltima fecha de acceso a archivo.txt
filesize()
Devuelve el nmero total de bytes que ocupa cualquier archivo. Es posible modificar
estos valores mediante divisiones para convertirlo a megabytes, kilobytes, etc.
<?
$tam = filesize("imagen.gif");
echo $tam;
?>
El anterior cdigo devolvera el tamao total en bytes que est ocupando imagen.gif
is_..
Las funciones is permiten conocer algunas caractersticas de un archivo o directorio.
Todas poseen la misma sintaxis por lo que slo veremos para qu sirve cada una.
La sintaxis base es:
<?
funcion($archivo);
?>
Donde funcion es alguna de las siguientes:

43
is_dir: Devuelve true si $archivo es un directorio
is_executable: Devuelve true si $archivo es ejecutable
is_file: Devuelve true si $archivo es un archivo y no directorio
is_readable: Devuelve true si se puede leer $archivo
is_writeable: Devuelve true si se puede escribir en $archivo
mkdir()
Trata de crear una carpeta en el servidor:
mkdir("/ruta/al/nuevo/directorio",permiso)
El primer parmetro debe ser la ruta al nuevo directorio, es decir, al que se trata de
crear y permiso es el permiso chmod en formato octal, es decir, con un 0 antes. El
permiso permite establecer el chmod que deseamos al momento de crear el
directorio. Funciona igual que chmod().
rename()
Trata de renombrar algn archivo.
<?
rename("nombreviejo","nuevonombre");
?>

Una nota de importancia es que en casi todos los ejemplos se ha utilizado como archivo el
nombre archivo.txt pero en realidad puede ser cualquiera.
Acceso a archivos remotos
Siempre que el soporte para la "envoltura URL fopen" est habilitado cuando se configura
PHP (lo cual ocurre a menos que se use explcitamente la opcin --disable-url-fopen-wrapper
en la configuracin de PHP para versiones hasta la 4.0.3, configurar como "off" el
parmetro allow_url_fopen en php.ini (para las nuevas versiones)) se pueden usar URLs
HTTP y FTP con la mayora de las funciones que toman un archivo como parmetro,
incluyendo las sentencias require() e include().
Nota: Consultar si la versin actual de PHP para Windows soporta el acceso
remoto a archivos en las siguientes funciones: include(), include_once(),
require() y require_once().
Como ejemplo, se puede usar este para abrir un archivo en un servidor web remoto, analizar
en la salida la informacin que se quiera, y entonces, usar la informacin en una consulta a
base de datos, o simplemente para sacarlas en un estilo que coincida con el resto de su sitio
web.


44
<?php
$file = fopen ("http://www.ejemplo.com/", "r");

if (!$file) {
echo "<p>No se puede abrir el archivo remoto.\n";
exit;
}

while (!feof ($file)) {
$line = fgets ($file, 1024);

/* Esto funciona si el ttulo y sus Tags estn en la misma lnea */
if (eregi ("<title>(.*)</title>", $line, $out)) {
$title = $out[1];//obtenemos el ttulo de la pgina remota
break;
}
}
fclose($file);
?>

Tambin se puede conectar con el protocolo FTP y escribir en el servidor remoto, siempre
que se conecte como un usuario con los correctos derechos de acceso, y el archivo no exista
ya.

Para conectar como un usuario distinto de 'anonymous', se necesita especificar el nombre de
usuario (y posiblemente contrasea) dentro de la URL, tales como
'ftp://usuario:clave@ftp.ejemplo.com/camino/a/archivo'.

Se puede usar la misma clase de sintaxis para acceder a archivos via HTTP cuando se
requiera una autenticacin.

En el siguiente ejemplo almacenamos datos en el servidor FTP.

<?php
$file = fopen ("ftp://ftp.ejemplo.com/path/archivo", "w");

if (!$file) {
echo "<p>No se puede abrir el archivo remoto.\n";
exit;
}

/* Grabar los datos. */
fputs ($file, $HTTP_SERVER_VARS['HTTP_USER_AGENT'] . "\n");
fclose ($file);
?>

45
Nota: Se puede captar la idea en el ejemplo anterior de como escribir en un registro remoto,
pero como ya hemos comentado antes, solamente se puede escribir a un archivo nuevo
usando la "envoltura URL fopen" Para registros distribuidos, consultar la funcin syslog().

46
2.4 Clases y Objetos
clases
Una clase es una coleccin de variables y de funciones que acceden a esas variables. Las
variables se conocen como atributos o propiedes y las funciones como mtodos.

Cuando se personaliza o instancia una clase se crea un objeto . Esta variable objeto
permite acceder a las propiedades y mtodos de la clase que en definitiva actan sobre las
propiedades de la clase.

Por ejemplo si se quisiera realizar un sistema que administre el tema de reserva de pasajes
de una Lnea area habra que mantener una serie de valores que indiquen el estado actual
de la reserva y disponibilidad de pasajes. Esto puede hacerse mediante una clase donde se
crean las funciones o mtodos para actualizar y mantener dichos valores o propiedades.

La ventaja de la clase que permite el reuso del cdigo ya que el mismo cdigo servira para
otras Lneas Areas simplemente creando nuevas instancias u objetos para el manejo de
otras Lneas.

Las clases realizan un manejo de cdigo similar al manejo de descriptores o manipuladores
que se usan cuando se habren archivos o se realizan consultas a bases de datos. Las
funciones que se usan en estos casos son las mismas para cualquier archivo o cualquier base
de datos.

Una clase se define con la siguiente sintaxis:

<?php
class Cart {
var $items; // Items en nuestro carro de la compra

// Aadir $num artculos de tipo $artnr al carro

function add_item ($artnr, $num) {
$this->items[$artnr] += $num;
}

// Sacar $num artculos del tipo $artnr del carro

function remove_item ($artnr, $num) {
if ($this->items[$artnr] > $num) {
$this->items[$artnr] -= $num;
return true;
} else {
return false;
}
}

47
}
?>

El ejemplo define una clase llamada Cart que consiste en un array asociativo de artculos en
el carro y dos funciones para meter y sacar tems del carro.

Las clases son tipos, es decir, son plantillas para variables. Tienes que crear una variable del
tipo deseado con el operador new.

$cart = new Cart;
$cart->add_item("10", 1);

Este ejemplo crea un objeto $cart de clase Cart. La funcin add_item() de ese objeto se
llama para aadir un item del artculo nmero 10 al carro.

Las Clases pueden ser extensines de otras clases. Las clases extendidas o derivadas tienen
todas las variables y funciones de la clase base y lo que les aadas al extender la definicin.
La herencia mltiple no est soportada.

class Carro_con_nombre extends Cart {
var $propietario;

function establece_propietario ($nombre) {
$this->propietario = $nombre;
}
}

Ese ejemplo define una clase Carro_con_nombre (carro con nombre o dueo) que tiene
todas las variables y funciones de Cart, y adems aade la variable $propietario y una
funcin adicional establece_propietario(). Un carro con nombre se crea de la forma habitual
y, una vez hecho, puedes acceder al propietario del carro. En los carros con nombre tambin
puedes acceder a las funciones normales del carro:

$ncart = new Carro_con_nombre ; // Creamos un carro con nombre
$ncart-> establece_propietario ("juan"); // Nombramos el carro
print $ncart->propietario; // Imprimimos el nombre del propietario
$ncart->add_item ("10", 1); // Funcionalidad heredada de Cart

En funciones de una clase, la variable $this hace referencia al propio objeto. Tienes que usar
$this->loquesea para acceder a una variable o funcin llamada loquesea del objeto actual.

Los constructores son funciones de una clase que se llaman automticamente al crear una
nueva instancia (objeto) de una clase. Una funcin se convierte en constructor cuando tiene
el mismo nombre que la clase.


48
class Auto_Cart extends Cart {
function Auto_Cart () {
$this->add_item ("10", 1);
}
}

Este ejemplo define una clase Auto_Cart que es un Cart junto con un constructor que
inicializa el carro con un item del tipo de artculo "10" cada vez que se crea un nuevo
Auto_Cart con "new". Los constructores tambin pueden recibir parmetros y estos
parmetros pueden ser opcionales, lo que los hace ms tiles.

class Constructor_Cart extends Cart {
function Constructor_Cart ($item = "10", $num = 1) {
$this->add_item ($item, $num);
}
}

// Compramos las mismas cosas aburridas de siempre

$default_cart = new Constructor_Cart;

// Compramos las cosas interesantes

$different_cart = new Constructor_Cart ("20", 17);

Funciones con objetos

get_class_methods (PHP 4 >= 4.0RC1)
Devuelve un vector (matriz unidimensional) con los nombres de los mtodos de la
clase en cuestin.

vector get_class_methods (string class_name)
Esta funcin devuelve un vector con los nombres de los mtodos definidos en la clase
especificada como class_name.

get_class_vars(PHP 4 >= 4.0RC1)
Devuelve un vector con las propiedades (inicializadas por defecto) de la clase

array get_class_vars (string class_name)
Atencin
Para las clases derivadas, el constructor de la clase padre no es llamado automticamente
cuando se llama al constructor de la clase derivada.

49
Esta funcin devuelve un vector con las propiedades que han sido inicializadas por
defecto en la clase.

get_object_vars (PHP 4 >= 4.0RC1)
Devuelve un vector de propiedades del objecto

array get_class_vars (object obj)
Esta funcin devuelve un vector con las propiedades de objeto definidas en el objeto
especificado como obj.

method_exists (PHP 4 >= 4.0b2)
Comprueba que el mtodo de clase existe

bool method_exists (object object, string method_name)
Esta funcin devuelve verdadero si el mtodo referido por method_name ha sido
definido en el objeto object, en cualquier otro case devuelve falso


50
2.5 Proteger pginas con password en PHP
Proteger una pgina para que solo pueda ser accedida por algunos usuarios es algo muy til,
el siguiente script es simple pero efectivo y permite una ptima proteccin.
El formulario (formulario.html) posee dos cajas de texto, en donde se deber ingresar el
nombre de usuario y la contrasea. La pgina en este caso protegida es password.php.
formulario.html

<form method="POST" action="password.php">
Usuario: <input type="text" name="usuario" size="10"><br>
Password: <input type="password" name="password" size="10"><br>
<input type="submit" value="Enviar" name="privado">
El formulario es enviado y procesado por password.php:
password.php

<?
// Comparamos a ver si son correctos
if ($usuario=="juan" && $password=="clavedejuan")
{
$valido="si";
}
else
{
$valido="no";
}
?>
<html>
<head>
<title>Pagina privada</title>
</head>
<body>
<? if ($valido=="si")
{
?>
' A continuacin todo el contenido de nuestra pagina privada
<p>BIENVENIDO A LA PAGINA PRIVADA</p>
<? }
else
{
?>
<p>USUARIO O CONTRASEA INCORRECTA</p>
<? } ?>

51
</body>
</html>
Como les dije antes, el sistema es muy sencillo, pero puede ser de gran utilidad para quienes
necesitan que alguna informacin pueda ser vista solamente por personas autorizadas.
Autentificacin HTTP con PHP
En un script de PHP (instalado como mdulo de Apache), se puede usar la funcin header()
para enviar un mensaje de "Autentificacin requerida" al navegador cliente haciendo que
muestre una ventana de entrada emergente con nombre de usuario y contrasea.

Una vez que el usuario ha rellenado el nombre y la contrasea, la URL que contiene el script
PHP vuelve a ser llamada con las variables $PHP_AUTH_USER, $PHP_AUTH_PW y
$PHP_AUTH_TYPE rellenas con el nombre de usuario, la contrasea y el tipo de
autentificacin respectivamente.

Un fragmento de script de ejmplo que fuerce la autentificacin del cliente en una pgina
sera como el siguiente:

<?php
if (!isset($_SERVER['PHP_AUTH_USER'])) {
header("WWW-Authenticate: Basc realm=\"Mi Sitio\"");
header("HTTP/1.0 401 Unauthorized");
echo "Texto a enviar si el usuario activa el boton Cancel\n";
exit;
} else {
echo "<p>Bienvenido {$_SERVER['PHP_AUTH_USER']}.</p>";
echo "<p>Usted est registrado con {$_SERVER['$PHP_AUTH_PW']} su
password.</p>";
}
?>
Nota: Por favor tener cuidado cuando ests programando las lneas de
cabecera HTTP. Para garantizar la maxima compatibilidad con todos los
clientes, la palabra clave "Basc" debe de ser escrita con "B" mayscula, la
cadena de texto debe estar incluida entre comillas dobles (no simples) y un
espacio debe preceder el cdigo "401" en la linea de cabecera "HTTP/1.0 401"
En vez de, sencillamente, mostrar $PHP_AUTH_USER y $PHP_AUTH_PW, seguramente
querrs comprobar la validez del nombre de usuario y la contrasea. Tal vez enviando una
consulta a una base de datos o buscando el usuario en un archivo dbm o de texto tal vez.
Vigilar aqu los navegadores Interner Explorer con bugs. Parecen muy quisquillosos con el
orden de las cabeceras. Enviar la cabecera WWW-Authenticate antes que la cabecera
HTTP/1.0 401 parece ser el truco por ahora.


52
Para prevenir que alguien escriba un script que revele la contrasea de una pgina que ha
sido autentificada a travs de algn mecanismo externo tradicional, las variables
PHP_AUTH no sern rellenadas si algn tipo de autentificacin externo ha sido activado
para una pgina en particular. En este caso, la variable $REMOTE_USER puede ser usada
para identificar al usuario autentificado externamente.
Nota: PHP usa la directiva AuthType para determinar si una autentificacin
externa esta en uso. Recordar no usar esta directiva cuando quieran usar la
autentificacin de PHP (si no todo intentento de autentificacin fallar).
A pesar de todo, lo ya dicho no proteje de que alguien que controle una URL
no autentificada robe contraseas de URLs autentificadas en el mismo servidor.

Tanto Netscape como Internet Explorer borrarn la cach con la informacin de la ventana
de autentificacin en el navegador local, despus de recibir una respuesta 401 del servidor.
Esto puede usarse, de forma efectiva, para "desconectar" a un usuario, forzandole a
reintroducir su nombre y contrasea. Algunas personas usan esto para "hacer caducar"
entradas.

53
2.6 Cookies
PHP soporta cookies HTTP. Las Cookies son un mecanismo que sirve para almacenar datos
en el navegador del usuario remoto, para as poder identificar al usuario cuando vuelva.

La principal utilidad de las cookies (galletas) es la de solventar el problema de la falta de
estado en la navegacin a travs de las paginas web.

Con las cookies, pequeas porciones de informacin se quedan registradas en el navegador
permitiendo identificar a este a travs de diferentes pginas de un mismo sitio e incluso
durante visitas entre distintos das.

Realmente las cookies no son mas que cadenas de texto que son enviadas desde el servidor
al cliente (navegador) y almacenadas en este, luego el navegador enva estas cookies al
servidor permitiendo as la identificacin del cliente en el servidor.

La cookie es enviada al navegador desde el servidor y si este la acepta permanece en l.

Las pginas piden la cookie al navegador...

El navegador las enva, permitiendo la identificacin del usuario por parte del servidor.

A continuacin vamos a ver como usar las cookies para nuestro beneficio.

Se pueden poner cookies usando la funcin setcookie(). Las Cookies son parte de la
cabecera HTTP, por tanto la funcin setcookie() debe ser llamada antes de que se
produzca cualquier salida al navegador.


54
Esta limitacin es la misma a la de la funcin header(). Se pueden usar las funciones de
buffer del resultado para retrasar el resultado del script hasta que hayas decidido mandar o
no una cookie o cabecera.

Cualquier cookie enviada al servidor desde el cliente, automticamente se convertir en una
variable PHP igual como ocurre con los mtodos de datos GET y POST, dependiendo de las
variables de configuracin register_globals y variables_order. Si deseas asignar
mltiples valores a una cookie simple, aade simplemente [] a el nombre de la cookie.

En PHP 4.1.0 y posteriores, la array auto-global $_COOKIE ser siempre actualizada con
cualquier cookie mandada por el cliente. $HTTP_COOKIE_VARS es tambin actualizada en
versiones anteriores de PHP cuando la variable de configuracin track_vars est activada.
Setcookie() define una cookie que es enviada junto con el resto de la informacin de la
cabecera(header).
int setcookie (string Name [, string Value [, int Expire [, string Path [, string
Domain [, int Secure]]]]])

Todos los argumentos excepto el nombre son opcionales.
Name. Nombre de la cookie. Si creamos una cookie solamente con el nombre, en el
cliente se eliminara la cookie que exista con ese nombre. Tambin podemos
reemplazar cualquier argumento con una cadena vaca ("").
Value. Valor que almacenar la cookie en el cliente.
Expire. El argumento expire es un argumento entero que indica la hora en que se
eliminara la cookie en el formato de hora que devuelven las funciones UNIX time() y
mktime(). Normalmente se usa time() + N. segundos de duracin, para especificar la
duracin de una cookie.
Path. Path de URL donde tiene valor la cookie.
Domain. Dominio en donde tiene valor la cookie. Si ponemos como dominio
www.domain.com la cookie no se transmite para domain.com, mientras que si
ponemos domain.com la cookie se transmite tanto para domain.com como para
www.domain.com
Secure. El argumento secure indica que la cookie solo se transmitir a travs de una
conexin segura HTTPS.
Ejemplo:

setcookie("usuario", "juan", time()+3600,"/","pepe.com");
En este ejemplo establecemos una cookie de nombre usuario que contiene el valor juan, que
dura 1 hora (3600 segundos) vlida para todo el dominio pepe.com.
Ejemplo de uso de cookies

55
En este ejemplo vamos a ver como establecer (en forma arbitraria) una cookie y cmo se
recupera el valor establecido. Para ello pediremos al usuario que introduzca su nombre, que
guardaremos en una cookie.
Primero pedimos al usuario que introduzca el valor de su nombre, usamos un formulario que
procesar la pgina procesar_cookie.phtml.
<html>
<head>
<title>Ejemplo de uso de cookie </title>
</head>
<body>
<H1>Ejemplo de uso de cookie</H1>
Introduzca su nombre:
<FORM ACTION="procesar_cookie.phtml" METHOD="GET">
<INPUT TYPE="text" NAME="nombre"><BR>
<INPUT TYPE="submit" VALUE="Enviar">
</FORM>
</body>
</html>
En el siguiente script (procesar_cookie.phtml) que procesa el envo del formulario, se
establece la cookie ejemusuario con el valor introducido anteriormente, y cuya duracin es
una hora.
<?php
setcookie("usuario", $_GET['nombre'], time()+3600,"/","");
?>
<html>
<head>
<title>Ejemplo de uso de cookie</title>
</head>
<body>

Se ha establecido una cookie de nombre <b>usuario</b> con el valor: <b>
<? print $_GET['nombre']; ?></b> que ser vlida durante 1 hora.
</body>
</html>

En este ejemplo veremos lo fcil que es recuperar el valor de la cookie establecida
anteriormente.

56
<html>
<head>
<title>Ejemplo de uso de cookie</title>
</head>
<body>

Se ha establecido la cookie de nombre <b>usuario</b> vale: <b><? print
$_COOKIE['usuario']; ?></b>
</body>
</html>


57
2.7 Sesiones
Bsicamente una sesin comprende el conjunto de la secuencia de pginas que un usuario
visita en un sitio web. Desde que entra en nuestro sitio, hasta que lo abandona.
El trmino sesin en PHP, session en ingls, se aplica a esta secuencia de navegacin, para
ello crearemos un identificador nico que asignamos a cada una de estas sesiones de
navegacin. A este identificador de sesin se le denomina, comnmente, como la
sesin.
El proceso en cualquier lenguaje de programacin podra ser algo as:
Existe una sesin?
Si existe la retomamos
Si no existe creamos una nueva
Generar un identificador nico
Y para que no perdamos el hilo de la navegacin del usuario deberemos asociar esta sesin
a todas las URLs y acciones de formulario. Podemos tambin crear un cookie que incluya el
identificador de sesin, pero es conveniente recordar que la disponibilidad o no de las
cookies depende del usuario, y no es conveniente fiarse de lo que un usuario pueda o no
tener habilitado.
Lo contado hasta ahora es teora pura y es aplicable a cualquier lenguaje de programacin C,
Perl, etc. Los que programamos en PHP4 tenemos la suerte de que toda la gestin de
sesiones la hace el mismo PHP.
Por lo tanto lo comentado a partir de aqu es solo aplicable a PHP4. Si an desarrollas
PHP3, tendrs que crear tus propias libreras de gestin de sesiones o recurrir a alguna de
las existentes, como la de PHPLIB.
Inicializacin de la sesin
Para utilizar sesiones en PHP lo primero es inicializarlas. Podemos hacerlo explcitamente,
mediante la funcin session_start(), o al registrar una variable en una sesin mediante
session_register('variabledesesion'). En ambos casos se crea una nueva sesin, si no
existe, o se retoma la sesin actual. Veamos un sencillo ejemplo:
<?php
session_start();
echo "He inicializado la sesin";
?>

Esta es la forma ms bsica, si el usuario tiene los cookies activados, PHP habr insertado de
forma automtica la sesin y sta ser pasada de una pgina a otra sin hacer nada ms.
Desde un punto de vista prctico la sesin es operativa, pero no vemos nada. Podemos

58
obtener la sesin en cualquier momento mediante la funcin session_id(). Inserta en las
sucesivas pginas la siguiente lnea para ver si la sesin est disponible:
<?php
session_start();
echo 'La sesin actual es: '.session_id();
?>
En este caso session_start() comprueba en los cookies que existe una sesin y continua
con ella, session_id() devuelve el identificador actual.
Ejemplo prctico
Veamos otro ejemplo que, tal vez, te lo aclare un poco ms:
<?php
session_register('contador');
echo '<a href="'.$PHP_SELF.'?'.$SID.'">Contador vale: '.++$_SESSION['contador']. '</a>';
?>
Como dije anteriormente la sesin se crea o recoge mediante session_start(), o tambin
cuando se registra una variable de sesin mediante session_register().
Si no has utilizado nunca las sesiones, el concepto de variable de sesin, puede resultar un
poco abstracto. Bsicamente es una variable, como cualquiera de las que gestiona PHP4,
pero que reside en un espacio especfico en el servidor, junto con el identificador de sesin,
y que pertenece nicamente a un usuario (a la sesin del usuario).
En nuestro ejemplo anterior, registramos la variable $contador en la primera lnea del script.
En la segunda lnea, entre otras cosas, cada vez que recarguemos la pgina o hagamos click
sobre el enlace, el valor de $contador se incrementar en 1.
En esta lnea hacemos uso de la variable reservada $PHP_SELF, que hace referencia al
propio script en ejecucin y una constante propia de PHP4, $SID, que contiene el nombre
de la sesin y el identificador de la misma.
Podemos averiguar tambin el nombre de la sesin, o modificarlo, mediante la funcin
session_name(). Veamos una prueba prctica:
<?php
session_name('misesion');
session_register('contador');
echo '<a href="'.$PHP_SELF.'?'.SID.'">Contador vale:
'.++$_SESSION['contador'].'</a><br>';
echo 'Ahora el nombre es '.session_name().' y la sesin '.$misesion.'<br>';
?>

59
La asignacin del nombre de sesin debe realizarse antes que ninguna otra funcin con
sesiones, antes que session_start() o session_register().
Para ser ms genrico debiera considerarse que al deshabilitar register_globals no puede
usarse los nombres de las variables slo como $variable, sino como $_SESSION[variable].

Error comn
Uno de los errores ms comunes cuando se utilizan sesiones es dejar lneas en blanco antes
de la inicializacin de PHP (o al final de un archivo que se incluye) o enviar alguna salida a la
pantalla. Para probarlo crea una lnea en blanco o con cualquier cosa antes de <?php.
Si tienes los cookies activados, te encontrars un error de este tipo:
Warning: Cannot send session cookie - headers already sent by (output started at
/home/session.php:2) in /home/session.php on line 4
PHP est informando de que no puede activar los cookies en el navegador del usuario,
porque las cabeceras ya han sido enviadas. Simplemente por la existencia de una lnea en
blanco. Como medida prctica, no dejes espacios ni antes del inicio del script, ni despus de
la finalizacin.
Si despus de todo lo comentado an no entiendes para que sirven las sesiones, veamos un
ejemplo prctico. Imagina que quisieras crear un sistema de cesta de la compra...
Carrito de compra
Si despus de todo lo comentado an no entiendes para que sirven las sesiones, veamos un
ejemplo prctico. Imagina que quisieras crear un sistema de cesta de la compra, en su forma
bsica podra ser algo as:
<?php
session_start();
session_register('itemsEnCesta');
$item=$_POST['item'];
$cantidad=$_POST['cantidad'];
$itemsEnCesta=$_SESSION['itemsEnCesta'];

if ($item){
if (!isset($itemsEnCesta)){
$itemsEnCesta[$item]=$cantidad;
}else{
foreach($itemsEnCesta as $k => $v){
if ($item==$k){
$itemsEnCesta[$k]+=$cantidad; //agrega cantidad aitem existente
$encontrado=1;
}
}

60
if (!$encontrado) $itemsEnCesta[$item]=$cantidad; //crea nuevo item con la cantidad
}
}
$_SESSION['itemsEnCesta']=$itemsEnCesta;
?>
<html>
<body>

<form action="<?=$PHP_SELF."?".$SID?>" method="post">
Dime el producto <input type="text" name="item" size="20"><br>
Cuantas unidades <input type="text" name="cantidad" size="20"><br>
<input type="submit" value="Aadir a la cesta"><br>
</form>
<?
if (isset($itemsEnCesta)){
echo'El contenido de la cesta de la compra es:<br>';
foreach($itemsEnCesta as $k => $v){
echo 'Artculo: '.$k.' Unidades: '.$v.'<br>';
}
}
?>

</body>
</html>

Una breve explicacin. comprobamos si el usuario ha pasado algn artculo, desde el
formulario. Si el array itemsEnCesta no existe, lo creamos con el nuevo producto y la
cantidad indicada. Si el array existe recorremos su contenido, y si encontramos un artculo
igual, aadimos la cantidad. Si no lo encontramos, es un nuevo artculo, por lo tanto,
aadimos el nuevo producto con la correspondiente cantidad a itemsEnCesta. Y a
continuacin imprimimos el formulario y los resultados, si los hubiera.
Te imaginas las posibilidades de un sistema de almacenamiento de informacin de estas
caractersticas?. No necesitas manejar archivos, ni bases de datos, ni tienes que andar
pasando valores de una pgina a otra. PHP va gestionando estos datos por nosotros, hasta
el momento en que decidamos almacenar la informacin donde ms nos interese.

61
2.8 Manejo de conexiones
Nota: Todo lo siguiente se aplica a partir de la versin 3.0.7 y posterior.
Internamente en PHP se mantiene el estado de la conexin. Hay 3 posibles estados:
0 - NORMAL
1 - ABORTED (Abortado)
2 - TIMEOUT (Fuera de tiempo)
Cuando un script PHP se est ejecutando se activa el estado NORMAL. Si el cliente remoto se
desconecta, se pasa al estado ABORTED. Esto suele ocurrir cuando el usuario pulsa en el
botn DETENER del navegador. Si se alcanza el lmite de tiempo impuesto por PHP (ver
set_time_limit()), se pasa al estado TIMEOUT.

Puedes decidir si quieres que la desconexin de un cliente cause que tu script sea abortado.
Algunas veces es cmodo que tus scripts se ejecuten por completo, incluso si no existe ya un
navegador remoto que reciba la salida.

El comportamiento por defecto es sin embargo, que tu script se aborte cuando el cliente
remoto se desconecta. Este comportamiento puede ser configurado va la directiva
ignore_user_abort en el archivo php3.ini, o tambin con la funcin
ignore_user_abort().

Si no le espeficicas a PHP que cuando un usuario aborte lo ignore, tu script terminar su
ejecucin. La nica excepcin es si tienes registrada una funcin de desconexin usando la
funcin register_shutdown_function().

Con una funcin de desconexin, cuando un usuario remoto pulsa en el botn DETENER, la
prxima vez que tu script intenta mostrar algo, PHP detecta que la conexin ha sido
abortada y se llama a la funcin de desconexin.

Esta funcin de desconexin tambin se llama al final de la ejecucin de tu script cuando se
ha ejecutado normalmente, de manera que si quieres hacer algo diferente en caso de que un
cliente se haya desconectado, puedes usar la funcin connection_aborted(). Esta funcin
devuelve TRUE si la conexin fue abortada.

El script tambin se puede terminar por un temporizador interno. El timeout por defecto es
de 30 segundos. Se puede cambiar usando la directiva max_execution_time en el archivo
php.ini o la correspondiente directiva php_max_execution_time en la configuracin del
servidor de pginas Apache, como tambin con la funcin set_time_limit().

Cuando el temporizador expira, el script se aborta como en el caso de la desconexin del
cliente, de manera que si se ha definido una funcin de desconexin, esta se llamar. Dentro
de esta funcin de desconexin, puedes comprobar si fue el timeout el que caus que se
llamara a la funcin de desconexin, llamando a la funcin connection_timeout(). Esta
funcin devolver verdadero si el timeout causa que se llame a la funcin de desconexin.


62
Hay que destacar que ambos, el estado ABORTED y el TIMEOUT, se pueden activar al mismo
tiempo. Esto es posible si le dices a PHP que ignore las desconexiones intencionadas de los
usuarios. PHP an notar el hecho de que el usuario puede haberse desconectado, pero el
script continuar ejecutndose. Si se alcanza el tiempo lmite de ejecucin ser abortado y, si
se ha definido una funcin de desconexin, esta ser llamada. En este punto, encontrars
que las funciones connection_timeout() y connection_aborted() devuelven verdadero.

Puedes comprobar ambos estados de una manera simple usando la funcin
connection_status(). Esta funcin devuelve un campo de bit de los estados activos. De
este modo, si ambos estados estn activos devolvera por ejemplo un valor 3.
Conexiones persistentes a bases de datos
Las conexiones persistentes son enlaces SQL que no se cierran cuando termina la ejecucin
del archivo de comandos.

Cuando se pide una conexin persistente, PHP comprueba si hay ya una conexin
persistente idntica (que permaneca abierta desde antes) - y si existe, la usa. Si no existe,
crea un enlace. Una conexin 'idntica' es una conexin que se abri hacia el mismo "host",
con el mismo nombre de usuario y la misma contrasea (donde sea aplicable).
Nota: Existen otras extensines que proporcionan conexiones persistentes, tal
como la extensin IMAP.
La gente que no est familiarizada con el modo como trabajan y distribuyen la carga los
servidores "web" puede confundir que significa conexiones persistentes. En particular, no te
dan la habilidad de abrir 'sesiones de usuario' en el mismo enlace SQL, no dan la habilidad
de construir una transaccin de forma eficiente, y no hacen un montn de otras cosas. De
hecho, para ser extremadamente claros sobre el tema las conexiones persistentes no te dan
ninguna functionalidad que no fuera posible con sus hermanas no-persistentes.

Esto tiene que ver con el modo como funcionan los servidores "web". Hay tres modos en que
un servidor "web" puede utilizar PHP para generar pginas web.

El primer mtodo es usar PHP como una capa CGI. Cuando corre de este modo, se crea y
destruye una instancia del intrprete PHP por cada pgina solicitada (para una pgina PHP) a
tu servidor. Debido a que se destruye despus de cada peticin, cualquier recurso que
adquiera (como un enlace a un servidor de base de datos SQL) se cierra cuando es
destruido. En este caso, no se gana nada si se intentan usar conexiones persistentes, ya que
simplemente no persisten.

El segundo, y ms popular, mtodo es correr PHP como un mdulo en un servidor web
multiproceso, lo cual actualmente slo incluye Apache. Un servidor multiproceso tiene
tpicamente un proceso (el padre) que coordina un conjunto de procesos (sus hijos) que
realmente hacen el trabajo se servir las pginas web. Cuando entra cada peticin de un
cliente, es entregada a uno de los hijos que no est ya sirviendo a otro cliente. Esto significa
que cuando el mismo cliente hace una segunda petcin al servidor, puede ser atendido por
un proceso hijo distinto del de la primera vez. Lo que una conexin persistente hace por ti en

63
este caso es hacerlo de tal modo que cada proceso hijo slo necesita conectar a tu SQL
server la primera vez que sirve una pgina que hace uso de una conexin as. Cuando otra
pgina solicita una conexin a SQL server, puede reutilizar la conexin que el hijo estableci
previamente.

El ltimo mtodo es usar PHP como un "plug-in" para un servidor web multihilo. Actualmente
PHP 4 soporta ISAPI, WSAPI y NSAPI (en Windows), lo cual permite a PHP ser utilizado
como "plug-in" para servidores web multihilo como Netscape FastTrack, Internet Information
Server (IIS) de Microsoft, y O'Reilly's WebSite Pro.

El comportamiento es exactamente el mismo que para el modelo de multiproceso descrito
anteriormente. Tener en cuanta que el soporte para SAPI no est disponible en PHP 3.

Si las conexiones persistentes no aportan ninguna funcionalidad aadida, para qu son
buenas?

La respuesta aqui es extremadamente simple -- eficiencia. Las conexiones persistentes son
atractivas cuando las cabeceras de control para crear un enlace a tu servidor SQL es
compleja. Que estas cabeceras sean o no realmente complejas depende de muchos factores.
Como, qu clase de base de datos es, si esta o no situada en el mismo computador que el
servidor web, cmo est de cargada la mquina donde se encuentre el servidor SQL, y otras
as.

El hecho fundamental es que si la cabecera de conexin es compleja, las conexiones
persistentes te ayudan considerablemente . Ellas hacen que el proceso hijo simplemente
conecte solamente una vez durante todo su intervalo de vida, en vez de cada vez que
procesa una pagina que requiere conectar al servidor SQL.

Esto significa que por cada hijo que abri una conexin persistente tendr su propia
conexin persistente al servidor. Por ejemplo, si tienes 20 procesos hijos distintos que corran
un archivo de comandos que cree una conexin persistente a tu servidor SQL, tendras 20
conexiones diferentes a ti servidor SQL, una por cada hijo.

No obstante, hay que tener en cuenta que esto puede tener desventajas si se est utilizando
una base de datos con lmites de conexin, por debajo del numero de procesos hijo con
conexiones persistentes.

Si tu base de datos tiene un lmite de 16 conexiones simultaneas y en el curso de una sesin
de servidor, 17 procesos hijo intentan conectarse, uno de ellos no podr hacerlo. Si existen
errores en los scripts, que no permitan terminar la conexion (p.ej.bucles infinitos), una base
de datos con solo 32 conexiones puede ser rpidamente hundida.
Comprobar la documentacion de la base de datos para obtener informacin sobre que hacer
con conexiones abandonadas libres.

Aviso
Un par de advertencias ms a tener en cuenta cuando utilicen conexiones persistentes.

64
La primera: si utilizan bloqueos en una tabla desde una conexin persistente y por
cualquier causa el script no puede desbloquear la tabla, todos los scripts posteriores
que usen esta conexin, quedarn bloqueados indefindamente y se requerir que,
bien el servidor httpd la base de datos sean arrancados de nuevo.
La segunda: cuando se usan transacciones, un bloqueo por transaccin ser
heredado por el prximo script usando la conexin, si la ejecucin del primer script
termina antes que el bloqueo. En ambos caso se puede utilizar
register_shutdown_function() para registrar una funcion simple de limpieza que
desbloquee las tablas deshaga la transaccin.
Lo mejor para evitar problemas es no usar conexiones persistentes en scripts que usen
bloqueos de tablas transacciones (para todo lo dems pueden ser usadas sin problemas).

Un resumen importante. Las conexiones persistentes fueron diseadas para tener una
equivalencia uno-a-uno con las conexiones normales. Eso significa que deberais siempre ser
capaz de reemplazar las conexiones persistentes por conexiones no persistentes y no
cambiar, el modo como se comporta el archivo de comandos. Puede cambiar la eficiencia
del archivo de comandos (y probablemete lo har), pero no su comportamiento!

65
2.9 Modo Seguro (Safe Mode)
El Modo Seguro de PHP es un intento para resolver el problema de la seguridad en un
servidor compartido. Tratar de resolver este problema al nivel de PHP es
arquitectnicamente incorrecto, pero ya que las alternativas en un servidor web y a niveles
de sistemas operativos no son tan realistas, mucha gente, especialmente la de proveedores
de Internet (ISP), usa el Modo Seguro por ahora.

Las directivas de Configuracin que controlan el Modo Seguro son:

Directiva Valor por defecto
safe_mode Off
safe_mode_gid 0
safe_mode_include_dir ""
safe_mode_exec_dir 1
open_basedir ""
safe_mode_allowed_env_vars PHP_
safe_mode_protected_env_vars LD_LIBRARY_PATH
disable_functions ""

Cuando safe_mode est en On, el PHP verifica si el dueo del script actual coincide con el
dueo del archivo a ser operado por una funcin de archivo. Por ejemplo:

-rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php
-rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd

Corriendo este script.php

<?php
readfile('/etc/passwd');
?>

resulta en este error cuando Modo Seguro est habilitado:

Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not
allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2

Sin embargo, pueden haber ambientes donde una estricta verificacin del UID no es
apropiada, y una relajada verificacin del GID es suficiente. Esto es soportado por medio del
switch safe_mode_gid. Setendolo a On hace la verificacin relajada GID, setendolo a Off
(el valor por omisin) hace la verificacin del UID.

66

Si en vez del safe_mode, se setea un directorio open_basedir, entonces todas las
operaciones de archivo estarn limitadas a los archivos bajo ese directorio especificado. Por
ejemplo (ejemplo de httpd.conf de Apache):

<Directory /docroot>
php_admin_value open_basedir /docroot
</Directory>

Si ejecutamos el mismo script.php con este seteo open_basedir, entonces este es el
resultado:

Warning: open_basedir restriction in effect. File is in wrong directory in
/docroot/script.php on line 2

Tambin podemos inhabilitar funciones individuales. Note que la directiva
disable_functions no puede ser usada fuera del archivo php.ini lo que significa que no
podemos inhabilitar funciones en per-virtualhost o per-directory, en el archivo httpd.conf. Si
agregamos esto a nuestro archivo php.ini:

disable_functions readfile,system

Entonces obtenemos esta salida:

Warning: readfile() has been disabled for security reasons in
/docroot/script.php on line 2
Funciones restringidas/inhabilitadas por Modo Seguro
Esta es una lista probablemente incompleta y posiblemente incorrecta de las funciones
limitadas por safe mode.

Funciones limitadas por Modo Seguro

Funcin Limitaciones
dbmopen()
Nota: Cuando safe-mode (modo-
seguro) est activado, PHP
comprueba si el archivo(s)/directorios
que vas a utilizar, tienen la misma
UID que el script que est siendo
ejecutado.
dbase_open()

67
Funcin Limitaciones
ejecutado.
filepro()
ejecutado.
filepro_rowcount()
ejecutado.
filepro_retrieve()
ejecutado.
ifx_*() restricciones sql_safe_mode, (!= safe mode)
ingres_*() restricciones sql_safe_mode, (!= safe mode)
mysql_*() restricciones sql_safe_mode, (!= safe mode)
pg_loimport()
ejecutado.
posix_mkfifo()
comprueba si los directorios que vas
a utilizar, tienen la misma UID que el
script que est siendo ejecutado.
putenv()
Obecede las ini-directivas
safe_mode_protected_env_vars y
safe_mode_allowed_env_vars. Vea
tambin la documentacin de
putenv()
move_uploaded_file()

68
Funcin Limitaciones
ejecutado.
chdir()
dl()
Esta funcin no est activada en
safe-mode (modo-seguro)
backtick operator
shell_exec() (equivalencia funcional de
backticks)
exec()
Ud. puede correr slo ejecutables
dentro delsafe_mode_exec_dir. Por
razones prcticas, no est
actualmente permitido tener
componentes .. en la ruta del archivo
ejecutable.
system()
Ud. puede correr slo ejecutatables
ejecutable.
passthru()
ejecutable.
popen()
ejecutable.
mkdir()

69
Funcin Limitaciones
rmdir()
comprueba si el
archivo(s)/directorios que vas a
utilizar, tienen la misma UID que el
rename()
comprueba si el
unlink()
comprueba si el
copy()
comprueba si el
chgrp()
comprueba si el
chown()
comprueba si el

70
Funcin Limitaciones
chmod()
comprueba si el
Adems, Ud. no puede setear los bits
de SUID, SGID y sticky
touch()
comprueba si el
symlink()
(Nota: slo el target es comprobado)
link()
comprueba si el
(Nota: slo the target es
comprobado)
getallheaders()
En Modo Seguro, las cabeceras que
empiezan con 'authorization'
(insensitivo al tipo de letra) no sern
retornadas. Advertencia: esto est
roto por la implementacin de aol-
server de getallheaders()!
header()
En Modo Seguro, el UID del script
est agregado a la parte realm de la
cabecera WWW-Authenticate si Ud.
setea esta cabecera (usado por

71
Funcin Limitaciones
HTTP Authentication).
highlight_file(), show_source()
comprueba si el
(Nota: slo afectado desde PHP
4.2.1)
parse_ini_file()
(Nota: slo afectado desde PHP
4.2.1)

Modulo2 - Estructuras Del Lenguaje PHP

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Modulo2 - Estructuras Del Lenguaje PHP

Caricato da

Copyright:

Formati disponibili

rea Tecnolgica de Educacin Virtual UTN FRC SEU

PHP, MySQL y E-Commerce Estructuras del lenguaje

Potrebbero piacerti anche