What's Changed

• Release version 2.0.1 by @nguyenanhung in https://github.com/nguyenanhung/basic-firewall/pull/1

New Contributors

• @nguyenanhung made their first contribution in https://github.com/nguyenanhung/basic-firewall/pull/1

Full Changelog: https://github.com/nguyenanhung/basic-firewall/compare/v2.0.0...v2.0.1

Full Changelog: https://github.com/nguyenanhung/basic-firewall/compare/v1.0.4...v1.0.5

• [x] v2.x support all PHP version >=7.0

• [x] Release V1.x support all PHP version >=5.4

• [x] Fix typo serer to server
• [x] Add test ./example/firewall.php to Github action
• [x] Add check CLI

• [x] Add Github Workflows
• [x] Refactor class CheckSystem

Thư viện PHP Basic Firewall được xây dựng bằng PHP cung cấp 1 phương thức đơn giản để hạn chế quyền truy cập website / api / webservice dựa vào địa chỉ IP truy cập của người dùng

Hướng dẫn sử dụng

Cài đặt gói

Cài đặt gói Basic Firewall thông qua composer với lệnh như sau

composer require nguyenanhung/basic-firewall

Hướng dẫn tích hợp

Tham khảo cách tích hợp thông qua hướng dẫn tại đoạn code ví dụ dưới đây

<?php
/**
 * Project basic-firewall
 * Created by PhpStorm
 * User: 713uk13m <[email protected]>
 * Copyright: 713uk13m <[email protected]>
 * Date: 09/01/2021
 * Time: 00:50
 */
require_once __DIR__ . '/vendor/autoload.php';

use nguyenanhung\PhpBasicFirewall\FirewallIP;

// ==================================== Setup List IP Whitelist
// Setup constants HUNGNG_IP_WHITELIST
defined('HUNGNG_IP_WHITELIST') or define('HUNGNG_IP_WHITELIST', array(
    '127.0.0.1',
    '192.168.0.*',
));
// Or Whitelist Array
$whiteList = array(
    '127.0.0.1',
    '192.168.0.*',
);

// ==================================== Setup List IP Blacklist
// Setup constants HUNGNG_IP_BLACKLIST
defined('HUNGNG_IP_BLACKLIST') or define('HUNGNG_IP_BLACKLIST', array(
    '127.0.0.1',
    '192.168.0.*',
));
// Or Blacklist Array
$blackList = array(
    '192.168.0.50',
);

// ==================================== Start Firewall

$firewall = new FirewallIP();
$firewall->setLogDestination(__DIR__ . '/logs/FirewallLog.log')
         ->setIpWhiteList($whiteList)
         ->setIpBlackList($blackList)
         ->checkUserConnect(false);

if (true !== $firewall->isAccess()) {
    $firewall->accessDeniedResponse(); // Response 403 http code, Access Denied message
}

// ==================================== End Firewall

Trong ví dụ trên, chỉ những IP bắt đầu bằng 192.168.0 (loại trừ 192.168.0.50) và 127.0.0.1 sẽ được cho phép truy cập bởi Firewall. Tất cả các IP khác handle() sẽ return false

• checkUserConnect(false) khai báo true hoặc false để xác định mặc định firewall cho phép hay từ chối truy cập (Optional - Default false). true nếu mặc định cho phép truy cập, false nếu mặc định từ chối
• setIpWhiteList($whiteList) khai báo $whiteList IP list cho phép truy cập
• setIpBlackList($blackList) khai báo $blackList IP list từ chối truy cập

IP List Formats

Firewall hỗ trợ input các IP whitelist và blacklist như sau

Type | Syntax | Details --- | --- | --- IPV6|::1|Short notation IPV4|192.168.0.1| Range|192.168.0.0-192.168.1.60|Includes all IPs from 192.168.0.0 to 192.168.0.255
and from 192.168.1.0 to 198.168.1.60 Wild card|192.168.0.*|IPs starting with 192.168.0
Same as IP Range 192.168.0.0-192.168.0.255 Subnet mask|192.168.0.0/255.255.255.0|IPs starting with 192.168.0
Same as 192.168.0.0-192.168.0.255 and 192.168.0.* CIDR Mask|192.168.0.0/24|IPs starting with 192.168.0
Same as 192.168.0.0-192.168.0.255 and 192.168.0.*
and 192.168.0.0/255.255.255.0

LICENSE

Gói được phân phối bởi giấy phép , tham khảo chi tiết giấy phép tại đây

Gói có sử dụng packages m6web/firewall được cung cấp bởi M6Web, bạn cũng có thể sử dụng riêng packages này theo đường link tại đây

Hỗ trợ

Nếu có bất kì câu hỏi hoặc cần hỗ trợ nào, liên hệ theo thông tin sau

| Name | Email | Skype | Facebook | | ----------- | -------------------- | ---------------- | ------------- | | Hung Nguyen | [email protected] | nguyenanhung5891 | @nguyenanhung |

From Vietnam with Love ❤️