Laravel 交易 - PHP

Laravel 是一个优秀的 PHP 框架，其内置的 Eloquent ORM 和 Blade 模板引擎使得开发者能够快速准确地建立一个功能完整、代码易于维护的交易平台。

安装 Laravel

在安装 Laravel 之前，你需要确保你的系统满足 Laravel 的运行要求。详情请参考 Laravel 官方文档。

安装 Laravel 可以通过 Composer 进行，具体步骤如下：

composer create-project --prefer-dist laravel/laravel my-trading-platform

这将会在当前目录下创建一个名为 my-trading-platform 的 Laravel 项目。

设计数据库结构

在建立交易平台之前，我们需要设计全面的数据库结构。举个例子，如果你的平台有商品和订单两个概念，那么它们的数据库结构可能如下：

商品

| 字段名 | 类型 | 描述 | | --- | --- | --- | | id | integer | 商品 ID | | name | string | 商品名称 | | price | float | 商品价格（单价） | | stock | integer | 商品库存 |

订单

| 字段名 | 类型 | 描述 | | --- | --- | --- | | id | integer | 订单 ID | | user_id | integer | 所属用户 ID | | total_price | float | 订单总价 | | status | string | 订单状态 |

建立模型与数据库关联

在 Laravel 中，模型是一个贯穿于整个应用程序的核心组成部分，它们负责与数据库的交互。我们可以通过以下代码建立商品和订单两个模型：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    protected $fillable = ['name', 'price', 'stock'];
  
  public function orders()
  {
      return $this->belongsToMany(Order::class)->withPivot('quantity');
  }
}

class Order extends Model
{
    protected $fillable = ['user_id', 'total_price', 'status'];
  
  public function user()
  {
      return $this->belongsTo(User::class);
  }
  
  public function products()
  {
      return $this->belongsToMany(Product::class)->withPivot('quantity');
  }
}

我们可以看到，Product 模型有一个关联方法 orders，这表示一个商品可以被多个订单拥有。而 Order 模型则有两个关联方法，user 和 products，这表示一个订单的属性与某个用户和多个商品相关联。

建立控制器与路由

在建立好模型之后，我们需要将其包装成 API 供给前端调用。这需要我们建立控制器和路由，让 Laravel 帮我们将请求分发至不同的控制器。

下面的代码演示了建立商品和订单 API 的示范：

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Product;

class ProductController extends Controller
{
    public function index()
    {
        return Product::all();
    }

    public function store(Request $request)
    {
        $product = Product::create($request->all());

        return response()->json($product, 201);
    }

    public function show(Product $product)
    {
        return $product;
    }

    public function update(Request $request, Product $product)
    {
        $product->update($request->all());

        return response()->json($product, 200);
    }

    public function delete(Product $product)
    {
        $product->delete();

        return response()->json(null, 204);
    }
}

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\Order;

class OrderController extends Controller
{
    public function index()
    {
        return Order::all();
    }

    public function store(Request $request)
    {
        $order = Order::create([
            'user_id' => 1,
            'total_price' => 0,
            'status' => 'unpaid'
        ]);

        $products = $request->input('products');

        foreach ($products as $product) {
            $quantity = $product['quantity'];
            $product = Product::find($product['id']);

            $order->products()->attach($product, ['quantity' => $quantity]);
            $order->total_price += $product->price * $quantity;
            $product->stock -= $quantity;
            $product->save();
        }

        $order->save();

        return response()->json($order, 201);
    }

    public function show(Order $order)
    {
        $order->products;

        return $order;
    }

    public function update(Request $request, Order $order)
    {
        $order->update($request->all());

        return response()->json($order, 200);
    }

    public function delete(Order $order)
    {
        $order->delete();

        return response()->json(null, 204);
    }
}

use Illuminate\Support\Facades\Route;

Route::get('/products', [ProductController::class, 'index']);
Route::post('/products', [ProductController::class, 'store']);
Route::get('/products/{product}', [ProductController::class, 'show']);
Route::put('/products/{product}', [ProductController::class, 'update']);
Route::delete('/products/{product}', [ProductController::class, 'delete']);

Route::get('/orders', [OrderController::class, 'index']);
Route::post('/orders', [OrderController::class, 'store']);
Route::get('/orders/{order}', [OrderController::class, 'show']);
Route::put('/orders/{order}', [OrderController::class, 'update']);
Route::delete('/orders/{order}', [OrderController::class, 'delete']);

这些代码演示了建立商品和订单控制器的基本用法，并将其定义在 /products 和 /orders 路由之中，分别用于列举商品和订单、创建商品和订单、查看单一商品和订单、更新商品和订单以及删除商品和订单。

建立 Blade 模板

除了 API 之外，我们还需要建立一个 UI 来供用户调用这些 API。Blade 模板引擎是 Laravel 的内置模板引擎，它能让开发者以简洁、高效的方式建立漂亮的、易于操作的前端页面。

下面是一个建立商品列表和订单列表的 Blade 模板示例：

<!-- resources/views/products/index.blade.php -->
@extends('layout')

@section('content')
    <div class="container">
        <h1 class="text-center">Products</h1>
        <table class="table">
            <thead>
                <tr>
                    <th>ID</th>
                    <th>Name</th>
                    <th>Price</th>
                    <th>Stock</th>
                    <th></th>
                </tr>
            </thead>
            <tbody>
                @foreach ($products as $product)
                    <tr>
                        <td>{{ $product->id }}</td>
                        <td>{{ $product->name }}</td>
                        <td>{{ $product->price }}</td>
                        <td>{{ $product->stock }}</td>
                        <td>
                            <a href="{{ route('products.edit', $product) }}" class="btn btn-primary">Edit</a>
                            <form action="{{ route('products.destroy', $product) }}" method="POST" style="display: inline;">
                                @csrf
                                @method('DELETE')
                                <button class="btn btn-danger">Delete</button>
                            </form>
                        </td>
                    </tr>
                @endforeach
            </tbody>
        </table>
        <a href="{{ route('products.create') }}" class="btn btn-success">Create</a>
    </div>
@stop

<!-- resources/views/orders/index.blade.php -->
@extends('layout')

@section('content')
    <div class="container">
        <h1 class="text-center">Orders</h1>
        <table class="table">
            <thead>
                <tr>
                    <th>ID</th>
                    <th>User ID</th>
                    <th>Total Price</th>
                    <th>Status</th>
                    <th></th>
                </tr>
            </thead>
            <tbody>
                @foreach ($orders as $order)
                    <tr>
                        <td>{{ $order->id }}</td>
                        <td>{{ $order->user_id }}</td>
                        <td>{{ $order->total_price }}</td>
                        <td>{{ $order->status }}</td>
                        <td>
                            <a href="{{ route('orders.edit', $order) }}" class="btn btn-primary">Edit</a>
                            <form action="{{ route('orders.destroy', $order) }}" method="POST" style="display: inline;">
                                @csrf
                                @method('DELETE')
                                <button class="btn btn-danger">Delete</button>
                            </form>
                        </td>
                    </tr>
                @endforeach
            </tbody>
        </table>
        <a href="{{ route('orders.create') }}" class="btn btn-success">Create</a>
    </div>
@stop

这些 Blade 模板会根据我们建立的控制器和路由，自动地掌握列表的页头页脚、数据的渲染方式以及编辑和删除操作的实现方法。我们只需要关注模板的 UI，并保证模板能够正确地访问到相应的控制器和模型即可。

总结

Laravel 框架的强大功能为建立一个功能完整、代码易于维护的交易平台提供了先决条件。在本文中，我们简单演示了建立交易平台的基本流程，包括设计数据库结构、建立模型与数据库关联、建立控制器与路由以及建立 Blade 模板等环节。

在使用 Laravel 进行交易平台开发时，需要我们具备扎实的 PHP 编程能力，并掌握 Eloquent ORM 和 Blade 模板引擎等 Laravel 基本框架。只有将这些基本技能打造得精益求精，才能更高效地完成一个出色的交易平台的建立。