README

AbstractMold is a base abstract class for centralizing all changes to an entity using user-provided data, whether it's full creation, complete update, or partial modification (patch).

💡 Philosophy

AbstractMold acts as a single, centralized point for handling and validating all data changes coming from the user. You must explicitly declare allowed fields via publicFields(), and implement validated() to return the final data array ready for storage.

🚀 Installation

composer require asokol1981/abstract-mold

✅ Usage

use ASokol1981\AbstractMold\AbstractMold;

final class UserMold extends AbstractMold
{
    protected function publicFields(): array
    {
        return ['name', 'email', 'age'];
    }

    protected function validated(): array
    {
        $age = $this->get('age');

        if ($age !== null && !is_numeric($age)) {
            throw new \InvalidArgumentException('Age must be numeric');
        }

        return [
            'name' => (string) $this->get('name', ''),
            'email' => strtolower((string) $this->get('email', '')),
            'age' => $age !== null ? (int) $age : null,
        ];
    }
}

// Create mold with initial data
$mold = new UserMold(['name' => 'John', 'email' => 'John@EXAMPLE.COM']);

// Apply partial patch
$mold->applyPatch(['age' => '30']);

// Get all validated data (for full update or create)
$data = $mold->allValidated();
// [
//     'name' => 'John',
//     'email' => 'john@example.com',
//     'age' => 30
// ]

// Get only patched validated data (for partial update)
$patchData = $mold->validatedPatch();
// [
//     'age' => 30
// ]

⚖️ Philosophy Highlights

Single point of data transformation: whether you create, fully update, or patch — always via Mold.
Strict whitelisting: only fields declared in publicFields() are accepted.
No internal validation flags: final data correctness is ensured by validated().

🧪 Testing

composer install
vendor/bin/phpunit

📄 License

MIT License. See LICENSE file for details.

Created by Aleksei Sokolov, in collaboration with ChatGPT (OpenAI), July 2025.

asokol1981 / abstract-mold

Maintainers

Details