Search code examples
phplaravellaravel-5error-messaging

How to get all possible error messages of a Laravel Controller method


So I have a Laravel Application, which has many Controllers to handle various aspects of the applications.

Now each controller has various methods. Most of the methods have validations rules defined such as:

$validationArray = [
    'id'=>'required|integer',
    'status'=>'required|string'
];
$validator = Validator::make($request->all(),$validationArray);
if ($validator->fails()){
    return Response::json(['response'=>implode(', ',$validator->messages()->all())],422);
}

Now the following line:

return Response::json(['response'=>implode(', ',$validator->messages()->all())],422);

actually returns whatever is wrong with the validation rules.

My question is: Is there any way to get all possible error messages programmatically?

Of course, one way to do it is going around the rule by rule and make a list manually but there are hundreds of the methods scattered over various controllers.

So, if anyone could point me in the direction of taking all the error messages in some easier way, would be much appreciated.

Thank you in advance!

UPDATE

So to clear further I need a list of all possible errors, like for above code the list will be like:

['id is required', 'id must be an integer', 'status is required', 'status must be an string']

UPDATE 2

Please keep in mind that there are hundreds of methods and also I do not want to change the final response of the method but to have some sort of external script which can help me getting the error messages without interfering with the controllers much.


Solution

  • In order to do that you have to extend Validator class and write a method that will iterate all rules and explicitly add error messages as if they failed.

    First, create a new file app\Http\Custom\Validator.php:

    <?php
    
    namespace App\Http\Custom;
    
    use Illuminate\Contracts\Validation\Rule as RuleContract;
    use Illuminate\Support\MessageBag;
    use Illuminate\Validation\ValidationRuleParser;
    use Illuminate\Validation\Validator as BaseValidator;
    
    class Validator extends BaseValidator {
    
      /** @var MessageBag */
      protected $errorMessages;
    
      /** @var array */
      protected $hasExplicitFileErrorMessage;
    
      protected $explicitFileRules = [
        'File', 'Image', 'Mimes', 'Mimetypes', 'Dimensions',
      ];
    
      function availableErrors()
      {
        $this->errorMessages = new MessageBag();
        $this->hasExplicitFileErrorMessage = [];
    
        foreach($this->rules as $attribute => $rules) {
          $attribute = str_replace('\.', '->', $attribute);
          foreach($rules as $rule) {
            [$rule, $parameters] = ValidationRuleParser::parse($rule);
    
            if($rule == '') {
              continue;
            }
            if(($keys = $this->getExplicitKeys($attribute)) &&
              $this->dependsOnOtherFields($rule)) {
              $parameters = $this->replaceAsterisksInParameters($parameters, $keys);
            }
            // explicitly add "failed to upload" error
            if($this->hasRule($attribute, $this->explicitFileRules) && !in_array($attribute, $this->hasExplicitFileErrorMessage)) {
              $this->addFailureMessage($attribute, 'uploaded', []);
              $this->hasExplicitFileErrorMessage[] = $attribute;
            }
    
            if($rule instanceof RuleContract) {
              $messages = $rule->message() ? (array)$rule->message() : [get_class($rule)];
              foreach($messages as $message) {
                $this->addFailureMessage($attribute, get_class($rule), [], $message);
              }
            } else {
              $this->addFailureMessage($attribute, $rule, $parameters);
            }
          }
        }
    
        return $this->errorMessages->all();
      }
    
      function addFailureMessage($attribute, $rule, $parameters = [], $rawMessage = null)
      {
        $this->errorMessages->add($attribute, $this->makeReplacements(
          $rawMessage ?? $this->getMessage($attribute, $rule), $attribute, $rule, $parameters
        ));
      }
    
      // we have to override this method since file-type errors depends on data value rather than rule type
      protected function getAttributeType($attribute)
      {
        if($this->hasRule($attribute, $this->explicitFileRules)) {
          return 'file';
        }
        return parent::getAttributeType($attribute);
      }
    }
    

    Next, let's register this class in Validation factory:

    <?php
    
    namespace App\Providers;
    
    use App\Http\Custom\Validator; // <-- our custom validator
    use Illuminate\Support\ServiceProvider;
    
    class AppServiceProvider extends ServiceProvider {
    
      public function boot()
      {
        app('validator')->resolver(function ($translator, $data, $rules, $messages) {
          return new Validator($translator, $data, $rules, $messages);
        });
      }
    
    }
    

    And... that's all. Let's test it:

    <?php
    
    namespace App\Http\Controllers;
    
    use Illuminate\Http\Request;
    use Illuminate\Support\Facades\Validator;
    
    class HomeController extends Controller {
    
      function index(Request $request)
      {
        $rules = [
          'id'      => 'required|int|between:2,10',
          'status'  => 'required_with:nonexisting|string|email',
          'avatar'  => 'required|file|mimes:png|max:1000',
          'company' => 'required_without:id|unique:companies,id'
        ];
    
        $validator = Validator::make([], $rules);
    
        dump($validator->availableErrors());
      }
    
    }
    
    array:13 [▼
      0 => "The id field is required."
      1 => "The id must be an integer."
      2 => "The id must be between 2 and 10."
      3 => "The status field is required when nonexisting is present."
      4 => "The status must be a string."
      5 => "The status must be a valid email address."
      6 => "The avatar failed to upload."
      7 => "The avatar field is required."
      8 => "The avatar must be a file."
      9 => "The avatar must be a file of type: png."
      10 => "The avatar may not be greater than 1000 kilobytes."
      11 => "The company field is required when id is not present."
      12 => "The company has already been taken."
    ]