本文旨在指导开发者将基于 Laravel 框架且使用 MS SQL Server 数据库的项目迁移到 MySQL 数据库。文章将详细介绍在不迁移数据以及需要迁移数据两种情况下的具体步骤，包括数据库配置、缓存清理、路由测试以及数据库结构重建等操作，并提供必要的代码示例和注意事项，帮助开发者顺利完成迁移过程。
将 Laravel 项目从 MS SQL Server 迁移到 MySQL 涉及多个步骤，需要谨慎操作以确保应用程序的稳定运行。以下将分别介绍在不需要迁移数据和需要迁移数据两种情况下的迁移方法。
一、无需迁移数据的情况
如果你的项目只需要迁移逻辑，而不需要保留原有的数据，那么迁移过程相对简单。
创建新的 MySQL 数据库： 首先，在 MySQL 服务器上创建一个新的数据库，用于存储 Laravel 应用的数据。
-
配置 .env 文件： 修改 Laravel 项目根目录下的 .env 文件，将数据库连接信息更改为 MySQL 的配置。例如：
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=my-db-name-here DB_USERNAME=root DB_PASSWORD=
请根据你的 MySQL 服务器配置修改 DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME 和 DB_PASSWORD 的值。
-
清理缓存： 清理 Laravel 应用的缓存，以确保新的数据库配置生效。依次执行以下 Artisan 命令：
php artisan config:clear --no-ansi php artisan cache:clear --no-ansi composer dump-autoload php artisan view:clear --no-ansi php artisan route:clear --no-ansi
这些命令分别用于清除配置缓存、应用缓存、重新生成自动加载文件、清除视图缓存和路由缓存。
-
测试路由： 运行以下 Artisan 命令，检查路由是否正常工作：
php artisan route:list --no-ansi
该命令会列出所有已定义的路由，你可以检查它们是否正确指向控制器和视图。
-
重建数据库结构： 运行数据库迁移命令，重新创建数据库表结构：
php artisan migrate --no-ansi
该命令会执行 database/migrations 目录下的所有迁移文件，创建对应的表结构。
-
可选：运行数据填充： 如果你的项目有数据填充（Seed）文件，可以运行以下命令来填充初始数据：
php artisan db:seed --no-ansi
该命令会执行 database/seeders 目录下的所有 Seed 文件。
二、需要迁移数据的情况
如果需要将 MS SQL Server 中的数据迁移到 MySQL，过程会稍微复杂一些。
按照上述步骤 1-4 操作，配置 MySQL 数据库并清理缓存。
-
数据迁移方法选择： 有两种主要的数据迁移方法：
- 直接复制数据： 使用专门的工具或脚本，直接从 MS SQL Server 数据库复制数据到 MySQL 数据库。可以参考一些在线教程，例如：https://www.php.cn/link/6b3825881c0f630382026fc43ba12869。这种方法通常需要对数据库结构和数据类型进行兼容性处理。
-
SQL 文件转换：
- 导出 MS SQL Server 数据库为 SQL 文件（或压缩包）。
- 寻找或选择一个工具，将 SQL 文件从 MS SQL Server 的语法/格式转换为 MySQL 的语法/格式。
- 将转换后的 SQL 文件导入到 MySQL 数据库中。
重建数据库结构和填充数据： 在数据迁移完成后，可以运行 php artisan migrate --no-ansi 来确保所有表结构都已正确创建。如果需要，还可以运行 php artisan db:seed --no-ansi 来填充数据。
注意事项：
- 数据类型兼容性： MS SQL Server 和 MySQL 在数据类型上存在差异，例如 nvarchar 和 varchar，datetime 和 timestamp 等。在迁移数据时，需要注意这些差异，并进行相应的转换，以避免数据丢失或错误。
- 字符编码： 确保 MySQL 数据库的字符编码与 MS SQL Server 数据库的字符编码一致，以避免乱码问题。
- 外键约束： 如果你的数据库中有外键约束，在迁移数据时需要特别注意，确保外键关系正确。
- 测试： 在完成迁移后，务必进行全面的测试，确保应用程序的各项功能正常工作。
总结：
将 Laravel 项目从 MS SQL Server 迁移到 MySQL 需要仔细规划和执行。根据是否需要迁移数据，选择合适的迁移方法。在迁移过程中，要注意数据类型兼容性、字符编码和外键约束等问题。最后，进行全面的测试，确保应用程序的稳定运行。
