S. 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 / devuelveNoContent.php

 
  
 
 
  
1
<?php

  
2

  
3
function devuelveNoContent()

  
4
{

  
5
 http_response_code(204);

  
6
}

  
7

 


      

     

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

 


      

     

         
5. php / lib / INTERNAL_SERVER_ERROR.php

 
  
 
 
  
1
<?php

  
2

  
3
const INTERNAL_SERVER_ERROR = 500;

 


      

     

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

 


      

     

         
7. php / lib / NO_AUTORIZADO.php

 
  
 
 
  
1
<?php

  
2

  
3
const NO_AUTORIZADO = 401;

  
4

 


      

     

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

 


      

     

         
10. php / lib / recibeTextoObligatorio.php

 
  
 
 
  
1
<?php

  
2

  
3
require_once __DIR__ . "/BAD_REQUEST.php";

  
4
require_once __DIR__ . "/recibeTexto.php";

  
5
require_once __DIR__ . "/ProblemDetailsException.php";

  
6

  
7
function recibeTextoObligatorio(string $parametro)

  
8
{

  
9
 $texto = recibeTexto($parametro);

  
10

  
11
 if ($texto === 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
 $trimTexto = trim($texto);

  
20

  
21
 if ($trimTexto === "")

  
22
  throw new ProblemDetailsException([

  
23
   "status" => BAD_REQUEST,

  
24
   "title" => "Campo $parametro en blanco.",

  
25
   "type" => "/errors/campoenblanco.html",

  
26
   "detail" => "Pon texto en el campo $parametro."

  
27
  ]);

  
28

  
29
 return $trimTexto;

  
30
}

  
31

 


      

     

         
11. php / lib / rolAgrega.php

 
  
 
 
  
1
<?php

  
2

  
3
function rolAgrega(\PDO $bd, string $id, string $descripcion)

  
4
{

  
5
 $rolAgrega = $bd->prepare(

  
6
  "INSERT INTO ROL (

  
7
     ROL_ID, ROL_DESCRIPCION

  
8
    ) VALUES (

  
9
     :ROL_ID, :ROL_DESCRIPCION

  
10
    )"

  
11
 );

  
12
 $rolAgrega->execute([

  
13
  ":ROL_ID" => $id,

  
14
  ":ROL_DESCRIPCION" => $descripcion,

  
15
 ]);

  
16
}

  
17

 


      

     

         
12. php / lib / rolBusca.php

 
  
 
 
  
1
<?php

  
2

  
3
function rolBusca(\PDO $bd, string $id)

  
4
{

  
5
 $rolBusca =  $bd->prepare("SELECT * FROM ROL WHERE ROL_ID = :ROL_ID");

  
6
 $rolBusca->execute([":ROL_ID" => $id]);

  
7
 $rol = $rolBusca->fetch(PDO::FETCH_ASSOC);

  
8
 return $rol;

  
9
}

  
10

 


      

     

         
13. php / lib / rolIdsParaUsuId.php

 
  
 
 
  
1
<?php

  
2

  
3
function rolIdsParaUsuId(\PDO $bd, int $usuId)

  
4
{

  
5
 $stmt = $bd->prepare(

  
6
  "SELECT ROL_ID

  
7
   FROM USU_ROL

  
8
   WHERE USU_ID = :USU_ID

  
9
   ORDER BY USU_ID"

  
10
 );

  
11
 $stmt->execute([":USU_ID" => $usuId]);

  
12
 $rolIds = $stmt->fetchAll(PDO::FETCH_COLUMN, 0);

  
13
 return $rolIds;

  
14
}

  
15

 


      

     

         
14. php / lib / usuRolAgrega.php

 
  
 
 
  
1
<?php

  
2

  
3
function usuRolAgrega(\PDO $bd, string $usuId, array $rolIds)

  
4
{

  
5
 $usuRolAgrega = $bd->prepare(

  
6
  "INSERT INTO USU_ROL (USU_ID, ROL_ID) values (:USU_ID, :ROL_ID)"

  
7
 );

  
8
 foreach ($rolIds as $rolId) {

  
9
  $usuRolAgrega->execute([

  
10
   ":USU_ID" => $usuId,

  
11
   ":ROL_ID" => $rolId,

  
12
  ]);

  
13
 }

  
14
}

  
15