NAME

Data::FormValidator::URI - URI constraint/filter for Data::FormValidator

SYNOPSIS

use Data::FormValidator;
use Data::FormValidator::URI;

my $res = Data::FormValidator->check(
  {
    website => 'http://www.example.com/path/to/some/resource.html',
  },
  {
    required      => [qw( website )],
    field_filters => {
      website => FV_uri_filter(default => 'http'),
    },
    constraint_methods => {
      website => FV_uri(
        schemes        => [qw( http https )],
        hostcheck      => 1,
        allow_userinfo => 0,
      ),
    },
  },
);

DESCRIPTION

This module provides a filter and a constraint method for use with Data::FormValidator, to help make it easier to valid URIs.

METHODS

FV_uri_filter(%opts)

Filter method which cleans up the given value as best it can and returns something that looks like a URI.

The filtered URI will be canonicalized, and common typos will be corrected.

Supported options:

default_scheme

Default URI scheme to use, if none was provided in the URI

FV_uri(%opts)

Constraint method, which ensures that we have a valid URI.

Supported options:

schemes

list-ref of valid schemes

hostcheck

host exists in URI and resolves as a valid host? (default off)

allow_userinfo

allow user info in URI (default off)

AUTHOR

Graham TerMarsch <cpan@howlingfrog.com>

COPYRIGHT

Copyright (C) 2013, Graham TerMarsch. All Rights Reserved.

This is free software; you can redistribute it and/or modify it under the terms of the Artistic 2.0 license.

SEE ALSO

Data::FormValidator
URI