thinkphp8 应当安装 think-orm 4.0。think-orm 3.0 是 thinkphp6 的配套版本，而 think-orm 4.0 是专为 thinkphp8 设计的版本，两者在底层架构、依赖注入方式以及命名空间上存在显著差异，混用会导致严重的兼容性问题。
think-orm 3.0 与 4.0 的核心区别是什么
think-orm 3.0 和 4.0 的主要区别在于它们所依赖的 ThinkPHP 框架版本及相应的技术栈升级。think-orm 3.0 基于 ThinkPHP 6.x 构建，主要使用 PHP 7.2+ 语法特性；而 think-orm 4.0 则完全适配 ThinkPHP 8.x，要求 PHP 8.1+ 环境，并引入了更严格的类型声明和现代化的依赖管理结构。
composer require topthink/think-orm:^4.0
在实际开发中，如果你正在启动一个新的 ThinkPHP 8 项目，必须通过 Composer 明确指定安装 think-orm 4.0 版本。如果错误地安装了 3.0 版本，框架在尝试加载 ORM 相关的服务提供者时，会因为找不到对应的类或方法签名不匹配而抛出异常。例如，ThinkPHP 8 的服务容器机制与 6.x 有细微差别，ORM 的初始化流程也进行了重构，以确保与新的路由和中间件系统更好地协同工作。
立即学习“PHP免费学习笔记（深入）”；
此外，think-orm 4.0 对数据库连接池和查询构造器的性能进行了优化，特别是在处理复杂关联查询时，生成的 SQL 语句更加高效。它还支持更多的数据库驱动和高级特性，如原生查询的增强支持、事务管理的简化等。这些改进使得 think-orm 4.0 成为 ThinkPHP 8 生态系统中不可或缺的一部分。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
如何正确配置 think-orm 4.0 的连接参数
在 ThinkPHP 8 中配置 think-orm 4.0 的连接参数，主要通过修改 config/database.php 文件来实现。你需要确保在该文件中定义正确的数据库类型、主机地址、端口、用户名、密码以及数据库名称。同时，还需要设置字符集和排序规则，以保证数据的一致性和完整性。
// config/database.php
return [
'default' => 'mysql',
'connections' => [
'mysql' => [
'type' => 'mysql',
'hostname' => '127.0.0.1',
'database' => 'your_database',
'username' => 'your_username',
'password' => 'your_password',
'hostport' => '3306',
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'prefix' => '',
'debug' => true,
],
],
];
在配置过程中，务必注意 charset 和 collation 的设置，以避免中文乱码问题。同时，开启 debug 模式可以帮助你在开发阶段查看生成的 SQL 语句，便于调试和优化。完成配置后，可以通过一个简单的模型测试来验证连接是否成功。
think-orm 4.0 在处理空值输入时会返回什么
当 think-orm 4.0 接收到空值输入（如 null 或空字符串）时，其行为取决于具体的操作场景。在查询构造器中，如果传入的参数为空，通常会生成一个不包含该条件的 SQL 片段，或者根据默认行为忽略该条件。在模型赋值操作中，空值可能会被转换为数据库中的 NULL 或默认值，具体取决于字段定义和模型的 auto_write_timestamp 等配置。
$model = new User(); $model->name = null; $model->save(); // 将 name 字段设为 NULL
在上述代码中，$model->name = null; 会将 name 字段的值设置为 NULL，然后调用 save() 方法将其持久化到数据库中。如果 name 字段在数据库中被定义为 NOT NULL 且有默认值，那么实际存储的值将是该默认值。这种行为确保了数据的完整性和一致性，同时也为开发者提供了灵活的处理方式。
