Upload
irvin-orantes
View
106
Download
0
Embed Size (px)
Citation preview
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.