如何在 PHP 中通过类属性定义数据库表结构并动态生成 SQL 表

本文介绍一种安全、可维护的 php 数据库建表方案：摒弃从方法内部变量反射提取字段的不可靠方式，转而使用显式声明的类属性（`$table` 和 `$columns`）配合基类继承，实现框架级表结构定义与自动化建表逻辑。

在构建轻量级 PHP 框架时，一个常见需求是将模型类自动映射为数据库表结构——例如类名作为数据库名（或前缀）、方法名作为表名、方法内局部变量作为字段定义。但原始思路（如题中 users() 方法内定义 $username="VARCHAR (255)"）存在根本性缺陷：PHP 无法在运行时可靠获取函数作用域内的局部变量名及其值。get_defined_vars() 仅在当前作用域内有效，且无法跨方法调用追溯；而 ReflectionFunction 也无法解析已编译的变量赋值语句，因此该方案在工程实践中不可行、不可调试、不可静态分析。

✅ 推荐替代方案：采用显式声明 + 面向对象建模
通过抽象基类统一约束模型结构，子类只需专注声明表名和字段定义，既保障类型安全，又支持 IDE 自动补全与静态检查。

以下为完整实现：

 '类型定义']
}

// 用户模型
class User extends Model
{
    public string $table = 'users';

    public array $columns = [
        'username' => 'VARCHAR(255) NOT NULL',
        'email'    => 'VARCHAR(255) UNIQUE',
        'password' => 'VARCHAR(255) NOT NULL',
        'created_at' => 'DATETIME DEFAULT CURRENT_TIMESTAMP',
    ];
}

// 商品模型
class Product extends Model
{
    public string $table = 'products';

    public array $columns = [
        'title'   => 'VARCHAR(255) NOT NULL',
        'price'   => 'DECIMAL(10,2) NOT NULL',
        'author'  => 'VARCHAR(255)',
        'status'  => "ENUM('draft','published') DEFAULT 'draft'",
    ];
}

// 分类模型
class Category extends Model
{
    public string $table = 'categories';

    public array $columns = [
        'category_name' => 'VARCHAR(255) NOT NULL',
        'slug'          => 'VARCHAR(255) UNIQUE',
        'parent_id'     => 'INT UNSIGNED NULL',
    ];
}

接着，构建 DatabaseBuilder 类，负责解析模型并生成/执行建表语句：

pdo = $pdo;
    }

    public function createTables(): void
    {
        $models = [
            new User(),
            new Product(),
            new Category(),
        ];

        foreach ($models as $model) {
            if (!$model instanceof Model) {
                throw new InvalidArgumentException('Model must extend Model class.');
            }

            $sql = $this->buildCreateTableSql($model);
            echo "Executing:\n{$sql}\n\n";
            $this->pdo->exec($sql);
        }
    }

    private function buildCreateTableSql(Model $model): string
    {
        $columnsSql = [];
        foreach ($model->columns as $column => $definition) {
            $columnsSql[] = "`{$column}` {$definition}";
        }

        return sprintf(
            'CREATE TABLE IF NOT EXISTS `%s` (%s);',
            $model->table,
            implode(', ', $columnsSql)
        );
    }
}

// 使用示例
try {
    $pdo = new \PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
    $builder = new DatabaseBuilder($pdo);
    $builder->createTables();
} catch (\Exception $e) {
    error_log('DB Build Failed: ' . $e->getMessage());
}

? 关键优势与注意事项：

• ✅ 可预测性：字段名与类型明确定义，无反射黑盒，便于验证、测试与文档生成；
• ✅ 可扩展性：后续可轻松添加索引、外键、默认值等高级特性（如扩展 $columns 为关联数组结构）；
• ⚠️ 避免魔法行为：不依赖 eval()、debug_backtrace() 或 token_get_all() 等高风险/低性能方案；
• ⚠️ 命名规范提醒：题中方法名 produts() 明显拼写错误，而基于属性的方案天然规避此类运行时才发现的低级错误；
• ? 进阶建议：可结合 PHP Attributes（PHP 8.0+）进一步声明约束（如 #[Index]、#[ForeignKey]），实现更丰富的 DDL 描述能力。

此模式已在 Laravel Eloquent、Symfony Doctrine 等成熟框架中被反复验证——清晰的契约优于隐式的约定。