如何在 Slim 框架中正确使用 Eloquent ORM 插入数据-php教程-PHP中文网

如何在 Slim 框架中正确使用 Eloquent ORM 插入数据

本文详解在 slim（非 laravel）环境中集成 illuminate database 和 eloquent 时，插入数据失败的常见原因及完整解决方案，涵盖模型配置、时间戳字段缺失修复、数据库连接初始化和错误调试方法。

本文详解在 slim（非 laravel）环境中集成 illuminate database 和 eloquent 时，插入数据失败的常见原因及完整解决方案，涵盖模型配置、时间戳字段缺失修复、数据库连接初始化和错误调试方法。

在 Slim 框架中独立使用 Laravel 的 Eloquent ORM 是完全可行的，但需手动完成 Laravel 内部自动处理的诸多细节。你遇到的 500 Internal Error 并非 Eloquent 本身问题，而是由于 数据库表结构与 Eloquent 默认约定不匹配 导致插入失败——最典型的原因是：缺少 created_at 和 updated_at 时间戳字段。

Eloquent 的 create() 方法默认会尝试写入 created_at 和 updated_at 字段（除非显式禁用），而你的 users 表定义中并未包含这两个字段（仅含 created_on），导致 SQL 插入语句因字段不存在而报错。

✅ 正确做法如下：

1. 修正数据库表结构（推荐）

为兼容 Eloquent 默认行为，扩展表结构以支持 Laravel 时间戳约定：

ALTER TABLE `users`
ADD COLUMN `created_at` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP,
ADD COLUMN `updated_at` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;

⚠️ 注意：若你坚持使用 created_on/updated_on 等自定义字段名，请跳至第 2 步进行模型适配。

2. 在模型中禁用或重定义时间戳字段

若无法修改数据库结构，需在 User 模型中明确配置：

Mergeek

Mergeek是一个产品爱好者社区，专注于发现并介绍全球范围内的优质产品和项目

下载

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    protected $table = 'users';

    // ✅ 方案 A：完全禁用时间戳（适用于无任何时间字段的场景）
    public $timestamps = false;

    // ✅ 方案 B：启用自定义时间戳字段名（推荐，保留业务字段语义）
    // protected $table = 'users';
    // public $timestamps = true;
    // const CREATED_AT = 'created_on';
    // const UPDATED_AT = 'updated_on';

    protected $fillable = [
        'first_name',
        'last_name',
        // 若启用了自定义时间戳，也需将它们加入 fillable（除非设为自动维护）
    ];
}

? 提示：const CREATED_AT 和 UPDATED_AT 必须声明为 public static，且值为字符串（如 'created_on'），Eloquent 会自动在 create()/update() 时填充。

3. 确保数据库连接已正确初始化

Slim 不自带 Eloquent 初始化逻辑，务必在应用启动时手动配置连接：

// config/database.php 或 boot.php 中
use Illuminate\Database\Capsule\Manager as Capsule;

$capsule = new Capsule;
$capsule->addConnection([
    'driver'    => 'mysql',
    'host'      => 'localhost',
    'database'  => 'your_db_name',
    'username'  => 'your_username',
    'password'  => 'your_password',
    'charset'   => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix'    => '',
]);

// 设置全局静态访问（使 Model::xxx 可用）
$capsule->setAsGlobal();
// 启动 Eloquent 查询构建器
$capsule->bootEloquent();

4. Controller 中安全创建用户（含错误处理）

避免静默失败，应捕获异常并返回有意义的响应：

use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;

public function index(Request $request, Response $response)
{
    try {
        $data = [
            'first_name' => $request->getParam('first_name') ?: 'Guest', // 避免空值
            'last_name'  => $request->getParam('last_name') ?: 'Team',
        ];

        $user = \App\Models\User::create($data);

        return $response->withJson([
            'success' => true,
            'data'    => $user->toArray(),
            'message' => 'User created successfully.'
        ], 201);

    } catch (\Illuminate\Database\QueryException $e) {
        error_log('DB Error: ' . $e->getMessage());
        return $response->withStatus(500)->withJson([
            'success' => false,
            'error'   => 'Database error',
            'message' => 'Failed to insert user.',
        ]);
    } catch (\Exception $e) {
        error_log('General Error: ' . $e->getMessage());
        return $response->withStatus(500)->withJson([
            'success' => false,
            'error'   => 'Internal error',
            'message' => 'Something went wrong.',
        ]);
    }
}

✅ 关键检查清单

[ ] 数据库连接已通过 Capsule::bootEloquent() 启动
[ ] 模型 protected $fillable 包含所有待插入字段（且无拼写错误）
[ ] 表中存在 id 主键，且类型与 Eloquent 默认（BIGINT/INT）兼容；若使用 BIGINT，确保 PHP 支持大整数（PHP ≥ 7.1）
[ ] id 字段设置为 AUTO_INCREMENT（否则 create() 无法自动生成主键）
[ ] 开启 PHP 错误显示或查看日志，避免 500 掩盖真实 SQL 错误