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

 
  
 
 
  
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

 


      

     

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

 


      

     

         
4. php / lib / devuelveNoContent.php

 
  
 
 
  
1
<?php

  
2

  
3
function devuelveNoContent()

  
4
{

  
5
 http_response_code(204);

  
6
}

  
7

 


      

     

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

 


      

     

         
6. php / lib / INTERNAL_SERVER_ERROR.php

 
  
 
 
  
1
<?php

  
2

  
3
const INTERNAL_SERVER_ERROR = 500;

 


      

     

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

 


      

     

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

 


      

     

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