Firewall - 源码 - 源码 - 免费下载

Firewall

文件大小： unknow

源码售价： 5 个金币积分规则积分充值

资源说明：Request verification component for PHP 5.3+.

# Firewall #

This component provides a starting point for an authentication system that can be used for validating any incoming `Request` instance.  All you need to
do to use it is to configure the `Firewall` instance however you like, and tell it to verify a `Request` object with `Firewall::verifyRequest`.

The Firewall works by providing its own series of events that you can hook into with your own code in order to implement whatever types of 
authentication proceedures you need.

If the firewall succeeds in verifying the request, it returns true.  If there is a failure, it may return a response instance, or an exception will be thrown.

## Usage ##

Here is the most basic usage of the firewall for verifying incoming requests based on an IP blacklist and/or whitelist.  It takes a bit 
of set up, it's most useful if used with a framework that provides some solution for managing configuration and dependency injection.

    addListener(FirewallEvents::REQUEST, array($whitelist, 'onFirewallRequest'));
    
    $ipBlacklist = new IpRangeFilter(array('10.0.100.*'), IpRangeFilter::BLACKLIST);
    $firewall->addListener(FirewallEvents::REQUEST, array($ipBlacklist, 'onFirewallRequest'));

    //if it fails, exceptions will be thrown to be handled by your application, or a Firewall listener may
    //handle a failure internally by returning a response
    $result = $firewall->verifyRequest(Request::createFromGlobals());

    if ($result instanceof Response) {
        $result->send();
    }

The configuration above would only allow requests through that are part of a local network, but still deny requests from 
client addresses that match `10.0.100.*`.  It will apply these checks on all requests.

## Configuration subscriber ##

The Firewall provides a flexible configuration subscriber which uses config handlers to dynamically register firewall listeners based
on the incoming request path, and request-specific configuration.
    
     array(
            'ip_whitelist' => array('10.*.*.*', '192.168.*),
            'ip_blacklist' => array('192.168.100.*', '192.168.252.32-192.168.252.64'),
        ),
    );
    
    //register factory handlers
    $configSubscriber = new ConfigSubscriber($firewallRules);
    $configSubscriber->addConfigHandler(new IpBlacklistHandler());
    $configSubscriber->addConfigHandler(new IpWhitelistHandler());
    
    //instantiate firewall with listener config
    $firewall = new Firewall();
    $firewall->addSubscriber($configSubscriber);
    
    //verify the request
    $result = $firewall->verifyRequest(Request::createFromGlobals());
    
This example applies specific configuration to certain configuration handlers, but only if the request path 
matches any of the rules.  In this case, only requests from an internal network would be allowed to access any 
route beginning with `/admin`.

## Events ##

The firewall fires a series of events for any custom authentication systems to hook into.  The events are documented in 
the `AC\Component\Event\FirewallEvents` class.  You can register events or event subscribers on the firewall the same as 
you would any other instance of an `EventDispatcherInterface`.

部分文件列表（点击文件名可查看文件内容）

					
									本源码包内暂不包含可直接显示的源代码文件，请下载源码包。