Feat attributes

WebFiori/Database/AbstractQuery.php

@@ -3,7 +3,7 @@
 /**
  * This file is licensed under MIT License.
  * 
- * Copyright (c) 2019 Ibrahim BinAlshikh
+ * Copyright (c) 2019-present WebFiori Framework
  * 
  * For more information on the license, please visit: 
  * https://github.com/WebFiori/.github/blob/main/LICENSE
@@ -14,6 +14,9 @@
 use Throwable;
 use WebFiori\Database\MsSql\MSSQLQuery;
 use WebFiori\Database\MySql\MySQLQuery;
+use WebFiori\Database\Query\Condition;
+use WebFiori\Database\Query\Expression;
+use WebFiori\Database\Query\InsertBuilder;
 /**
  * A base class that can be used to build SQL queries.
  * 

WebFiori/Database/Attributes/AttributeTableBuilder.php

@@ -0,0 +1,151 @@
+<?php
+namespace WebFiori\Database\Attributes;
+
+use ReflectionClass;
+use WebFiori\Database\ColOption;
+use WebFiori\Database\DataType;
+use WebFiori\Database\MsSql\MSSQLTable;
+use WebFiori\Database\MySql\MySQLTable;
+use WebFiori\Database\Table as TableClass;
+
+class AttributeTableBuilder {
+    public static function build(string $entityClass, string $dbType = 'mysql'): TableClass {
+        $reflection = new ReflectionClass($entityClass);
+
+        $tableAttr = $reflection->getAttributes(Table::class)[0] ?? null;
+
+        if (!$tableAttr) {
+            throw new \RuntimeException("Class $entityClass must have #[Table] attribute");
+        }
+
+        $tableConfig = $tableAttr->newInstance();
+
+        $table = $dbType === 'mysql' 
+            ? new MySQLTable($tableConfig->name) 
+            : new MSSQLTable($tableConfig->name);
+
+        if ($tableConfig->comment) {
+            $table->setComment($tableConfig->comment);
+        }
+
+        $columns = [];
+        $foreignKeys = [];
+
+        // Check for class-level Column attributes
+        $classColumnAttrs = $reflection->getAttributes(Column::class);
+
+        if (!empty($classColumnAttrs)) {
+            // Class-level approach: columns defined at class level
+            foreach ($classColumnAttrs as $columnAttr) {
+                $columnConfig = $columnAttr->newInstance();
+                $columnKey = $columnConfig->name ?? throw new \RuntimeException("Column name is required for class-level attributes");
+
+                $columns[$columnKey] = [
+                    ColOption::TYPE => $columnConfig->type,
+                    ColOption::NAME => $columnConfig->name,
+                    ColOption::SIZE => $columnConfig->size,
+                    ColOption::SCALE => $columnConfig->scale,
+                    ColOption::PRIMARY => $columnConfig->primary,
+                    ColOption::UNIQUE => $columnConfig->unique,
+                    ColOption::NULL => $columnConfig->nullable,
+                    ColOption::AUTO_INCREMENT => $columnConfig->autoIncrement,
+                    ColOption::IDENTITY => $columnConfig->identity,
+                    ColOption::AUTO_UPDATE => $columnConfig->autoUpdate,
+                    ColOption::DEFAULT => $columnConfig->default,
+                    ColOption::COMMENT => $columnConfig->comment,
+                    ColOption::VALIDATOR => $columnConfig->callback
+                ];
+            }
+
+            // Check for class-level ForeignKey attributes
+            $classFkAttrs = $reflection->getAttributes(ForeignKey::class);
+
+            foreach ($classFkAttrs as $fkAttr) {
+                $fkConfig = $fkAttr->newInstance();
+                $foreignKeys[] = [
+                    'property' => $fkConfig->column,
+                    'config' => $fkConfig
+                ];
+            }
+        } else {
+            // Property-level approach: columns defined on properties
+            foreach ($reflection->getProperties() as $property) {
+                $columnAttrs = $property->getAttributes(Column::class);
+
+                if (empty($columnAttrs)) {
+                    continue;
+                }
+
+                $columnConfig = $columnAttrs[0]->newInstance();
+                $columnKey = self::propertyToKey($property->getName());
+
+                $columns[$columnKey] = [
+                    ColOption::TYPE => $columnConfig->type,
+                    ColOption::NAME => $columnConfig->name,
+                    ColOption::SIZE => $columnConfig->size,
+                    ColOption::SCALE => $columnConfig->scale,
+                    ColOption::PRIMARY => $columnConfig->primary,
+                    ColOption::UNIQUE => $columnConfig->unique,
+                    ColOption::NULL => $columnConfig->nullable,
+                    ColOption::AUTO_INCREMENT => $columnConfig->autoIncrement,
+                    ColOption::IDENTITY => $columnConfig->identity,
+                    ColOption::AUTO_UPDATE => $columnConfig->autoUpdate,
+                    ColOption::DEFAULT => $columnConfig->default,
+                    ColOption::COMMENT => $columnConfig->comment,
+                    ColOption::VALIDATOR => $columnConfig->callback
+                ];
+
+                $fkAttrs = $property->getAttributes(ForeignKey::class);
+
+                foreach ($fkAttrs as $fkAttr) {
+                    $fkConfig = $fkAttr->newInstance();
+                    $foreignKeys[] = [
+                        'property' => $columnKey,
+                        'config' => $fkConfig
+                    ];
+                }
+            }
+        }
+
+        $table->addColumns($columns);
+
+        // Store table references for foreign keys
+        $tableRegistry = [];
+
+        foreach ($foreignKeys as $fk) {
+            $refTableName = $fk['config']->table;
+            $refColName = $fk['config']->column;
+
+            // Create a minimal table reference if not exists
+            if (!isset($tableRegistry[$refTableName])) {
+                $refTable = $dbType === 'mysql' 
+                    ? new MySQLTable($refTableName) 
+                    : new MSSQLTable($refTableName);
+
+                // Add the referenced column to make FK work
+                $refTable->addColumns([
+                    $refColName => [
+                        ColOption::TYPE => DataType::INT,
+                        ColOption::PRIMARY => true
+                    ]
+                ]);
+
+                $tableRegistry[$refTableName] = $refTable;
+            }
+
+            $table->addReference(
+                $tableRegistry[$refTableName],
+                [$fk['property'] => $refColName],
+                $fk['config']->name ?? 'fk_'.$fk['property'],
+                $fk['config']->onUpdate,
+                $fk['config']->onDelete
+            );
+        }
+
+        return $table;
+    }
+
+    private static function propertyToKey(string $propertyName): string {
+        return strtolower(preg_replace('/([a-z])([A-Z])/', '$1-$2', $propertyName));
+    }
+}

WebFiori/Database/Attributes/Column.php

@@ -0,0 +1,24 @@
+<?php
+namespace WebFiori\Database\Attributes;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
+class Column {
+    public function __construct(
+        public string $type,
+        public ?int $size = null,
+        public ?int $scale = null,
+        public bool $primary = false,
+        public bool $unique = false,
+        public bool $nullable = false,
+        public bool $autoIncrement = false,
+        public bool $identity = false,
+        public bool $autoUpdate = false,
+        public mixed $default = null,
+        public ?string $name = null,
+        public ?string $comment = null,
+        public mixed $callback = null
+    ) {
+    }
+}

WebFiori/Database/Attributes/ForeignKey.php

@@ -0,0 +1,16 @@
+<?php
+namespace WebFiori\Database\Attributes;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
+class ForeignKey {
+    public function __construct(
+        public string $table,
+        public string $column,
+        public ?string $name = null,
+        public string $onUpdate = 'set null',
+        public string $onDelete = 'set null'
+    ) {
+    }
+}

WebFiori/Database/Attributes/Table.php

@@ -0,0 +1,13 @@
+<?php
+namespace WebFiori\Database\Attributes;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_CLASS)]
+class Table {
+    public function __construct(
+        public string $name,
+        public ?string $comment = null
+    ) {
+    }
+}

WebFiori/Database/ColOption.php

@@ -3,7 +3,7 @@
 /**
  * This file is licensed under MIT License.
  * 
- * Copyright (c) 2024 Ibrahim BinAlshikh
+ * Copyright (c) 2024-present WebFiori Framework
  * 
  * For more information on the license, please visit: 
  * https://github.com/WebFiori/.github/blob/main/LICENSE

WebFiori/Database/Column.php

@@ -3,7 +3,7 @@
 /**
  * This file is licensed under MIT License.
  * 
- * Copyright (c) 2019 Ibrahim BinAlshikh
+ * Copyright (c) 2019-present WebFiori Framework
  * 
  * For more information on the license, please visit: 
  * https://github.com/WebFiori/.github/blob/main/LICENSE
@@ -325,15 +325,11 @@ public function getOwner() {
      * the column to an entity class. For example, the 'varchar' in MySQL is 
      * a 'string' in PHP.
      * 
-     * @return string A string that represents column datatype in PHP.
+     * @return string A string that represents column datatype in PHP (int, float, bool, string).
      * 
      */
     public function getPHPType() : string {
-        if ($this->getDatatype() == 'char') {
-            return 'string';
-        }
-
-        return 'mixed';
+        return DataType::toPHPType($this->getDatatype());
     }
     /**
      * Returns the previous table which was owns the column.

WebFiori/Database/Connection.php

@@ -3,7 +3,7 @@
 /**
  * This file is licensed under MIT License.
  * 
- * Copyright (c) 2019 Ibrahim BinAlshikh
+ * Copyright (c) 2019-present WebFiori Framework
  * 
  * For more information on the license, please visit: 
  * https://github.com/WebFiori/.github/blob/main/LICENSE

WebFiori/Database/ConnectionInfo.php

@@ -3,7 +3,7 @@
 /**
  * This file is licensed under MIT License.
  * 
- * Copyright (c) 2019 Ibrahim BinAlshikh
+ * Copyright (c) 2019-present WebFiori Framework
  * 
  * For more information on the license, please visit: 
  * https://github.com/WebFiori/.github/blob/main/LICENSE

WebFiori/Database/DataType.php

@@ -3,7 +3,7 @@
 /**
  * This file is licensed under MIT License.
  * 
- * Copyright (c) 2024 Ibrahim BinAlshikh
+ * Copyright (c) 2024-present WebFiori Framework
  * 
  * For more information on the license, please visit: 
  * https://github.com/WebFiori/.github/blob/main/LICENSE
@@ -204,4 +204,19 @@ class DataType {
      * </ul>
      */
     const VARCHAR = 'varchar';
+
+    /**
+     * Maps database data type to PHP type.
+     * 
+     * @param string $dbType The database data type
+     * @return string The PHP type (int, float, bool, string)
+     */
+    public static function toPHPType(string $dbType): string {
+        return match (strtolower($dbType)) {
+            self::INT, self::BIGINT => 'int',
+            self::FLOAT, self::DOUBLE, self::DECIMAL, self::MONEY => 'float',
+            self::BOOL, self::BIT => 'bool',
+            default => 'string'
+        };
+    }
 }