NAME

Web::Detect - Detect if program is running under some web environment

VERSION

version 0.04

SYNOPSIS

    use Web::Detect qw(detect_web detect_web_fast);
    use IO::Interactive::Tiny ();

    if (Web::Detect::detect_web_fast()) {
        # do HTML
    }
    else {
        # do CLI
        if (IO::Interactive::Tiny::is_interactive()) {
            # prompt/ANSI/etc
        }
        else {
            # do not prompt/plain text/etc
        }
    }

DESCRIPTION

Knowing if you are under a web environment or not is very handy.

For example, often you need to decide whether to output HTML or plaintext.

FUNCTIONS

Functions are exportable but are not exported by default.

detect_web() => HASHREF

Return false if not detected running under any web environment.

Return a hash otherwise.

These keys exists if it is detected that we are running under the given environment and the value is suitable as a boolean (always true).

mod_perl

plack

pangea

cpanel

http://cpanel.net

catalyst

dancer

mojo

FCGI.pm

IIS

cgi

General CGI

general

Value can be 1 if it was detected during the first general check, 2 if it was detected during the second general check, and 3 if it was detected under both.

Additionally, psgi is also true if we know its a PSGI environment.

detect_web_fast()

Same as detect_web() but return HASHREF upon first successful check instead of trying all heuristics.

TODO

Make heuristics even better!

More links/description to each HASHREF key.

Never enough tests.

AUTHOR

Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Steven Haryanto.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.