Laravel+MSSQL在Ubuntu下日期字段格式异常问题求助

问题核心 #

Linux环境下MSSQL驱动（如FreeTDS）默认返回的date字段格式为美式字符串（如Jun 13 2023 12:00:00:AM），而Windows环境驱动返回格式符合Laravel预期，导致应用处理出错。以下是无需修改所有查询的解决方案：

解决方案1：模型中定义日期字段自动转换（推荐） #

Laravel支持将指定字段自动转换为Carbon日期对象，无需手动格式化：

在HrEmployeesInShift模型中添加$dates属性：

namespace Modules\HR\Entities;

use Illuminate\Database\Eloquent\Model;

class HrEmployeesInShift extends Model
{
    protected $fillable = [
        'employee_shift_master_id',
        'employee_id',
        'created_at',
        'updated_at',
        'deleted_at',
        'employee_company_info_id',
        'effect_from',
        'effect_to',
        'created_by',
        'updated_by',
        'deleted_by'
    ];

    // 新增：指定自动转换为Carbon对象的日期字段
    protected $dates = ['effect_from', 'effect_to', 'created_at', 'updated_at', 'deleted_at'];

    // 可选：控制序列化（如返回JSON）时的默认格式
    protected function serializeDate(\DateTimeInterface $date)
    {
        return $date->format('Y-m-d');
    }

    // 原有关联方法...
    public function employeeDetails()
    {
        return $this->belongsTo(HrEmployeeCompanyInfo::class,'employee_id','employee_id');
    }
    public function employeesShiftMaster()
    {
        return $this->belongsTo(HrEmployeeShiftMaster::class,'employee_shift_master_id','id');
    }
}

• 效果：effect_from和effect_to会被自动转为Carbon对象，可随时调用->format('Y-m-d')获取格式；如果定义了serializeDate，返回JSON时会直接输出Y-m-d格式。

解决方案2：为字段定义访问器 #

如果不想依赖Carbon对象，可直接在模型中定义访问器强制格式化：

namespace Modules\HR\Entities;

use Illuminate\Database\Eloquent\Model;
use Carbon\Carbon;

class HrEmployeesInShift extends Model
{
    // ... 原有代码 ...

    // 定义effect_from字段的访问器
    public function getEffectFromAttribute($value)
    {
        // 解析任意格式的日期字符串，返回Y-m-d格式
        return Carbon::parse($value)->format('Y-m-d');
    }

    // 定义effect_to字段的访问器
    public function getEffectToAttribute($value)
    {
        return Carbon::parse($value)->format('Y-m-d');
    }

    // ... 原有关联方法 ...
}

• 效果：无论驱动返回什么格式，获取$model->effect_from时都会自动返回Y-m-d格式的字符串。

解决方案3：修改MSSQL驱动配置（全局生效） #

修改Linux下的FreeTDS配置，强制返回ISO标准日期格式：

1. 编辑FreeTDS配置文件（通常路径为/etc/freetds/freetds.conf）
2. 在[global]或对应数据库的配置段中添加：

   date format = iso
   

3. 重启Web服务（如Nginx/Apache）和PHP-FPM

• 效果：所有MSSQL查询返回的date字段都会自动以YYYY-MM-DD格式返回，无需修改任何代码。

解决方案4：全局作用域自动格式化查询 #

如果需要在数据库层面格式化，可通过全局作用域自动注入FORMAT语句：

namespace Modules\HR\Entities;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class HrEmployeesInShift extends Model
{
    // ... 原有代码 ...

    protected static function booted()
    {
        static::addGlobalScope('date_format', function (Builder $query) {
            // 自动添加格式化后的字段，覆盖原字段名
            $query->selectRaw('*, FORMAT(effect_from, \'yyyy-MM-dd\') as effect_from, FORMAT(effect_to, \'yyyy-MM-dd\') as effect_to');
        });
    }

    // ... 原有关联方法 ...
}

• 效果：所有针对该模型的查询都会自动带上格式化后的日期字段，无需修改查询代码。

内容的提问来源于stack exchange，提问作者Shamnad K M