validator.php 25 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069
  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 is_array($value) 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. if (Lang::has($line, $this->language))
  852. {
  853. return Lang::line($line)->get($this->language);
  854. }
  855. // If no language line has been specified for the attribute, all of
  856. // the underscores are removed from the attribute name and that
  857. // will be used as the attribtue name.
  858. else
  859. {
  860. return str_replace('_', ' ', $attribute);
  861. }
  862. }
  863. /**
  864. * Determine if an attribute has a rule assigned to it.
  865. *
  866. * @param string $attribute
  867. * @param array $rules
  868. * @return bool
  869. */
  870. protected function has_rule($attribute, $rules)
  871. {
  872. foreach ($this->rules[$attribute] as $rule)
  873. {
  874. list($rule, $parameters) = $this->parse($rule);
  875. if (in_array($rule, $rules)) return true;
  876. }
  877. return false;
  878. }
  879. /**
  880. * Extract the rule name and parameters from a rule.
  881. *
  882. * @param string $rule
  883. * @return array
  884. */
  885. protected function parse($rule)
  886. {
  887. $parameters = array();
  888. // The format for specifying validation rules and parameters follows a
  889. // {rule}:{parameters} formatting convention. For instance, the rule
  890. // "max:3" specifies that the value may only be 3 characters long.
  891. if (($colon = strpos($rule, ':')) !== false)
  892. {
  893. $parameters = str_getcsv(substr($rule, $colon + 1));
  894. }
  895. return array(is_numeric($colon) ? substr($rule, 0, $colon) : $rule, $parameters);
  896. }
  897. /**
  898. * Set the bundle that the validator is running for.
  899. *
  900. * The bundle determines which bundle the language lines will be loaded from.
  901. *
  902. * @param string $bundle
  903. * @return Validator
  904. */
  905. public function bundle($bundle)
  906. {
  907. $this->bundle = $bundle;
  908. return $this;
  909. }
  910. /**
  911. * Set the language that should be used when retrieving error messages.
  912. *
  913. * @param string $language
  914. * @return Validator
  915. */
  916. public function speaks($language)
  917. {
  918. $this->language = $language;
  919. return $this;
  920. }
  921. /**
  922. * Set the database connection that should be used by the validator.
  923. *
  924. * @param Database\Connection $connection
  925. * @return Validator
  926. */
  927. public function connection(Database\Connection $connection)
  928. {
  929. $this->db = $connection;
  930. return $this;
  931. }
  932. /**
  933. * Get the database connection for the Validator.
  934. *
  935. * @return Database\Connection
  936. */
  937. protected function db()
  938. {
  939. if ( ! is_null($this->db)) return $this->db;
  940. return $this->db = Database::connection();
  941. }
  942. /**
  943. * Dynamically handle calls to custom registered validators.
  944. */
  945. public function __call($method, $parameters)
  946. {
  947. // First we will slice the "validate_" prefix off of the validator since
  948. // custom validators aren't registered with such a prefix, then we can
  949. // just call the method with the given parameters.
  950. if (isset(static::$validators[$method = substr($method, 9)]))
  951. {
  952. return call_user_func_array(static::$validators[$method], $parameters);
  953. }
  954. throw new \Exception("Method [$method] does not exist.");
  955. }
  956. }