mirror of
https://codeberg.org/vlw/scaffold.git
synced 2026-01-13 15:06:00 +01:00
Compare commits
No commits in common. "2f6e24b0a1bc49f11edc4db07c660d73829cea3b" and "4fa45083d07019cf97cf13ce2cee8a1d2d1a67c9" have entirely different histories.
2f6e24b0a1
...
4fa45083d0
8 changed files with 27 additions and 177 deletions
|
|
@ -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);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -10,8 +10,7 @@
|
|||
* Abstract reading, creating, and updating of database entities.
|
||||
*/
|
||||
abstract class Model {
|
||||
public const DATE_FORMAT = Database::DATE_FORMAT;
|
||||
public const DATETIME_FORMAT = Database::DATETIME_FORMAT;
|
||||
const DATE_FORMAT = Database::DATE_FORMAT;
|
||||
|
||||
abstract public string $id { get; }
|
||||
|
||||
|
|
@ -37,9 +36,9 @@
|
|||
* @param array<array> $where vlw/MySQL->where() to locate the target entity
|
||||
*/
|
||||
public function __construct(
|
||||
public readonly string $table,
|
||||
public readonly array $columns,
|
||||
public readonly array $where
|
||||
private readonly string $table,
|
||||
private readonly array $columns,
|
||||
private readonly array $where
|
||||
) {
|
||||
$this->db = new Database();
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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>";
|
||||
}
|
||||
Loading…
Add table
Reference in a new issue