如何将CakePHP 1.3的哈希密码迁移至Laravel 5.6？

当然有可行方案！我之前帮团队做过类似的框架迁移，不用强制用户重置密码就能实现平滑过渡，下面是具体的步骤和细节：

首先得明确CakePHP 1.3的默认哈希逻辑：它采用SHA-1算法，结合应用级别的salt（通常存放在core.php的Configure::write('Security.salt')中），最终生成的哈希值是 sha1(原始密码 + salt) 的结果。如果你的项目自定义了哈希规则（比如多层哈希、替换算法），需要对应调整下面的验证逻辑。

步骤1：迁移并配置旧的salt值 #

1. 从CakePHP 1.3的配置文件里复制Security.salt的值。
2. 在Laravel的.env文件中添加新的环境变量：

   CAKE_LEGACY_SALT=你的CakePHP旧salt值
   

3. 在config/app.php中注册这个配置，方便后续调用：

   'cake_legacy_salt' => env('CAKE_LEGACY_SALT'),
   

步骤2：创建自定义密码验证逻辑 #

Laravel的Auth系统支持自定义验证规则，我们可以在AuthServiceProvider中注册一个回调，用来兼容CakePHP的旧哈希，甚至在用户登录成功后自动将密码升级为Laravel默认的bcrypt（更安全）。

修改app/Providers/AuthServiceProvider.php：

use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Hash;
use Illuminate\Contracts\Auth\Authenticatable;

public function boot()
{
    $this->registerPolicies();

    // 注册兼容CakePHP旧密码的验证器
    Auth::viaRequest('cake-legacy-auth', function ($request) {
        // 根据登录表单的邮箱/用户名查找用户
        $user = \App\User::where('email', $request->email)->first();

        if (!$user) {
            return null;
        }

        // 优先尝试Laravel默认的bcrypt验证（兼容已升级的用户）
        if (Hash::check($request->password, $user->password)) {
            return $user;
        }

        // 尝试CakePHP 1.3的哈希验证
        if ($this->validateCakePassword($request->password, $user->password)) {
            // 自动升级密码为bcrypt，后续登录就不用再处理旧哈希了
            $user->password = Hash::make($request->password);
            $user->save();

            return $user;
        }

        return null;
    });
}

/**
 * 验证CakePHP 1.3格式的哈希密码
 */
private function validateCakePassword(string $rawPassword, string $hashedPassword): bool
{
    $legacySalt = config('app.cake_legacy_salt');
    return sha1($rawPassword . $legacySalt) === $hashedPassword;
}

步骤3：配置Auth使用自定义验证器 #

打开config/auth.php，修改guards中的web驱动为request，并指定我们刚才注册的验证器：

'guards' => [
    'web' => [
        'driver' => 'request',
        'provider' => 'users',
        'via' => 'cake-legacy-auth', // 对应注册的验证器名称
    ],
    // 其他guard配置保持不变
],

关键注意事项 #

• 字段长度检查：CakePHP的SHA-1哈希是40字符，Laravel的bcrypt是60字符，建议把用户表的password字段修改为VARCHAR(255)，避免后续升级密码时出现截断问题。
• 自定义哈希兼容：如果你的CakePHP项目用了非默认的哈希逻辑（比如MD5、多层SHA1），只需要修改validateCakePassword方法里的哈希生成逻辑即可。
• 测试验证：迁移完成后，找几个测试用户用原密码登录，确认能正常登录，并且登录后数据库中的密码已更新为bcrypt格式。

内容的提问来源于stack exchange，提问作者CodingFlow