grid->column($field, $label);
}
/**
* 添加用户安全信息组合列
*
* 复用价值：高 - 将用户安全相关信息组合显示，提高信息密度
*
* @param string $secretPasswordField 安全密码字段名
* @param string $lastCheckAtField 最后验证时间字段名
* @param string $label 标签名
* @return Column
*/
public function columnUserSecurity(string $secretPasswordField = 'secret_password', string $lastCheckAtField = 'last_check_at', string $label = '安全信息'): Column
{
return $this->grid->column($secretPasswordField, $label)->display(function ($secretPassword) use ($lastCheckAtField) {
$lastCheckAt = $this->{$lastCheckAtField} ?? '';
$secretPasswordHtml = "安全密码: " . ($secretPassword ? '已设置' : '未设置') . "
";
$lastCheckAtHtml = $lastCheckAt ? "最后验证: {$lastCheckAt}
" : '';
return $secretPasswordHtml . $lastCheckAtHtml;
});
}
/**
* 添加时间信息组合列 - 使用统一的时间格式化
*
* 复用价值：高 - 将创建时间和更新时间组合显示，提高信息密度
*
* @param string $createdAtField 创建时间字段名
* @param string $updatedAtField 更新时间字段名
* @param string $label 标签名
* @return Column
*/
public function columnTimes($createdAtField = 'created_at', $updatedAtField = 'updated_at', $label = '时间信息'): Column
{
return $this->grid->column($createdAtField, $label)->display(function ($createdAt) use ($updatedAtField) {
$updatedAt = $this->{$updatedAtField} ?? '';
// 使用静态方法进行时间格式化
$createdAtFormatted = self::formatDateTimeStatic($createdAt);
$createdAtHtml = "创建: {$createdAtFormatted}
";
$updatedAtHtml = '';
if ($updatedAt) {
$updatedAtFormatted = self::formatDateTimeStatic($updatedAt);
$updatedAtHtml = "更新: {$updatedAtFormatted}
";
}
return $createdAtHtml . $updatedAtHtml;
})->sortable();
}
/**
* 格式化时间的静态方法
*
* @param mixed $value 时间值
* @return string 格式化后的时间字符串
*/
private static function formatDateTimeStatic($value)
{
// 检查空值（但不包括0，因为0是有效的时间戳）
if (is_null($value) || $value === '') {
return '-';
}
// 如果是时间戳，转换为日期时间字符串
if (is_numeric($value)) {
return date('Y-m-d H:i:s', $value);
}
// 如果是Carbon实例或DateTime对象
if ($value instanceof \Carbon\Carbon || $value instanceof \DateTime) {
return $value->format('Y-m-d H:i:s');
}
// 如果是字符串，尝试转换为标准格式
if (is_string($value)) {
try {
$date = new \DateTime($value);
return $date->format('Y-m-d H:i:s');
} catch (\Exception $e) {
return $value; // 如果转换失败，返回原值
}
}
return $value;
}
/**
* 添加用户活动时间组合列
*
* 复用价值：高 - 将最后登录时间和最后活动时间组合显示，提高信息密度
*
* @param string $label 标签名
* @return Column
*/
public function columnUserActivityTimes(string $label = '活动时间'): Column
{
return $this->grid->column('info.last_login_time', $label)->display(function ($lastLoginTime) {
$lastActivityTime = $this->info->last_activity_time ?? '';
$loginTimeHtml = $lastLoginTime ? "最后登录: {$lastLoginTime}
" : "最后登录: 未登录
";
$activityTimeHtml = $lastActivityTime ? "最后活动: {$lastActivityTime}
" : "最后活动: 无活动
";
return $loginTimeHtml . $activityTimeHtml;
})->sortable();
}
/**
* 添加最后登录时间列
*
* 复用价值：中 - 单独显示最后登录时间
*
* @param string $label 标签名
* @return Column
*/
public function columnLastLoginTime(string $label = '最后登录时间'): Column
{
return $this->grid->column('info.last_login_time', $label)->display(function ($value) {
return $value ?: '未登录';
})->sortable();
}
/**
* 添加最后活动时间列
*
* 复用价值：中 - 单独显示最后活动时间
*
* @param string $label 标签名
* @return Column
*/
public function columnLastActivityTime(string $label = '最后活动时间'): Column
{
return $this->grid->column('info.last_activity_time', $label)->display(function ($value) {
return $value ?: '无活动';
})->sortable();
}
}