24. Compras sencillas

Versión para imprimir.

A. Introducción

B. Diagrama entidad relación

Diagrama entidad relación

C. Diagrama relacional

Diagrama relacional

D. Diagrama de despliegue

Diagrama de despliegue

E. Hazlo funcionar

  1. Prueba el ejemplo en http://srvcompras.rf.gd/.

  2. Descarga el archivo /src/srvcompras.zip y descompáctalo.

  3. Crea tu proyecto en GitHub:

    1. Crea una cuenta de email, por ejemplo, pepito@google.com

    2. Crea una cuenta de GitHub usando el email anterior y selecciona el nombre de usuario unsando la parte inicial del correo electrónico, por ejemplo pepito.

    3. Crea un repositorio nuevo. En la página principal de GitHub cliquea 📘 New.

    4. En la página Create a new repository introduce los siguientes datos:

      • Proporciona el nombre de tu repositorio debajo de donde dice Repository name *.

      • Mantén la selección Public para que otros usuarios puedan ver tu proyecto.

      • Verifica la casilla Add a README file. En este archivo se muestra información sobre tu proyecto.

      • Cliquea License: None. y selecciona la licencia que consideres más adecuada para tu proyecto.

      • Cliquea Create repository.

  4. Importa el proyecto en GitHub:

    1. En la página principal de tu proyecto en GitHub, en la pestaña < > Code, cliquea < > Code y en la sección Branches y copia la dirección que está en HTTPS, debajo de Clone.

    2. En Visual Studio Code, usa el botón de la izquierda para Source Control.

      Imagen de Source Control

    3. Cliquea el botón Clone Repository.

    4. Pega la url que copiaste anteriormente hasta arriba, donde dice algo como Provide repository URL y presiona la teclea Intro.

    5. Selecciona la carpeta donde se guardará la carpeta del proyecto.

    6. Abre la carpeta del proyecto importado.

    7. Añade el contenido de la carpeta descompactada que contiene el código del ejemplo.

  5. Edita los archivos que desees.

  6. Haz clic derecho en index.html, selecciona PHP Server: serve project y se abre el navegador para que puedas probar localmente el ejemplo.

  7. Para depurar paso a paso haz lo siguiente:

    1. En el navegador, haz clic derecho en la página que deseas depurar y selecciona inspeccionar.

    2. Recarga la página, de preferencia haciendo clic derecho en el ícono de volver a cargar la página Ïmagen del ícono de recarga y seleccionando vaciar caché y volver a cargar de manera forzada (o algo parecido). Si no aparece un menú emergente, simplemente cliquea volver a cargar la página Ïmagen del ícono de recarga. Revisa que no aparezca ningún error ni en la pestañas Consola, ni en Red.

    3. Selecciona la pestaña Fuentes (o Sources si tu navegador está en Inglés).

    4. Selecciona el archivo donde vas a empezar a depurar.

    5. Haz clic en el número de la línea donde vas a empezar a depurar.

    6. En Visual Studio Code, abre el archivo de PHP donde vas a empezar a depurar.

    7. Haz clic en Run and Debug .

    8. Si no está configurada la depuración, haz clic en create a launch json file.

    9. Haz clic en la flechita RUN AND DEBUG, al lado de la cual debe decir Listen for Xdebug .

    10. Aparece un cuadro con los controles de depuración

    11. Selecciona otra vez el archivo de PHP y haz clic en el número de la línea donde vas a empezar a depurar.

    12. Regresa al navegador, recarga la página y empieza a usarla.

    13. Si se ejecuta alguna de las líneas de código seleccionadas, aparece resaltada en la pestaña de fuentes. Usa los controles de depuración para avanzar, como se muestra en este video.

  8. Sube el proyecto al hosting que elijas. En algunos casos puedes usar filezilla (https://filezilla-project.org/)

  9. Abre un navegador y prueba el proyecto en tu hosting.

  10. En el hosting InfinityFree, la primera ves que corres la página, puede marcar un mensaje de error, pero al recargar funciona correctamente. Puedes evitar este problema usando un dominio propio.

  11. Para subir el código a GitHub, en la sección de SOURCE CONTROL, en Message introduce un mensaje sobre los cambios que hiciste, por ejemplo index.html corregido, selecciona v y luego Commit & Push.

    Imagen de Commit & Push

F. Archivos

Haz clic en los triángulos para expandir las carpetas

G. index.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Productos</title>
10
11 <script type="module" src="lib/js/consumeJson.js"></script>
12 <script type="module" src="lib/js/muestraObjeto.js"></script>
13 <script type="module" src="lib/js/muestraError.js"></script>
14
15</head>
16
17<body onload="consumeJson('srv/productos.php')
18 .then(render => muestraObjeto(document, render.body))
19 .catch(muestraError)">
20
21 <h1>Productos</h1>
22
23 <p><a href="carrito.html">Ver carrito</a></p>
24
25 <dl id="lista">
26 <dt>Cargando…</dt>
27 <dd><progress max="100">Cargando…</progress></dd>
28 </dl>
29
30</body>
31
32</html>

H. agrega.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Agregar</title>
10
11 <script type="module" src="lib/js/consumeJson.js"></script>
12 <script type="module" src="lib/js/submitForm.js"></script>
13 <script type="module" src="lib/js/muestraObjeto.js"></script>
14 <script type="module" src="lib/js/muestraError.js"></script>
15
16 <script>
17 // Obtiene los parámetros de la página.
18 const params = new URL(location.href).searchParams
19 </script>
20
21</head>
22
23<body onload="if (params.size > 0) {
24 consumeJson('srv/producto.php?' + params)
25 .then(producto => muestraObjeto(document, producto.body))
26 .catch(muestraError)
27 }">
28
29 <form onsubmit="submitForm('srv/det-venta-agrega.php', event)
30 .then(modelo => location.href = 'index.html')
31 .catch(muestraError)">
32
33 <h1>Agregar</h1>
34
35 <p><a href="index.html">Cancelar</a></p>
36
37 <input type="hidden" name="id">
38
39 <p>
40 <label>
41 Producto
42 <output name="producto">
43 <progress max="100">Cargando…</progress>
44 </output>
45 </label>
46 </p>
47
48 <p>
49 <label>
50 Precio
51 <output name="precio">
52 <progress max="100">Cargando…</progress>
53 </output>
54 </label>
55 </p>
56
57 <p>
58 <label>
59 Cantidad *
60 <input name="cantidad" type="number" min="0" step="0.01">
61 </label>
62 </p>
63
64 <p>* Obligatorio</p>
65
66 <p><button type="submit">Agregar</button></p>
67
68 </form>
69
70</body>
71
72</html>

I. carrito.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Carrito</title>
10
11 <script type="module" src="lib/js/consumeJson.js"></script>
12 <script type="module" src="lib/js/muestraError.js"></script>
13 <script type="module" src="lib/js/muestraObjeto.js"></script>
14
15</head>
16
17<body onload="consumeJson('srv/venta-en-captura.php')
18 .then(venta => muestraObjeto(document, venta.body))
19 .catch(muestraError)">
20
21 <h1>Carrito</h1>
22
23 <p>
24
25 <a href="index.html">Productos</a>
26
27 <button type='button' onclick="if (confirm('Confirma procesar')) {
28 consumeJson('srv/venta-en-captura-procesa.php')
29 .then(() => location.href = 'index.html')
30 .catch(muestraError)
31 }">
32 Procesar compra
33 </button>
34
35 </p>
36
37 <p>
38 <label>
39 Folio
40 <output id="folio">
41 <progress max="100">Cargando…</progress>
42 </output>
43 </label>
44 </p>
45
46 <fieldset>
47
48 <legend>Detalle</legend>
49
50 <dl id="detalles">
51 <dt>Cargando…</dt>
52 <dd><progress max="100">Cargando…</progress></dd>
53 </dl>
54
55 </fieldset>
56
57</body>
58
59</html>

J. modifica.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Modificar</title>
10
11 <script type="module" src="lib/js/consumeJson.js"></script>
12 <script type="module" src="lib/js/submitForm.js"></script>
13 <script type="module" src="lib/js/muestraError.js"></script>
14 <script type="module" src="lib/js/muestraObjeto.js"></script>
15
16 <script>
17 // Obtiene los parámetros de la página.
18 const params = new URL(location.href).searchParams
19 </script>
20
21</head>
22
23<body onload="if (params.size > 0) {
24 consumeJson('srv/det-venta.php?' + params)
25 .then(modelo => muestraObjeto(document, modelo.body))
26 .catch(muestraError)
27 }">
28
29 <form onsubmit="submitForm('srv/det-venta-modifica.php', event)
30 .then(modelo => location.href = 'carrito.html')
31 .catch(muestraError)">
32
33 <h1>Modificar</h1>
34
35 <p><a href="carrito.html">Cancelar</a></p>
36
37 <input type="hidden" name="prodId">
38
39 <p>
40 <label>
41 Producto
42 <output name="prodNombre">
43 <progress max="100">Cargando…</progress>
44 </output>
45 </label>
46 </p>
47
48 <p>
49 <label>
50 Precio
51 <output name="precio">
52 <progress max="100">Cargando…</progress>
53 </output>
54 </label>
55 </p>
56
57 <p>
58 <label>
59 Cantidad *
60 <input name="cantidad" type="number" min="0" step="0.01">
61 </label>
62 </p>
63
64 <p>* Obligatorio</p>
65
66 <p>
67
68 <button type="submit">Guardar</button>
69
70 <button type="button" onclick="
71 if (params.size > 0 && confirm('Confirma la eliminación')) {
72 consumeJson('srv/det-venta-elimina.php?' + params)
73 .then(() => location.href = 'carrito.html')
74 .catch(muestraError)
75 }">
76 Eliminar
77 </button>
78
79 </p>
80
81 </form>
82
83</body>
84
85</html>

K. Carpeta « srv »

Versión para imprimir.

A. srv / Bd.php

1<?php
2
3require_once __DIR__ . "/ventaEnCapturaAgrega.php";
4
5class Bd
6{
7
8 private static ?PDO $pdo = null;
9
10 public static function pdo(): PDO
11 {
12 if (self::$pdo === null) {
13 self::$pdo = new PDO(
14 // cadena de conexión
15 "sqlite:srvcompras.db",
16 // usuario
17 null,
18 // contraseña
19 null,
20 // Opciones: pdos no persistentes y lanza excepciones.
21 [PDO::ATTR_PERSISTENT => false, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
22 );
23
24 self::$pdo->exec(
25 'CREATE TABLE IF NOT EXISTS VENTA (
26 VENT_ID INTEGER,
27 VENT_EN_CAPTURA INTEGER NOT NULL,
28 CONSTRAINT VENT_PK
29 PRIMARY KEY(VENT_ID)
30 )'
31 );
32 self::$pdo->exec(
33 'CREATE TABLE IF NOT EXISTS PRODUCTO (
34 PROD_ID INTEGER,
35 PROD_NOMBRE TEXT NOT NULL,
36 PROD_EXISTENCIAS REAL NOT NULL,
37 PROD_PRECIO REAL NOT NULL,
38 CONSTRAINT PROD_PK
39 PRIMARY KEY(PROD_ID),
40 CONSTRAINT PROD_NOM_UNQ
41 UNIQUE(PROD_NOMBRE),
42 CONSTRAINT PROD_NOM_NV
43 CHECK(LENGTH(PROD_NOMBRE) > 0)
44 )'
45 );
46 self::$pdo->exec(
47 'CREATE TABLE IF NOT EXISTS DET_VENTA (
48 VENT_ID INTEGER NOT NULL,
49 PROD_ID INTEGER NOT NULL,
50 DTV_CANTIDAD REAL NOT NULL,
51 DTV_PRECIO REAL NOT NULL,
52 CONSTRAINT DTV_PK
53 PRIMARY KEY (VENT_ID, PROD_ID),
54 CONSTRAINT DTV_VENT_FK
55 FOREIGN KEY (VENT_ID) REFERENCES VENTA(VENT_ID),
56 CONSTRAINT DTV_PROD_FK
57 FOREIGN KEY (PROD_ID) REFERENCES PRODUCTO(PROD_ID)
58 )'
59 );
60
61 $cantidadDeProductos =
62 self::$pdo->query("SELECT COUNT(PROD_ID) FROM PRODUCTO")->fetchColumn();
63
64 if ($cantidadDeProductos === 0) {
65 self::$pdo->exec(
66 "INSERT INTO PRODUCTO
67 (PROD_NOMBRE, PROD_EXISTENCIAS, PROD_PRECIO)
68 VALUES
69 ('Sandwich', 50, 15),
70 ('Hot dog', 40, 30),
71 ('Hamburguesa', 30, 40)"
72 );
73 }
74
75 $cantidadDeVentas =
76 self::$pdo->query("SELECT COUNT(VENT_ID) FROM VENTA")->fetchColumn();
77
78 if ($cantidadDeVentas === 0) {
79 ventaEnCapturaAgrega(self::$pdo);
80 }
81 }
82
83 return self::$pdo;
84 }
85}
86

B. srv / det-venta-agrega.php

1<?php
2
3require_once __DIR__ . "/../lib/php/ejecutaServicio.php";
4require_once __DIR__ . "/../lib/php/recuperaIdEntero.php";
5require_once __DIR__ . "/../lib/php/recuperaDecimal.php";
6require_once __DIR__ . "/../lib/php/insert.php";
7require_once __DIR__ . "/../lib/php/devuelveCreated.php";
8require_once __DIR__ . "/Bd.php";
9require_once __DIR__ . "/TABLA_VENTA.php";
10require_once __DIR__ . "/TABLA_PRODUCTO.php";
11require_once __DIR__ . "/TABLA_DET_VENTA.php";
12require_once __DIR__ . "/validaCantidad.php";
13require_once __DIR__ . "/productoBusca.php";
14require_once __DIR__ . "/validaProducto.php";
15require_once __DIR__ . "/ventaEnCapturaBusca.php";
16require_once __DIR__ . "/validaVenta.php";
17
18ejecutaServicio(function () {
19
20 $prodId = recuperaIdEntero("id");
21 $cantidad = recuperaDecimal("cantidad");
22
23 $cantidad = validaCantidad($cantidad);
24
25 $pdo = Bd::pdo();
26
27 $producto = productoBusca($pdo, $prodId);
28 validaProducto($producto, $prodId);
29
30 $venta = ventaEnCapturaBusca($pdo);
31 validaVenta($venta);
32
33 insert(
34 pdo: Bd::pdo(),
35 into: DET_VENTA,
36 values: [
37 VENT_ID => $venta[VENT_ID],
38 PROD_ID => $prodId,
39 DTV_CANTIDAD => $cantidad,
40 DTV_PRECIO => $producto[PROD_PRECIO],
41 ]
42 );
43
44 $encodeProdId = urlencode($prodId);
45 devuelveCreated("/srv/det-venta.php?id=$encodeProdId", [
46 "prodId" => ["value" => $prodId],
47 "prodNombre" => ["value" => $producto[PROD_NOMBRE]],
48 "precio" => ["value" => "$" . number_format($producto[PROD_PRECIO], 2)],
49 "cantidad" => ["valueAsNumber" => $cantidad],
50 ]);
51});
52

C. srv / det-venta-elimina.php

1<?php
2
3require_once __DIR__ . "/../lib/php/ejecutaServicio.php";
4require_once __DIR__ . "/../lib/php/recuperaIdEntero.php";
5require_once __DIR__ . "/../lib/php/devuelveNoContent.php";
6require_once __DIR__ . "/../lib/php/delete.php";
7require_once __DIR__ . "/Bd.php";
8require_once __DIR__ . "/TABLA_VENTA.php";
9require_once __DIR__ . "/TABLA_PRODUCTO.php";
10require_once __DIR__ . "/TABLA_DET_VENTA.php";
11require_once __DIR__ . "/ventaEnCapturaBusca.php";
12
13ejecutaServicio(function () {
14
15 $prodId = recuperaIdEntero("prodId");
16
17 $pdo = Bd::pdo();
18
19 $venta = ventaEnCapturaBusca($pdo);
20 if ($venta !== false) {
21 delete(
22 pdo: $pdo,
23 from: DET_VENTA,
24 where: [VENT_ID => $venta[VENT_ID], PROD_ID => $prodId]
25 );
26 }
27 devuelveNoContent();
28});
29

D. srv / det-venta-modifica.php

1<?php
2
3require_once __DIR__ . "/../lib/php/ejecutaServicio.php";
4require_once __DIR__ . "/../lib/php/recuperaIdEntero.php";
5require_once __DIR__ . "/../lib/php/recuperaDecimal.php";
6require_once __DIR__ . "/../lib/php/update.php";
7require_once __DIR__ . "/../lib/php/devuelveJson.php";
8require_once __DIR__ . "/Bd.php";
9require_once __DIR__ . "/TABLA_VENTA.php";
10require_once __DIR__ . "/TABLA_PRODUCTO.php";
11require_once __DIR__ . "/TABLA_DET_VENTA.php";
12require_once __DIR__ . "/validaCantidad.php";
13require_once __DIR__ . "/productoBusca.php";
14require_once __DIR__ . "/validaProducto.php";
15require_once __DIR__ . "/ventaEnCapturaBusca.php";
16require_once __DIR__ . "/validaVenta.php";
17
18ejecutaServicio(function () {
19
20 $prodId = recuperaIdEntero("prodId");
21 $cantidad = recuperaDecimal("cantidad");
22
23 $cantidad = validaCantidad($cantidad);
24
25 $pdo = Bd::pdo();
26
27 $producto = productoBusca($pdo, $prodId);
28 validaProducto($producto, $prodId);
29
30 $venta = ventaEnCapturaBusca($pdo);
31 validaVenta($venta);
32
33 update(
34 pdo: Bd::pdo(),
35 table: DET_VENTA,
36 set: [DTV_CANTIDAD => $cantidad, DTV_PRECIO => $producto[PROD_PRECIO]],
37 where: [VENT_ID => $venta[VENT_ID], PROD_ID => $prodId]
38 );
39
40 devuelveJson([
41 "prodId" => ["value" => $prodId],
42 "prodNombre" => ["value" => $producto[PROD_NOMBRE]],
43 "precio" => ["value" => "$" . number_format($producto[PROD_PRECIO], 2)],
44 "cantidad" => ["valueAsNumber" => $cantidad],
45 ]);
46});
47

E. srv / det-venta.php

1<?php
2
3require_once __DIR__ . "/../lib/php/NOT_FOUND.php";
4require_once __DIR__ . "/../lib/php/ejecutaServicio.php";
5require_once __DIR__ . "/../lib/php/recuperaIdEntero.php";
6require_once __DIR__ . "/../lib/php/selectFirst.php";
7require_once __DIR__ . "/../lib/php/devuelveJson.php";
8require_once __DIR__ . "/../lib/php/ProblemDetails.php";
9require_once __DIR__ . "/Bd.php";
10require_once __DIR__ . "/TABLA_VENTA.php";
11require_once __DIR__ . "/TABLA_PRODUCTO.php";
12require_once __DIR__ . "/TABLA_DET_VENTA.php";
13require_once __DIR__ . "/productoBusca.php";
14require_once __DIR__ . "/validaProducto.php";
15require_once __DIR__ . "/ventaEnCapturaBusca.php";
16require_once __DIR__ . "/validaVenta.php";
17
18ejecutaServicio(function () {
19
20 $prodId = recuperaIdEntero("prodId");
21
22 $pdo = Bd::pdo();
23
24 $venta = ventaEnCapturaBusca($pdo);
25 validaVenta($venta);
26
27 $producto = productoBusca($pdo, $prodId);
28 validaProducto($producto, $prodId);
29
30 $detVenta = selectFirst(
31 pdo: $pdo,
32 from: DET_VENTA,
33 where: [
34 VENT_ID => $venta[VENT_ID],
35 PROD_ID => $prodId
36 ]
37 );
38
39 if ($detVenta === false) {
40 $htmlId = htmlentities($prodId);
41 throw new ProblemDetails(
42 status: NOT_FOUND,
43 type: "/error/detalledeventanoencontrado.html",
44 title: "Detalle de venta no encontrado.",
45 detail: "No se encontró ningún detalle de venta con el id de producto "
46 . $htmlId . ".",
47 );
48 }
49
50 devuelveJson([
51 "prodId" => ["value" => $prodId],
52 "prodNombre" => ["value" => $producto[PROD_NOMBRE]],
53 "precio" => ["value" => "$" . number_format($detVenta[DTV_PRECIO], 2)],
54 "cantidad" => ["valueAsNumber" => $detVenta[DTV_CANTIDAD]],
55 ]);
56});
57

F. srv / detVentaConsulta.php

1<?php
2
3require_once __DIR__ . "/../lib/php/fetchAll.php";
4
5function detVentaConsulta(PDO $pdo, int $ventaId)
6{
7 return fetchAll(
8 $pdo->query(
9 "SELECT
10 DV.PROD_ID,
11 P.PROD_NOMBRE,
12 P.PROD_EXISTENCIAS,
13 P.PROD_PRECIO,
14 DV.DTV_CANTIDAD,
15 DV.DTV_PRECIO
16 FROM DET_VENTA DV, PRODUCTO P
17 WHERE
18 DV.PROD_ID = P.PROD_ID
19 AND DV.VENT_ID = :VENT_ID
20 ORDER BY P.PROD_NOMBRE"
21 ),
22 [":VENT_ID" => $ventaId]
23 );
24}
25

G. srv / producto.php

1<?php
2
3require_once __DIR__ . "/../lib/php/ejecutaServicio.php";
4require_once __DIR__ . "/../lib/php/recuperaIdEntero.php";
5require_once __DIR__ . "/../lib/php/devuelveJson.php";
6require_once __DIR__ . "/Bd.php";
7require_once __DIR__ . "/productoBusca.php";
8require_once __DIR__ . "/validaProducto.php";
9
10ejecutaServicio(function () {
11
12 $id = recuperaIdEntero("id");
13
14 $producto = productoBusca(Bd::pdo(), $id);
15 validaProducto($producto, $id);
16
17 devuelveJson([
18 "id" => ["value" => $id],
19 "producto" => ["value" => $producto[PROD_NOMBRE]],
20 "precio" => ["value" => "$" . number_format($producto[PROD_PRECIO], 2)],
21 ]);
22});
23

H. srv / productoBusca.php

1<?php
2
3require_once __DIR__ . "/../lib/php/selectFirst.php";
4require_once __DIR__ . "/Bd.php";
5require_once __DIR__ . "/TABLA_PRODUCTO.php";
6
7function productoBusca(PDO $pdo, int $id)
8{
9 return selectFirst(pdo: $pdo, from: PRODUCTO, where: [PROD_ID => $id]);
10}
11

I. srv / productos.php

1<?php
2
3require_once __DIR__ . "/../lib/php/ejecutaServicio.php";
4require_once __DIR__ . "/../lib/php/select.php";
5require_once __DIR__ . "/../lib/php/devuelveJson.php";
6require_once __DIR__ . "/Bd.php";
7require_once __DIR__ . "/TABLA_PRODUCTO.php";
8
9ejecutaServicio(function () {
10
11 $pdo = Bd::pdo();
12
13 $lista = select(pdo: $pdo, from: PRODUCTO, orderBy: PROD_NOMBRE);
14
15 $render = "";
16 foreach ($lista as $modelo) {
17 $encodeId = urlencode($modelo[PROD_ID]);
18 $id = htmlentities($encodeId);
19 $nombre = htmlentities($modelo[PROD_NOMBRE]);
20 $precio = htmlentities("$" . number_format($modelo[PROD_PRECIO], 2));
21 $existencias = htmlentities(number_format($modelo[PROD_EXISTENCIAS], 2));
22 $render .=
23 "<dt>$nombre</dt>
24 <dd>
25 <a href='agrega.html?id=$id'>Agregar al carrito</a>
26 </dd>
27 <dd>
28 <dl>
29 <dt>Precio</dt>
30 <dd>$precio</dd>
31 <dt>Existencias</dt>
32 <dd>$existencias</dd>
33 </dl>
34 </dd>";
35 }
36 devuelveJson(["lista" => ["innerHTML" => $render]]);
37});
38

J. srv / TABLA_DET_VENTA.php

1<?php
2
3const DET_VENTA = "DET_VENTA";
4const DTV_CANTIDAD = "DTV_CANTIDAD";
5const DTV_PRECIO = "DTV_PRECIO";
6

K. srv / TABLA_PRODUCTO.php

1<?php
2
3const PRODUCTO = "PRODUCTO";
4const PROD_ID = "PROD_ID";
5const PROD_NOMBRE = "PROD_NOMBRE";
6const PROD_EXISTENCIAS = "PROD_EXISTENCIAS";
7const PROD_PRECIO = "PROD_PRECIO";
8

L. srv / TABLA_VENTA.php

1<?php
2
3const VENTA = "VENTA";
4const VENT_ID = "VENT_ID";
5const VENT_EN_CAPTURA = "VENT_EN_CAPTURA";
6

M. srv / validaCantidad.php

1<?php
2
3require_once __DIR__ . "/../lib/php/BAD_REQUEST.php";
4require_once __DIR__ . "/../lib/php/ProblemDetails.php";
5
6function validaCantidad(false|null|float $cantidad)
7{
8 if ($cantidad === false)
9 throw new ProblemDetails(
10 status: BAD_REQUEST,
11 title: "Falta la cantidad.",
12 type: "/error/faltacantidad.html",
13 detail: "La solicitud no tiene el valor de cantidad."
14 );
15
16 if ($cantidad === null)
17 throw new ProblemDetails(
18 status: BAD_REQUEST,
19 title: "Falta la cantidad.",
20 type: "/error/cantidadenblanco.html",
21 detail: "Pon un número en el campo cantidad."
22 );
23
24 return $cantidad;
25}
26

N. srv / validaProducto.php

1<?php
2
3require_once __DIR__ . "/../lib/php/NOT_FOUND.php";
4
5function validaProducto($producto, $prodId)
6{
7 if ($producto === false) {
8 $htmlId = htmlentities($prodId);
9 throw new ProblemDetails(
10 status: NOT_FOUND,
11 title: "Producto no encontrado.",
12 type: "/error/productonoencontrado.html",
13 detail: "No se encontró ningún producto con el id $htmlId.",
14 );
15 }
16}
17

O. srv / validaVenta.php

1<?php
2
3require_once __DIR__ . "/../lib/php/BAD_REQUEST.php";
4
5function validaVenta($venta)
6{
7 if ($venta === false)
8 throw new ProblemDetails(
9 status: BAD_REQUEST,
10 title: "Venta en captura no encontrada.",
11 type: "/error/ventaencapturanoencontrada.html",
12 detail: "No se encontró ninguna venta en captura.",
13 );
14}
15

P. srv / venta-en-captura-procesa.php

1<?php
2
3require_once __DIR__ . "/../lib/php/ejecutaServicio.php";
4require_once __DIR__ . "/../lib/php/devuelveCreated.php";
5require_once __DIR__ . "/../lib/php/update.php";
6require_once __DIR__ . "/Bd.php";
7require_once __DIR__ . "/TABLA_VENTA.php";
8require_once __DIR__ . "/TABLA_PRODUCTO.php";
9require_once __DIR__ . "/TABLA_DET_VENTA.php";
10require_once __DIR__ . "/ventaEnCapturaBusca.php";
11require_once __DIR__ . "/validaVenta.php";
12require_once __DIR__ . "/detVentaConsulta.php";
13require_once __DIR__ . "/ventaEnCapturaAgrega.php";
14
15ejecutaServicio(function () {
16
17 $pdo = Bd::pdo();
18 $pdo->beginTransaction();
19
20 $venta = ventaEnCapturaBusca($pdo);
21 validaVenta($venta);
22
23 $detalles = detVentaConsulta($pdo, $venta[VENT_ID]);
24
25 // Actualiza las existencias de los productos vendidos.
26 $update = $pdo->prepare(
27 "UPDATE PRODUCTO
28 SET PROD_EXISTENCIAS = :PROD_EXISTENCIAS
29 WHERE PROD_ID = :PROD_ID"
30 );
31 foreach ($detalles as $detVenta) {
32 $update->execute([
33 ":PROD_ID" => $detVenta[PROD_ID],
34 ":PROD_EXISTENCIAS" => $detVenta[PROD_EXISTENCIAS] - $detVenta[DTV_CANTIDAD]
35 ]);
36 }
37
38 update(
39 pdo: $pdo,
40 table: VENTA,
41 set: [VENT_EN_CAPTURA => 0],
42 where: [VENT_ID => $venta[VENT_ID]]
43 );
44
45 ventaEnCapturaAgrega($pdo);
46 $folio = $pdo->lastInsertId();
47
48 $pdo->commit();
49
50 devuelveCreated("/srv/venta-en-captura.php", [
51 "folio" => ["value" => $folio],
52 "detalles" => ["innerHTML" => ""]
53 ]);
54});
55

Q. srv / venta-en-captura.php

1<?php
2
3require_once __DIR__ . "/../lib/php/ejecutaServicio.php";
4require_once __DIR__ . "/../lib/php/fetchAll.php";
5require_once __DIR__ . "/../lib/php/devuelveJson.php";
6require_once __DIR__ . "/Bd.php";
7require_once __DIR__ . "/TABLA_VENTA.php";
8require_once __DIR__ . "/TABLA_PRODUCTO.php";
9require_once __DIR__ . "/TABLA_DET_VENTA.php";
10require_once __DIR__ . "/ventaEnCapturaBusca.php";
11require_once __DIR__ . "/validaVenta.php";
12require_once __DIR__ . "/detVentaConsulta.php";
13require_once __DIR__ . "/Bd.php";
14
15ejecutaServicio(function () {
16
17 $pdo = Bd::pdo();
18
19 $venta = ventaEnCapturaBusca($pdo);
20 validaVenta($venta);
21
22 $detalles = detVentaConsulta($pdo, $venta[VENT_ID]);
23
24 $renderDetalles = "";
25 foreach ($detalles as $detVenta) {
26 $encodeProdId = urlencode($detVenta[PROD_ID]);
27 $prodId = htmlentities($encodeProdId);
28 $prodNombre = htmlentities($detVenta[PROD_NOMBRE]);
29 $precio = htmlentities("$" . number_format($detVenta[PROD_PRECIO], 2));
30 $cantidad = htmlentities(number_format($detVenta[DTV_CANTIDAD], 2));
31 $renderDetalles .=
32 "<dt>$prodNombre</dt>
33 <dd>
34 <a href= 'modifica.html?prodId=$prodId'>Modificar o eliminar</a>
35 </dd>
36 <dd>
37 <dl>
38 <dt>Cantidad</dt>
39 <dd>$cantidad</dd>
40 <dt>Precio</dt>
41 <dd>$precio</dd>
42 </dl>
43 </dd>";
44 }
45
46 devuelveJson([
47 "folio" => ["value" => $venta[VENT_ID]],
48 "detalles" => ["innerHTML" => $renderDetalles]
49 ]);
50});
51

R. srv / ventaEnCapturaAgrega.php

1<?php
2
3require_once __DIR__ . "/../lib/php/selectFirst.php";
4
5function ventaEnCapturaAgrega(PDO $pdo)
6{
7 $pdo->exec("INSERT INTO VENTA (VENT_EN_CAPTURA) VALUES (1)");
8}
9

S. srv / ventaEnCapturaBusca.php

1<?php
2
3require_once __DIR__ . "/../lib/php/fetch.php";
4
5function ventaEnCapturaBusca(PDO $pdo)
6{
7 return fetch($pdo->query("SELECT * FROM VENTA WHERE VENT_EN_CAPTURA = 1"));
8}
9

L. Carpeta « lib »

Versión para imprimir.

A. Carpeta « lib / js »

Versión para imprimir.

1. lib / js / consumeJson.js

1import { exportaAHtml } from "./exportaAHtml.js"
2import { ProblemDetails } from "./ProblemDetails.js"
3
4/**
5 * Espera a que la promesa de un fetch termine. Si
6 * hay error, lanza una excepción. Si no hay error,
7 * interpreta la respuesta del servidor como JSON y
8 * la convierte en una literal de objeto.
9 *
10 * @param { string | Promise<Response> } servicio
11 */
12export async function consumeJson(servicio) {
13
14 if (typeof servicio === "string") {
15 servicio = fetch(servicio, {
16 headers: { "Accept": "application/json, application/problem+json" }
17 })
18 } else if (!(servicio instanceof Promise)) {
19 throw new Error("Servicio de tipo incorrecto.")
20 }
21
22 const respuesta = await servicio
23
24 const headers = respuesta.headers
25
26 if (respuesta.ok) {
27 // Aparentemente el servidor tuvo éxito.
28
29 if (respuesta.status === 204) {
30 // No contiene texto de respuesta.
31
32 return { headers, body: {} }
33
34 } else {
35
36 const texto = await respuesta.text()
37
38 try {
39
40 return { headers, body: JSON.parse(texto) }
41
42 } catch (error) {
43
44 // El contenido no es JSON. Probablemente sea texto de un error.
45 throw new ProblemDetails(respuesta.status, headers, texto,
46 "/error/errorinterno.html")
47
48 }
49
50 }
51
52 } else {
53 // Hay un error.
54
55 const texto = await respuesta.text()
56
57 if (texto === "") {
58
59 // No hay texto. Se usa el texto predeterminado.
60 throw new ProblemDetails(respuesta.status, headers, respuesta.statusText)
61
62 } else {
63 // Debiera se un ProblemDetails en JSON.
64
65 try {
66
67 const { title, type, detail } = JSON.parse(texto)
68
69 throw new ProblemDetails(respuesta.status, headers,
70 typeof title === "string" ? title : respuesta.statusText,
71 typeof type === "string" ? type : undefined,
72 typeof detail === "string" ? detail : undefined)
73
74 } catch (error) {
75
76 if (error instanceof ProblemDetails) {
77 // El error si era un ProblemDetails
78
79 throw error
80
81 } else {
82
83 throw new ProblemDetails(respuesta.status, headers, respuesta.statusText,
84 undefined, texto)
85
86 }
87
88 }
89
90 }
91
92 }
93
94}
95
96exportaAHtml(consumeJson)

2. lib / js / exportaAHtml.js

1/**
2 * Permite que los eventos de html usen la función.
3 * @param {function} functionInstance
4 */
5export function exportaAHtml(functionInstance) {
6 window[nombreDeFuncionParaHtml(functionInstance)] = functionInstance
7}
8
9/**
10 * @param {function} valor
11 */
12export function nombreDeFuncionParaHtml(valor) {
13 const names = valor.name.split(/\s+/g)
14 return names[names.length - 1]
15}

3. lib / js / muestraError.js

1import { exportaAHtml } from "./exportaAHtml.js"
2import { ProblemDetails } from "./ProblemDetails.js"
3
4/**
5 * Muestra un error en la consola y en un cuadro de
6 * alerta el mensaje de una excepción.
7 * @param { ProblemDetails | Error | null } error descripción del error.
8 */
9export function muestraError(error) {
10
11 if (error === null) {
12
13 console.error("Error")
14 alert("Error")
15
16 } else if (error instanceof ProblemDetails) {
17
18 let mensaje = error.title
19 if (error.detail) {
20 mensaje += `\n\n${error.detail}`
21 }
22 mensaje += `\n\nCódigo: ${error.status}`
23 if (error.type) {
24 mensaje += ` ${error.type}`
25 }
26
27 console.error(mensaje)
28 console.error(error)
29 console.error("Headers:")
30 error.headers.forEach((valor, llave) => console.error(llave, "=", valor))
31 alert(mensaje)
32
33 } else {
34
35 console.error(error)
36 alert(error.message)
37
38 }
39
40}
41
42exportaAHtml(muestraError)

4. lib / js / muestraObjeto.js

1import { exportaAHtml } from "./exportaAHtml.js"
2
3/**
4 * @param { Document | HTMLElement } raizHtml
5 * @param { any } objeto
6 */
7export function muestraObjeto(raizHtml, objeto) {
8
9 for (const [nombre, definiciones] of Object.entries(objeto)) {
10
11 if (Array.isArray(definiciones)) {
12
13 muestraArray(raizHtml, nombre, definiciones)
14
15 } else if (definiciones !== undefined && definiciones !== null) {
16
17 const elementoHtml = buscaElementoHtml(raizHtml, nombre)
18
19 if (elementoHtml instanceof HTMLInputElement) {
20
21 muestraInput(raizHtml, elementoHtml, definiciones)
22
23 } else if (elementoHtml !== null) {
24
25 for (const [atributo, valor] of Object.entries(definiciones)) {
26 if (atributo in elementoHtml) {
27 elementoHtml[atributo] = valor
28 }
29 }
30
31 }
32
33 }
34
35 }
36
37}
38exportaAHtml(muestraObjeto)
39
40/**
41 * @param { Document | HTMLElement } raizHtml
42 * @param { string } nombre
43 */
44export function buscaElementoHtml(raizHtml, nombre) {
45 return raizHtml.querySelector(
46 `#${nombre},[name="${nombre}"],[data-name="${nombre}"]`)
47}
48
49/**
50 * @param { Document | HTMLElement } raizHtml
51 * @param { string } propiedad
52 * @param {any[]} valores
53 */
54function muestraArray(raizHtml, propiedad, valores) {
55
56 const conjunto = new Set(valores)
57 const elementos =
58 raizHtml.querySelectorAll(`[name="${propiedad}"],[data-name="${propiedad}"]`)
59
60 if (elementos.length === 1) {
61 const elemento = elementos[0]
62
63 if (elemento instanceof HTMLSelectElement) {
64 const options = elemento.options
65 for (let i = 0, len = options.length; i < len; i++) {
66 const option = options[i]
67 option.selected = conjunto.has(option.value)
68 }
69 return
70 }
71
72 }
73
74 for (let i = 0, len = elementos.length; i < len; i++) {
75 const elemento = elementos[i]
76 if (elemento instanceof HTMLInputElement) {
77 elemento.checked = conjunto.has(elemento.value)
78 }
79 }
80
81}
82
83/**
84 * @param { Document | HTMLElement } raizHtml
85 * @param { HTMLInputElement } input
86 * @param { any } definiciones
87 */
88function muestraInput(raizHtml, input, definiciones) {
89
90 for (const [atributo, valor] of Object.entries(definiciones)) {
91
92 if (atributo == "data-file") {
93
94 const img = getImgParaElementoHtml(raizHtml, input)
95 if (img !== null) {
96 input.dataset.file = valor
97 input.value = ""
98 if (valor === "") {
99 img.src = ""
100 img.hidden = true
101 } else {
102 img.src = valor
103 img.hidden = false
104 }
105 }
106
107 } else if (atributo in input) {
108
109 input[atributo] = valor
110
111 }
112 }
113
114}
115
116/**
117 * @param { Document | HTMLElement } raizHtml
118 * @param { HTMLElement } elementoHtml
119 */
120export function getImgParaElementoHtml(raizHtml, elementoHtml) {
121 const imgId = elementoHtml.getAttribute("data-img")
122 if (imgId === null) {
123 return null
124 } else {
125 const input = buscaElementoHtml(raizHtml, imgId)
126 if (input instanceof HTMLImageElement) {
127 return input
128 } else {
129 return null
130 }
131 }
132}

5. lib / js / ProblemDetails.js

1/**
2 * Detalle de los errores devueltos por un servicio.
3 */
4export class ProblemDetails extends Error {
5
6 /**
7 * @param {number} status
8 * @param {Headers} headers
9 * @param {string} title
10 * @param {string} [type]
11 * @param {string} [detail]
12 */
13 constructor(status, headers, title, type, detail) {
14 super(title)
15 /**
16 * @readonly
17 */
18 this.status = status
19 /**
20 * @readonly
21 */
22 this.headers = headers
23 /**
24 * @readonly
25 */
26 this.type = type
27 /**
28 * @readonly
29 */
30 this.detail = detail
31 /**
32 * @readonly
33 */
34 this.title = title
35 }
36
37}

6. lib / js / submitForm.js

1import { consumeJson } from "./consumeJson.js"
2import { exportaAHtml } from "./exportaAHtml.js"
3
4/**
5 * Envía los datos de la forma a la url usando la codificación
6 * multipart/form-data.
7 * @param {string} url
8 * @param {Event} event
9 * @param { "GET" | "POST"| "PUT" | "PATCH" | "DELETE" | "TRACE" | "OPTIONS"
10 * | "CONNECT" | "HEAD" } metodoHttp
11 */
12export function submitForm(url, event, metodoHttp = "POST") {
13
14 event.preventDefault()
15
16 const form = event.target
17
18 if (!(form instanceof HTMLFormElement))
19 throw new Error("event.target no es un elemento de tipo form.")
20
21 return consumeJson(fetch(url, {
22 method: metodoHttp,
23 headers: { "Accept": "application/json, application/problem+json" },
24 body: new FormData(form)
25 }))
26
27}
28
29exportaAHtml(submitForm)

B. Carpeta « lib / php »

Versión para imprimir.

1. lib / php / BAD_REQUEST.php

1<?php
2
3const BAD_REQUEST = 400;
4

2. lib / php / calculaArregloDeParametros.php

1<?php
2
3function calculaArregloDeParametros(array $arreglo)
4{
5 $parametros = [];
6 foreach ($arreglo as $llave => $valor) {
7 $parametros[":$llave"] = $valor;
8 }
9 return $parametros;
10}
11

3. lib / php / calculaSqlDeAsignaciones.php

1<?php
2
3function calculaSqlDeAsignaciones(string $separador, array $arreglo)
4{
5 $primerElemento = true;
6 $sqlDeAsignacion = "";
7 foreach ($arreglo as $llave => $valor) {
8 $sqlDeAsignacion .=
9 ($primerElemento === true ? "" : $separador) . "$llave=:$llave";
10 $primerElemento = false;
11 }
12 return $sqlDeAsignacion;
13}
14

4. lib / php / calculaSqlDeCamposDeInsert.php

1<?php
2
3function calculaSqlDeCamposDeInsert(array $values)
4{
5 $primerCampo = true;
6 $sqlDeCampos = "";
7 foreach ($values as $nombreDeValue => $valorDeValue) {
8 $sqlDeCampos .= ($primerCampo === true ? "" : ",") . "$nombreDeValue";
9 $primerCampo = false;
10 }
11 return $sqlDeCampos;
12}
13

5. lib / php / calculaSqlDeValues.php

1<?php
2
3function calculaSqlDeValues(array $values)
4{
5 $primerValue = true;
6 $sqlDeValues = "";
7 foreach ($values as $nombreDeValue => $valorDeValue) {
8 $sqlDeValues .= ($primerValue === true ? "" : ",") . ":$nombreDeValue";
9 $primerValue = false;
10 }
11 return $sqlDeValues;
12}
13

6. lib / php / delete.php

1<?php
2
3require_once __DIR__ . "/calculaArregloDeParametros.php";
4require_once __DIR__ . "/calculaSqlDeAsignaciones.php";
5
6function delete(PDO $pdo, string $from, array $where)
7{
8 $sql = "DELETE FROM $from";
9
10 if (sizeof($where) === 0) {
11 $pdo->exec($sql);
12 } else {
13 $sqlDeWhere = calculaSqlDeAsignaciones(" AND ", $where);
14 $sql .= " WHERE $sqlDeWhere";
15
16 $statement = $pdo->prepare($sql);
17 $parametros = calculaArregloDeParametros($where);
18 $statement->execute($parametros);
19 }
20}
21

7. lib / php / devuelveCreated.php

1<?php
2
3require_once __DIR__ . "/devuelveResultadoNoJson.php";
4
5function devuelveCreated($urlDelNuevo, $resultado)
6{
7
8 $json = json_encode($resultado);
9
10 if ($json === false) {
11
12 devuelveResultadoNoJson();
13 } else {
14
15 http_response_code(201);
16 header("Location: {$urlDelNuevo}");
17 header("Content-Type: application/json");
18 echo $json;
19 }
20}
21

8. lib / php / devuelveErrorInterno.php

1<?php
2
3require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";
4require_once __DIR__ . "/devuelveProblemDetails.php";
5require_once __DIR__ . "/devuelveProblemDetails.php";
6
7function devuelveErrorInterno(Throwable $error)
8{
9 devuelveProblemDetails(new ProblemDetails(
10 status: INTERNAL_SERVER_ERROR,
11 title: $error->getMessage(),
12 type: "/error/errorinterno.html"
13 ));
14}
15

9. lib / php / devuelveJson.php

1<?php
2
3require_once __DIR__ . "/devuelveResultadoNoJson.php";
4
5function devuelveJson($resultado)
6{
7
8 $json = json_encode($resultado);
9
10 if ($json === false) {
11
12 devuelveResultadoNoJson();
13 } else {
14
15 http_response_code(200);
16 header("Content-Type: application/json");
17 echo $json;
18 }
19}
20

10. lib / php / devuelveNoContent.php

1<?php
2
3function devuelveNoContent()
4{
5 http_response_code(204);
6}
7

11. lib / php / devuelveProblemDetails.php

1<?php
2
3require_once __DIR__ . "/devuelveResultadoNoJson.php";
4require_once __DIR__ . "/ProblemDetails.php";
5
6function devuelveProblemDetails(ProblemDetails $details)
7{
8
9 $body = ["title" => $details->title];
10 if ($details->type !== null) {
11 $body["type"] = $details->type;
12 }
13 if ($details->detail !== null) {
14 $body["detail"] = $details->detail;
15 }
16
17 $json = json_encode($body);
18
19 if ($json === false) {
20
21 devuelveResultadoNoJson();
22 } else {
23
24 http_response_code($details->status);
25 header("Content-Type: application/problem+json");
26 echo $json;
27 }
28}
29

12. lib / php / devuelveResultadoNoJson.php

1<?php
2
3require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";
4
5function devuelveResultadoNoJson()
6{
7
8 http_response_code(INTERNAL_SERVER_ERROR);
9 header("Content-Type: application/problem+json");
10 echo '{' .
11 '"title": "El resultado no puede representarse como JSON."' .
12 '"type": "/error/resultadonojson.html"' .
13 '}';
14}
15

13. lib / php / ejecutaServicio.php

1<?php
2
3require_once __DIR__ . "/ProblemDetails.php";
4require_once __DIR__ . "/devuelveProblemDetails.php";
5require_once __DIR__ . "/devuelveErrorInterno.php";
6
7function ejecutaServicio(callable $codigo)
8{
9 try {
10 $codigo();
11 } catch (ProblemDetails $details) {
12 devuelveProblemDetails($details);
13 } catch (Throwable $error) {
14 devuelveErrorInterno($error);
15 }
16}
17

14. lib / php / fetch.php

1<?php
2
3function fetch(
4 PDOStatement|false $statement,
5 $parametros = [],
6 int $mode = PDO::FETCH_ASSOC,
7 $opcional = null
8) {
9
10 if ($statement === false) {
11
12 return false;
13 } else {
14
15 if (sizeof($parametros) > 0) {
16 $statement->execute($parametros);
17 }
18
19 if ($opcional === null) {
20 return $statement->fetch($mode);
21 } else {
22 $statement->setFetchMode($mode, $opcional);
23 return $statement->fetch();
24 }
25 }
26}
27

15. lib / php / fetchAll.php

1<?php
2
3function fetchAll(
4 PDOStatement|false $statement,
5 $parametros = [],
6 int $mode = PDO::FETCH_ASSOC,
7 $opcional = null
8): array {
9
10 if ($statement === false) {
11
12 return [];
13 } else {
14
15 if (sizeof($parametros) > 0) {
16 $statement->execute($parametros);
17 }
18
19 $resultado = $opcional === null
20 ? $statement->fetchAll($mode)
21 : $statement->fetchAll($mode, $opcional);
22
23 if ($resultado === false) {
24 return [];
25 } else {
26 return $resultado;
27 }
28 }
29}
30

16. lib / php / insert.php

1<?php
2
3require_once __DIR__ . "/calculaSqlDeCamposDeInsert.php";
4require_once __DIR__ . "/calculaSqlDeValues.php";
5require_once __DIR__ . "/calculaArregloDeParametros.php";
6
7function insert(PDO $pdo, string $into, array $values)
8{
9 $sqlDeCampos = calculaSqlDeCamposDeInsert($values);
10 $sqlDeValues = calculaSqlDeValues($values);
11 $sql = "INSERT INTO $into ($sqlDeCampos) VALUES ($sqlDeValues)";
12 $parametros = calculaArregloDeParametros($values);
13 $pdo->prepare($sql)->execute($parametros);
14}
15

17. lib / php / INTERNAL_SERVER_ERROR.php

1<?php
2
3const INTERNAL_SERVER_ERROR = 500;

18. lib / php / NOT_FOUND.php

1<?php
2
3const NOT_FOUND = 404;
4

19. lib / php / ProblemDetails.php

1<?php
2
3/** Detalle de los errores devueltos por un servicio. */
4class ProblemDetails extends Exception
5{
6
7 public int $status;
8 public string $title;
9 public ?string $type;
10 public ?string $detail;
11
12 public function __construct(
13 int $status,
14 string $title,
15 ?string $type = null,
16 ?string $detail = null,
17 Throwable $previous = null
18 ) {
19 parent::__construct($title, $status, $previous);
20 $this->status = $status;
21 $this->type = $type;
22 $this->title = $title;
23 $this->detail = $detail;
24 }
25}
26

20. lib / php / recuperaArray.php

1<?php
2
3/**
4 * Recupera los valores asociados a un
5 * parámetro multivaluado; por ejemplo, un
6 * grupo de checkbox, recibido en el servidor
7 * por medio de GET, POST o cookie. Si no se
8 * recibe el parámetro, devuelve []. Si el
9 * valor recibido no es un arreglo, lo coloca
10 * dentro de uno.
11 */
12function recuperaArray(string $parametro)
13{
14 if (isset($_REQUEST[$parametro])) {
15 $valor = $_REQUEST[$parametro];
16 return is_array($valor)
17 ? $valor
18 : [$valor];
19 } else {
20 return [];
21 }
22}
23

21. lib / php / recuperaDecimal.php

1<?php
2
3require_once __DIR__ . "/recuperaTexto.php";
4
5/**
6 * Recupera el valor decimal de un parámetro (que
7 * puede tener fracciones) enviado al servidor por
8 * medio de GET, POST o cookie.
9 *
10 * Si el parámetro no se recibe, devuekve false
11 *
12 * Si se recibe una cadena vacía, se devuelve null.
13 *
14 * Si parámetro no se puede convertir a entero,
15 * devuelve 0.
16 */
17function recuperaDecimal(string $parametro): false|null|float
18{
19 $valor = recuperaTexto($parametro);
20 if ($valor === false) {
21 return false;
22 } elseif ($valor === "") {
23 return null;
24 } else {
25 return (float) trim($valor);
26 }
27 return $valor === null|| $valor === ""
28 ? null
29 : trim($valor);
30}
31

22. lib / php / recuperaEntero.php

1<?php
2
3require_once __DIR__ . "/recuperaTexto.php";
4
5/**
6 * Devuelve el valor entero de un parámetro recibido en el
7 * servidor por medio de GET, POST o cookie.
8 *
9 * Si el parámetro no se recibe, devuekve false
10 *
11 * Si se recibe una cadena vacía, se devuelve null.
12 *
13 * Si parámetro no se puede convertir a entero, se genera
14 * un error.
15 */
16function recuperaEntero(string $parametro): false|null|int
17{
18 $valor = recuperaTexto($parametro);
19 if ($valor === false) {
20 return false;
21 } elseif ($valor === "") {
22 return null;
23 } else {
24 return (int) trim($valor);
25 }
26}
27

23. lib / php / recuperaIdEntero.php

1<?php
2
3require_once __DIR__ . "/BAD_REQUEST.php";
4require_once __DIR__ . "/recuperaEntero.php";
5require_once __DIR__ . "/ProblemDetails.php";
6
7function recuperaIdEntero(string $parametro): int
8{
9
10 $id = recuperaEntero($parametro);
11
12 if ($id === false)
13 throw new ProblemDetails(
14 status: BAD_REQUEST,
15 title: "Falta el id.",
16 type: "/error/faltaid.html",
17 detail: "La solicitud no tiene el valor de id.",
18 );
19
20 if ($id === null)
21 throw new ProblemDetails(
22 status: BAD_REQUEST,
23 title: "Id en blanco.",
24 type: "/error/idenblanco.html",
25 );
26
27 return $id;
28}
29

24. lib / php / recuperaTexto.php

1<?php
2
3/**
4 * Recupera el texto de un parámetro enviado al
5 * servidor por medio de GET, POST o cookie.
6 *
7 * Si el parámetro no se recibe, devuelve false.
8 */
9function recuperaTexto(string $parametro): false|string
10{
11 /* Si el parámetro está asignado en $_REQUEST,
12 * devuelve su valor; de lo contrario, devuelve false.
13 */
14 $valor = isset($_REQUEST[$parametro])
15 ? $_REQUEST[$parametro]
16 : false;
17 return $valor;
18}
19

25. lib / php / select.php

1<?php
2
3require_once __DIR__ . "/fetchAll.php";
4require_once __DIR__ . "/calculaSqlDeAsignaciones.php";
5
6function select(
7 PDO $pdo,
8 string $from,
9 array $where = [],
10 string $orderBy = "",
11 int $mode = PDO::FETCH_ASSOC,
12 $opcional = null
13) {
14 $sql = "SELECT * FROM $from";
15
16 if (sizeof($where) > 0) {
17 $sqlDeWhere = calculaSqlDeAsignaciones(" AND ", $where);
18 $sql .= " WHERE $sqlDeWhere";
19 }
20
21 if ($orderBy !== "") {
22 $sql .= " ORDER BY $orderBy";
23 }
24
25 if (sizeof($where) === 0) {
26 $statement = $pdo->query($sql);
27 return fetchAll($statement, [], $mode, $opcional);
28 } else {
29 $statement = $pdo->prepare($sql);
30 $parametros = calculaArregloDeParametros($where);
31 return fetchAll($statement, $parametros, $mode, $opcional);
32 }
33}
34

26. lib / php / selectFirst.php

1<?php
2
3require_once __DIR__ . "/fetch.php";
4require_once __DIR__ . "/calculaArregloDeParametros.php";
5require_once __DIR__ . "/calculaSqlDeAsignaciones.php";
6
7function selectFirst(
8 PDO $pdo,
9 string $from,
10 array $where = [],
11 string $orderBy = "",
12 int $mode = PDO::FETCH_ASSOC,
13 $opcional = null
14) {
15 $sql = "SELECT * FROM $from";
16
17 if (sizeof($where) > 0) {
18 $sqlDeWhere = calculaSqlDeAsignaciones(" AND ", $where);
19 $sql .= " WHERE $sqlDeWhere";
20 }
21
22 if ($orderBy !== "") {
23 $sql .= " ORDER BY $orderBy";
24 }
25
26 if (sizeof($where) === 0) {
27 $statement = $pdo->query($sql);
28 return fetch($statement, [], $mode, $opcional);
29 } else {
30 $statement = $pdo->prepare($sql);
31 $parametros = calculaArregloDeParametros($where);
32 return fetch($statement, $parametros, $mode, $opcional);
33 }
34}
35

27. lib / php / update.php

1<?php
2
3require_once __DIR__ . "/calculaArregloDeParametros.php";
4require_once __DIR__ . "/calculaSqlDeAsignaciones.php";
5
6
7function update(PDO $pdo, string $table, array $set, array $where)
8{
9 $sqlDeSet = calculaSqlDeAsignaciones(",", $set);
10 $sqlDeWhere = calculaSqlDeAsignaciones(" AND ", $where);
11 $sql = "UPDATE $table SET $sqlDeSet WHERE $sqlDeWhere";
12
13 $parametros = calculaArregloDeParametros($set);
14 foreach ($where as $nombreDeWhere => $valorDeWhere) {
15 $parametros[":$nombreDeWhere"] = $valorDeWhere;
16 }
17 $statement = $pdo->prepare($sql);
18 $statement->execute($parametros);
19}
20

M. Carpeta « error »

Versión para imprimir.

A. error / cantidadenblanco.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Cantidad en blanco</title>
10
11</head>
12
13<body>
14
15 <h1>Nombre en blanco</h1>
16
17 <p>Pon un número en el campo cantidad.</p>
18
19</body>
20
21</html>

B. error / cantidadincorrecta.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>La cantidad no puede ser NAN</title>
10
11</head>
12
13<body>
14
15 <h1>La cantidad no puede ser NAN</h1>
16
17</body>
18
19</html>

C. error / detalledeventaincorrecto.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Tipo incorrecto para un etalle de venta</title>
10
11</head>
12
13<body>
14
15 <h1>Tipo incorrecto para un etalle de venta</h1>
16
17</body>
18
19</html>

D. error / detalledeventanoencontrado.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Detalle de venta no encontrado</title>
10
11</head>
12
13<body>
14
15 <h1>Detalle de venta no encontrado</h1>
16
17 <p>No se encontró ningún detalle de venta con el id de producto solicitado.</p>
18
19</body>
20
21</html>

E. error / errorinterno.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Error interno del servidor</title>
10
11</head>
12
13<body>
14
15 <h1>Error interno del servidor</h1>
16
17 <p>Se presentó de forma inesperada un error interno del servidor.</p>
18
19</body>
20
21</html>

F. error / existenciasincorrectas.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Las existencias no pueden ser NAN</title>
10
11</head>
12
13<body>
14
15 <h1>Las existencias no pueden ser NAN</h1>
16
17</body>
18
19</html>

G. error / faltacantidad.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Falta la cantidad</title>
10
11</head>
12
13<body>
14
15 <h1>Falta la cantidad</h1>
16
17 <p>La solicitud no tiene el valor de cantidad.</p>
18
19</body>
20
21</html>

H. error / faltaid.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Falta el id</title>
10
11</head>
12
13<body>
14
15 <h1>Falta el id</h1>
16
17 <p>La solicitud no tiene el valor de id.</p>
18
19</body>
20
21</html>

I. error / faltanombre.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Falta el nombre</title>
10
11</head>
12
13<body>
14
15 <h1>Falta el nombre</h1>
16
17 <p>La solicitud no tiene el valor de nombre.</p>
18
19</body>
20
21</html>

J. error / idenblanco.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Id en blanco</title>
10
11</head>
12
13<body>
14
15 <h1>Id en blanco</h1>
16
17</body>
18
19</html>

K. error / nombreenblanco.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Nombre en blanco</title>
10
11</head>
12
13<body>
14
15 <h1>Nombre en blanco</h1>
16
17 <p>Pon texto en el campo nombre.</p>
18
19</body>
20
21</html>

L. error / precioincorrecto.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>El precio no puede ser NAN</title>
10
11</head>
12
13<body>
14
15 <h1>El precio no puede ser NAN</h1>
16
17</body>
18
19</html>

M. error / productonoencontrado.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Producto no encontrado</title>
10
11</head>
12
13<body>
14
15 <h1>Producto no encontrado</h1>
16
17 <p>No se encontró ningún producto con el id solicitado.</p>
18
19</body>
20
21</html>

N. error / resultadonojson.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>El resultado no puede representarse como JSON</title>
10
11</head>
12
13<body>
14
15 <h1>El resultado no puede representarse como JSON</h1>
16
17 <p>
18 Debido a un error interno del servidor, el resultado generado, no se puede
19 recuperar.
20 </p>
21
22</body>
23
24</html>

O. error / ventaencapturanoencontrada.html

1<!DOCTYPE html>
2<html lang="es">
3
4<head>
5
6 <meta charset="UTF-8">
7 <meta name="viewport" content="width=device-width">
8
9 <title>Venta en captura no encontrada</title>
10
11</head>
12
13<body>
14
15 <h1>Venta en captura no encontrada</h1>
16
17 <p>No se encontró ninguna venta en captura.</p>
18
19</body>
20
21</html>

N. jsconfig.json

1{
2 "compilerOptions": {
3 "checkJs": true,
4 "strictNullChecks": true,
5 "target": "ES6",
6 "module": "Node16",
7 "moduleResolution": "Node16",
8 "lib": [
9 "ES2017",
10 "WebWorker",
11 "DOM"
12 ]
13 }
14}

O. Resumen