Laravel Blade模板中嵌入PHP代码的方法及表格新增列代码错误排查

Blade给咱们提供了几种灵活的方式来嵌入PHP代码，不用生硬地写原生<?php ?>标签，当然也支持原生写法，具体看场景：

• 多行PHP代码用@php指令：这是官方最推荐的方式，适合需要执行一段逻辑的场景，比如变量计算、循环处理等

  @php
      $totalPrice = 0;
      foreach($cartItems as $item) {
          $totalPrice += $item->quantity * $item->price;
      }
  @endphp
  

• 单行简单表达式：如果只是定义一个简单变量，也可以用原生PHP标签，但更推荐结合Blade的语法来输出

  <?php $currentUser = auth()->user(); ?>
  <!-- 或者直接输出的话用Blade echo -->
  {{ $currentUser->name ?? 'Guest' }}
  

• 直接输出PHP表达式结果：用{{ }}来安全输出（会自动转义HTML），如果需要输出原始HTML内容，用{!! !!}（注意防范XSS风险）

  {{ ucfirst($post->title) }}
  {!! '<em>'.$post->excerpt.'</em>' !!}
  

先看你写的这段代码：

@php 
$amount_to_be_collected = DB::table('shipments') 
    ->select('amount_to_be_collected') 
    ->where('mission_id', $mission->id) 
    ->get(); 
@endphp 
<td>{{format_price($amount_to_be_collected)}}</td>

这里有几个关键问题需要修正：

1. 查询返回的是集合而非单个数值 #

get()方法会返回一个Collection对象（哪怕只有一条匹配的记录），而你的format_price函数应该是期望接收一个数字类型的参数，直接传集合肯定会报错——比如函数尝试格式化一个对象，而不是数字。

解决办法分两种情况：

• 如果一个mission对应唯一一条shipment：用first()代替get()，然后取出字段值，同时处理空值情况

  @php 
  $shipment = DB::table('shipments') 
      ->select('amount_to_be_collected') 
      ->where('mission_id', $mission->id) 
      ->first(); 
  // 用空合并运算符处理无记录的情况，默认设为0
  $amount_to_be_collected = $shipment?->amount_to_be_collected ?? 0;
  @endphp 
  <td>{{format_price($amount_to_be_collected)}}</td>
  

• 如果一个mission对应多条shipment：用pluck()取出所有金额，再求和

  @php 
  $amounts = DB::table('shipments') 
      ->where('mission_id', $mission->id) 
      ->pluck('amount_to_be_collected');
  $amount_to_be_collected = $amounts->sum();
  @endphp 
  <td>{{format_price($amount_to_be_collected)}}</td>
  

2. 模板里写数据库查询不符合架构原则 #

Blade模板的职责应该是展示数据，而不是直接查询数据库。把查询逻辑放在模板里会让代码难以维护，也不符合MVC的设计思想。

更优的做法是利用Laravel的关联模型和预加载：

1. 先在Mission模型里定义和Shipment的关联：

   // app/Models/Mission.php
   public function shipments()
   {
       return $this->hasMany(Shipment::class);
   }
   

2. 在控制器中预加载关联并计算总金额：

   $missions = Mission::withSum('shipments', 'amount_to_be_collected')->get();
   

3. 最后在模板里直接使用预计算好的数据：

   <td>{{format_price($mission->shipments_sum_amount_to_be_collected ?? 0)}}</td>
   

这样代码更整洁，也更容易调试和维护。

3. 缺少空值处理 #

如果没有找到匹配的shipment记录，first()会返回null，直接访问$shipment->amount_to_be_collected会触发报错。上面的解决方案里用了?->可选链运算符和??空合并运算符，就是为了处理这种无数据的情况。

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