unijimpe

Este artículo ya se encuentra obsoleto.
Para una referencia actual leer: Insertar datos en MySQL usando PDO en PHP

Continuando con la serie de artículos dedicados a explicar como trabajar PHP con MySQL, ahora nos toca explicar como insertar datos o registros en nuestras tablas de MySQL.

Requerimientos

Para guardar datos en MySQL es necesario primero crear una conexión con MySQL, también necesitamos una base de datos de ejemplo el cual pueden crear con el siguiente script SQL y finalmente conocimientos básicos de SQL.

Conceptos Básicos

PHP provee funciones nativas que permiten interactuar con MySQL, para el proceso de insertar registros utilizaremos las siguientes funciones.

• mysql_query permite enviar cualquier consulta SQL (SELECT, INSERT, UPDATE, etc.) desde PHP.
• mysql_insert_id devuelve el identificador del último registro ingresado.

Entonces si deseamos insertar una nueva empresa en nuestra tabla de ejemplo tendríamos:

// abrimos la conexión
require("conexion.php");
// insertarmos el registro
mysql_query("INSERT INTO empresa (nombre, direccion) VALUES ('Apple', '1 Infinite Loop')");
// mostramos el ID del registro
echo mysql_insert_id();

Como pueden ver la creación de datos es sencilla, solo necesitamos crear la consulta adecuada y la enviamos mediante mysql_query.

Ejemplo Práctico

Veamos un ejemplo práctico, donde mediante un formulario en HTML registraremos los datos de las empresas.

Creando el Formulario

Para nuestro ejemplo creamos un formulario con tres campos (nombre, dirección y teléfono) con dos botones uno para enviar los datos y otro para limpiar el formulario.

<form method="post" action="agregar-empresa.php">
    Nombre  <input type="text" id="nombre" name="nombre" /><br />
    Direcci&oacute;n  <input type="text" id="direccion" name="direccion" /><br />
    Tel&eacute;fono   <input type="text" id="telefono" name="telefono" /><br />
    <button type="submit">Guardar</button>
    <button type="reset">Limpiar</button>
</form>

Procesando los Datos

El siguiente paso, es verificar si se están enviando datos desde un formulario para luego crear la consulta concatenando los datos enviados para finalmente guardar los datos con la función mysql_query.

// file: insert-demo2.php
require("conexion.php");
$status = "";
if (isset($_POST["nombre"])) {
	$nombre = $_POST["nombre"];
	$direccion = $_POST["direccion"];
	$telefono = $_POST["telefono"];
	// Creamos la consulta	
	$sql = "INSERT INTO empresa (nombre, direccion, telefono) ";
	$sql.= "VALUES ('".$nombre."', '".$direccion."', '".$telefono."')";
	// enviamos la consulta
	mysql_query($sql, $conexion);
	$status = "ok";
}

Uniendo el código obtenemos nuestro primer ejemplo funcionando para agregar registros desde un formulario.

Filtrando los Datos

El ejemplo anterior, funciona pero tiene un problema y es que el usuario podría haber ingresado datos inválidos (Por ejemplo texto donde solo se aceptan números) o también enviar código SQL para atacar a nuestra base de datos. Por ello antes de utilizar los datos enviados por el usuario es necesario antes normalizar estos datos.

Creamos una función llamada sqlValue, esta se encarga de convertir al tipo de dato correcto y agregarle los apostrofes necesarios para los textos y fechas.

// file: funciones.php
function sqlValue($value, $type) {
  $value = get_magic_quotes_gpc() ? stripslashes($value) : $value;
  $value = function_exists("mysql_real_escape_string") ? mysql_real_escape_string($value) : mysql_escape_string($value);
  switch ($type) {
    case "text":
      $value = ($value != "") ? "'" . $value . "'" : "NULL";
      break;
    case "int":
      $value = ($value != "") ? intval($value) : "NULL";
      break;
    case "double":
      $value = ($value != "") ? "'" . doubleval($value) . "'" : "NULL";
      break;
    case "date":
      $value = ($value != "") ? "'" . $value . "'" : "NULL";
      break;
  }
  return $value;
}

Esta función recibe dos parámetros, el primero el dato que deseamos normalizar y el segundo el tipo de dato (text, int, double, date). Luego vamos a modificar nuestro primer script para verificar los datos antes de guardarlos.

// file: insert-demo3.php
require("conexion.php");
require("funciones.php");
$status = "";
if (isset($_POST["nombre"])) {
	$nombre = sqlValue($_POST["nombre"], "text");
	$direccion = sqlValue($_POST["direccion"], "text");
	$telefono = sqlValue($_POST["telefono"], "int");
	
	$sql = "INSERT INTO empresa (nombre, direccion, telefono) ";
	$sql.= "VALUES (".$nombre.", ".$direccion.", ".$telefono.")";
	
	mysql_query($sql, $conexion);
	$status = "ok";
}

Unimos nuevamente el código y obtenemos una nueva forma de guardar datos en MySQL esta vez verificando los tipos de datos antes de guardarlos.

Haciendo pequeñas modificaciones podríamos guardar los datos de cualquier formulario, no importa la cantidad de datos o la complejidad de los mismos, todo este proceso se puede resumir en armar correctamente la consulta SQL para insertar los datos.

Depurar los INSERTS

Si tienen problemas en la creación de sus consultas por que no insertan o generan un error, lo mas sencillo es imprimir la consulta antes de enviarla a MySQL y detener la ejecución del script PHP.

$sql = "INSERT INTO empresa (nombre, direccion, telefono) ";
$sql.= "VALUES (".$nombre.", ".$direccion.", ".$telefono.")";
echo $sql;
exit;
mysql_query($sql, $conexion);

La consulta devuelta podemos revisarla y detectar algún error de sintaxis, también podríamos ejecutarla directamente en algún cliente de MySQL que tengamos para verificar si hace la inserción correctamente.

[download id=»50″ autop=»false»]

Nota Final

Para mejorar aún mas nuestro script para insertar datos, podríamos agregar validación de formularios. Ello lo podríamos hacer desde el lado del cliente mediante una librería javascript para validar formulario (Por ejemplo: Validar Formularios con Mootools o también Vanadium: Validar formularios fácilmente). La segunda forma es hacerlo con PHP verificando que los datos no estén vacíos, asignando valores por defecto si es que el campo esta vacío, entre otras verificaciones.

Posts Relacionados

• PHP con MySQL: Crear una conexión a MySQL
• PHP con MySQL: Eliminar Registros en MySQL
• Insertar registros en MySQL
• Conectar PHP con MySQL
• PHP and MySQL by Example