使用 PHP 和 Laravel 构建快递/物流系统：可行性与优势

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class CourierOrder extends Model
{
    use HasFactory;

    // 定义可批量赋值的字段
    protected $fillable = [
        'customer_id',
        'driver_id',
        'pickup_address',
        'delivery_address',
        'status',
        'weight',
        'dimensions',
        'tracking_number',
    ];

    /**
     * 定义与客户的关系
     */
    public function customer()
    {
        return $this->belongsTo(User::class, 'customer_id');
    }

    /**
     * 定义与司机的关系
     */
    public function driver()
    {
        return $this->belongsTo(User::class, 'driver_id');
    }
}

// 在控制器中创建订单示例
use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
use App\Models\CourierOrder;
use App\Models\User; // 假设用户模型为User

class OrderController extends Controller
{
    /**
     * 存储新的快递订单
     */
    public function store(Request $request)
    {
        // 验证请求数据
        $request->validate([
            'pickup_address' => 'required|string|max:255',
            'delivery_address' => 'required|string|max:255',
            'weight' => 'required|numeric|min:0.1',
            // ... 其他验证规则
        ]);

        $order = CourierOrder::create([
            'customer_id' => auth()->id(), // 假设用户已登录
            'pickup_address' => $request->input('pickup_address'),
            'delivery_address' => $request->input('delivery_address'),
            'status' => 'pending', // 初始状态为待处理
            'weight' => $request->input('weight'),
            'tracking_number' => 'TRK' . time() . uniqid(), // 生成唯一的追踪号
        ]);

        return response()->json(['message' => 'Order created successfully', 'order' => $order], 201);
    }

    /**
     * 查询当前登录客户的所有订单
     */
    public function index()
    {
        // 假设User模型中定义了customerOrders关系
        // public function customerOrders() { return $this->hasMany(CourierOrder::class, 'customer_id'); }
        $orders = auth()->user()->customerOrders()->get();
        return response()->json($orders);
    }
}