README

此驱动程序提供了将您的模型审计保存到 elasticsearch 的能力。

内容

• 安装
• 设置
• 控制台命令
• 使用方法
• 捐赠

安装

如果您需要使用 owen-it/laravel-auditing: ^7.0，则此驱动程序是必需的。满足此条件后，您可以按如下方式安装驱动程序

composer require iconscout/laravel-auditing-elasticsearch

设置

如果您需要更改驱动程序默认行为，请将以下配置条目添加到 config/audit.php 中。配置文件的 queue 键应如下所示

    ...
    'queue' => env('AUDIT_QUEUE', true),
    ...

或者

    ...
    'queue' => env('AUDIT_QUEUE', [
        'queue' => 'default',
        'connection' => 'redis'
    ]),
    ...

配置文件的 driver 键应如下所示

    ...
    'driver' => Iconscout\Auditing\Drivers\ElasticSearch::class,
    ...

配置文件的 drivers 键应如下所示

    ...
    'drivers' => [
        'database' => [
            'table'      => 'audits',
            'connection' => null,
        ],
        'es' => [
            'client' => [
                'hosts' => [
                    env('AUDIT_HOST', 'localhost:9200')
                ]
            ],
            'index' => env('AUDIT_INDEX', 'laravel_auditing'),
            'type' => env('AUDIT_TYPE', 'audits')
        ],
    ],
    ...

控制台命令

以下列出了可用的 artisan 命令

命令 | 参数 | 描述 --- | --- auditing:es-index | 将所有模型记录索引到搜索索引。 auditing:es-delete | 从索引中删除所有模型记录。

在命令行中运行 php artisan help [command] 以获取详细描述和所有可用选项。

使用方法

您可以使用 ElasticSearch 驱动在任何 Auditable 模型中，如下所示，以便在 elasticsearch 中存储审计记录

<?php
namespace App\Models;

use Iconscout\Auditing\Drivers\ElasticSearch;
use Illuminate\Database\Eloquent\Model;
use OwenIt\Auditing\Auditable;
use OwenIt\Auditing\Contracts\Auditable as AuditableContract;

class SomeModel extends Model implements AuditableContract
{
    use Auditable;

    /**
     * ElasticSearch Audit Driver
     *
     * @var Iconscout\Auditing\Drivers\ElasticSearch
     */
    protected $auditDriver = ElasticSearch::class;

    // ...
}

您可以使用 ElasticSearchAuditable trait 在任何 Auditable 模型中，如下所示，以检索从 elasticsearch 获取的审计记录

<?php
namespace App\Models;

use Iconscout\Auditing\Drivers\ElasticSearch;
use Iconscout\Auditing\Traits\ElasticSearchAuditable;
use Illuminate\Database\Eloquent\Model;
use OwenIt\Auditing\Auditable;
use OwenIt\Auditing\Contracts\Auditable as AuditableContract;

class SomeModel extends Model implements AuditableContract
{
    use Auditable, ElasticSearchAuditable;

    /**
     * ElasticSearch Audit Driver
     *
     * @var Iconscout\Auditing\Drivers\ElasticSearch
     */
    protected $auditDriver = ElasticSearch::class;

    // ...
}

// Get first available Icon
$icon = Icon::first();

// Get all associated Audits
$all = $icon->esAudits;

// Get all associated Audits via parameters ($page & $perPage)
$all = $icon->esAudits($page = 1, $perPage = 10);

捐赠

通过 贡献 或捐赠一些资金来帮助保持项目开发。先谢谢了。

通过 Paypal 直接捐赠

有关使用 owen-it/laravel-auditing 的自定义驱动程序的更多信息，可以在他们的 主页 上找到