src/Validators/PatientValidator.php

   1 <?php
   2
   3 namespace OpenEMR\Validators;
   4
   5 use Particle\Validator\Validator;
   6 use Particle\Validator\Exception\InvalidValueException;
   7 use OpenEMR\Common\Uuid\UuidRegistry;
   8 use Ramsey\Uuid\Exception\InvalidUuidStringException;
   9
  10 /**
  11  * Supports Patient Record Validation.
  12  *
  13  * @package   OpenEMR
  14  * @link      http://www.open-emr.org
  15  * @author    Dixon Whitmire <dixonwh@gmail.com>
  16  * @copyright Copyright (c) 2020 Jerry Padgett <sjpadgett@gmail.com>
  17  * @copyright Copyright (c) 2020 Dixon Whitmire <dixonwh@gmail.com>
  18  * @license   https://github.com/openemr/openemr/blob/master/LICENSE GNU General Public License 3
  19  */
  20 class PatientValidator extends BaseValidator
  21 {
  22     /**
  23      * Validates that a patient UUID exists in the database
  24      */
  25     public function isExistingUuid($uuid)
  26     {
  27         try {
  28             $uuidLookup = UuidRegistry::uuidToBytes($uuid);
  29         } catch (InvalidUuidStringException $e) {
  30             return false;
  31         }
  32
  33         $result = sqlQuery(
  34             'SELECT uuid AS uuid FROM patient_data WHERE uuid = ?',
  35             array($uuidLookup)
  36         );
  37
  38         $existingUuid = $result['uuid'] ?? null;
  39         return $existingUuid != null;
  40     }
  41
  42     /**
  43      * Configures validations for the Patient DB Insert and Update use-case.
  44      * The update use-case is comprised of the same fields as the insert use-case.
  45      * The update use-case differs from the insert use-case in that fields other than pid are not required.
  46      */
  47     protected function configureValidator()
  48     {
  49         parent::configureValidator();
  50
  51         // insert validations
  52         $this->validator->context(
  53             self::DATABASE_INSERT_CONTEXT,
  54             function (Validator $context) {
  55                 $context->required("fname", "First Name")->lengthBetween(2, 255);
  56                 $context->required("lname", 'Last Name')->lengthBetween(2, 255);
  57                 $context->required("sex", 'Gender')->lengthBetween(4, 30);
  58                 $context->required("DOB", 'Date of Birth')->datetime('Y-m-d');
  59             }
  60         );
  61
  62         // update validations copied from insert
  63         $this->validator->context(
  64             self::DATABASE_UPDATE_CONTEXT,
  65             function (Validator $context) {
  66                 $context->copyContext(
  67                     self::DATABASE_INSERT_CONTEXT,
  68                     function ($rules) {
  69                         foreach ($rules as $key => $chain) {
  70                             $chain->required(false);
  71                         }
  72                     }
  73                 );
  74                 // additional uuid validations
  75                 $context->required("uuid", "uuid")->callback(function ($value) {
  76                     if (!$this->isExistingUuid($value)) {
  77                         $message = "UUID " . $value . " does not exist";
  78                         throw new InvalidValueException($message, $value);
  79                     }
  80                     return true;
  81                 })->string();
  82             }
  83         );
  84     }
  85 }