Compare commits

..

No commits in common. "2f6e24b0a1bc49f11edc4db07c660d73829cea3b" and "4fa45083d07019cf97cf13ce2cee8a1d2d1a67c9" have entirely different histories.

8 changed files with 27 additions and 177 deletions

View file

@ -1,115 +0,0 @@
<?php
namespace vlw\Scaffold\Database;
use ReflectionClass;
use ReflectionProperty;
use ReflectionNamedType;
use ReflectionUnionType;
/**
* Modify database entity values using an instanced database Model
*/
class Controller {
/**
* Returns an array of allowed property types
*
* @param ReflectionNamedType|ReflectionUnionType A \ReflectionType instance to retrieve types from
* @return array<string> An array containing the allowed property types (literals and classes)
*/
private static function get_types(ReflectionNamedType|ReflectionUnionType $type): array {
$types = [];
// Property value is nullable
if ($type->allowsNull()) {
$types[] = "null";
}
// Property only accepts one type
if ($type instanceof ReflectionNamedType) {
// Add type name to output and trim shorthand nullable from name if present
$types[] = ltrim($type->getName(), "?");
return $types;
}
return array_merge($types, $type->getTypes());
}
/**
* Creates a new instance of a class-like object
*
* @param string Namespaced class name to instance
* @param array<mixed> Arguments to pass to the class constructor
* @return object Instanced class
*/
private static function instance_class(string $class_name, array $args): object {
$class = new ReflectionClass($class_name);
// Return new instance of Enum from case name
if ($class->isEnum()) {
return $class_name::fromName(...$args);
}
return $class->newInstance(...$args);
}
/**
* Instance a new Controller for a given database Model
*
* @param Model An instance of a database Model entity
*/
public function __construct(private readonly Model $model) {}
/**
* Update a database entity by passing an assoc array of column => value
*
* @param array<array> Associative array of column keys and column values to update
* @return void
*/
public function update(array $values): void {
foreach($values as $key => $value) {
// Bail out if we're trying to update a column that has not been implemented
// by the passed database Model
if (!in_array($key, $this->model->columns)) {
continue;
}
$property = new ReflectionProperty($this->model, $key);
$types = self::get_types($property->getSettableType());
// Value is definitely a primitive
if (!is_string($value)) {
// Property does not accept this primitive as value, bail out
if (!in_array(gettype($value), $types)) {
continue;
}
// Set primitve value and move on
$this->model->{$key} = $value;
continue;
}
// Returns the name of the first class object
$class_name = array_find($types, fn(string $type): bool => class_exists($type));
// No class object found, string value must be literal
if (!$class_name) {
// Property does not accept string literals as value, bail out
if (!in_array("string", $types)) {
continue;
}
// Set string literal value and move on
$this->model->{$key} = $value;
continue;
}
// Wrap single value in an array (as one constructor argument)
if (!is_array($value)) {
$value = [$value];
}
$this->model->{$key} = self::instance_class($class_name, $value);
}
}
}

View file

@ -10,8 +10,7 @@
* Abstract reading, creating, and updating of database entities. * Abstract reading, creating, and updating of database entities.
*/ */
abstract class Model { abstract class Model {
public const DATE_FORMAT = Database::DATE_FORMAT; const DATE_FORMAT = Database::DATE_FORMAT;
public const DATETIME_FORMAT = Database::DATETIME_FORMAT;
abstract public string $id { get; } abstract public string $id { get; }
@ -37,9 +36,9 @@
* @param array<array> $where vlw/MySQL->where() to locate the target entity * @param array<array> $where vlw/MySQL->where() to locate the target entity
*/ */
public function __construct( public function __construct(
public readonly string $table, private readonly string $table,
public readonly array $columns, private readonly array $columns,
public readonly array $where private readonly array $where
) { ) {
$this->db = new Database(); $this->db = new Database();
} }

View file

@ -1,34 +0,0 @@
<?php
namespace vlw\Scaffold\Helpers;
class License {
public const MAGNET_END = PHP_EOL . "// @license-end";
public const GPL_V3_MAGNET = "// @license magnet:?xt=urn:btih:1f739d935676111cfff4b4693e3816e664797050&dn=gpl-3.0.txt GPL-v3-or-Later";
public const GPL_V3_BLOCK = "<script><!--//--><![CDATA[//><!--
/**
* @licstart The following is the entire license notice for the JavaScript
* code in this page.
*
* Copyright (C) 2020 Free Software Foundation.
*
* The JavaScript code in this page is free software: you can redistribute
* it and/or modify it under the terms of the GNU General Public License
* (GNU GPL) as published by the Free Software Foundation, either version 3
* of the License, or (at your option) any later version. The code is
* distributed WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU GPL
* for more details.
*
* As additional permission under GNU GPL version 3 section 7, you may
* distribute non-source (e.g., minimized or compacted) forms of that code
* without the copy of the GNU GPL normally required by section 4, provided
* you include this license notice and a URL through which recipients can
* access the Corresponding Source.
*
* @licend The above is the entire license notice for the JavaScript code
* in this page.
*/
//--><!]]></script>";
}