Tutorial de PHP y MySQL - Funciones PHP de acceso a MySQL (I)

En esta leccion vamos a ver todas la funciones que provee PHP para el manejo de bases de datos MySQL. Los ejemplos del manejo de las funciones, los veremos a lo largo del curso.

mysql_affected_rows

int mysql_affected_rows(int [link_identifier] );

mysql_affected_rows devuelve el número de filas afectado en el último SELECT, UPDATE o DELETE pregunta en el servidor asociado con el identificador de conexión especificado. Si no se e especifica un identificador de conexión, se asume le de la última conexión abierta.

Este orden no es eficaz para las instrucciones SELECT, sólo en instrucciones que modifican archivos. Para recuperar el número de filas vuelto de un SELECT, usa mysql_num_rows.

---

mysql_close

int mysql_close(int [link_identifier] );

Devuelve: TRUE si se ha cerrado correctamente, FALSE en caso de errror.

mysql_close closes la conexión a la base de datos MySQL asociada al idenficador de conexión especificado. Si no se e especifica un identificador de conexión, se asume le de la última conexión abierta.

Note que esta función no es normalmente necesaria en conexiones no-persistentes (abiertas con mysl_connect) ya que ést se cerrará automáticamente al final de la ejecución del script o página. La función mysql_close no cierra una coneción persistente (abierta con mysql_pconnect()).

Ver tambien: mysql_connect y mysql_pconnect.

---

mysql_connect

int mysql_connect(string [hostname] , string [username] , string [password] );

Devuelve: un identificador de conexión, o FALSE en caso de error.

sql_connect establece una conexión a un servidor de MySQL. Todos los argumentos son optativos, y si no se especifican, los valores por defecto son (' el localhost', nombre del usuario del usuario que posee el proceso del servidor, la contraseña vacía). La cadena hostname también puede incluir un número del puerto, "hostname:port".

En caso de realizar una segunda llamada a mysql_connect con los mismos argumentos, no se establecerá ninguna nueva conexión, sino se devolverá el identificador de conexión de la ya existente.

La conexión al servidor se cerrará en cuanto la ejecución del script acabe, a menos que la cerremos antes con la función mysql_close.

Ver también: mysql_pconnect y mysql_close.

---

mysql_create_db

int mysql_create_db(string database name, int [link_identifier] );

La función mysql_create_db intenta crear una nueva base de datos en el servidor asociado con el identificado de conexión especificado.

Ver también: mysql_drop_db.

---

mysql_data_seek

int mysql_data_seek(int result_identifier, int row_number);

Devuelve: TRUE si toda ha ido bien, y FALSE en caso de error.

La función mysql_data_seek mueve el puntero que indica la fila actual al número de fila de la consulta que indica el identificador. La próxima llamada al mysql_fetch_row o mysql_fetch_array devolvería esa fila.

Ver también: mysql_data_seek.

---

mysql_dbname

string mysql_dbname(string result, int i);

mysql_dbname devuelve el nombre de la base de datos guardado en posición i de los resultados del indicador de consulta devuelto por la función del mysql_list_dbs. La función del mysql_num_rows puede usarse para determinar cuántos nombres de bases de datos están disponibles.

---

mysql_db_query

int mysql_db_query(string database, string query, int link_identifier);

Devuelve: un identificador de conexión, o FALSE en caso de error.

Ejecuta una consulta en una base de datos. Si el identificador no se especifica, la función intenta encontrar una conexión abierta con el servidor. Si no encuentra una conexión, intentará crear una (similar a mysql_connect( ) sin argumentos).

See also mysql_connect.

---

mysql_drop_db

int mysql_drop_db(string database_name, int [link_identifier] );

Devuelve: TRUE si toda ha ido bien, y FALSE en caso de error.

Elimina una base de datos del servidor asociado al identificador de conexión.

Ver también: mysql_create_db

---

mysql_errno

int mysql_errno();

Devuelve el número de error asociado a la última operación realizada.

Ver también: mysql_error

---

mysql_error

string mysql_error();

Devuelve el texto asociado al error producido en la última operación realizada por la base de datos.

<?php
mysql_connect("marliesle");
echo mysql_errno().": ".mysql_error()."<BR>";
mysql_select_db("nonexistentdb");
echo mysql_err_db("nonexistentdb");
echo mysql_errno().": ".mysql_error()."<BR>";
$conn = mysql_query("SELECT * FROM nonexistenttable");
echo mysql_errno().": ".mysql_error()."<BR>";
?>

Ver también: mysql_errno

---

mysql_fetch_array

array mysql_fetch_array(int result);

Devuelve un array con la información correspondiente al resultado de una consulta especificado por su identificador o 'false' si ya no hay más filas.

Es una versión extendida de mysql_fetch_row ( ). Además de almacenar los datos a través de índices numéricos del array, también lo hace a través de índices asociativos, utilizando los nombres de los campos como claves.
Si dos o más columnas del resultado tienen el mismo nombre de campo, la última es la que tiene preferencia. Para acceder a las demás es necesario utilizar el índice numérico o construir un alias para la columna:

select t1.f1 as foo t2.f1 as bar from t1, t2

as foo t2.f1 as bar from t1, t2

Esta función no es más lenta que 'mysql_fetch_row( )'.

Example 1. mysql fetch array

<?php
mysql_connect($host,$user,$password);
$result = mysql_db_query("database","select * from table");
while($row = mysql_fetch_array($result)) {
echo $row["user_id"];
echo $row["fullname"];
}
mysql_free_result($result);
?>

---

mysql_fetch_field

object mysql_fetch_field(int result, int [field_offset] );

Devuelve un objeto que contiene la información de los campos que componen un resultado de una consulta. Si no se especifica 'offset', devuelve información sobre el siguiente campo que todavía no ha sido devuelto.

Propiedades del objeto devuelto:

• name - nombre del campo
• table - nombre de la tabla a la que pertenece el campo
• max_length - longitud máxima que puede tomar el campo
• not_null - 1 si el campo no puede tomar valores nulos
• primary_key - 1 si el campo es una clave principal (primary key)
• unique_key - 1 si el campo tiene restricción de unicidad
• multiple_key - 1 si el campo no tiene rest
• multiple_key - 1 si el campo no tiene restricción de unicidad
• numeric - 1 si el campo es numérico
• blob - 1 si el campo es BLOB
• type - tipo de dato (del campo)
• unsigned - 1 si el campo es 'unsigned'
• zerofill - 1 si el campo es rellenado con ceros

See also mysql_field_seek

---

mysql_fetch_lengths

int mysql_fetch_lengths(int result);

Devuelve: una tabla o FALSE si hay error.

mysql_fetch_lengths almacena en una tabla la longitud de cada campo de una consulta realizada con mysql_fetch_row o mysql_fetch_array. El índice de la tabla comienza en 0.

Ver también: mysql_fetch_row.

---