UNIVERSIDAD DON BOSCO

DEPARTAMENTO DE INFORMÁTICA

“Funciones en PHP”

INSTRUCTOR: Ricardo Ernesto Elías Guandique

CARRERA: TECNICO EN INGENERIA EN COMPUTACION – 4º PILET

N° Apellidos Nombres

1 Merino Hernández Erick Noé

2 Orantes Cardoza Irvin Elenilson

3 Cornejo Castillo Christofer Alexander

NOTA:

OBSERVACIONES:

San Salvador, 10 de Febrero del 2014

Contenido INTRODUCCION ....................................................................................................................................................... 1

Funciones en PHP .................................................................................................................................................... 2

Función Mail ....................................................................................................................................................... 2

Función Pow ....................................................................................................................................................... 3

Función sqrt ........................................................................................................................................................ 3

Función round ..................................................................................................................................................... 4

Función ctype_alnum ......................................................................................................................................... 5

Función finfo_file ................................................................................................................................................ 6

Función getdate .................................................................................................................................................. 7

Funcion sort ........................................................................................................................................................ 9

Funcion in_array ............................................................................................................................................... 10

Funcion array_diff ............................................................................................................................................. 11

Funcion Header ................................................................................................................................................. 11

Función cal_days_in_month ............................................................................................................................. 12

Función dbase_create....................................................................................................................................... 13

Funcion exit ...................................................................................................................................................... 14

Función exp ....................................................................................................................................................... 15

Función explode................................................................................................................................................ 15

Funcion floor ..................................................................................................................................................... 16

Funcion fopen ................................................................................................................................................... 16

Funcion getimagesize ....................................................................................................................................... 17

Funcion getlastmod .......................................................................................................................................... 18

Funcion debug_backtrace................................................................................................................................. 19

Funcion error_reporting ................................................................................................................................... 20

Funcion app_add .............................................................................................................................................. 21

Funcion error_get_last ..................................................................................................................................... 22

Funcion apc_store ............................................................................................................................................ 23

Funcion apd_callstack ....................................................................................................................................... 24

Funcion set_exception_handler ....................................................................................................................... 24

Funcion restore_exception_handler ................................................................................................................ 25

Funcion apc_fetch ............................................................................................................................................ 25

Funcion apc_delete_file ................................................................................................................................... 26

Conclusión ............................................................................................................................................................. 28

1

INTRODUCCION

En el presente documento, se muestran algunas de las principales funciones que PHP presenta al

programador para que pueda hacer un buen uso de ellas y por lo tanto brindar al usuario final un

trabajo más rápido y sencillo de utilizar.

Para mostrar las funciones más eficientes que el lenguaje puede brindar, se hizo uso de la

investigación ex aula, visitando la página principal de PHP, se puede ver la inmensa cantidad de

funciones que el lenguaje posee, además que la mayoría de ellas incluso se dividen en más funciones

a la vez.

Con el objetivo de poder demostrar claramente cada una de ellas, se presenta la siguiente

información de cada una de ellas:

Sintaxis: Se muestra la sintaxis básica de la función que se presenta.

Definición: Una breve definición de la función brinda una idea clara del uso y funcionamiento

de esta.

Parámetros: Los parámetros necesarios para que todas las funciones trabajen de la manera

adecuada, en el caso de que no lo necesiten, se aclarará en cada una de ellas.

Valor devuelto: Se especifica el valor que la función retornara en el caso que lo necesite,

además de especificar el tipo de este.

Ejemplo: Un ejemplo básico de la función presentada, ayudara a comprender mejor el uso y

la sintaxis de esta en una situación necesaria.

La realización de este documento, fomentara en el programador el uso de las funciones para que las

aplicaciones que este desarrolle, se ejecuten de la manera más clara, fácil y rápida posible.

2

Funciones en PHP

Función Mail

Sintaxis

Bool mail ( string $to , string $subject ,string $message [, string $additional_headers] )

Descripción

Enviar un correo electrónico

Parámetros

to

Dirección e-mail a la que se va enviar el correo electrónico. Debe cumplir con el estándar

RFC2822.

subject

Representa el asunto del correo electrónico a enviar.

message

Mensaje a enviar al destinatario especificado. No debe ser mayor a 70 caracteres. Cada línea

debe ser separa con CRLF(\r\n).

additional_headers (opcional)

Cadena que es insertada al final del encabezado del e-mail.

Valor de retorno

La función mail devuelve verdadero (true) si el e-mail fue aceptado para su envió y falso (false) en

caso contrario.

Ejemplo

3

Función Pow

Sintaxis

number pow ( number $base , number $exp )

Devuelve una base elevada a una potencia.

Parámetros

base

La base a ser usada

exp

El exponente

Valor de retorno

Devuelve la base elevada a una potencia. Si los dos argumentos son enteros positivos como resultado

brinda un entero en otro caso retorna un dato de tipo float.

Ejemplo

Función sqrt

Sintaxis

float sqrt ( float $arg )

Descripción

Calcula la raíz cuadrada de un número.

Parámetros

4

arg

El argumento a procesar

Valor de retorno

La raíz cuadrada del argumento enviado. En caso de haber ingresado un valor negativo la función

retornara NAN.

Ejemplo

Función round

Sintaxis

float round ( float $val [, int $precision = 0 [, int $mode = PHP_ROUND_HALF_UP ]] )

Descripción

Redondea números decimales con una determinada precisión (cifras después del punto decimal). El

valor de precisión por default es 0.

Valor de retorno

El valor redondeado

Parámetros

val

El valor a redondear

precision

Opcionalmente, el número de dígitos decimales a redondear.

mode Utilice las siguientes constantes para determinar el modo de redondeo:

5

PHP_ROUND_HALF_UP: aproxima a la cantidad siguiente cuando se tiene más de la mitad.

PHP_ROUND_HALF_DOWN: redondea hacia la cantidad anterior cuando esta antes de la

mitad.

PHP_ROUND_HALF_EVEN: redondea hacia un valor siguiente.

PHP_ROUND_HALF_ODD: redondea hacia un valor anterior.

Ejemplo

Función ctype_alnum

Sintaxis

bool ctype_alnum ( string $text )

Descripción

Verifica si todos los caracteres de la cadena ingresada son alfanuméricos.

Parámetros

text

La cadena de prueba.

Valores de retorno

Devuelve verdadero (true) si cada carácter de la cadena de prueba es una letra o un digito de lo

contrario retornara falso (false)

Ejemplo

6

Función finfo_file

Sintaxis

string finfo_file ( resource $finfo , string $file_name = NULL [,

int $options = FILEINFO_NONE ] )

Descripción

Devuelve información de un archivo

Parámetros

finfo

Devuelve recurso Fileinfo por finfo_open().

file_name

Nombre del fichero a ser comprobado.

options

Una de las constantes de Fileinfo

FILEINFO_NONE (entero)

No special handling.

FILEINFO_SYMLINK (entero)

Seguir enlaces simbólicos.

FILEINFO_MIME_TYPE (entero)

Devuelve el tipo mime. Disponible desde PHP 5.3.0.

FILEINFO_MIME_ENCODING (entero)

context

Para una descripción de contexts, dirígase a Funciones de Flujos.

7

Valor de retorno

Devuelve una descripción de texto del contenido del argumento filename, o FALSE en caso de error.

Ejemplo

Función getdate

Sintaxis

array getdate ([ int $timestamp = time() ] )

Descripción

Devuelve un arreglo asociativo que contiene la información de la fecha de timestamp, o el

momento actual si no se da timestamp.

Parámetros

timestamp

El parámetro opcional timestamp es una marca de tiempo Unix de tipo integer que por

defecto es la hora local si no se proporciona ningún valor a timestamp.

Valor de retorno

Devuelve un arreglo asociativo con información relacionada con la marca de tiempo timestamp. Los

elementos devueltos de la matriz asociativa son los siguientes:

Clave Descripción Ejemplo de valores devueltos

"seconds" Representación numérica de los segundos 0 a 59

8

"minutes" Representación numérica de los minutos 0 a 59

"hours" Representación numérica de las horas 0 a 23

"mday" Representación numérica del día del mes 1 a 31

"wday" Representación numérica del día de la

semana

0 (para Domingo) hasta 6 (para Sábado)

"mon" Representación numérica de un mes 1 hasta 12

"year" Una representación numérica completa de

una año, 4 dígitos

Ejemplos: 1999 o 2003

"yday" Representación numérica del día del año 0 hasta 365

"weekday" Una representación textual completa del

día de la semana

Sunday hasta Saturday

"month" Una representación textual completa de un

mes, como January o March

January hasta December

0 Los segundos desde la Época Unix, similar

a los valores devueltos por time() y usados

por date().

Dependiente del Sistema, típicamente -

2147483648 hasta2147483647.

Ejemplo

9

Funcion sort

Sintaxis

bool sort ( array &$array [, int $sort_flags = SORT_REGULAR ] )

Descripción

Toma un valor arreglo y devuelve un nuevo arreglo con el orden de los elementos invertido.

Parámetros

array

El array de entrada.

sort_flags

El segundo parámetro opcional sort_flags puede ser usado para modificar el modo de

ordenación usando estos valores:

Tipos de ordenación:

o SORT_REGULAR - compara elementos normalmente (no cambia los tipos)

o SORT_NUMERIC - compara elementos de forma numérica

o SORT_STRING - compara elementos como cadenas

o SORT_LOCALE_STRING - compara elementos como cadenas, basándose en la

configuración regional en uso. Utiliza la configuración regional, la cual puede

cambiarse usando setlocale().

o SORT_NATURAL - compara elementos como cadenas usando el "orden natural" de la

misma forma quenatsort().

o SORT_FLAG_CASE - se puede combinar (OR a nivel de bits)

con SORT_STRING o SORT_NATURAL para ordenar cadenas de forma insensible a

mayúsculas/minúsculas.

10

Valor de retorno

Devuelve verdadero (TRUE) en caso de éxito o falso (FALSE) en caso de error.

Ejemplo

Funcion in_array

Sintaxis

bool in_array ( mixed $needle , array $haystack [, bool $strict = FAL

SE ] )

Descripción

Compara si un valor existe en un arreglo usando comparación flexible.

Parámetros

Needle

El valor a buscar.

Haystack

El arreglo

strict (opcional)

Si este parámetro se define como verdadero (TRUE) también comprobará los tipos de la

needle en el haystack.

Valores de retorno

Devuelve verdadero (TRUE) si la needle se encuentra en el arreglo, de lo contrario retornara falso

(FALSE).

Ejemplo

11

Funcion array_diff

Sintaxis

array array_diff ( array $array1 , array $array2 [, array $... ] )

Descripción

Su función es comparar dos o más arreglos y devolver la diferencia entre estos.

Parámetros

$array1 Arreglo a comparar

$array2 Un arreglo contra el cual comparar

… Mas arreglos contra los cuales comparas

Valores de retorno

Retorna un arreglo conteniendo todas las entradas del array1 que no están presentes en ninguna de

las otras matrices.

Ejemplo

Funcion Header

Sintaxis

12

void header (string $string [,bool $replace =

true [,int $http_response_code ]] )

Descripción

header() es usado para enviar encabezados HTTP sin formato.

Parámetros

string

El encabezado en formato cadena.

replace

El parámetro opcional replace indica cuando el encabezado debe reemplazar un encabezado

previo similar o añadir un segundo encabezado del mismo tipo.

http_response_code

Fuerza el código de respuesta HTTP a un valor específico. Observe que este parámetro

solamente tiene efecto sistring no está vacío.

Valores de retorno

No devuelve ningún valor.

Ejemplo

Función cal_days_in_month

Sintaxis

int cal_days_in_month ( int $calendar , int $month , int $year )

Descripción

13

Esta función devolverá el número de días del mes month del año year para el

calendario calendar especificado.

Parámetros

Calendar El calendario que se va a usar para el cálculo

Month El mes del calendario seleccionado

Year El año del calendario seleccionado

Valores devueltos

La duración en días del mes seleccionado en el calendario dado.

Ejemplos

Función dbase_create

Sintaxis

int dbase_create ( string $filename , array $fields )

Descripción

dbase_create() crea una base de datos dBase con la definición dada.

Parámetros

filename

El nombre de la base de datos. Puede ser una ruta relativa o absoluta al archivo donde dBase

almacenará la información.

fields

Una matriz de matrices, donde cada matriz describe el formato de un campo de la base de

datos. Cada campo consiste en un nombre, un carácter que indica el tipo de campo y,

opcionalmente, una longitud y una precisión.

Valores devueltos

Devuelve un identificador de enlace de la base de datos si la base de datos se creó con éxito,

o FALSE si ocurrió un error.

14

Funcion exit

Sintaxis

void exit ([ string $status ] )

Descripción

Finaliza la ejecución del script. Funciones shutdown y Objectos destructores siempre serán

ejecutados incluso si se llama a la función exit.

exites una construcción de lenguaje y puede ser llamada sin paréntesis si no se le pasa status s.

Parámetros

status

Si status es una cadena, esta función imprime el status justo antes de salir.

Si status es un valor integer, ese valor será usado también como el status de salida y no se

mostrará.

Valores devueltos

No devuelve ningún valor.

Ejemplos

15

Función exp

Sintaxis

float exp ( float $arg )

Descripción

Devuelve e elevado a la potencia de arg.

Parámetros

arg El argumento a procesar

Valores devueltos

‘e’ elevado a la potencia arg

Ejemplo

Función explode

Sintaxis

array explode ( string $delimiter , string $string [, int $limit ] )

Descripción

Devuelve un array de cadenas, siendo cada una de ellas una subcadena del parámetro

string formado por la división según los delimitadores indicados en el parámetro delimiter.

Parámetros

delimiter

La cadena delimitadora.

string

La cadena de entrada.

limit

Si el parámetro limit es positivo, el array devuelto contendrá el máximo de elementos en

el limit y el último elemento contendrá el resto del string.

Si el parámetro limit es negativo, se devolverán todos los componentes a excepción el último

- limit.

16

Si el parámetro limit es cero, actuará como si su valor fuera 1.

Valores devueltos

Devuelve un array de cadenas creadas por la división del parámetro string usando los limitadores

indicados en el parámetro delimiter.

Ejemplo

Funcion floor

Sintaxis

float floor ( float $value )

Description

Devuelve el máximo de los enteros menores o iguales, redondeando valor si es necesario.

Parámetros

value El valor a redondear

Valores devueltos

value redondeado al anterior entero más bajo.

Ejemplos

Funcion fopen

Sintaxis

17

resource fopen ( string $filename , string $mode [, bool$use_include_path =

false [, resource $context ]] )

Descripción

fopen() asocia un recurso con nombre, especificado por filename, a un flujo.

Parámetros

Filename

La ubicación del fichero que deseamos abrir.

mode

El parámetro mode especifica el tipo de acceso que se necesita para el flujo. Existen 10 de ellos.

use_include_path

El tercer parámetro opcional use_include_path puede ser establecido a '1' o TRUE si se

desea buscar un fichero en use_include_path también.

Context

Sin descripción.

Valores devueltos

Devuelve un recurso de puntero a fichero si tiene éxito, o FALSE si se produjo un error.

Ejemplo

Funcion getimagesize

Sintaxis

array getimagesize ( string $filename [, array &$imageinfo ] )

Descripcion

La función getimagesize() determinará el tamaño de un archivo de imagen dado y devolverá las

dimensiones junto con el tipo de archivo y una cadena de texto con el alto/ancho para ser usada

dentro una etiqueta IMG de HTML normal y el tipo de contenido HTTP correspondiente.

18

Parámetros

filename

Este parámetro especifica el archivo del que se quiere recuperar información. Puede

referenciar a un archivo local o (si la configuración lo permite) a un archivo remoto usando

uno de los flujos soportados.

imageinfo

Este parámetro opcional permite extraer alguna información ampliada del archivo de

imagen.

Valores devueltos

Devolverá el tipo de imagen, la altura y el ancho de esta

Funcion getlastmod

Sintaxis

int getlastmod ( void )

Descripción

Obtiene la hora de la última modificación del script principal de la ejecución.

Valores devueltos

Devuelve la hora de la última modificación de la página actual. El valor devuelto es una marca de

tiempo Unix, apropiada para ser pasada a date(). Devuelve FALSE en caso de fallo.

Parámetros

No necesita

Ejemplo

19

Funcion debug_backtrace

Sintaxis

array debug_backtrace ([ int $options =

DEBUG_BACKTRACE_PROVIDE_OBJECT [, int $limit = 0 ]] )

Esta función genera un rastreo de PHP.

Parámetros

options

Desde 5.3.6, este parámetro es una mascara de bits para las siguientes opciones:

debug_backtrace() options

DEBUG_BACKTRACE_PROVIDE_OBJECT Completar el índice "object" o no.

DEBUG_BACKTRACE_IGNORE_ARGS Omitir el índice "args" y por lo tanto todos los

argumentos de las funciones/métodos para

ahorrar memoria o no.

Antes de 5.3.6, el único valor reconocido es TRUE o FALSE, que es lo mismo que establecer y

desestablecer la opción DEBUG_BACKTRACE_PROVIDE_OBJECT.

limit

Desde 5.4.0, este parámetro puede ser usado para limitar el número de stack frames que se

muestran. Por defecto (limit=0) imprime todos los stack frames.

Valores devueltos

Devuelve un array de array asociativos. Los posibles elementos devueltos son los

siguientes:

Posibles elementos devueltos por debug_backtrace()

Nombre Tipo Descripción

function string El nombre de la función actual. Véase también __FUNCTION__.

20

line integer El número de línea actual. Véase también __LINE__.

file string El nombre de archivo actual. Véase también __FILE__.

class string El nombre de la clase actual. Véase también __CLASS__

object object El objeto actual.

type string El tipo de llamada actual. Si es una llamada a un método devuelve "-

>". Si es una llamada a un método estático devuelve "::". Si es una

llamada a una función no se devuelve nada.

args array Dentro de una función se lista los argumentos de la función. Dentro de

un archvo incluido se lista el nombre (o nombres) del archivo incluido.

Ejemplo

Funcion error_reporting

Sintaxis

int error_reporting ([ int $level ] )

Establece cuáles errores de PHP son notificados. PHP tiene varios niveles de errores para notificar, al

utilizar ésta función se define el nivel de duración (tiempo de ejecución) de sus scripts. Si el

parámetro opcional level no se define, la función error_reporting() sólo devolverá el nivel actual de

notificación de error.

Parámetros

level

El nuevo nivel de error_reporting. Este nivel toma una máscara de bit o constantes

nominadas. Según se añaden niveles de error, el rango de los enteros incrementa, por lo que

21

los niveles antiguos de errores basados en enteros no siempre se comportarán como se

esperaba.

Valores devueltos

Devuelve el nivel antiguo de error_reporting o el nivel actual si el parámetro level no se proporciona.

Ejemplo

Funcion app_add

Sintaxis

bool apc_add ( string $key , mixed $var [, int $ttl = 0 ] )

array apc_add ( array $values [, mixed $unused = NULL [, int $ttl = 0 ]] )

Pone una variable en caché en el almacén de datos, sólo si no está ya almacenada.

Parámetros

key

Almacena la variable usando este nombre. Las claves (keys) son únicas en la caché, por lo

que intentar usar apc_add() para almacenar información con una clave que ya existe no

sobrescribirá la información existente, en su lugar devolverá FALSE. (Esta es la única

diferencia entre apc_add() y apc_store().)

var

La variable a almacenar

22

ttl

Time To Live (Tiempo de Vida); almacena var en la caché durante ttl segundos. Después de

que pase ttl, la variable almacenada será expurgada de la caché (en la siguiente solicitud). Si

no se proporciona ttl (o si ttl es0), el valor persistirá hasta que sea eliminado de la caché

manualmente, o si no dejará de existir (al limpiar, reiniciar, etc.).

values

Nombres en clave, variables en valor.

Valores devueltos

Devuelve TRUE si realmente se ha añadido algo a la caché, de lo contrario devuelve FALSE. La

segunda sintaxis devuelve un array con las claves de errores.

Ejemplo

Funcion error_get_last

Sintaxis

array error_get_last ( void )

Obtiene información sobre el último error que ocurrió.

Parámetros

No requiere.

Valores devueltos

Devuelve una matriz asociativa describiendo el último error con las claves "type" (tipo), "message"

(mensaje), "file" (archivo) y "line" (línea). Si el error ha sido causado por una función interna de PHP,

el "message" (mensaje) comienza con su nombre. Devuelve NULL si no ha habido aún un error.

Ejemplo

23

Funcion apc_store

Sintaxis

bool apc_store ( string $key , mixed $var [, int $ttl = 0 ] )

array apc_store ( array $values [, mixed $unused = NULL [, int $ttl = 0 ]] )

Guarda una variable en caché en el almacén de datos.

Parámetros

key

Almacena la variable usando este nombre. Las claves (keys) son únicas en la caché, por lo que

almacenar un segundo valor con la misma clave dada por key sobrescribirá el valor original.

var

La variable a almacenar

ttl

Time To Live (Tiempo de Vida); almacena var en la caché durante ttl segundos. Después de

que pase ttl, la variable almacenada será expurgada de la caché (en la siguiente solicitud). Si

no se proporciona ttl (o si ttl es0), el valor persistirá hasta que sea eliminado de la caché

manualmente, o si no dejará de existir (al limpiar, reiniciar, etc.).

values

Nombres en clave, variables en valor.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error. La segunda sintaxis devuelve un array con

claves de errores.

Ejemplo

24

Funcion apd_callstack

Sintaxis

array apd_callstack ( void )

Retorna la actual pila de llamado como una matriz.

Parámetros

No requiere.

Valores devueltos

Una matriz que contiene la actual pila de llamado.

Funcion set_exception_handler

Sintaxis

callable set_exception_handler ( callable $exception_handler )

Establece el gestor de excepciones predeterminado si una excepción no es capturada dentro de un

bloque try/catch. La ejecución se detendrá después de la llamada a exception_handler.

Parámetros

exception_handler

Nombre de la función a llamar cuando ocurra una excepción no capturada. Esta función debe

ser definida antes de llamar a set_exception_handler(). Esta función de gestión necesita

aceptar un parámetro, que será el objeto de excepción que fue lanzado.

void handler ( Exception $ex )

Valores devueltos

Devuelve el nombre del gestor de excepciones definido anteriormente, o NULL en caso de error. Si

no se definió un gestor anterior también devolverá NULL.

Ejemplo

25

Funcion restore_exception_handler

Sintaxis

bool restore_exception_handler ( void )

Usada después de cambiar la función de gestión de excepciones al utilizar set_exception_handler(),

para volver al gestor de excepciones anterior (el cuál puede ser la función interna o una definida por

el usuario).

Parámetros

No requiere

Valores Devueltos

Esta función siempre devuelve TRUE.

Funcion apc_fetch

Sintaxis

mixed apc_fetch ( mixed $key [, bool &$success ] )

26

Trae una variable almacenada desde la caché.

Parámetros

key

La clave dada por key usada para almacenar el valor (con apc_store()). Si se pasa un array

cada elemento es traído y devuelto.

success

Se establece a TRUE para éxito y FALSE en caso de error.

Valores devueltos

La variable almacenada o una matriz de variables en caso de éxito, FALSE en caso de error.

Funcion apc_delete_file

Sintaxis

mixed apc_delete_file ( mixed $keys )

Borra los archivos dados de la caché del código de operación.

Parámetros

keys

Los archivos a ser borrados. Acepta un string, un array de strings, o un object APCIterator.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error. O si keys es un array, se devuelve un array

vacío en caso de éxito, o se devuelve un array con los archivos fallidos.

27

28

Conclusión

Tras la finalización de este trabajo se puede concluir que PHP brinda al programador un conjunto

de funciones que simplifican en gran manera la codificación por parte del programador en el

desarrollo de una aplicación web que trabaje con PHP del lado del servidor. Esto complementado

con un buen uso de los lenguajes de programación del lado del cliente, como por ejemplo

JavaScript, permiten tener una amplia gama de opciones para innovar en el desarrollo de

aplicaciones web.

El programador web del siglo XI posee la tarea de innovar en su entorno de desarrollo. Siendo

capaz de implementar todas las herramientas con las que dispone, la clave está en actualizarse

constantemente documentándose y aplicando las nuevas tecnologías.