xref: /plugin/struct/meta/AccessDataValidator.php (revision 7234bfb14e712ff548d9266ef32fdcc8eaf2d04e)
193ca6f4fSAndreas Gohr<?php
293ca6f4fSAndreas Gohr
393ca6f4fSAndreas Gohrnamespace dokuwiki\plugin\struct\meta;
493ca6f4fSAndreas Gohr
593ca6f4fSAndreas Gohr/**
693ca6f4fSAndreas Gohr * Validate the data for a whole schema
793ca6f4fSAndreas Gohr *
893ca6f4fSAndreas Gohr * Should be aquired through AccessDataTable::getValidator()
993ca6f4fSAndreas Gohr */
10d6d97f60SAnna Dabrowskaclass AccessDataValidator extends ValueValidator
11d6d97f60SAnna Dabrowska{
1293ca6f4fSAndreas Gohr    /** @var AccessTable */
1393ca6f4fSAndreas Gohr    protected $access;
1493ca6f4fSAndreas Gohr
1593ca6f4fSAndreas Gohr    /** @var array */
1693ca6f4fSAndreas Gohr    protected $data;
1793ca6f4fSAndreas Gohr
1893ca6f4fSAndreas Gohr    /**
1993ca6f4fSAndreas Gohr     * ValidationResult constructor.
2093ca6f4fSAndreas Gohr     * @param AccessTable $access
2193ca6f4fSAndreas Gohr     * @param array $data the data to validate (and save)
2293ca6f4fSAndreas Gohr     */
23d6d97f60SAnna Dabrowska    public function __construct(AccessTable $access, $data)
24d6d97f60SAnna Dabrowska    {
2593ca6f4fSAndreas Gohr        parent::__construct();
2693ca6f4fSAndreas Gohr        $this->access = $access;
2793ca6f4fSAndreas Gohr        $this->data = $data;
2893ca6f4fSAndreas Gohr    }
2993ca6f4fSAndreas Gohr
3093ca6f4fSAndreas Gohr    /**
3193ca6f4fSAndreas Gohr     * Validate the given data
3293ca6f4fSAndreas Gohr     *
3393ca6f4fSAndreas Gohr     * checks for assignments
3493ca6f4fSAndreas Gohr     * validates
3593ca6f4fSAndreas Gohr     * returns changed data only
3693ca6f4fSAndreas Gohr     *
3793ca6f4fSAndreas Gohr     * @param array $data array('schema' => ( 'fieldlabel' => 'value', ...))
3893ca6f4fSAndreas Gohr     * @param string $pageid
3993ca6f4fSAndreas Gohr     * @param string[] $errors validation errors
4093ca6f4fSAndreas Gohr     * @return AccessDataValidator[]|bool savable data or false on validation error
4193ca6f4fSAndreas Gohr     */
42d6d97f60SAnna Dabrowska    public static function validateDataForPage($data, $pageid, &$errors)
43d6d97f60SAnna Dabrowska    {
44*7234bfb1Ssplitbrain        $tosave = [];
4593ca6f4fSAndreas Gohr        $valid = true;
46*7234bfb1Ssplitbrain        $errors = [];
4793ca6f4fSAndreas Gohr
48025cb9daSAndreas Gohr        $assignments = Assignments::getInstance();
4993ca6f4fSAndreas Gohr        $tables = $assignments->getPageAssignments($pageid);
5093ca6f4fSAndreas Gohr        foreach ($tables as $table) {
514cd5cc28SAnna Dabrowska            $access = AccessTable::getPageAccess($table, $pageid);
5293ca6f4fSAndreas Gohr            $validation = $access->getValidator($data[$table]);
5393ca6f4fSAndreas Gohr            if (!$validation->validate()) {
5493ca6f4fSAndreas Gohr                $valid = false;
5593ca6f4fSAndreas Gohr                $errors = array_merge($errors, $validation->getErrors());
56*7234bfb1Ssplitbrain            } elseif ($validation->hasChanges()) {
5793ca6f4fSAndreas Gohr                $tosave[] = $validation;
5893ca6f4fSAndreas Gohr            }
5993ca6f4fSAndreas Gohr        }
6093ca6f4fSAndreas Gohr        if ($valid) return $tosave;
6193ca6f4fSAndreas Gohr        return false;
6293ca6f4fSAndreas Gohr    }
6393ca6f4fSAndreas Gohr
6493ca6f4fSAndreas Gohr    /**
6593ca6f4fSAndreas Gohr     * Validate the data. This will clean the data according to type!
6693ca6f4fSAndreas Gohr     *
6793ca6f4fSAndreas Gohr     * @return bool
6893ca6f4fSAndreas Gohr     */
69d6d97f60SAnna Dabrowska    public function validate()
70d6d97f60SAnna Dabrowska    {
7193ca6f4fSAndreas Gohr        $result = true;
7293ca6f4fSAndreas Gohr        foreach ($this->access->getSchema()->getColumns() as $col) {
7393ca6f4fSAndreas Gohr            $label = $col->getType()->getLabel();
7493ca6f4fSAndreas Gohr            $result = $result && $this->validateValue($col, $this->data[$label]);
7593ca6f4fSAndreas Gohr        }
7693ca6f4fSAndreas Gohr        return $result;
7793ca6f4fSAndreas Gohr    }
7893ca6f4fSAndreas Gohr
7993ca6f4fSAndreas Gohr    /**
8093ca6f4fSAndreas Gohr     * Check if the data changed (selects current data)
8193ca6f4fSAndreas Gohr     *
8293ca6f4fSAndreas Gohr     * @return bool
8393ca6f4fSAndreas Gohr     */
84d6d97f60SAnna Dabrowska    public function hasChanges()
85d6d97f60SAnna Dabrowska    {
8693ca6f4fSAndreas Gohr        $olddata = $this->access->getDataArray();
8793ca6f4fSAndreas Gohr        return ($olddata != $this->data);
8893ca6f4fSAndreas Gohr    }
8993ca6f4fSAndreas Gohr
9093ca6f4fSAndreas Gohr    /**
9193ca6f4fSAndreas Gohr     * @return AccessTable
9293ca6f4fSAndreas Gohr     */
93d6d97f60SAnna Dabrowska    public function getAccessTable()
94d6d97f60SAnna Dabrowska    {
9593ca6f4fSAndreas Gohr        return $this->access;
9693ca6f4fSAndreas Gohr    }
9793ca6f4fSAndreas Gohr
9893ca6f4fSAndreas Gohr    /**
9993ca6f4fSAndreas Gohr     * Access the data after it has been cleand in the validation process
10093ca6f4fSAndreas Gohr     *
10193ca6f4fSAndreas Gohr     * @return array
10293ca6f4fSAndreas Gohr     */
103d6d97f60SAnna Dabrowska    public function getCleanData()
104d6d97f60SAnna Dabrowska    {
10593ca6f4fSAndreas Gohr        return $this->data;
10693ca6f4fSAndreas Gohr    }
10793ca6f4fSAndreas Gohr
10893ca6f4fSAndreas Gohr    /**
10993ca6f4fSAndreas Gohr     * Saves the data
11093ca6f4fSAndreas Gohr     *
11193ca6f4fSAndreas Gohr     * This saves no matter what. You have to chcek validation results and changes on your own!
11293ca6f4fSAndreas Gohr     *
11393ca6f4fSAndreas Gohr     * @param int $ts the timestamp to use when saving the data
11493ca6f4fSAndreas Gohr     * @return bool
11593ca6f4fSAndreas Gohr     */
116d6d97f60SAnna Dabrowska    public function saveData($ts = 0)
117d6d97f60SAnna Dabrowska    {
11893ca6f4fSAndreas Gohr        $this->access->setTimestamp($ts);
11993ca6f4fSAndreas Gohr        return $this->access->saveData($this->data);
12093ca6f4fSAndreas Gohr    }
12193ca6f4fSAndreas Gohr}
122