The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

HTTP::SimpleLinkChecker - Check the HTTP response code for a link

SYNOPSIS

THIS MODULE HAS BEEN ABANDONED. YOU CAN ADOPT IT https://pause.perl.org/pause/authenquery?ACTION=pause_04about#takeover

        use HTTP::SimpleLinkChecker;

        my $code = HTTP::SimpleLinkChecker::check_link($url);

        unless( defined $code ) {
                print "Error: $HTTP::SimpleLinkChecker::ERROR\n";
                }

DESCRIPTION

You don't have to know anything about objected-oriented Perl, LWP, or the HTTP module to be able to check your links. This module is designed for the casual user. It has one function, check_link, that returns the HTTP response code that it receives when it tries to fetch the web address passed to it. The undef value is returned for any non-HTTP failure and the $HTTP::SimpleLinkChecker::ERROR variable is set.

The HEAD method is tried first, although if anything other than a good status code (those less than 400) is received, another request is made with the GET method.

The user-agent will automatically handle redirects. If you don't like that, you can change the user agent settings before you start:

        HTTP::SimpleLinkChecker::user_agent()->max_redirects(0);

The user agent is Mojo::UserAgent, so anything you do with that module you can do with the user agent.

Note that even with the best code, no module can control how servers decide to respond to a check, or control any of the myriad things that can go wrong with the network between you and the remote server. Some may filter requests based on origin IP address, user-agent type, or any other arbitrary factor. Some servers may not respond correctly at all. Furthermore, some servers might be temporarily down or overloaded. I recommend that you recheck "broken" links a couple times over a long period (like a day or two) before you decide they are really broken.

If you are behind a firewall or proxy, this module picks up those settings through Mojo::UserAgent::Proxy's detect() method. See Mojo::UserAgent::Proxy for more details.

Functions

check_link( URL )

Returns the HTTP response code for URL.

user_agent

Returns a reference to the Mojo::UserAgent object. You can affect it directly. See Mojo::UserAgent.

        my $ua = HTTP::SimpleLinkChecker::user_agent();
        $ua->transactor->name( 'Mozilla 19.2' );

SOURCE AVAILABILITY

This source is in Github:

        https://github.com/briandfoy/http-simplelinkchecker

AUTHOR

brian d foy, <bdfoy@cpan.org>

Contributors

  • Sebastian Paaske Tørholm, <Eckankar@gmail.com>

COPYRIGHT AND LICENSE

Copyright © 2004-2021, brian d foy <bdfoy@cpan.org>. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the Artistic License 2.0.