Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
HTTP::SimpleLinkCheckeUser Contributed Perl DocumentHTTP::SimpleLinkChecker(3)

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

SYNOPSIS
	       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
       o   Sebastian Paaske TA,rholm, "<Eckankar@gmail.com>"

COPYRIGHT AND LICENSE
       Copyright A(C) 2004-2018, 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.

perl v5.32.0			  2018-04-28	    HTTP::SimpleLinkChecker(3)

NAME | SYNOPSIS | DESCRIPTION | SOURCE AVAILABILITY | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=HTTP::SimpleLinkChecker&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help