Add in software files and templates

This commit is contained in:
2023-06-21 14:19:40 +01:00
parent f42fdb947c
commit 5228fc5e9f
143 changed files with 23175 additions and 2 deletions

View File

@@ -0,0 +1,96 @@
<?php
/**
* dmarc-srg - A php parser, viewer and summary report generator for incoming DMARC reports.
* Copyright (C) 2020 Aleksey Andreev (liuch)
*
* Available at:
* https://github.com/liuch/dmarc-srg
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the Free
* Software Foundation, either version 3 of the License.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see <http://www.gnu.org/licenses/>.
*/
namespace Liuch\DmarcSrg\ReportLog;
use Liuch\DmarcSrg\Core;
class ReportLog
{
public const ORDER_ASCENT = 1;
public const ORDER_DESCENT = 2;
private $db = null;
private $filter = [
'from_time' => null,
'till_time' => null
];
private $order = [
'direction' => 'ascent'
];
private $rec_limit = 0;
private $position = 0;
public function __construct($from_time, $till_time, $db = null)
{
$this->filter['from_time'] = $from_time;
$this->filter['till_time'] = $till_time;
$this->db = $db ?? Core::instance()->database();
}
public function setOrder(int $dir)
{
$this->order['direction'] = ($dir === self::ORDER_DESCENT ? 'descent' : 'ascent');
}
public function setMaxCount(int $n)
{
$this->rec_limit = $n;
}
public function count()
{
$limit = [ 'offset' => 0, 'count' => $this->rec_limit ];
return $this->db->getMapper('report-log')->count($this->filter, $limit);
}
public function getList(int $pos)
{
$this->position = $pos;
$max_rec = $this->rec_limit > 0 ? $this->rec_limit : 25;
$limit = [ 'offset' => $pos, 'count' => $max_rec + 1 ];
$list = $this->db->getMapper('report-log')->list($this->filter, $this->order, $limit);
if (count($list) > $max_rec) {
$more = true;
unset($list[$max_rec]);
} else {
$more = false;
}
foreach ($list as &$it) {
$it['source'] = ReportLogItem::sourceToString($it['source']);
}
unset($it);
return [
'items' => $list,
'more' => $more
];
}
public function delete()
{
$limit = [ 'offset' => 0, 'count' => $this->rec_limit ];
$this->db->getMapper('report-log')->delete($this->filter, $this->order, $limit);
}
}

View File

@@ -0,0 +1,147 @@
<?php
/**
* dmarc-srg - A php parser, viewer and summary report generator for incoming DMARC reports.
* Copyright (C) 2020 Aleksey Andreev (liuch)
*
* Available at:
* https://github.com/liuch/dmarc-srg
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the Free
* Software Foundation, either version 3 of the License.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see <http://www.gnu.org/licenses/>.
*/
namespace Liuch\DmarcSrg\ReportLog;
use Liuch\DmarcSrg\Core;
use Liuch\DmarcSrg\Sources\Source;
use Liuch\DmarcSrg\Exception\LogicException;
use Liuch\DmarcSrg\Exception\SoftException;
use Liuch\DmarcSrg\Exception\DatabaseNotFoundException;
class ReportLogItem
{
private $db = null;
private $data = [
'id' => null,
'domain' => null,
'external_id' => null,
'event_time' => null,
'filename' => null,
'source' => 0,
'success' => false,
'message' => null
];
private function __construct($source, $filename, $db)
{
if (!is_null($source)) {
if (gettype($source) !== 'integer' || $source <= 0) {
throw new LogicException('Invalid parameter passed');
}
}
$this->data['source'] = $source;
$this->data['filename'] = gettype($filename) == 'string' ? $filename : null;
$this->db = $db ?? Core::instance()->database();
}
public static function success(int $source, $report, $filename, $message, $db = null)
{
$li = new ReportLogItem($source, $filename, $db);
$li->data['success'] = true;
$rdata = $report->get();
$li->data['domain'] = $rdata['domain'];
$li->data['external_id'] = $rdata['external_id'];
$li->data['message'] = $message;
return $li;
}
public static function failed(int $source, $report, $filename, $message, $db = null)
{
$li = new ReportLogItem($source, $filename, $db);
$li->data['success'] = false;
if (!is_null($report)) {
$rdata = $report->get();
$li->data['domain'] = $rdata['domain'];
$li->data['external_id'] = $rdata['external_id'];
} else {
$li->data['domain'] = null;
$li->data['external_id'] = null;
}
$li->data['message'] = $message;
return $li;
}
/**
* Returns an instance of ReportLogItem with the passed Id
*
* @param int $id Item Id to return
* @param DatabaseController $db The database controller
*
* @return ReportLogItem an instance of ReportLogItem with the specified Id.
*/
public static function byId(int $id, $db = null)
{
$li = new ReportLogItem(null, null, $db);
$li->data['id'] = $id;
try {
$li->db->getMapper('report-log')->fetch($li->data);
} catch (DatabaseNotFoundException $e) {
throw new SoftException('The log item is not found');
}
return $li;
}
/**
* Converts an integer source value to a string representation
*
* Returns a string with the source name or an empty string if the integer value is incorrect.
*
* @param int $source - an integer value to convert
*
* @return string A string value of the passed source
*/
public static function sourceToString(int $source): string
{
switch ($source) {
case Source::SOURCE_UPLOADED_FILE:
return 'uploaded_file';
case Source::SOURCE_MAILBOX:
return 'email';
case Source::SOURCE_DIRECTORY:
return 'directory';
}
return '';
}
/**
* Returns an array with log item data
*
* @return array Log item data
*/
public function toArray(): array
{
$res = $this->data;
$res['source'] = static::sourceToString($this->data['source']);
return $res;
}
/**
* Saves the report log item to the database
*
* @return void
*/
public function save(): void
{
$this->db->getMapper('report-log')->save($this->data);
}
}