Zabbix

<?php

/*

** Zabbix

** Copyright (C) 2001-2022 Zabbix SIA

**

** 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 2 of the License, or

** (at your option) any later version.

**

** 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, write to the Free Software

** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

**/

​

​

/**

 * Class containing methods for operations with events.

 */

class CEvent extends CApiService {

​

    public const ACCESS_RULES = [

        'get' => ['min_user_type' => USER_TYPE_ZABBIX_USER],

        'acknowledge' => ['min_user_type' => USER_TYPE_ZABBIX_USER]

    ];

​

    protected $tableName = 'events';

    protected $tableAlias = 'e';

    protected $sortColumns = ['eventid', 'objectid', 'clock'];

​

    /**

     * Array of supported objects where keys are object IDs and values are translated object names.

     *

     * @var array

     */

    protected $objects = [];

​

    /**

     * Array of supported sources where keys are source IDs and values are translated source names.

     *

     * @var array

     */

    protected $sources = [];

​

    public function __construct() {

        parent::__construct();

​

        $this->sources = eventSource();

        $this->objects = eventObject();

    }

​

    /**

     * Get events data.

     *

     * @param array $options

     * @param array $options['itemids']

     * @param array $options['hostids']

     * @param array $options['groupids']

     * @param array $options['eventids']

     * @param array $options['status']

     * @param bool  $options['editable']

     * @param array $options['count']

     * @param array $options['pattern']

     * @param array $options['limit']

     * @param array $options['order']

     *

     * @return array|int item data as array or false if error

     */

    public function get($options = []) {

        $defOptions = [

            'eventids'                  => null,

            'groupids'                  => null,

            'hostids'                   => null,

            'objectids'                 => null,

​

            'editable'                  => false,

            'object'                    => EVENT_OBJECT_TRIGGER,

            'source'                    => EVENT_SOURCE_TRIGGERS,

            'severities'                => null,

            'nopermissions'             => null,

            // filter

            'value'                     => null,

            'time_from'                 => null,

            'time_till'                 => null,

            'eventid_from'              => null,

            'eventid_till'              => null,