Files
espocrm/application/Espo/Tools/DynamicLogic/ConditionChecker.php
2026-01-19 17:46:06 +01:00

350 lines
9.7 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
/************************************************************************
* This file is part of EspoCRM.
*
* EspoCRM Open Source CRM application.
* Copyright (C) 2014-2025 EspoCRM, Inc.
* Website: https://www.espocrm.com
*
* 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, either version 3 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 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/>.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
************************************************************************/
namespace Espo\Tools\DynamicLogic;
use Espo\Core\Field\Date;
use Espo\Core\Field\DateTime;
use Espo\Core\Utils\DateTime\SystemClock;
use Espo\Entities\User;
use Espo\ORM\Entity;
use Espo\Tools\DynamicLogic\ConditionChecker\Options;
use Espo\Tools\DynamicLogic\Exceptions\BadCondition;
use Psr\Clock\ClockInterface;
use Exception;
use RuntimeException;
use DateTimeImmutable;
use DateTimeZone;
/**
* @since 9.1.0
*/
class ConditionChecker
{
/**
* Use `ConditionCheckerFactory` instead.
*/
public function __construct(
private Entity $entity,
private ?User $user = null,
private Options $options = new Options(),
private ClockInterface $clock = new SystemClock(),
) {}
/**
* @throws BadCondition
*/
public function check(Item $item): bool
{
$type = $item->type;
$value = $item->value;
if ($type === Type::And) {
if (!is_array($value)) {
throw new BadCondition();
}
foreach ($value as $subItem) {
if (!$subItem instanceof Item) {
throw new BadCondition();
}
if (!$this->check($subItem)) {
return false;
}
}
return true;
}
if ($type === Type::Or) {
if (!is_array($value)) {
throw new BadCondition();
}
foreach ($value as $subItem) {
if (!$subItem instanceof Item) {
throw new BadCondition();
}
if ($this->check($subItem)) {
return true;
}
}
return false;
}
if ($type === Type::Not) {
if (!$value instanceof Item) {
throw new BadCondition();
}
return !$this->check($value);
}
if (!$item->attribute) {
throw new BadCondition("No attribute.");
}
$setValue = $this->getAttributeValue($item->attribute);
if ($type === Type::Equals) {
return $setValue === $value;
}
if ($type === Type::NotEquals) {
return $setValue !== $value;
}
if ($type === Type::IsEmpty) {
return $setValue === [] ||
$setValue === null ||
$setValue === false ||
$setValue === '';
}
if ($type === Type::IsNotEmpty) {
return !(
$setValue === [] ||
$setValue === null ||
$setValue === false ||
$setValue === ''
);
}
if ($type === Type::IsTrue) {
return (bool) $setValue;
}
if ($type === Type::IsFalse) {
return !$setValue;
}
if ($type === Type::Contains) {
if (is_string($setValue) && is_string($value)) {
return str_contains($setValue, $value);
}
if (is_array($setValue)) {
return in_array($value, $setValue);
}
return false;
}
if ($type === Type::NotContains) {
if (is_string($setValue) && is_string($value)) {
return !str_contains($setValue, $value);
}
if (is_array($setValue)) {
return !in_array($value, $setValue);
}
return true;
}
if ($type === Type::Has) {
if (is_array($setValue)) {
return in_array($value, $setValue);
}
return false;
}
if ($type === Type::NotHas) {
if (is_array($setValue)) {
return !in_array($value, $setValue);
}
return true;
}
if ($type === Type::StartsWith) {
if (is_string($setValue) && is_string($value)) {
return str_starts_with($setValue, $value);
}
return false;
}
if ($type === Type::EndsWith) {
if (is_string($setValue) && is_string($value)) {
return str_ends_with($setValue, $value);
}
return false;
}
if ($type === Type::Matches) {
if (is_string($setValue) && is_string($value)) {
return (bool) preg_match($value, $setValue);
}
return false;
}
if ($type === Type::GreaterThan) {
return $setValue > $value;
}
if ($type === Type::LessThan) {
return $setValue < $value;
}
if ($type === Type::GreaterThanOrEquals) {
return $setValue >= $value;
}
if ($type === Type::LessThanOrEquals) {
return $setValue <= $value;
}
if ($type === Type::In) {
if (is_array($value)) {
return in_array($setValue, $value);
}
return false;
}
if ($type === Type::NotIn) {
if (is_array($value)) {
return !in_array($setValue, $value);
}
return true;
}
if (!$setValue || !is_string($setValue)) {
return false;
}
if ($type === Type::IsToday) {
if (strlen($setValue) > 10) {
$setDateTime = DateTime::fromDateTime($this->createDateTime($setValue));
$todayStart = $this->createNow()
->withTimezone($this->getTimeZone())
->withTime(0, 0);
$todayEnd = $todayStart->addDays(1);
return $todayStart->isLessThanOrEqualTo($setDateTime) && $setDateTime->isLessThan($todayEnd);
}
$setDate = Date::fromDateTime($this->createDateTime($setValue));
$today = $this->createToday();
return $setDate->isEqualTo($today);
}
if ($type === Type::InFuture) {
if (strlen($setValue) > 10) {
$setDateTime = DateTime::fromDateTime($this->createDateTime($setValue));
return $setDateTime->isGreaterThan($this->createNow());
}
$setDate = Date::fromDateTime($this->createDateTime($setValue));
$today = $this->createToday();
return $setDate->isGreaterThan($today);
}
if ($type === Type::InPast) {
if (strlen($setValue) > 10) {
$setDateTime = DateTime::fromDateTime($this->createDateTime($setValue));
return $setDateTime->isLessThan($this->createNow());
}
$setDate = Date::fromDateTime($this->createDateTime($setValue));
$today = $this->createToday();
return $setDate->isLessThan($today);
}
/** @phpstan-ignore-next-line deadCode.unreachable */
throw new BadCondition("Unimplemented type '$type->value'.");
}
private function getAttributeValue(string $attribute): mixed
{
if (str_starts_with($attribute, '$')) {
if (!$this->user) {
return null;
}
if ($attribute === '$user.id') {
return $this->user->getId();
}
if ($attribute === '$user.teamsIds') {
return $this->user->getTeamIdList();
}
}
return $this->entity->get($attribute);
}
private function getTimeZone(): DateTimeZone
{
return $this->options->timezone;
}
private function createDateTime(string $value): DateTimeImmutable
{
try {
$setDateTime = new DateTimeImmutable($value, $this->getTimeZone());
} catch (Exception $e) {
throw new RuntimeException($e->getMessage(), 0, $e);
}
return $setDateTime;
}
private function createNow(): DateTime
{
return DateTime::fromDateTime($this->clock->now());
}
private function createToday(): Date
{
$dateTime = $this->clock
->now()
->setTimezone($this->getTimeZone());
return Date::fromDateTime($dateTime);
}
}