$modelo->test()

Esta función sirve para comprobar los valores de las propiedades o columnas del modelo. Devuelve false si detecta problemas en los valores o true en caso contrario. Por ejemplo, devolverá false si en una columna del modelo tenemos valor null y en la tabla, en esa columna, tenemos una restricción NOT NULL. Para ser más claros, la función test() del modelo Cliente devolverá false si en el cifnif tenemos NULL, ya que la columna cifnif de la tabla no puede contener NULL.

¿Cuando se ejecuta?

Esta función se ejecuta dentro de la función save() del modelo. Y se ejecuta antes de las funciones internas saveInsert() y saveUpdate().

¿Cómo se usa normalmente?

No es habitual llamar directamente a esta función. Lo habitual es que en nuestros modelos, cuando tenemos que hacer alguna comprobación o corrección sobre los valores, lo hagamos en esta función:

    public function test(): bool
    {
        // comprobamos que el codpago solamente tiene letras, números y algunos caracteres especiales
        if ($this->codpago && 1 !== preg_match('/^[A-Z0-9_\+\.\-\s]{1,10}$/i', $this->codpago)) {
            $this->toolBox()->i18nLog()->error(
                'invalid-alphanumeric-code',
                ['%value%' => $this->codpago, '%column%' => 'codpago', '%min%' => '1', '%max%' => '10']
            );
            return false;
        }

        return parent::test();
    }