A. php / archivo.php

<?php

require_once __DIR__ . "/lib/recibeEnteroObligatorio.php";
require_once __DIR__ . "/lib/validaEntidadObligatoria.php";
require_once __DIR__ . "/Bd.php";

// Evita que la imagen se cargue en el caché del navegador.
header("Cache-Control: no-store, no-cache, must-revalidate, max-age=0");
header("Cache-Control: post-check=0, pre-check=0", false);
header("Pragma: no-cache");

$archId = recibeEnteroObligatorio("id");

$bd = Bd::pdo();

$stmt = $bd->prepare("SELECT * FROM ARCHIVO WHERE ARCH_ID = :ARCH_ID");
$stmt->execute([":ARCH_ID" => $archId]);
$archivo = $stmt->fetch(PDO::FETCH_ASSOC);

$archivo = validaEntidadObligatoria("Archivo",  $archivo);

$bytes = $archivo["ARCH_BYTES"];
$contentType = (new finfo(FILEINFO_MIME_TYPE))->buffer($bytes);
header("Content-Type: $contentType");
echo $bytes;


B. php / archivoAgrega.php

<?php

function archivoAgrega(PDO $bd, string $bytes)
{
 $stmt = $bd->prepare(
  "INSERT INTO ARCHIVO (
    ARCH_BYTES
   ) values (
    :ARCH_BYTES
   )"
 );
 $stmt->execute([
  ":ARCH_BYTES" => $bytes
 ]);
 $archId = $bd->lastInsertId();
 return $archId;
}


C. php / Bd.php

<?php

class Bd
{
 private static ?PDO $pdo = null;

 static function pdo(): PDO
 {
  if (self::$pdo === null) {

   self::$pdo = new PDO(
    // cadena de conexión
    "sqlite:" . __DIR__ . "/srvarchivos.db",
    // usuario
    null,
    // contraseña
    null,
    // Opciones: pdos no persistentes y lanza excepciones.
    [PDO::ATTR_PERSISTENT => false, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
   );

   self::$pdo->exec(
    'CREATE TABLE IF NOT EXISTS ARCHIVO (
      ARCH_ID INTEGER,
      ARCH_BYTES BLOB NOT NULL,
      CONSTRAINT ARCH_PK
       PRIMARY KEY(ARCH_ID)
     )'
   );
   self::$pdo->exec(
    'CREATE TABLE IF NOT EXISTS PRODUCTO (
      PROD_ID INTEGER,
      PROD_NOMBRE TEXT NOT NULL,
      ARCH_ID INTEGER NOT NULL,
      CONSTRAINT PROD_PK
       PRIMARY KEY(PROD_ID),
      CONSTRAINT PROD_NOM_UNQ
       UNIQUE(PROD_NOMBRE),
      CONSTRAINT PROD_NOM_NV
       CHECK(LENGTH(PROD_NOMBRE) > 0),
      CONSTRAINT PROD_ARCH_FK
       FOREIGN KEY (ARCH_ID) REFERENCES ARCHIVO(ARCH_ID)
      )'
   );
  }

  return self::$pdo;
 }
}


D. php / producto-agrega.php

<?php

require_once __DIR__ . "/lib/manejaErrores.php";
require_once __DIR__ . "/lib/recibeTextoObligatorio.php";
require_once __DIR__ . "/lib/recibeBytesObligatorios.php";
require_once __DIR__ . "/lib/devuelveCreated.php";
require_once __DIR__ . "/Bd.php";
require_once __DIR__ . "/archivoAgrega.php";

$nombre = recibeTextoObligatorio("nombre");
$bytes = recibeBytesObligatorios("imagen");

$bd = Bd::pdo();
$bd->beginTransaction();

$archId = archivoAgrega($bd, $bytes);

$stmt = $bd->prepare(
 "INSERT INTO PRODUCTO (
    PROD_NOMBRE, ARCH_ID
   ) values (
    :PROD_NOMBRE, :ARCH_ID
   )"
);
$stmt->execute([
 ":PROD_NOMBRE" => $nombre,
 ":ARCH_ID" => $archId
]);
$prodId = $bd->lastInsertId();

$bd->commit();

$encodeId = urlencode($prodId);
$encodeArchId = urlencode($archId);
$htmlEncodeArchId = htmlentities($encodeArchId);
// Los bytes de las imágenes se descargan con "archivo.php"; no desde aquí.
devuelveCreated("/php/producto-vista-modifica.php?id=$encodeId", [
 "id" => ["value" => $prodId],
 "nombre" => ["value" => $nombre],
 "imagen" => [
  "imagen" => [
   "data-src" => $htmlEncodeArchId === ""
    ? ""
    : "php/archivo.php?id=$htmlEncodeArchId"
  ]
 ]
]);


E. php / producto-elimina.php

<?php

require_once __DIR__ . "/lib/manejaErrores.php";
require_once __DIR__ . "/lib/recibeEnteroObligatorio.php";
require_once __DIR__ . "/lib/devuelveNoContent.php";
require_once __DIR__ . "/Bd.php";
require_once __DIR__ . "/productoBusca.php";

$prodId = recibeEnteroObligatorio("id");

$bd = Bd::pdo();
$bd->beginTransaction();

$producto = productoBusca($bd, $prodId);
if ($producto !== false) {

 $stmt = $bd->prepare("DELETE FROM PRODUCTO WHERE PROD_ID = :PROD_ID");
 $stmt->execute([":PROD_ID" => $prodId]);

 if ($producto["ARCH_ID"] !== null) {
  $stmt = $bd->prepare("DELETE FROM ARCHIVO WHERE ARCH_ID = :ARCH_ID");
  $stmt->execute([":ARCH_ID" => $producto["ARCH_ID"]]);
 }
}

$bd->commit();

devuelveNoContent();


F. php / producto-modifica.php

<?php

require_once __DIR__ . "/lib/manejaErrores.php";
require_once __DIR__ . "/lib/recibeEnteroObligatorio.php";
require_once __DIR__ . "/lib/recibeTextoObligatorio.php";
require_once __DIR__ . "/lib/recibeBytesOpcionales.php";
require_once __DIR__ . "/lib/validaEntidadObligatoria.php";
require_once __DIR__ . "/lib/devuelveJson.php";
require_once __DIR__ . "/Bd.php";
require_once __DIR__ . "/productoBusca.php";

$prodId = recibeEnteroObligatorio("id");
$nombre = recibeTextoObligatorio("nombre");
$bytes = recibeBytesOpcionales("imagen");

$bd = Bd::pdo();
$bd->beginTransaction();

$producto = productoBusca($bd, $prodId);
$producto = validaEntidadObligatoria("Producto",  $producto);

$archId = $producto["ARCH_ID"];

if ($bytes !== "") {
 if ($archId === null) {
  $archId = archivoAgrega($bd, $bytes);
 } else {
  $stmt = $bd->prepare(
   "UPDATE ARCHIVO
   SET
    ARCH_BYTES = :ARCH_BYTES
   WHERE
    ARCH_ID = :ARCH_ID"
  );
  $stmt->execute([
   ":ARCH_BYTES" => $bytes,
   ":ARCH_ID" => $archId,
  ]);
 }
}

$stmt = $bd->prepare(
 "UPDATE PRODUCTO
   SET
    PROD_NOMBRE = :PROD_NOMBRE,
    ARCH_ID = :ARCH_ID
   WHERE
    PROD_ID = :PROD_ID"
);
$stmt->execute([
 ":PROD_NOMBRE" => $nombre,
 ":ARCH_ID" => $archId,
 ":PROD_ID" => $prodId,
]);

$bd->commit();

$encodeArchId = $archId === null ? "" : urlencode($archId);
$htmlEncodeArchId = htmlentities($encodeArchId);
// Los bytes de las imágenes se descargan con "archivo.php"; no desde aquí.
devuelveJson([
 "id" => ["value" => $prodId],
 "nombre" => ["value" => $nombre],
 "imagen" => [
  "data-src" => $htmlEncodeArchId === ""
   ? ""
   : "php/archivo.php?id=$htmlEncodeArchId"
 ]
]);


G. php / producto-vista-index.php

<?php

require_once __DIR__ . "/lib/manejaErrores.php";
require_once __DIR__ . "/lib/devuelveJson.php";
require_once __DIR__ . "/Bd.php";

$bd = Bd::pdo();
$stmt = $bd->query("SELECT * FROM PRODUCTO ORDER BY PROD_NOMBRE");
$lista = $stmt->fetchAll(PDO::FETCH_ASSOC);

$render = "";
foreach ($lista as $modelo) {
 $prodId = htmlentities($modelo["PROD_ID"]);
 $prodNombre = htmlentities($modelo["PROD_NOMBRE"]);
 $encodeArchId =
 $modelo["ARCH_ID"] === null ? "" : urlencode($modelo["ARCH_ID"]);
 $archId = $encodeArchId === "" ? "" : htmlentities($encodeArchId);
 $src = $archId === "" ? "" : "php/archivo.php?id=$archId";
 // Los bytes de las imágenes se descargan con "archivo.php"; no desde aquí.
 $render .=
  "<div style='display: flex; flex-direction: row-reverse;
      align-items: center; gap: 0.5rem'>
     <dt style='flex: 1 1 0'>
      <a href='modifica.html?id=$prodId'>$prodNombre</a>
     </dt>
     <dd style='flex: 1 1 0; margin: 0'>
      <a href='modifica.html?id=$prodId'><img
        style='width: 100%; aspect-ratio:16/9; object-fit: cover'
        alt='Imagen del producto' src='$src'></a>
     </dd>
    </div>";
}

devuelveJson(["lista" => ["innerHTML" => $render]]);


H. php / producto-vista-modifica.php

<?php

require_once __DIR__ . "/lib/manejaErrores.php";
require_once __DIR__ . "/lib/recibeEnteroObligatorio.php";
require_once __DIR__ . "/lib/validaEntidadObligatoria.php";
require_once __DIR__ . "/lib/devuelveJson.php";
require_once __DIR__ . "/Bd.php";
require_once __DIR__ . "/productoBusca.php";

$prodId = recibeEnteroObligatorio("id");

$bd = Bd::pdo();
$modelo = productoBusca($bd, $prodId);

$modelo = validaEntidadObligatoria("Producto",  $modelo);

$encodeArchId =
 $modelo["ARCH_ID"] === null ? "" : urlencode($modelo["ARCH_ID"]);
$htmlEncodeArchId = htmlentities($encodeArchId);
// Los bytes de las imágenes se descargan con "archivo.php"; no desde aquí.
devuelveJson([
 "id" => ["value" => $prodId],
 "nombre" => ["value" => $modelo["PROD_NOMBRE"]],
 "imagen" => [
  "data-src" => $htmlEncodeArchId === ""
   ? ""
   : "php/archivo.php?id=$htmlEncodeArchId"
 ]
]);


I. php / productoBusca.php

<?php

function productoBusca(PDO $bd, int $prodId)
{
 $stmt = $bd->prepare("SELECT * FROM PRODUCTO WHERE PROD_ID = :PROD_ID");
 $stmt->execute([":PROD_ID" => $prodId]);
 $modelo = $stmt->fetch(PDO::FETCH_ASSOC);
 return $modelo;
}


J. Carpeta « php / lib »

Versión para imprimir.

1. php / lib / BAD_REQUEST.php


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

2. php / lib / devuelveCreated.php

<?php

require_once __DIR__ . "/devuelveResultadoNoJson.php";

function devuelveCreated($urlDelNuevo, $resultado)
{
 $json = json_encode($resultado);
 if ($json === false) {
  devuelveResultadoNoJson();
 } else {
  http_response_code(201);
  header("Location: $urlDelNuevo");
  header("Content-Type: application/json; charset=utf-8");
  echo $json;
 }
}


3. php / lib / devuelveJson.php

<?php

require_once __DIR__ . "/devuelveResultadoNoJson.php";

function devuelveJson($resultado)
{
 $json = json_encode($resultado);
 if ($json === false) {
  devuelveResultadoNoJson();
 } else {
  header("Content-Type: application/json; charset=utf-8");
  echo $json;
 }
 exit();
}


4. php / lib / devuelveNoContent.php

<?php

function devuelveNoContent()
{
 http_response_code(204);
}


5. php / lib / devuelveResultadoNoJson.php

<?php

require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";

function devuelveResultadoNoJson()
{
 http_response_code(INTERNAL_SERVER_ERROR);
 header("Content-Type: application/problem+json; charset=utf-8");

 echo '{' .
  "status: " . INTERNAL_SERVER_ERROR .
  '"title": "El resultado no puede representarse como JSON."' .
  '"type": "/errors/resultadonojson.html"' .
  '}';
}


6. php / lib / INTERNAL_SERVER_ERROR.php


1	<?php
2
3	const INTERNAL_SERVER_ERROR = 500;

7. php / lib / manejaErrores.php

<?php

require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";
require_once __DIR__ . "/ProblemDetailsException.php";

// Hace que se lance una excepción automáticamente cuando se genere un error.
set_error_handler(function ($severity, $message, $file, $line) {
 throw new ErrorException($message, 0, $severity, $file, $line);
});

// Código cuando una excepción no es atrapada.
set_exception_handler(function (Throwable $excepcion) {
 if ($excepcion instanceof ProblemDetailsException) {
  devuelveProblemDetails($excepcion->problemDetails);
 } else {
  devuelveProblemDetails([
   "status" => INTERNAL_SERVER_ERROR,
   "title" => "Error interno del servidor",
   "detail" => $excepcion->getMessage(),
   "type" => "/errors/errorinterno.html",
  ]);
 }
 exit();
});

function devuelveProblemDetails(array $array)
{
 $json = json_encode($array);
 if ($json === false) {
  devuelveResultadoNoJson();
 } else {
  http_response_code(isset($array["status"]) ? $array["status"] : 500);
  header("Content-Type: application/problem+json; charset=utf-8");
  echo $json;
 }
}


8. php / lib / NOT_FOUND.php


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

9. php / lib / ProblemDetailsException.php

<?php

require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";

/**
 * Detalle de los errores devueltos por un servicio.
 */
class ProblemDetailsException extends Exception
{

 public array $problemDetails;

 public function __construct(
  array $problemDetails,
 ) {
  
  parent::__construct(
   isset($problemDetails["detail"])
    ? $problemDetails["detail"]
    : (isset($problemDetails["title"])
     ? $problemDetails["title"]
     : "Error"),
   $problemDetails["status"]
    ? $problemDetails["status"]
    : INTERNAL_SERVER_ERROR
  );

  $this->problemDetails = $problemDetails;
 }
}


10. php / lib / recibeBytes.php

<?php

require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";
require_once __DIR__ . "/BAD_REQUEST.php";
require_once __DIR__ . "/ProblemDetailsException.php";

function recibeBytes(string $parametro)
{
 if (isset($_FILES[$parametro])) {

  $path = $_FILES[$parametro]["tmp_name"];

  if ($path === "") {

   return "";
  } elseif (is_uploaded_file($path)) {

   $contents = file_get_contents($path);

   if ($contents === false) {

    switch ($_FILES[$parametro]['error']) {

     case UPLOAD_ERR_OK:

      return $contents;

     case UPLOAD_ERR_INI_SIZE:
     case UPLOAD_ERR_FORM_SIZE:

      throw new ProblemDetailsException([
       "status" => BAD_REQUEST,
       "title" => "Archivo demasiado largo.",
       "type" => "/errors/archivodemasiadolargo.html",
       "detail" => "El archivo " - $parametro .
        " excede el tamaño máximo que el servidor puede recibir."
      ]);

     case UPLOAD_ERR_PARTIAL:
      throw new ProblemDetailsException([
       "status" => INTERNAL_SERVER_ERROR,
       "title" => "Carga incompleta de archivo.",
       "type" => "/errors/archivocargaincompleta.html",
       "detail" => "Por una razón desconocida, el archivo " - $parametro .
        " no se cargó completamente."
      ]);

     case UPLOAD_ERR_NO_FILE:

      throw creaArchivoNoRecibido($parametro);

     case UPLOAD_ERR_NO_TMP_DIR:

      throw new ProblemDetailsException([
       "status" => INTERNAL_SERVER_ERROR,
       "title" => "Falta la carpeta temporal.",
       "type" => "/errors/faltacarpetatemporal.html",
       "detail" => "Por una razón desconocida, falta la carpeta temporal " .
        "para cargar el archivo $parametro."
      ]);

     case UPLOAD_ERR_CANT_WRITE:

      throw new ProblemDetailsException([
       "status" => INTERNAL_SERVER_ERROR,
       "title" => "El archivo no se guardó.",
       "type" => "/errors/archivonoguardado.html",
       "detail" => "Por una razón desconocida, el archivo " - $parametro .
        " no se pudo guardar en disco."
      ]);

     case UPLOAD_ERR_EXTENSION:

      throw new ProblemDetailsException([
       "status" => BAD_REQUEST,
       "title" => "Extensión no permitida.",
       "type" => "/errors/extensionprohibida.html",
       "detail" => "La extensión del archivo " - $parametro .
        " no está permitida en el servidor."
      ]);

     default:

      throw new ProblemDetailsException([
       "status" => INTERNAL_SERVER_ERROR,
       "title" => "Error no identificado recuperando el archivo.",
       "type" => "/errors/errorrecuperandoarchivo.html",
       "detail" => "Por una razón desconocida, el archivo " - $parametro .
        " no se pudo recuperar."
      ]);
    }
   } else {

    return $contents;
   }
  } else {

   throw creaArchivoNoRecibido($parametro);
  }
 } else {
  return false;
 }
}

function creaArchivoNoRecibido(string $parametro)
{
 return new ProblemDetailsException([
  "status" => BAD_REQUEST,
  "title" => "Archivo no recibido.",
  "type" => "/errors/archivonorecibido.html",
  "detail" => "El archivo $parametro no fué recibido por el servidor."
 ]);
}


11. php / lib / recibeBytesObligatorios.php

<?php

require_once __DIR__ . "/BAD_REQUEST.php";
require_once __DIR__ . "/recibeBytes.php";
require_once __DIR__ . "/ProblemDetailsException.php";

function recibeBytesObligatorios(string $parametro)
{
 $bytes = recibeBytes($parametro);

 if ($bytes === false)
  throw new ProblemDetailsException([
   "status" => BAD_REQUEST,
   "title" => "Falta el valor $parametro.",
   "type" => "/errors/faltavalor.html",
   "detail" => "La solicitud no tiene el valor de $parametro."
  ]);

 if ($bytes === "")
  throw new ProblemDetailsException([
   "status" => BAD_REQUEST,
   "title" => "Archivo no seleccionado o vacío para el campo $parametro.",
   "type" => "/errors/archivovacio.html",
   "detail" => "Selecciona un archivo que no esté vacío en el campo $parametro."
  ]);

 return $bytes;
}


12. php / lib / recibeBytesOpcionales.php

<?php

require_once __DIR__ . "/recibeBytes.php";

function recibeBytesOpcionales(string $parametro)
{
 $enteroOpcional = recibeBytes($parametro);
 return $enteroOpcional === false ? "" : $enteroOpcional;
}


13. php / lib / recibeEntero.php

<?php

require_once __DIR__ . "/recibeTexto.php";

/**
 * Devuelve el valor entero de un parámetro recibido en el
 * servidor por medio de GET, POST o cookie.
 * 
 * Si el parámetro no se recibe, devuelve false
 *
 * Si se recibe una cadena vacía, se devuelve null.
 * 
 * Si parámetro no se puede convertir a entero, se genera
 * un error.
 */
function recibeEntero(string $parametro): false|null|int
{
 $valor = recibeTexto($parametro);
 if ($valor === false) {
  return false;
 } else {
  $valor = trim($valor);
  if ($valor === "") {
   return null;
  } else {
   return (int) $valor;
  }
 }
}


14. php / lib / recibeEnteroObligatorio.php

<?php

require_once __DIR__ . "/BAD_REQUEST.php";
require_once __DIR__ . "/recibeEntero.php";
require_once __DIR__ . "/ProblemDetailsException.php";

function recibeEnteroObligatorio(string $parametro)
{
 $entero = recibeEntero($parametro);

 if ($entero === false)
  throw new ProblemDetailsException([
   "status" => BAD_REQUEST,
   "title" => "Falta el valor $parametro.",
   "type" => "/errors/faltavalor.html",
   "detail" => "La solicitud no tiene el valor de $parametro."
  ]);

 if ($entero === null)
  throw new ProblemDetailsException([
   "status" => BAD_REQUEST,
   "title" => "Campo $parametro en blanco.",
   "type" => "/errors/campoenteroenblanco.html",
   "detail" => "Pon un número entero en el campo $parametro."
  ]);

 return $entero;
}


15. php / lib / recibeEnteroOpcional.php

<?php

require_once __DIR__ . "/recibeEntero.php";

function recibeEnteroOpcional(string $parametro)
{
 $enteroOpcional = recibeEntero($parametro);
 return $enteroOpcional === false ? null : $enteroOpcional;
}


16. php / lib / recibeTexto.php

<?php

/**
 * Devuelve el texto de un parámetro enviado al
 * servidor por medio de GET, POST o cookie.
 * 
 * Si el parámetro no se recibe, devuelve false.
 */
function recibeTexto(string $parametro): false|string
{
 /* Si el parámetro está asignado en $_REQUEST,
  * devuelve su valor; de lo contrario, devuelve false.
  */
 $valor = isset($_REQUEST[$parametro])
  ? $_REQUEST[$parametro]
  : false;
 return $valor;
}


17. php / lib / recibeTextoObligatorio.php

<?php

require_once __DIR__ . "/BAD_REQUEST.php";
require_once __DIR__ . "/recibeTexto.php";
require_once __DIR__ . "/ProblemDetailsException.php";

function recibeTextoObligatorio(string $parametro)
{
 $texto = recibeTexto($parametro);

 if ($texto === false)
  throw new ProblemDetailsException([
   "status" => BAD_REQUEST,
   "title" => "Falta el valor $parametro.",
   "type" => "/errors/faltavalor.html",
   "detail" => "La solicitud no tiene el valor de $parametro."
  ]);

 $trimTexto = trim($texto);

 if ($trimTexto === "")
  throw new ProblemDetailsException([
   "status" => BAD_REQUEST,
   "title" => "Campo $parametro en blanco.",
   "type" => "/errors/campoenblanco.html",
   "detail" => "Pon texto en el campo $parametro."
  ]);

 return $trimTexto;
}


18. php / lib / validaEntidadObligatoria.php

<?php

require_once __DIR__ . "/NOT_FOUND.php";
require_once __DIR__ . "/ProblemDetailsException.php";

function validaEntidadObligatoria(string $nombre,  $entidad)
{

 if ($entidad === false)
  throw new ProblemDetailsException([
  "status" => NOT_FOUND,
  "title" => "Registro de $nombre no encontrado.",
  "type" => "/errors/entidadnoencontrada.html",
  "detail" => "No se encontró ningún registro de $nombre con el id solicitado.",
  ]);

 return $entidad;
}


1	<?php
2
3	require_once __DIR__ . "/lib/recibeEnteroObligatorio.php";
4	require_once __DIR__ . "/lib/validaEntidadObligatoria.php";
5	require_once __DIR__ . "/Bd.php";
6
7	// Evita que la imagen se cargue en el caché del navegador.
8	header("Cache-Control: no-store, no-cache, must-revalidate, max-age=0");
9	header("Cache-Control: post-check=0, pre-check=0", false);
10	header("Pragma: no-cache");
11
12	$archId = recibeEnteroObligatorio("id");
13
14	$bd = Bd::pdo();
15
16	$stmt = $bd->prepare("SELECT * FROM ARCHIVO WHERE ARCH_ID = :ARCH_ID");
17	$stmt->execute([":ARCH_ID" => $archId]);
18	$archivo = $stmt->fetch(PDO::FETCH_ASSOC);
19
20	$archivo = validaEntidadObligatoria("Archivo", $archivo);
21
22	$bytes = $archivo["ARCH_BYTES"];
23	$contentType = (new finfo(FILEINFO_MIME_TYPE))->buffer($bytes);
24	header("Content-Type: $contentType");
25	echo $bytes;
26

1	<?php
2
3	function archivoAgrega(PDO $bd, string $bytes)
4	{
5	$stmt = $bd->prepare(
6	"INSERT INTO ARCHIVO (
7	ARCH_BYTES
8	) values (
9	:ARCH_BYTES
10	)"
11	);
12	$stmt->execute([
13	":ARCH_BYTES" => $bytes
14	]);
15	$archId = $bd->lastInsertId();
16	return $archId;
17	}
18

1	<?php
2
3	class Bd
4	{
5	private static ?PDO $pdo = null;
6
7	static function pdo(): PDO
8	{
9	if (self::$pdo === null) {
10
11	self::$pdo = new PDO(
12	// cadena de conexión
13	"sqlite:" . __DIR__ . "/srvarchivos.db",
14	// usuario
15	null,
16	// contraseña
17	null,
18	// Opciones: pdos no persistentes y lanza excepciones.
19	[PDO::ATTR_PERSISTENT => false, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
20	);
21
22	self::$pdo->exec(
23	'CREATE TABLE IF NOT EXISTS ARCHIVO (
24	ARCH_ID INTEGER,
25	ARCH_BYTES BLOB NOT NULL,
26	CONSTRAINT ARCH_PK
27	PRIMARY KEY(ARCH_ID)
28	)'
29	);
30	self::$pdo->exec(
31	'CREATE TABLE IF NOT EXISTS PRODUCTO (
32	PROD_ID INTEGER,
33	PROD_NOMBRE TEXT NOT NULL,
34	ARCH_ID INTEGER NOT NULL,
35	CONSTRAINT PROD_PK
36	PRIMARY KEY(PROD_ID),
37	CONSTRAINT PROD_NOM_UNQ
38	UNIQUE(PROD_NOMBRE),
39	CONSTRAINT PROD_NOM_NV
40	CHECK(LENGTH(PROD_NOMBRE) > 0),
41	CONSTRAINT PROD_ARCH_FK
42	FOREIGN KEY (ARCH_ID) REFERENCES ARCHIVO(ARCH_ID)
43	)'
44	);
45	}
46
47	return self::$pdo;
48	}
49	}
50

1	<?php
2
3	require_once __DIR__ . "/lib/manejaErrores.php";
4	require_once __DIR__ . "/lib/recibeTextoObligatorio.php";
5	require_once __DIR__ . "/lib/recibeBytesObligatorios.php";
6	require_once __DIR__ . "/lib/devuelveCreated.php";
7	require_once __DIR__ . "/Bd.php";
8	require_once __DIR__ . "/archivoAgrega.php";
9
10	$nombre = recibeTextoObligatorio("nombre");
11	$bytes = recibeBytesObligatorios("imagen");
12
13	$bd = Bd::pdo();
14	$bd->beginTransaction();
15
16	$archId = archivoAgrega($bd, $bytes);
17
18	$stmt = $bd->prepare(
19	"INSERT INTO PRODUCTO (
20	PROD_NOMBRE, ARCH_ID
21	) values (
22	:PROD_NOMBRE, :ARCH_ID
23	)"
24	);
25	$stmt->execute([
26	":PROD_NOMBRE" => $nombre,
27	":ARCH_ID" => $archId
28	]);
29	$prodId = $bd->lastInsertId();
30
31	$bd->commit();
32
33	$encodeId = urlencode($prodId);
34	$encodeArchId = urlencode($archId);
35	$htmlEncodeArchId = htmlentities($encodeArchId);
36	// Los bytes de las imágenes se descargan con "archivo.php"; no desde aquí.
37	devuelveCreated("/php/producto-vista-modifica.php?id=$encodeId", [
38	"id" => ["value" => $prodId],
39	"nombre" => ["value" => $nombre],
40	"imagen" => [
41	"imagen" => [
42	"data-src" => $htmlEncodeArchId === ""
43	? ""
44	: "php/archivo.php?id=$htmlEncodeArchId"
45	]
46	]
47	]);
48

1	<?php
2
3	require_once __DIR__ . "/lib/manejaErrores.php";
4	require_once __DIR__ . "/lib/devuelveJson.php";
5	require_once __DIR__ . "/Bd.php";
6
7	$bd = Bd::pdo();
8	$stmt = $bd->query("SELECT * FROM PRODUCTO ORDER BY PROD_NOMBRE");
9	$lista = $stmt->fetchAll(PDO::FETCH_ASSOC);
10
11	$render = "";
12	foreach ($lista as $modelo) {
13	$prodId = htmlentities($modelo["PROD_ID"]);
14	$prodNombre = htmlentities($modelo["PROD_NOMBRE"]);
15	$encodeArchId =
16	$modelo["ARCH_ID"] === null ? "" : urlencode($modelo["ARCH_ID"]);
17	$archId = $encodeArchId === "" ? "" : htmlentities($encodeArchId);
18	$src = $archId === "" ? "" : "php/archivo.php?id=$archId";
19	// Los bytes de las imágenes se descargan con "archivo.php"; no desde aquí.
20	$render .=
21	"<div style='display: flex; flex-direction: row-reverse;
22	align-items: center; gap: 0.5rem'>
23	<dt style='flex: 1 1 0'>
24	<a href='modifica.html?id=$prodId'>$prodNombre</a>
25	</dt>
26	<dd style='flex: 1 1 0; margin: 0'>
27	<a href='modifica.html?id=$prodId'><img
28	style='width: 100%; aspect-ratio:16/9; object-fit: cover'
29	alt='Imagen del producto' src='$src'></a>
30	</dd>
31	</div>";
32	}
33
34	devuelveJson(["lista" => ["innerHTML" => $render]]);
35

1	<?php
2
3	function productoBusca(PDO $bd, int $prodId)
4	{
5	$stmt = $bd->prepare("SELECT * FROM PRODUCTO WHERE PROD_ID = :PROD_ID");
6	$stmt->execute([":PROD_ID" => $prodId]);
7	$modelo = $stmt->fetch(PDO::FETCH_ASSOC);
8	return $modelo;
9	}
10

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

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

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

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

1	<?php
2
3	require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";
4	require_once __DIR__ . "/ProblemDetailsException.php";
5
6	// Hace que se lance una excepción automáticamente cuando se genere un error.
7	set_error_handler(function ($severity, $message, $file, $line) {
8	throw new ErrorException($message, 0, $severity, $file, $line);
9	});
10
11	// Código cuando una excepción no es atrapada.
12	set_exception_handler(function (Throwable $excepcion) {
13	if ($excepcion instanceof ProblemDetailsException) {
14	devuelveProblemDetails($excepcion->problemDetails);
15	} else {
16	devuelveProblemDetails([
17	"status" => INTERNAL_SERVER_ERROR,
18	"title" => "Error interno del servidor",
19	"detail" => $excepcion->getMessage(),
20	"type" => "/errors/errorinterno.html",
21	]);
22	}
23	exit();
24	});
25
26	function devuelveProblemDetails(array $array)
27	{
28	$json = json_encode($array);
29	if ($json === false) {
30	devuelveResultadoNoJson();
31	} else {
32	http_response_code(isset($array["status"]) ? $array["status"] : 500);
33	header("Content-Type: application/problem+json; charset=utf-8");
34	echo $json;
35	}
36	}
37

1	<?php
2
3	require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";
4
5	/**
6	* Detalle de los errores devueltos por un servicio.
7	*/
8	class ProblemDetailsException extends Exception
9	{
10
11	public array $problemDetails;
12
13	public function __construct(
14	array $problemDetails,
15	) {
16
17	parent::__construct(
18	isset($problemDetails["detail"])
19	? $problemDetails["detail"]
20	: (isset($problemDetails["title"])
21	? $problemDetails["title"]
22	: "Error"),
23	$problemDetails["status"]
24	? $problemDetails["status"]
25	: INTERNAL_SERVER_ERROR
26	);
27
28	$this->problemDetails = $problemDetails;
29	}
30	}
31

1	<?php
2
3	require_once __DIR__ . "/INTERNAL_SERVER_ERROR.php";
4	require_once __DIR__ . "/BAD_REQUEST.php";
5	require_once __DIR__ . "/ProblemDetailsException.php";
6
7	function recibeBytes(string $parametro)
8	{
9	if (isset($_FILES[$parametro])) {
10
11	$path = $_FILES[$parametro]["tmp_name"];
12
13	if ($path === "") {
14
15	return "";
16	} elseif (is_uploaded_file($path)) {
17
18	$contents = file_get_contents($path);
19
20	if ($contents === false) {
21
22	switch ($_FILES[$parametro]['error']) {
23
24	case UPLOAD_ERR_OK:
25
26	return $contents;
27
28	case UPLOAD_ERR_INI_SIZE:
29	case UPLOAD_ERR_FORM_SIZE:
30
31	throw new ProblemDetailsException([
32	"status" => BAD_REQUEST,
33	"title" => "Archivo demasiado largo.",
34	"type" => "/errors/archivodemasiadolargo.html",
35	"detail" => "El archivo " - $parametro .
36	" excede el tamaño máximo que el servidor puede recibir."
37	]);
38
39	case UPLOAD_ERR_PARTIAL:
40	throw new ProblemDetailsException([
41	"status" => INTERNAL_SERVER_ERROR,
42	"title" => "Carga incompleta de archivo.",
43	"type" => "/errors/archivocargaincompleta.html",
44	"detail" => "Por una razón desconocida, el archivo " - $parametro .
45	" no se cargó completamente."
46	]);
47
48	case UPLOAD_ERR_NO_FILE:
49
50	throw creaArchivoNoRecibido($parametro);
51
52	case UPLOAD_ERR_NO_TMP_DIR:
53
54	throw new ProblemDetailsException([
55	"status" => INTERNAL_SERVER_ERROR,
56	"title" => "Falta la carpeta temporal.",
57	"type" => "/errors/faltacarpetatemporal.html",
58	"detail" => "Por una razón desconocida, falta la carpeta temporal " .
59	"para cargar el archivo $parametro."
60	]);
61
62	case UPLOAD_ERR_CANT_WRITE:
63
64	throw new ProblemDetailsException([
65	"status" => INTERNAL_SERVER_ERROR,
66	"title" => "El archivo no se guardó.",
67	"type" => "/errors/archivonoguardado.html",
68	"detail" => "Por una razón desconocida, el archivo " - $parametro .
69	" no se pudo guardar en disco."
70	]);
71
72	case UPLOAD_ERR_EXTENSION:
73
74	throw new ProblemDetailsException([
75	"status" => BAD_REQUEST,
76	"title" => "Extensión no permitida.",
77	"type" => "/errors/extensionprohibida.html",
78	"detail" => "La extensión del archivo " - $parametro .
79	" no está permitida en el servidor."
80	]);
81
82	default:
83
84	throw new ProblemDetailsException([
85	"status" => INTERNAL_SERVER_ERROR,
86	"title" => "Error no identificado recuperando el archivo.",
87	"type" => "/errors/errorrecuperandoarchivo.html",
88	"detail" => "Por una razón desconocida, el archivo " - $parametro .
89	" no se pudo recuperar."
90	]);
91	}
92	} else {
93
94	return $contents;
95	}
96	} else {
97
98	throw creaArchivoNoRecibido($parametro);
99	}
100	} else {
101	return false;
102	}
103	}
104
105	function creaArchivoNoRecibido(string $parametro)
106	{
107	return new ProblemDetailsException([
108	"status" => BAD_REQUEST,
109	"title" => "Archivo no recibido.",
110	"type" => "/errors/archivonorecibido.html",
111	"detail" => "El archivo $parametro no fué recibido por el servidor."
112	]);
113	}
114

1	<?php
2
3	require_once __DIR__ . "/BAD_REQUEST.php";
4	require_once __DIR__ . "/recibeBytes.php";
5	require_once __DIR__ . "/ProblemDetailsException.php";
6
7	function recibeBytesObligatorios(string $parametro)
8	{
9	$bytes = recibeBytes($parametro);
10
11	if ($bytes === false)
12	throw new ProblemDetailsException([
13	"status" => BAD_REQUEST,
14	"title" => "Falta el valor $parametro.",
15	"type" => "/errors/faltavalor.html",
16	"detail" => "La solicitud no tiene el valor de $parametro."
17	]);
18
19	if ($bytes === "")
20	throw new ProblemDetailsException([
21	"status" => BAD_REQUEST,
22	"title" => "Archivo no seleccionado o vacío para el campo $parametro.",
23	"type" => "/errors/archivovacio.html",
24	"detail" => "Selecciona un archivo que no esté vacío en el campo $parametro."
25	]);
26
27	return $bytes;
28	}
29

1	<?php
2
3	require_once __DIR__ . "/recibeBytes.php";
4
5	function recibeBytesOpcionales(string $parametro)
6	{
7	$enteroOpcional = recibeBytes($parametro);
8	return $enteroOpcional === false ? "" : $enteroOpcional;
9	}
10

1	<?php
2
3	require_once __DIR__ . "/recibeTexto.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, devuelve 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	*/
16	function recibeEntero(string $parametro): false\|null\|int
17	{
18	$valor = recibeTexto($parametro);
19	if ($valor === false) {
20	return false;
21	} else {
22	$valor = trim($valor);
23	if ($valor === "") {
24	return null;
25	} else {
26	return (int) $valor;
27	}
28	}
29	}
30

1	<?php
2
3	require_once __DIR__ . "/BAD_REQUEST.php";
4	require_once __DIR__ . "/recibeEntero.php";
5	require_once __DIR__ . "/ProblemDetailsException.php";
6
7	function recibeEnteroObligatorio(string $parametro)
8	{
9	$entero = recibeEntero($parametro);
10
11	if ($entero === false)
12	throw new ProblemDetailsException([
13	"status" => BAD_REQUEST,
14	"title" => "Falta el valor $parametro.",
15	"type" => "/errors/faltavalor.html",
16	"detail" => "La solicitud no tiene el valor de $parametro."
17	]);
18
19	if ($entero === null)
20	throw new ProblemDetailsException([
21	"status" => BAD_REQUEST,
22	"title" => "Campo $parametro en blanco.",
23	"type" => "/errors/campoenteroenblanco.html",
24	"detail" => "Pon un número entero en el campo $parametro."
25	]);
26
27	return $entero;
28	}
29

1	<?php
2
3	require_once __DIR__ . "/recibeEntero.php";
4
5	function recibeEnteroOpcional(string $parametro)
6	{
7	$enteroOpcional = recibeEntero($parametro);
8	return $enteroOpcional === false ? null : $enteroOpcional;
9	}
10

1	<?php
2
3	/**
4	* Devuelve 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	*/
9	function recibeTexto(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

1	<?php
2
3	require_once __DIR__ . "/NOT_FOUND.php";
4	require_once __DIR__ . "/ProblemDetailsException.php";
5
6	function validaEntidadObligatoria(string $nombre, $entidad)
7	{
8
9	if ($entidad === false)
10	throw new ProblemDetailsException([
11	"status" => NOT_FOUND,
12	"title" => "Registro de $nombre no encontrado.",
13	"type" => "/errors/entidadnoencontrada.html",
14	"detail" => "No se encontró ningún registro de $nombre con el id solicitado.",
15	]);
16
17	return $entidad;
18	}
19

K. Carpeta « php »

A. php / archivo.php

B. php / archivoAgrega.php

C. php / Bd.php

D. php / producto-agrega.php

E. php / producto-elimina.php

F. php / producto-modifica.php

G. php / producto-vista-index.php

H. php / producto-vista-modifica.php

I. php / productoBusca.php

J. Carpeta « php / lib »

1. php / lib / BAD_REQUEST.php

2. php / lib / devuelveCreated.php

3. php / lib / devuelveJson.php

4. php / lib / devuelveNoContent.php

5. php / lib / devuelveResultadoNoJson.php

6. php / lib / INTERNAL_SERVER_ERROR.php

7. php / lib / manejaErrores.php

8. php / lib / NOT_FOUND.php

9. php / lib / ProblemDetailsException.php

10. php / lib / recibeBytes.php

11. php / lib / recibeBytesObligatorios.php

12. php / lib / recibeBytesOpcionales.php

13. php / lib / recibeEntero.php

14. php / lib / recibeEnteroObligatorio.php

15. php / lib / recibeEnteroOpcional.php

16. php / lib / recibeTexto.php

17. php / lib / recibeTextoObligatorio.php

18. php / lib / validaEntidadObligatoria.php