Laravel模型键类型？主键类型怎样设置？-Laravel-PHP中文网

Laravel模型键类型？主键类型怎样设置？

星降

发布： 2025-09-02 19:08:01

原创

578人浏览过

Laravel模型主键类型由$keyType属性决定，默认为int，可设为string等类型；若主键非自增需设置$incrementing = false；主键字段非id时需定义$primaryKey属性；Eloquent不直接支持复合主键，可通过唯一索引加查询方法模拟实现。

laravel模型键类型？主键类型怎样设置？

Laravel模型主键类型主要由

$keyType

登录后复制

属性决定，默认是自增的整数

int

登录后复制

，但你可以根据需求修改为字符串

string

登录后复制

或其它类型。设置主键类型，直接在模型类中定义

$keyType

登录后复制

属性即可。

解决方案：

要修改Laravel模型的主键类型，你需要在模型类中设置

$keyType

登录后复制

属性。同时，如果你的主键不是自增的整数，还需要禁用自动递增。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    /**
     * 指示是否自动递增模型 ID。
     *
     * @var bool
     */
    public $incrementing = false;

    /**
     * 模型的 "类型" 的自动递增 ID。
     *
     * @var string
     */
    protected $keyType = 'string';
}

登录后复制

上面的例子中，

$incrementing

登录后复制

设置为

false

登录后复制

，因为主键不是自增的。

$keyType

登录后复制

设置为

string

登录后复制

，表示主键是字符串类型。这样做之后，Laravel在操作

Product

登录后复制

模型时，就会按照字符串类型来处理主键。

模型主键自增ID如何修改？

如果你的主键是自增的，但不是默认的

int

登录后复制

类型，比如你想用

bigint

登录后复制

，实际上不需要修改

$keyType

登录后复制

，因为 Laravel 默认将自增的主键视为整数。你需要在数据库迁移文件中设置主键的类型为

bigInteger

登录后复制

。

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateProductsTable extends Migration
{
    /**
     * 运行数据库迁移。
     *
     * @return void
     */
    public function up()
    {
        Schema::create('products', function (Blueprint $table) {
            $table->bigIncrements('id'); // 使用 bigIncrements
            $table->string('name');
            $table->timestamps();
        });
    }

    /**
     * 回滚数据库迁移。
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('products');
    }
}

登录后复制

注意，如果你已经有数据表，并且修改了主键类型，可能需要手动迁移数据，或者先清空表再执行迁移。

Laravel模型主键名称不是id怎么办？

豆包大模型

字节跳动自主研发的一系列大型语言模型

834

查看详情

Laravel默认主键字段是

id

登录后复制

。如果你的表主键不是

id

登录后复制

，比如是

product_id

登录后复制

，那么需要在模型中定义

$primaryKey

登录后复制

属性。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    /**
     * 与模型关联的主键。
     *
     * @var string
     */
    protected $primaryKey = 'product_id';
}

登录后复制

这样，Laravel在查询

Product

登录后复制

模型时，就会使用

product_id

登录后复制

作为主键。

复合主键如何处理？

Laravel Eloquent ORM 本身并不直接支持复合主键。虽然可以绕过 ORM，直接使用 DB facade 进行操作，但这会失去 Eloquent 的便利性。

一个常见的替代方案是创建一个自增的

id

登录后复制

作为主键，然后将原来的复合主键字段设置为唯一索引。

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateOrderItemsTable extends Migration
{
    /**
     * 运行数据库迁移。
     *
     * @return void
     */
    public function up()
    {
        Schema::create('order_items', function (Blueprint $table) {
            $table->id(); // 自增主键
            $table->unsignedBigInteger('order_id');
            $table->unsignedBigInteger('product_id');
            $table->integer('quantity');
            $table->timestamps();

            $table->unique(['order_id', 'product_id']); // 复合唯一索引
        });
    }

    /**
     * 回滚数据库迁移。
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('order_items');
    }
}

登录后复制

然后在模型中，你可以定义一个方法来模拟复合主键的查询：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class OrderItem extends Model
{
    /**
     * 通过 order_id 和 product_id 查找记录。
     *
     * @param  int  $orderId
     * @param  int  $productId
     * @return \App\Models\OrderItem|null
     */
    public static function findByCompositeKey($orderId, $productId)
    {
        return static::where('order_id', $orderId)
                     ->where('product_id', $productId)
                     ->first();
    }
}

登录后复制

这种方法虽然不是真正的复合主键，但通常可以满足大部分需求，并且可以继续使用 Eloquent 的其他功能。当然，如果你的应用对复合主键有严格的要求，可能需要考虑使用更底层的数据库操作，或者寻找支持复合主键的第三方 Eloquent 扩展包。

以上就是Laravel模型键类型？主键类型怎样设置？的详细内容，更多请关注php中文网其它相关文章！