Laravel Excel导入时生成自定义递增ID的策略与实践

// app/Models/Tempdat.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Tempdat extends Model
{
    // 定义可填充字段，确保 employee_id 也是可填充的
    protected $fillable = [
        'name', 'gender', 'bod', 'engagement_code', 'client_code', 'employee_id'
    ];

    // 其他模型方法...

    /**
     * 模型启动时注册事件监听器
     */
    protected static function booted()
    {
        // 监听 'created' 事件，即记录首次保存到数据库后
        static::created(function (Tempdat $tempdat) {
            // 确保 client_code 在模型创建时已存在
            $clientCode = $tempdat->client_code;

            // 将数据库自增ID格式化为4位带前导零的字符串
            // 例如，id=1 -> "0001", id=123 -> "0123"
            $paddedId = str_pad($tempdat->id, 4, '0', STR_PAD_LEFT);

            // 组合生成 employee_id
            $tempdat->employee_id = $clientCode . $paddedId;

            // 静默保存模型，避免再次触发事件循环
            // saveQuietly() 会跳过所有模型事件，防止无限循环
            $tempdat->saveQuietly();
        });
    }
}

// app/Imports/DataImport.php
namespace App\Imports;

use App\Models\Tempdat;
use Maatwebsite\Excel\Concerns\ToModel;
use Maatwebsite\Excel\Concerns\WithStartRow;
use Carbon\Carbon;
use PhpOffice\PhpSpreadsheet\Shared\Date;

class DataImport implements ToModel, WithStartRow
{
    private $engagementCode;
    private $clientCode;

    /**
     * 构造函数，接收控制器传递的参数
     */
    public function __construct(string $engagementCode, string $clientCode)
    {
        $this->engagementCode = $engagementCode;
        $this->clientCode = $clientCode;
    }

    /**
     * 将每一行数据映射到模型
     */
    public function model(array $row)
    {
        return new Tempdat([
            'name' => $row[1],
            'gender' => $row[2],
            'bod' => $this->transformDate($row[3]),
            'engagement_code' => $this->engagementCode, // 使用构造函数传入的值
            'client_code' => $this->clientCode,       // 使用构造函数传入的值
            // employee_id 字段无需在此处设置，它将在模型创建后由事件自动生成
        ]);
    }

    /**
     * 处理Excel日期格式转换为Carbon日期对象
     */
    public function transformDate($value, $format = 'Y-m-d')
    {
        try {
            return Carbon::instance(Date::excelToDateTimeObject($value));
        } catch (\ErrorException $e) {
            return Carbon::createFromFormat($format, $value);
        }
    }

    /**
     * 指定从Excel的哪一行开始读取数据
     */
    public function startRow(): int
    {
        return 2; // 从第二行开始读取，跳过表头
    }
}

// app/Http/Controllers/DataController.php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Maatwebsite\Excel\Facades\Excel;
use App\Imports\DataImport;

class DataController extends Controller
{
    /**
     * 处理Excel文件导入
     */
    public function ImportExcel(Request $request)
    {
        // 验证请求数据，确保文件和必要参数存在
        $this->validate($request, [
            'file' => 'required|mimes:xls,xlsx',
            'engagement_code' => 'required|string',
            'client_code' => 'required|string', // 确保 client_code 也被验证
        ]);

        $file = $request->file('file');
        $clientCode = $request->input('client_code'); // 使用 input() 方法获取参数
        $engagementCode = $request->input('engagement_code');
        $todayDate = date('dFY');

        // 构建文件存储路径和名称
        $file_name = $engagementCode . '_' . $todayDate . $file->getClientOriginalName();
        $file->move(public_path('tempdat'), $file_name); // 将文件移动到指定目录

        // 实例化 DataImport 类，并传入必要的参数
        Excel::import(new DataImport($engagementCode, $clientCode), public_path('/tempdat/' . $file_name));

        // 导入成功后重定向
        return redirect()->route('dashboard.tempdat.index')->with('success', '数据导入成功！');
    }
}