G. Carpeta « php »

Versión para imprimir.

A. php / render.php

1
<?php
2

  
3
require_once __DIR__ . "/lib/manejaErrores.php";

  
4
require_once __DIR__ . "/lib/devuelveJson.php";

  
5

  
6
$lista = [

  
7
 [

  
8
  "nombre" => "pp",

  
9
  "color" => "azul"

  
10
 ],

  
11
 [

  
12
  "nombre" => "qk",

  
13
  "color" => "rojo"

  
14
 ],

  
15
 [

  
16
  "nombre" => "tt",

  
17
  "color" => "rosa"

  
18
 ],

  
19
 [

  
20
  "nombre" => "bb",

  
21
  "color" => "azul"

  
22
 ]

  
23
];

  
24

  
25
// Genera el código HTML de la lista.

  
26
$render = "";

  
27
foreach ($lista as $modelo) {

  
28
 /* Codifica nombre y color para que cambie los caracteres

  
29
   * especiales y el texto no se pueda interpretar como HTML.

  
30
   * Esta técnica evita la inyección de código. */

  
31
 $nombre = htmlentities($modelo["nombre"]);

  
32
 $color = htmlentities($modelo["color"]);

  
33
 $render .=

  
34
  "<dt>{$nombre}</dt>

  
35
    <dd>{$color}</dd>";

  
36
}

  
37

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

  
39

 


      

     

         
B. Carpeta « php / lib »

   
 
    

     Versión para imprimir.
    

   


  

   
  

     

         
1. php / lib / devuelveJson.php

 
  
 
 
  
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

 


      

     

         
2. php / lib / devuelveResultadoNoJson.php

 
  
 
 
  
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

 


      

     

         
3. php / lib / INTERNAL_SERVER_ERROR.php

 
  
 
 
  
1
<?php

  
2

  
3
const INTERNAL_SERVER_ERROR = 500;

 


      

     

         
4. php / lib / manejaErrores.php

 
  
 
 
  
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

 


      

     

         
5. php / lib / ProblemDetailsException.php

 
  
 
 
  
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