I. Carpeta « php »

Versión para imprimir.

A. php / valida.php

1
<?php
2

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

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

  
5
require_once __DIR__ . "/lib/recibeTexto.php";

  
6
require_once __DIR__ . "/lib/ProblemDetailsException.php";

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

  
8

  
9
$saludo = recibeTexto("saludo");

  
10
$nombre = recibeTexto("nombre");

  
11

  
12
if (

  
13
 $saludo === false

  
14
 || $saludo === ""

  
15
)

  
16
 throw new ProblemDetailsException([

  
17
  "status" => BAD_REQUEST,

  
18
  "title" => "Falta el saludo.",

  
19
  "type" => "/erros/faltasaludo.html"

  
20
 ]);

  
21

  
22
if (

  
23
 $nombre === false

  
24
 || $nombre === ""

  
25
)

  
26
 throw new ProblemDetailsException([

  
27
  "status" => BAD_REQUEST,

  
28
  "title" => "Falta el nombre.",

  
29
  "type" => "/errors/faltanombre.html"

  
30
 ]);

  
31

  
32
$resultado = "{$saludo} {$nombre}.";

  
33

  
34
devuelveJson($resultado);

  
35

 


      

     

         
B. 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 / 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

 


      

     

         
3. 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

 


      

     

         
4. php / lib / INTERNAL_SERVER_ERROR.php

 
  
 
 
  
1
<?php

  
2

  
3
const INTERNAL_SERVER_ERROR = 500;

 


      

     

         
5. 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

 


      

     

         
6. 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

 


      

     

         
7. php / lib / recibeJson.php

 
  
 
 
  
1
<?php

  
2

  
3
require_once __DIR__ . "/BAD_REQUEST.php";

  
4

  
5
function recibeJson()

  
6
{

  
7
 $json = json_decode(file_get_contents("php://input"));

  
8

  
9
 if ($json === null) {

  
10

  
11
  http_response_code(BAD_REQUEST);

  
12
  header("Content-Type: application/problem+json; charset=utf-8");

  
13

  
14
  echo '{' .

  
15
   "status: " . BAD_REQUEST .

  
16
   '"title": "Los datos recibidos no están en formato JSON."' .

  
17
   '"type": "/errors/datosnojson.html"' .

  
18
   '}';

  
19

  
20
  exit();

  
21
 }

  
22

  
23
 return $json;

  
24
}

  
25

 


      

     

         
8. php / lib / recibeTexto.php

 
  
 
 
  
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