{"id":942,"date":"2025-06-12T03:15:35","date_gmt":"2025-06-11T19:15:35","guid":{"rendered":"https:\/\/www.zhaozhao123.cn\/php\/php-application-manual\/laravel\/942.html"},"modified":"2025-06-12T03:15:35","modified_gmt":"2025-06-11T19:15:35","slug":"%e5%a6%82%e4%bd%95%e5%9c%a8-laravel-%e7%9a%84-eloquent-%e4%b8%ad%e4%bd%bf%e7%94%a8%e8%87%aa%e5%ae%9a%e4%b9%89%e8%a1%a8%e5%90%8d","status":"publish","type":"my1js","link":"https:\/\/www.zhaozhao123.cn\/php\/my1js\/942.html","title":{"rendered":"\u5982\u4f55\u5728 Laravel \u7684 Eloquent \u4e2d\u4f7f\u7528\u81ea\u5b9a\u4e49\u8868\u540d"},"content":{"rendered":"
\r\n
\r\n
\r\n
\r\n
\r\n
\"Bug编译狮\"<\/figure>\r\n\r\n\r\n\r\n

Bug编译狮<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
\r\n
\r\n

在 Laravel 中，如果你希望使用自定义的表名，可以通过配置文件来实现。以下是具体步骤：<\/p>\n

    \n
  1. \n

    编辑 config\/database.php<\/code> 文件<\/strong>：\n打开 config\/database.php<\/code> 文件，找到 connections<\/code> 部分，然后找到你要修改的数据库连接（例如 mysql<\/code> 或 pgsql<\/code>）。<\/p>\n<\/li>\n

  2. \n

    添加或修改 table<\/code> 字段<\/strong>：\n在每个数据库连接中，添加或修改 table<\/code> 字段，将其值设置为你想要使用的表名。<\/p>\n

    'mysql' => [\n   'driver' => 'mysql',\n   'host' => env('DB_HOST', '127.0.0.1'),\n   'port' => env('DB_PORT', 3306),\n   'database' => env('DB_DATABASE', 'forge'),\n   'username' => env('DB_USERNAME', 'forge'),\n   'password' => env('DB_PASSWORD', ''),\n   'charset' => 'utf8mb4',\n   'collation' => 'utf8mb4_unicode_ci',\n   'prefix' => '',\n   'strict' => false,\n   'engine' => null,\n   \/\/ 添加或修改 table 字段\n   'table' => 'custom_table_name',\n],<\/code><\/pre>\n<\/li>\n
  3. \n
    应用迁移<\/strong>：\n修改完 config\/database.php<\/code> 文件后，运行迁移命令以应用更改。<\/p>\n
    php artisan migrate<\/code><\/pre>\n
    这将根据你的配置创建一个新的表，并且这个新表的名字将是你指定的表名。<\/p>\n<\/li>\n<\/ol>\n
    示例代码<\/h3>\n
    以下是一个完整的示例，展示了如何在 config\/database.php<\/code> 文件中添加自定义表名，并在模型中使用它：<\/p>\n
    config\/database.php<\/h4>\n
    'default' => env('DB_CONNECTION', 'mysql'),\n\n'connections' => [\n    'mysql' => [\n        'driver' => 'mysql',\n        'host' => env('DB_HOST', '127.0.0.1'),\n        'port' => env('DB_PORT', 3306),\n        'database' => env('DB_DATABASE', 'forge'),\n        'username' => env('DB_USERNAME', 'forge'),\n        'password' => env('DB_PASSWORD', ''),\n        'charset' => 'utf8mb4',\n        'collation' => 'utf8mb4_unicode_ci',\n        'prefix' => '',\n        'strict' => false,\n        'engine' => null,\n        'table' => 'custom_table_name',\n    ],\n],<\/code><\/pre>\n
    AppModelsYourModel.php<\/h4>\n
    namespace AppModels;\n\nuse IlluminateDatabaseEloquentModel;\n\nclass YourModel extends Model\n{\n    protected $table = 'custom_table_name';\n}<\/code><\/pre>\n
    通过以上步骤，你可以轻松地在 Laravel 中使用自定义的表名。<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>
    \r\n
    \r\n
    \r\n
    \r\n
    \r\n
    \"黑板Bug讲师\"<\/figure>\r\n\r\n\r\n\r\n
    黑板Bug讲师<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
    \r\n
    \r\n
    介绍<\/h2>
    Eloquent ORM（对象关系映射器）是Laravel中的一个关键特性，它通过实现活动记录模式来简化与数据库的交互。根据惯例，Eloquent会根据类名的小写形式生成表名，并将其转换为单数形式。然而，这种做法可能不适用于所有人，尤其是在处理遗留数据库或应用程序时，如果表命名约定不同。Eloquent的一个最灵活的功能就是允许你在模型中自定义表名。在本教程中，我们将一步步指导您使用自定义表名的过程，涵盖从基础到更高级别场景的所有内容。<\/p>
    基本用法<\/h2>
    定义Eloquent中的表名的最简单方法是通过明确指定一个受保护的属性来实现。$table<\/code>在你的模型内部，可以这样定义：<\/p>
    class User extends Model {\n    protected $table = 'my_custom_users';\n}\n<\/code><\/pre>
    由于这一更改，Eloquent在查询User模型时会使用‘my_custom_users’而不是默认的‘users’表。<\/p>
    高级表名定义<\/h2>
    在指定自定义名称时，确实非常简单和直观，但在某些情况下，应用程序可能需要在运行时确定表名。你可以重写这个方法来实现这一点。getTable<\/code>在您的模型内部实现这一点的方法是什么：<\/p>
    class User extends Model {\n    public function getTable() {\n        return 'prefix_' . parent::getTable();\n    }\n}\n<\/code><\/pre>
    该代码动态设置表名，通过前缀来实现，这在多租户系统中非常有用，每个租户都有自己的表前缀。<\/p>
    与Schema Builder合作<\/h2>
    在创建迁移时，你应该确保在schema操作中使用正确的表名：<\/p>
    Schema::create('my_custom_users', function (Blueprint $table) {\n    \/\/ Define the schema for the my_custom_users table\n});\n<\/code><\/pre>
    记得在迁移时，将表名与模型中定义的名称保持一致。<\/p>
    与定制表名的关系<\/h2>
    在定义关系时，自定义表名也需要特别注意。你需要在关系方法中指定自定义表名。<\/p>
    class Post extends Model {\n    public function author() {\n        return $this->belongsTo(User::class, 'author_id', 'id');\n    }\n}\n<\/code><\/pre>
    默认情况下，的belongsTo<\/code>方法尝试链接到‘用户’表。由于Eloquent根据User模型配置自动处理了这一点，因此无需进行额外更改即可与‘我的自定义用户’表无缝集成。<\/p>
    查询使用自定义表名<\/h2>
    当查询具有自定义表名的模型时，不需要直接指定表名。像以下这样的查询可以直接使用：<\/p>
    $users = User::where('active', 1)->get();\n<\/code><\/pre>
    这个查询语句将会正确地与 ‘my_custom_users’ 表进行匹配。<\/p>
    结论。<\/h2>
    本教程探讨了在Laravel的Eloquent ORM中使用自定义表名的各种方法。您学习了如何显式定义自定义表名、动态设置表名以及在定义关系和编写迁移文件时如何处理自定义表名。遵循这些指导原则，您可以灵活地与任何数据库模式工作，同时利用Eloquent的强大功能。<\/p>
    当你开始处理Laravel项目时，要记住：惯例是工具，而不是规则。Eloquent与自定义表名的适应性正是Laravel设计为开发者而设的一个绝佳例子，它既强大又灵活。<\/p><\/body>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>
    \r\n
    \r\n
    \r\n
    \r\n
    \r\n
    \"长工码奴1523\"<\/figure>\r\n\r\n\r\n\r\n
    长工码奴1523<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
    \r\n
    \r\n
    在 Laravel 5.7 及更高版本中，你可以通过以下方式在 Eloquent 模型中使用自定义表名：<\/p>\n
      \n
    1. \n
      首先确保你在数据库配置文件（database.php<\/code>）中启用了 --table-prefix<\/code> 参数：<\/p>\n
      $connect->useDatabaseForMigration();\n$connect->setAsGlobalConnection('default');<\/code><\/pre>\n<\/li>\n
    2. \n
      创建一个新的迁移来修改数据库的表结构：<\/p>\n
      php artisan make:migration add_custom_column_to_table_name migration_name<\/code><\/pre>\n<\/li>\n
    3. \n
      在迁移脚本中添加自定义字段，并设置相应的字段类型和数据类型：<\/p>\n
      $table->string('custom_column', 100)->nullable()->after('column');<\/code><\/pre>\n<\/li>\n
    4. \n
      使用这个迁移来创建新表并应用自定义字段：<\/p>\n
      php artisan migrate --seed<\/code><\/pre>\n<\/li>\n
    5. \n
      现在，当你运行查询时，Laravel 将会自动将自定义字段的值与表名关联起来。<\/p>\n<\/li>\n
    6. \n
      示例代码（假设表名为 my_table<\/code>，自定义字段名为 custom_column<\/code>）：<\/p>\n<\/li>\n<\/ol>\n
      class MyModel extends Model\n{\n    use SoftDeletes;\n\n    protected $table = 'my_table';\n    protected $primaryKey = 'id';\n\n    public function getCustomColumnAttribute()\n    {\n        return $this->getAttribute('custom_column');\n    }\n}<\/code><\/pre>\n
      在这个例子中，当从数据库查询 MyModel<\/code> 对象中的 custom_column<\/code> 字段时，Laravel 会自动根据 my_table<\/code> 表名将其与 custom_column<\/code> 关联起来。<\/p>\n
      如果你需要更复杂的表名处理逻辑，例如根据特定的规则生成表名，可以考虑使用 Laravel 的 config<\/code> 文件系统，或者编写自定义的迁移和模型类。<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\n","protected":false},"excerpt":{"rendered":"
      Bug编译狮 在 Laravel 中，如果你希望使用自定义的表&#2..<\/p>\n","protected":false},"author":1,"featured_media":0,"menu_order":0,"template":"","meta":{"_acf_changed":false},"tags":[],"my1js2nav":[44],"tuisongtax":[],"class_list":["post-942","my1js","type-my1js","status-publish","hentry","my1js2nav-laravel"],"acf":{"qian_art_seotitle":"","qian_art_seotitle_source":{"label":"SEO\u6807\u9898","type":"text","formatted_value":""},"qian_art_seokws":"","qian_art_seokws_source":{"label":"SEO\u5173\u952e\u8bcd","type":"text","formatted_value":""},"qian_art_stzhong":"","qian_art_stzhong_source":{"label":"\u4e2d | \u77ed\u6807\u9898","type":"text","formatted_value":""}},"_links":{"self":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js\/942","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js"}],"about":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/types\/my1js"}],"author":[{"embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/media?parent=942"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tags?post=942"},{"taxonomy":"my1js2nav","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js2nav?post=942"},{"taxonomy":"tuisongtax","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tuisongtax?post=942"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}