Source
<?php
/*
** Copyright (C) 2001-2025 Zabbix SIA
**
** This program is free software: you can redistribute it and/or modify it under the terms of
** the GNU Affero General Public License as published by the Free Software Foundation, version 3.
**
** 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 Affero General Public License for more details.
**
** You should have received a copy of the GNU Affero General Public License along with this program.
** If not, see <https://www.gnu.org/licenses/>.
**/
/**
* Class for rendering partial-views, which are useful for reusing the same partial-views or updating specific parts of
* the page asynchronously, i.e., partials can be included into a view initially and updated in AJAX manner, later.
*/
class CPartial {
/**
* Directory list of MVC partials ordered by search priority.
*
* @var array
*/
private static $directories = ['local/app/partials', 'app/partials'];
/**
* Partial name.
*
* @var string
*/
private $name;
/**
* Data provided for partial.
*
* @var array
*/
private $data;
/**
* Directory where the partial file was found.
*
* @var string
*/
private $directory;
/**
* Create a partial based on partial name and data.
*
* @param string $name Partial name to search for.
* @param array $data Accessible data within the partial.
*
* @throws InvalidArgumentException if partial name not valid.
* @throws RuntimeException if partial not found or not readable.
*/
public function __construct($name, array $data = []) {
if (!preg_match('/^[a-z]+(\/[a-z]+)*(\.[a-z]+)*$/', $name)) {
throw new InvalidArgumentException(sprintf('Invalid partial name: "%s".', $name));
}