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 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();
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -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