validator.php 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068
  1. <?php namespace Laravel; use Closure;
  2. class Validator {
  3. /**
  4. * The array being validated.
  5. *
  6. * @var array
  7. */
  8. public $attributes;
  9. /**
  10. * The post-validation error messages.
  11. *
  12. * @var Messages
  13. */
  14. public $errors;
  15. /**
  16. * The validation rules.
  17. *
  18. * @var array
  19. */
  20. protected $rules = array();
  21. /**
  22. * The validation messages.
  23. *
  24. * @var array
  25. */
  26. protected $messages = array();
  27. /**
  28. * The database connection that should be used by the validator.
  29. *
  30. * @var Database\Connection
  31. */
  32. protected $db;
  33. /**
  34. * The bundle for which the validation is being run.
  35. *
  36. * @var string
  37. */
  38. protected $bundle = DEFAULT_BUNDLE;
  39. /**
  40. * The language that should be used when retrieving error messages.
  41. *
  42. * @var string
  43. */
  44. protected $language;
  45. /**
  46. * The size related validation rules.
  47. *
  48. * @var array
  49. */
  50. protected $size_rules = array('size', 'between', 'min', 'max');
  51. /**
  52. * The numeric related validation rules.
  53. *
  54. * @var array
  55. */
  56. protected $numeric_rules = array('numeric', 'integer');
  57. /**
  58. * The registered custom validators.
  59. *
  60. * @var array
  61. */
  62. protected static $validators = array();
  63. /**
  64. * Create a new validator instance.
  65. *
  66. * @param array $attributes
  67. * @param array $rules
  68. * @param array $messages
  69. * @return void
  70. */
  71. public function __construct($attributes, $rules, $messages = array())
  72. {
  73. foreach ($rules as $key => &$rule)
  74. {
  75. $rule = (is_string($rule)) ? explode('|', $rule) : $rule;
  76. }
  77. $this->rules = $rules;
  78. $this->messages = $messages;
  79. $this->attributes = $attributes;
  80. }
  81. /**
  82. * Create a new validator instance.
  83. *
  84. * @param array $attributes
  85. * @param array $rules
  86. * @param array $messages
  87. * @return Validator
  88. */
  89. public static function make($attributes, $rules, $messages = array())
  90. {
  91. return new static($attributes, $rules, $messages);
  92. }
  93. /**
  94. * Register a custom validator.
  95. *
  96. * @param string $name
  97. * @param Closure $validator
  98. * @return void
  99. */
  100. public static function register($name, $validator)
  101. {
  102. static::$validators[$name] = $validator;
  103. }
  104. /**
  105. * Validate the target array using the specified validation rules.
  106. *
  107. * @return bool
  108. */
  109. public function passes()
  110. {
  111. return $this->valid();
  112. }
  113. /**
  114. * Validate the target array using the specified validation rules.
  115. *
  116. * @return bool
  117. */
  118. public function fails()
  119. {
  120. return $this->invalid();
  121. }
  122. /**
  123. * Validate the target array using the specified validation rules.
  124. *
  125. * @return bool
  126. */
  127. public function invalid()
  128. {
  129. return ! $this->valid();
  130. }
  131. /**
  132. * Validate the target array using the specified validation rules.
  133. *
  134. * @return bool
  135. */
  136. public function valid()
  137. {
  138. $this->errors = new Messages;
  139. foreach ($this->rules as $attribute => $rules)
  140. {
  141. foreach ($rules as $rule) $this->check($attribute, $rule);
  142. }
  143. return count($this->errors->messages) == 0;
  144. }
  145. /**
  146. * Evaluate an attribute against a validation rule.
  147. *
  148. * @param string $attribute
  149. * @param string $rule
  150. * @return void
  151. */
  152. protected function check($attribute, $rule)
  153. {
  154. list($rule, $parameters) = $this->parse($rule);
  155. $value = array_get($this->attributes, $attribute);
  156. // Before running the validator, we need to verify that the attribute and rule
  157. // combination is actually validatable. Only the "accepted" rule implies that
  158. // the attribute is "required", so if the attribute does not exist, the other
  159. // rules will not be run for the attribute.
  160. $validatable = $this->validatable($rule, $attribute, $value);
  161. if ($validatable and ! $this->{'validate_'.$rule}($attribute, $value, $parameters, $this))
  162. {
  163. $this->error($attribute, $rule, $parameters);
  164. }
  165. }
  166. /**
  167. * Determine if an attribute is validatable.
  168. *
  169. * To be considered validatable, the attribute must either exist, or the rule
  170. * being checked must implicitly validate "required", such as the "required"
  171. * rule or the "accepted" rule.
  172. *
  173. * @param string $rule
  174. * @param string $attribute
  175. * @param mixed $value
  176. * @return bool
  177. */
  178. protected function validatable($rule, $attribute, $value)
  179. {
  180. return $this->validate_required($attribute, $value) or $this->implicit($rule);
  181. }
  182. /**
  183. * Determine if a given rule implies that the attribute is required.
  184. *
  185. * @param string $rule
  186. * @return bool
  187. */
  188. protected function implicit($rule)
  189. {
  190. return $rule == 'required' or $rule == 'accepted';
  191. }
  192. /**
  193. * Add an error message to the validator's collection of messages.
  194. *
  195. * @param string $attribute
  196. * @param string $rule
  197. * @param array $parameters
  198. * @return void
  199. */
  200. protected function error($attribute, $rule, $parameters)
  201. {
  202. $message = $this->replace($this->message($attribute, $rule), $attribute, $rule, $parameters);
  203. $this->errors->add($attribute, $message);
  204. }
  205. /**
  206. * Validate that a required attribute exists in the attributes array.
  207. *
  208. * @param string $attribute
  209. * @param mixed $value
  210. * @return bool
  211. */
  212. protected function validate_required($attribute, $value)
  213. {
  214. if (is_null($value))
  215. {
  216. return false;
  217. }
  218. elseif (is_string($value) and trim($value) === '')
  219. {
  220. return false;
  221. }
  222. elseif ( ! is_null(Input::file($attribute)) and $value['tmp_name'] == '')
  223. {
  224. return false;
  225. }
  226. return true;
  227. }
  228. /**
  229. * Validate that an attribute has a matching confirmation attribute.
  230. *
  231. * @param string $attribute
  232. * @param mixed $value
  233. * @return bool
  234. */
  235. protected function validate_confirmed($attribute, $value)
  236. {
  237. return $this->validate_same($attribute, $value, array($attribute.'_confirmation'));
  238. }
  239. /**
  240. * Validate that an attribute was "accepted".
  241. *
  242. * This validation rule implies the attribute is "required".
  243. *
  244. * @param string $attribute
  245. * @param mixed $value
  246. * @return bool
  247. */
  248. protected function validate_accepted($attribute, $value)
  249. {
  250. return $this->validate_required($attribute, $value) and ($value == 'yes' or $value == '1');
  251. }
  252. /**
  253. * Validate that an attribute is the same as another attribute.
  254. *
  255. * @param string $attribute
  256. * @param mixed $value
  257. * @param array $parameters
  258. * @return bool
  259. */
  260. protected function validate_same($attribute, $value, $parameters)
  261. {
  262. $other = $parameters[0];
  263. return isset($this->attributes[$other]) and $value == $this->attributes[$other];
  264. }
  265. /**
  266. * Validate that an attribute is different from another attribute.
  267. *
  268. * @param string $attribute
  269. * @param mixed $value
  270. * @param array $parameters
  271. * @return bool
  272. */
  273. protected function validate_different($attribute, $value, $parameters)
  274. {
  275. $other = $parameters[0];
  276. return isset($this->attributes[$other]) and $value != $this->attributes[$other];
  277. }
  278. /**
  279. * Validate that an attribute is numeric.
  280. *
  281. * @param string $attribute
  282. * @param mixed $value
  283. * @return bool
  284. */
  285. protected function validate_numeric($attribute, $value)
  286. {
  287. return is_numeric($value);
  288. }
  289. /**
  290. * Validate that an attribute is an integer.
  291. *
  292. * @param string $attribute
  293. * @param mixed $value
  294. * @return bool
  295. */
  296. protected function validate_integer($attribute, $value)
  297. {
  298. return filter_var($value, FILTER_VALIDATE_INT) !== false;
  299. }
  300. /**
  301. * Validate the size of an attribute.
  302. *
  303. * @param string $attribute
  304. * @param mixed $value
  305. * @param array $parameters
  306. * @return bool
  307. */
  308. protected function validate_size($attribute, $value, $parameters)
  309. {
  310. return $this->size($attribute, $value) == $parameters[0];
  311. }
  312. /**
  313. * Validate the size of an attribute is between a set of values.
  314. *
  315. * @param string $attribute
  316. * @param mixed $value
  317. * @param array $parameters
  318. * @return bool
  319. */
  320. protected function validate_between($attribute, $value, $parameters)
  321. {
  322. $size = $this->size($attribute, $value);
  323. return $size >= $parameters[0] and $size <= $parameters[1];
  324. }
  325. /**
  326. * Validate the size of an attribute is greater than a minimum value.
  327. *
  328. * @param string $attribute
  329. * @param mixed $value
  330. * @param array $parameters
  331. * @return bool
  332. */
  333. protected function validate_min($attribute, $value, $parameters)
  334. {
  335. return $this->size($attribute, $value) >= $parameters[0];
  336. }
  337. /**
  338. * Validate the size of an attribute is less than a maximum value.
  339. *
  340. * @param string $attribute
  341. * @param mixed $value
  342. * @param array $parameters
  343. * @return bool
  344. */
  345. protected function validate_max($attribute, $value, $parameters)
  346. {
  347. return $this->size($attribute, $value) <= $parameters[0];
  348. }
  349. /**
  350. * Get the size of an attribute.
  351. *
  352. * @param string $attribute
  353. * @param mixed $value
  354. * @return mixed
  355. */
  356. protected function size($attribute, $value)
  357. {
  358. // This method will determine if the attribute is a number, string, or file and
  359. // return the proper size accordingly. If it is a number, then number itself is
  360. // the size; if it is a file, the size is kilobytes in the size; if it is a
  361. // string, the length is the size.
  362. if (is_numeric($value) and $this->has_rule($attribute, $this->numeric_rules))
  363. {
  364. return $this->attributes[$attribute];
  365. }
  366. elseif (array_key_exists($attribute, Input::file()))
  367. {
  368. return $value['size'] / 1024;
  369. }
  370. else
  371. {
  372. return Str::length(trim($value));
  373. }
  374. }
  375. /**
  376. * Validate an attribute is contained within a list of values.
  377. *
  378. * @param string $attribute
  379. * @param mixed $value
  380. * @param array $parameters
  381. * @return bool
  382. */
  383. protected function validate_in($attribute, $value, $parameters)
  384. {
  385. return in_array($value, $parameters);
  386. }
  387. /**
  388. * Validate an attribute is not contained within a list of values.
  389. *
  390. * @param string $attribute
  391. * @param mixed $value
  392. * @param array $parameters
  393. * @return bool
  394. */
  395. protected function validate_not_in($attribute, $value, $parameters)
  396. {
  397. return ! in_array($value, $parameters);
  398. }
  399. /**
  400. * Validate the uniqueness of an attribute value on a given database table.
  401. *
  402. * If a database column is not specified, the attribute will be used.
  403. *
  404. * @param string $attribute
  405. * @param mixed $value
  406. * @param array $parameters
  407. * @return bool
  408. */
  409. protected function validate_unique($attribute, $value, $parameters)
  410. {
  411. // We allow the table column to be specified just in case the column does
  412. // not have the same name as the attribute. It must be within the second
  413. // parameter position, right after the database table name.
  414. if (isset($parameters[1]))
  415. {
  416. $attribute = $parameters[1];
  417. }
  418. $query = $this->db()->table($parameters[0])->where($attribute, '=', $value);
  419. // We also allow an ID to be specified that will not be included in the
  420. // uniqueness check. This makes updating columns easier since it is
  421. // fine for the given ID to exist in the table.
  422. if (isset($parameters[2]))
  423. {
  424. $id = (isset($parameters[3])) ? $parameters[3] : 'id';
  425. $query->where($id, '<>', $parameters[2]);
  426. }
  427. return $query->count() == 0;
  428. }
  429. /**
  430. * Validate the existence of an attribute value in a database table.
  431. *
  432. * @param string $attribute
  433. * @param mixed $value
  434. * @param array $parameters
  435. * @return bool
  436. */
  437. protected function validate_exists($attribute, $value, $parameters)
  438. {
  439. if (isset($parameters[1])) $attribute = $parameters[1];
  440. // Grab the number of elements we are looking for. If the given value is
  441. // in array, we'll count all of the values in the array, otherwise we
  442. // can just make sure the count is greater or equal to one.
  443. $count = (is_array($value)) ? count($value) : 1;
  444. $query = $this->db()->table($parameters[0]);
  445. // If the given value is an array, we will check for the existence of
  446. // all the values in the database, otherwise we'll check for the
  447. // presence of the single given value in the database.
  448. if (is_array($value))
  449. {
  450. $query = $query->where_in($attribute, $value);
  451. }
  452. else
  453. {
  454. $query = $query->where($attribute, '=', $value);
  455. }
  456. return $query->count() >= $count;
  457. }
  458. /**
  459. * Validate that an attribute is a valid IP.
  460. *
  461. * @param string $attribute
  462. * @param mixed $value
  463. * @return bool
  464. */
  465. protected function validate_ip($attribute, $value)
  466. {
  467. return filter_var($value, FILTER_VALIDATE_IP) !== false;
  468. }
  469. /**
  470. * Validate that an attribute is a valid e-mail address.
  471. *
  472. * @param string $attribute
  473. * @param mixed $value
  474. * @return bool
  475. */
  476. protected function validate_email($attribute, $value)
  477. {
  478. return filter_var($value, FILTER_VALIDATE_EMAIL) !== false;
  479. }
  480. /**
  481. * Validate that an attribute is a valid URL.
  482. *
  483. * @param string $attribute
  484. * @param mixed $value
  485. * @return bool
  486. */
  487. protected function validate_url($attribute, $value)
  488. {
  489. return filter_var($value, FILTER_VALIDATE_URL) !== false;
  490. }
  491. /**
  492. * Validate that an attribute is an active URL.
  493. *
  494. * @param string $attribute
  495. * @param mixed $value
  496. * @return bool
  497. */
  498. protected function validate_active_url($attribute, $value)
  499. {
  500. $url = str_replace(array('http://', 'https://', 'ftp://'), '', Str::lower($value));
  501. return checkdnsrr($url);
  502. }
  503. /**
  504. * Validate the MIME type of a file is an image MIME type.
  505. *
  506. * @param string $attribute
  507. * @param mixed $value
  508. * @return bool
  509. */
  510. protected function validate_image($attribute, $value)
  511. {
  512. return $this->validate_mimes($attribute, $value, array('jpg', 'png', 'gif', 'bmp'));
  513. }
  514. /**
  515. * Validate that an attribute contains only alphabetic characters.
  516. *
  517. * @param string $attribute
  518. * @param mixed $value
  519. * @return bool
  520. */
  521. protected function validate_alpha($attribute, $value)
  522. {
  523. return preg_match('/^([a-z])+$/i', $value);
  524. }
  525. /**
  526. * Validate that an attribute contains only alpha-numeric characters.
  527. *
  528. * @param string $attribute
  529. * @param mixed $value
  530. * @return bool
  531. */
  532. protected function validate_alpha_num($attribute, $value)
  533. {
  534. return preg_match('/^([a-z0-9])+$/i', $value);
  535. }
  536. /**
  537. * Validate that an attribute contains only alpha-numeric characters, dashes, and underscores.
  538. *
  539. * @param string $attribute
  540. * @param mixed $value
  541. * @return bool
  542. */
  543. protected function validate_alpha_dash($attribute, $value)
  544. {
  545. return preg_match('/^([-a-z0-9_-])+$/i', $value);
  546. }
  547. /**
  548. * Validate that an attribute passes a regular expression check.
  549. *
  550. * @param string $attribute
  551. * @param mixed $value
  552. * @return bool
  553. */
  554. protected function validate_match($attribute, $value, $parameters)
  555. {
  556. return preg_match($parameters[0], $value);
  557. }
  558. /**
  559. * Validate the MIME type of a file upload attribute is in a set of MIME types.
  560. *
  561. * @param string $attribute
  562. * @param array $value
  563. * @param array $parameters
  564. * @return bool
  565. */
  566. protected function validate_mimes($attribute, $value, $parameters)
  567. {
  568. if ( ! is_array($value) or array_get($value, 'tmp_name', '') == '') return true;
  569. foreach ($parameters as $extension)
  570. {
  571. if (File::is($extension, $value['tmp_name']))
  572. {
  573. return true;
  574. }
  575. }
  576. return false;
  577. }
  578. /**
  579. * Validate the date is before a given date.
  580. *
  581. * @param string $attribute
  582. * @param mixed $value
  583. * @param array $parameters
  584. * @return bool
  585. */
  586. protected function validate_before($attribute, $value, $parameters)
  587. {
  588. return (strtotime($value) < strtotime($parameters[0]));
  589. }
  590. /**
  591. * Validate the date is after a given date.
  592. *
  593. * @param string $attribute
  594. * @param mixed $value
  595. * @param array $parameters
  596. * @return bool
  597. */
  598. protected function validate_after($attribute, $value, $parameters)
  599. {
  600. return (strtotime($value) > strtotime($parameters[0]));
  601. }
  602. /**
  603. * Get the proper error message for an attribute and rule.
  604. *
  605. * @param string $attribute
  606. * @param string $rule
  607. * @return string
  608. */
  609. protected function message($attribute, $rule)
  610. {
  611. $bundle = Bundle::prefix($this->bundle);
  612. // First we'll check for developer specified, attribute specific messages.
  613. // These messages take first priority. They allow the fine-grained tuning
  614. // of error messages for each rule.
  615. $custom = $attribute.'_'.$rule;
  616. if (array_key_exists($custom, $this->messages))
  617. {
  618. return $this->messages[$custom];
  619. }
  620. elseif (Lang::has($custom = "{$bundle}validation.custom.{$custom}", $this->language))
  621. {
  622. return Lang::line($custom)->get($this->language);
  623. }
  624. // Next we'll check for developer specified, rule specific error messages.
  625. // These allow the developer to override the error message for an entire
  626. // rule, regardless of the attribute being validated by that rule.
  627. elseif (array_key_exists($rule, $this->messages))
  628. {
  629. return $this->messages[$rule];
  630. }
  631. // If the rule being validated is a "size" rule, we will need to gather
  632. // the specific size message for the type of attribute being validated,
  633. // either a number, file, or string.
  634. elseif (in_array($rule, $this->size_rules))
  635. {
  636. return $this->size_message($bundle, $attribute, $rule);
  637. }
  638. // If no developer specified messages have been set, and no other special
  639. // messages apply to the rule, we will just pull the default validation
  640. // message from the validation language file.
  641. else
  642. {
  643. $line = "{$bundle}validation.{$rule}";
  644. return Lang::line($line)->get($this->language);
  645. }
  646. }
  647. /**
  648. * Get the proper error message for an attribute and size rule.
  649. *
  650. * @param string $bundle
  651. * @param string $attribute
  652. * @param string $rule
  653. * @return string
  654. */
  655. protected function size_message($bundle, $attribute, $rule)
  656. {
  657. // There are three different types of size validations. The attribute
  658. // may be either a number, file, or a string, so we'll check a few
  659. // things to figure out which one it is.
  660. if ($this->has_rule($attribute, $this->numeric_rules))
  661. {
  662. $line = 'numeric';
  663. }
  664. // We assume that attributes present in the $_FILES array are files,
  665. // which makes sense. If the attribute doesn't have numeric rules
  666. // and isn't as file, it's a string.
  667. elseif (array_key_exists($attribute, Input::file()))
  668. {
  669. $line = 'file';
  670. }
  671. else
  672. {
  673. $line = 'string';
  674. }
  675. return Lang::line("{$bundle}validation.{$rule}.{$line}")->get($this->language);
  676. }
  677. /**
  678. * Replace all error message place-holders with actual values.
  679. *
  680. * @param string $message
  681. * @param string $attribute
  682. * @param string $rule
  683. * @param array $parameters
  684. * @return string
  685. */
  686. protected function replace($message, $attribute, $rule, $parameters)
  687. {
  688. $message = str_replace(':attribute', $this->attribute($attribute), $message);
  689. if (method_exists($this, $replacer = 'replace_'.$rule))
  690. {
  691. $message = $this->$replacer($message, $attribute, $rule, $parameters);
  692. }
  693. return $message;
  694. }
  695. /**
  696. * Replace all place-holders for the between rule.
  697. *
  698. * @param string $message
  699. * @param string $attribute
  700. * @param string $rule
  701. * @param array $parameters
  702. * @return string
  703. */
  704. protected function replace_between($message, $attribute, $rule, $parameters)
  705. {
  706. return str_replace(array(':min', ':max'), $parameters, $message);
  707. }
  708. /**
  709. * Replace all place-holders for the size rule.
  710. *
  711. * @param string $message
  712. * @param string $attribute
  713. * @param string $rule
  714. * @param array $parameters
  715. * @return string
  716. */
  717. protected function replace_size($message, $attribute, $rule, $parameters)
  718. {
  719. return str_replace(':size', $parameters[0], $message);
  720. }
  721. /**
  722. * Replace all place-holders for the min rule.
  723. *
  724. * @param string $message
  725. * @param string $attribute
  726. * @param string $rule
  727. * @param array $parameters
  728. * @return string
  729. */
  730. protected function replace_min($message, $attribute, $rule, $parameters)
  731. {
  732. return str_replace(':min', $parameters[0], $message);
  733. }
  734. /**
  735. * Replace all place-holders for the max rule.
  736. *
  737. * @param string $message
  738. * @param string $attribute
  739. * @param string $rule
  740. * @param array $parameters
  741. * @return string
  742. */
  743. protected function replace_max($message, $attribute, $rule, $parameters)
  744. {
  745. return str_replace(':max', $parameters[0], $message);
  746. }
  747. /**
  748. * Replace all place-holders for the in rule.
  749. *
  750. * @param string $message
  751. * @param string $attribute
  752. * @param string $rule
  753. * @param array $parameters
  754. * @return string
  755. */
  756. protected function replace_in($message, $attribute, $rule, $parameters)
  757. {
  758. return str_replace(':values', implode(', ', $parameters), $message);
  759. }
  760. /**
  761. * Replace all place-holders for the not_in rule.
  762. *
  763. * @param string $message
  764. * @param string $attribute
  765. * @param string $rule
  766. * @param array $parameters
  767. * @return string
  768. */
  769. protected function replace_not_in($message, $attribute, $rule, $parameters)
  770. {
  771. return str_replace(':values', implode(', ', $parameters), $message);
  772. }
  773. /**
  774. * Replace all place-holders for the not_in rule.
  775. *
  776. * @param string $message
  777. * @param string $attribute
  778. * @param string $rule
  779. * @param array $parameters
  780. * @return string
  781. */
  782. protected function replace_mimes($message, $attribute, $rule, $parameters)
  783. {
  784. return str_replace(':values', implode(', ', $parameters), $message);
  785. }
  786. /**
  787. * Replace all place-holders for the same rule.
  788. *
  789. * @param string $message
  790. * @param string $attribute
  791. * @param string $rule
  792. * @param array $parameters
  793. * @return string
  794. */
  795. protected function replace_same($message, $attribute, $rule, $parameters)
  796. {
  797. return str_replace(':other', $parameters[0], $message);
  798. }
  799. /**
  800. * Replace all place-holders for the different rule.
  801. *
  802. * @param string $message
  803. * @param string $attribute
  804. * @param string $rule
  805. * @param array $parameters
  806. * @return string
  807. */
  808. protected function replace_different($message, $attribute, $rule, $parameters)
  809. {
  810. return str_replace(':other', $parameters[0], $message);
  811. }
  812. /**
  813. * Replace all place-holders for the before rule.
  814. *
  815. * @param string $message
  816. * @param string $attribute
  817. * @param string $rule
  818. * @param array $parameters
  819. * @return string
  820. */
  821. protected function replace_before($message, $attribute, $rule, $parameters)
  822. {
  823. return str_replace(':date', $parameters[0], $message);
  824. }
  825. /**
  826. * Replace all place-holders for the after rule.
  827. *
  828. * @param string $message
  829. * @param string $attribute
  830. * @param string $rule
  831. * @param array $parameters
  832. * @return string
  833. */
  834. protected function replace_after($message, $attribute, $rule, $parameters)
  835. {
  836. return str_replace(':date', $parameters[0], $message);
  837. }
  838. /**
  839. * Get the displayable name for a given attribute.
  840. *
  841. * @param string $attribute
  842. * @return string
  843. */
  844. protected function attribute($attribute)
  845. {
  846. $bundle = Bundle::prefix($this->bundle);
  847. // More reader friendly versions of the attribute names may be stored
  848. // in the validation language file, allowing a more readable version
  849. // of the attribute name in the message.
  850. $line = "{$bundle}validation.attributes.{$attribute}";
  851. $display = Lang::line($line)->get($this->language);
  852. // If no language line has been specified for the attribute, all of
  853. // the underscores are removed from the attribute name and that
  854. // will be used as the attribtue name.
  855. if (is_null($display))
  856. {
  857. return str_replace('_', ' ', $attribute);
  858. }
  859. return $display;
  860. }
  861. /**
  862. * Determine if an attribute has a rule assigned to it.
  863. *
  864. * @param string $attribute
  865. * @param array $rules
  866. * @return bool
  867. */
  868. protected function has_rule($attribute, $rules)
  869. {
  870. foreach ($this->rules[$attribute] as $rule)
  871. {
  872. list($rule, $parameters) = $this->parse($rule);
  873. if (in_array($rule, $rules)) return true;
  874. }
  875. return false;
  876. }
  877. /**
  878. * Extract the rule name and parameters from a rule.
  879. *
  880. * @param string $rule
  881. * @return array
  882. */
  883. protected function parse($rule)
  884. {
  885. $parameters = array();
  886. // The format for specifying validation rules and parameters follows a
  887. // {rule}:{parameters} formatting convention. For instance, the rule
  888. // "max:3" specifies that the value may only be 3 characters long.
  889. if (($colon = strpos($rule, ':')) !== false)
  890. {
  891. $parameters = str_getcsv(substr($rule, $colon + 1));
  892. }
  893. return array(is_numeric($colon) ? substr($rule, 0, $colon) : $rule, $parameters);
  894. }
  895. /**
  896. * Set the bundle that the validator is running for.
  897. *
  898. * The bundle determines which bundle the language lines will be loaded from.
  899. *
  900. * @param string $bundle
  901. * @return Validator
  902. */
  903. public function bundle($bundle)
  904. {
  905. $this->bundle = $bundle;
  906. return $this;
  907. }
  908. /**
  909. * Set the language that should be used when retrieving error messages.
  910. *
  911. * @param string $language
  912. * @return Validator
  913. */
  914. public function speaks($language)
  915. {
  916. $this->language = $language;
  917. return $this;
  918. }
  919. /**
  920. * Set the database connection that should be used by the validator.
  921. *
  922. * @param Database\Connection $connection
  923. * @return Validator
  924. */
  925. public function connection(Database\Connection $connection)
  926. {
  927. $this->db = $connection;
  928. return $this;
  929. }
  930. /**
  931. * Get the database connection for the Validator.
  932. *
  933. * @return Database\Connection
  934. */
  935. protected function db()
  936. {
  937. if ( ! is_null($this->db)) return $this->db;
  938. return $this->db = Database::connection();
  939. }
  940. /**
  941. * Dynamically handle calls to custom registered validators.
  942. */
  943. public function __call($method, $parameters)
  944. {
  945. // First we will slice the "validate_" prefix off of the validator since
  946. // custom validators aren't registered with such a prefix, then we can
  947. // just call the method with the given parameters.
  948. if (isset(static::$validators[$method = substr($method, 9)]))
  949. {
  950. return call_user_func_array(static::$validators[$method], $parameters);
  951. }
  952. throw new \Exception("Method [$method] does not exist.");
  953. }
  954. }