PHP date_get_last_errors() 函数

语法

array date_get_last_errors ( void )

参数说明

此函数没有任何参数。

返回值

• 数组 - 包含警告和错误信息的关联数组
• 如果没有错误，返回空数组
• 数组结构包含 warning_count、warnings、error_count 和 errors 键

返回数组结构

示例代码

示例 1：基本用法

<?php
// 尝试解析一个格式不匹配的日期
$date = date_create_from_format('Y-m-d', '15/03/2024');

// 检查是否解析成功
if ($date === false) {
    echo "日期解析失败！<br>";

    // 获取错误信息
    $errors = date_get_last_errors();

    echo "错误信息:<br>";
    echo "错误数量: " . $errors['error_count'] . "<br>";
    echo "警告数量: " . $errors['warning_count'] . "<br><br>";

    // 显示具体错误
    if (!empty($errors['errors'])) {
        echo "具体错误:<br>";
        foreach ($errors['errors'] as $position => $message) {
            echo "位置 {$position}: {$message}<br>";
        }
    }

    if (!empty($errors['warnings'])) {
        echo "<br>警告信息:<br>";
        foreach ($errors['warnings'] as $position => $message) {
            echo "位置 {$position}: {$message}<br>";
        }
    }
} else {
    echo "日期解析成功: " . date_format($date, 'Y-m-d');
}

/*
输出示例：
日期解析失败！
错误信息:
错误数量: 1
警告数量: 0

具体错误:
位置 0: Unexpected data found.
*/
?>

示例 2：详细错误分析工具

<?php
/**
 * 日期解析调试函数
 */
function debugDateParse($dateString, $format) {
    echo "尝试解析: '{$dateString}' 使用格式: '{$format}'<br>";

    // 解析日期
    $date = date_create_from_format($format, $dateString);

    if ($date !== false) {
        echo "✅ 解析成功: " . date_format($date, 'Y-m-d H:i:s') . "<br><br>";
        return $date;
    }

    echo "❌ 解析失败<br>";

    // 获取错误信息
    $errors = date_get_last_errors();

    // 显示错误统计
    echo "<div class='alert alert-danger'>";
    echo "错误统计: {$errors['error_count']} 个错误, {$errors['warning_count']} 个警告<br>";
    echo "</div>";

    // 显示错误详细信息
    if ($errors['error_count'] > 0) {
        echo "<div class='alert alert-warning'>";
        echo "<strong>错误详情:</strong><br>";
        foreach ($errors['errors'] as $position => $message) {
            echo "位置 {$position}: {$message}<br>";
        }
        echo "</div>";
    }

    if ($errors['warning_count'] > 0) {
        echo "<div class='alert alert-info'>";
        echo "<strong>警告详情:</strong><br>";
        foreach ($errors['warnings'] as $position => $message) {
            echo "位置 {$position}: {$message}<br>";
        }
        echo "</div>";
    }

    // 可视化解析过程
    echo "<strong>解析过程分析:</strong><br>";
    echo "<pre>";
    echo "日期字符串: " . $dateString . "\n";
    echo "格式字符串: " . $format . "\n\n";

    // 模拟解析过程
    $formatChars = str_split($format);
    $dateChars = str_split($dateString);

    echo "字符对应关系:\n";
    for ($i = 0; $i < max(count($formatChars), count($dateChars)); $i++) {
        $formatChar = $formatChars[$i] ?? ' ';
        $dateChar = $dateChars[$i] ?? ' ';
        echo "位置 {$i}: 格式['{$formatChar}'] → 数据['{$dateChar}']";

        if (isset($errors['errors'][$i])) {
            echo " ❌ 错误: " . $errors['errors'][$i];
        } elseif (isset($errors['warnings'][$i])) {
            echo " ⚠️ 警告: " . $errors['warnings'][$i];
        }
        echo "\n";
    }
    echo "</pre><br>";

    return false;
}

// 测试各种日期解析问题
echo "<h5>测试1: 格式不匹配</h5>";
debugDateParse('15/03/2024', 'Y-m-d');

echo "<h5>测试2: 无效日期</h5>";
debugDateParse('2024-02-30', 'Y-m-d');

echo "<h5>测试3: 缺少前导零</h5>";
debugDateParse('2024-3-5', 'Y-m-d');

echo "<h5>测试4: 时间格式错误</h5>";
debugDateParse('2024-03-15 25:61:61', 'Y-m-d H:i:s');

echo "<h5>测试5: 成功解析</h5>";
debugDateParse('2024-03-15 14:30:45', 'Y-m-d H:i:s');
?>

示例 3：批量验证日期格式

<?php
/**
 * 批量验证日期字符串
 */
function validateDates($dates, $expectedFormat) {
    $results = [];

    foreach ($dates as $index => $dateString) {
        $date = date_create_from_format($expectedFormat, $dateString);

        if ($date !== false) {
            $results[$index] = [
                'status' => 'success',
                'parsed_date' => date_format($date, 'Y-m-d H:i:s'),
                'errors' => [],
                'warnings' => [],
            ];
        } else {
            $errors = date_get_last_errors();
            $results[$index] = [
                'status' => 'failed',
                'parsed_date' => null,
                'errors' => $errors['errors'] ?? [],
                'warnings' => $errors['warnings'] ?? [],
                'error_count' => $errors['error_count'] ?? 0,
                'warning_count' => $errors['warning_count'] ?? 0,
            ];
        }
    }

    return $results;
}

// 测试数据
$testDates = [
    '2024-03-15',
    '2024/03/15',
    '15-03-2024',
    '2024-02-30', // 无效日期
    '2024-13-01', // 无效月份
    '2024-03-15 14:30:45',
    '2024-03-15 25:00:00', // 无效小时
];

$format = 'Y-m-d';
$results = validateDates($testDates, $format);

echo "<h4>批量日期验证结果 (期望格式: {$format})</h4>";
echo "<table class='table table-bordered'>";
echo "<thead><tr><th>日期字符串</th><th>状态</th><th>解析结果</th><th>错误/警告</th></tr></thead>";
echo "<tbody>";

foreach ($results as $dateString => $result) {
    echo "<tr>";
    echo "<td>{$dateString}</td>";

    if ($result['status'] === 'success') {
        echo "<td><span class='badge badge-success'>成功</span></td>";
        echo "<td>" . $result['parsed_date'] . "</td>";
        echo "<td>无</td>";
    } else {
        echo "<td><span class='badge badge-danger'>失败</span></td>";
        echo "<td>解析失败</td>";

        $messages = [];
        if (!empty($result['errors'])) {
            foreach ($result['errors'] as $pos => $msg) {
                $messages[] = "错误[{$pos}]: {$msg}";
            }
        }
        if (!empty($result['warnings'])) {
            foreach ($result['warnings'] as $pos => $msg) {
                $messages[] = "警告[{$pos}]: {$msg}";
            }
        }

        echo "<td>" . implode('<br>', $messages) . "</td>";
    }

    echo "</tr>";
}

echo "</tbody></table>";

// 统计信息
$successCount = count(array_filter($results, fn($r) => $r['status'] === 'success'));
$failedCount = count($results) - $successCount;
echo "<div class='alert alert-info'>";
echo "统计: 成功 {$successCount} 个, 失败 {$failedCount} 个";
echo "</div>";
?>

示例 4：错误处理和日志记录

<?php
/**
 * 安全的日期解析函数，包含错误日志
 */
class DateParser {
    private $logFile = 'date_errors.log';

    /**
     * 安全解析日期
     */
    public function safeParse($dateString, $format, $default = null) {
        // 清除之前的错误信息
        date_get_last_errors();

        $date = date_create_from_format($format, $dateString);

        if ($date === false) {
            $this->logError($dateString, $format);
            return $default;
        }

        return $date;
    }

    /**
     * 记录错误到日志
     */
    private function logError($dateString, $format) {
        $errors = date_get_last_errors();

        $logEntry = [
            'timestamp' => date('Y-m-d H:i:s'),
            'date_string' => $dateString,
            'expected_format' => $format,
            'error_count' => $errors['error_count'] ?? 0,
            'warning_count' => $errors['warning_count'] ?? 0,
            'errors' => $errors['errors'] ?? [],
            'warnings' => $errors['warnings'] ?? [],
        ];

        $logLine = json_encode($logEntry, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

        // 写入日志文件
        file_put_contents($this->logFile, $logLine . PHP_EOL, FILE_APPEND);
    }

    /**
     * 获取错误日志
     */
    public function getErrorLog($limit = 10) {
        if (!file_exists($this->logFile)) {
            return [];
        }

        $lines = file($this->logFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
        $logs = array_slice($lines, -$limit);

        return array_map('json_decode', $logs, array_fill(0, count($logs), true));
    }

    /**
     * 清除错误日志
     */
    public function clearErrorLog() {
        if (file_exists($this->logFile)) {
            unlink($this->logFile);
        }
    }
}

// 使用示例
$parser = new DateParser();

echo "<h4>安全日期解析示例</h4>";

// 测试解析
$testCases = [
    ['date' => '2024-03-15', 'format' => 'Y-m-d', 'desc' => '标准格式'],
    ['date' => '15/03/2024', 'format' => 'Y-m-d', 'desc' => '格式不匹配'],
    ['date' => '2024-02-30', 'format' => 'Y-m-d', 'desc' => '无效日期'],
    ['date' => '2024-03-15 14:30', 'format' => 'Y-m-d H:i:s', 'desc' => '缺少秒数'],
];

foreach ($testCases as $case) {
    echo "<strong>{$case['desc']}:</strong> ";
    $date = $parser->safeParse($case['date'], $case['format'], '解析失败');

    if ($date instanceof DateTime) {
        echo "解析成功: " . $date->format('Y-m-d H:i:s') . "<br>";
    } else {
        echo "{$date}<br>";
    }
}

// 显示错误日志
echo "<h5>错误日志:</h5>";
$errorLog = $parser->getErrorLog();

if (empty($errorLog)) {
    echo "<div class='alert alert-success'>没有错误日志</div>";
} else {
    echo "<table class='table table-bordered table-sm'>";
    echo "<thead><tr><th>时间</th><th>日期字符串</th><th>期望格式</th><th>错误数</th></tr></thead>";
    echo "<tbody>";

    foreach ($errorLog as $log) {
        echo "<tr>";
        echo "<td>{$log->timestamp}</td>";
        echo "<td>{$log->date_string}</td>";
        echo "<td>{$log->expected_format}</td>";
        echo "<td>{$log->error_count} 错误, {$log->warning_count} 警告</td>";
        echo "</tr>";
    }

    echo "</tbody></table>";
}
?>

示例 5：错误位置的可视化表示

<?php
/**
 * 可视化显示日期解析错误位置
 */
function visualizeDateParse($dateString, $format) {
    echo "<div class='card mb-3'>";
    echo "<div class='card-header'>日期解析可视化</div>";
    echo "<div class='card-body'>";

    echo "<p><strong>日期字符串:</strong> {$dateString}</p>";
    echo "<p><strong>期望格式:</strong> {$format}</p>";

    $date = date_create_from_format($format, $dateString);

    if ($date !== false) {
        echo "<div class='alert alert-success'>✅ 解析成功</div>";
        return;
    }

    $errors = date_get_last_errors();

    // 创建可视化表示
    echo "<div class='mb-3'><strong>字符位置分析:</strong></div>";

    echo "<div class='row mb-2'>";
    echo "<div class='col-md-6'>";
    echo "<div class='border p-2'>";
    echo "<strong>日期字符串:</strong><br>";
    for ($i = 0; $i < strlen($dateString); $i++) {
        $char = $dateString[$i];
        $hasError = isset($errors['errors'][$i]);
        $hasWarning = isset($errors['warnings'][$i]);

        $class = '';
        if ($hasError) $class = 'bg-danger text-white';
        elseif ($hasWarning) $class = 'bg-warning';

        echo "<span class='border p-1 {$class}' title='位置 {$i}'>{$char}</span>";
    }
    echo "</div></div>";

    echo "<div class='col-md-6'>";
    echo "<div class='border p-2'>";
    echo "<strong>格式字符串:</strong><br>";
    for ($i = 0; $i < strlen($format); $i++) {
        $char = $format[$i];
        $hasError = isset($errors['errors'][$i]);
        $hasWarning = isset($errors['warnings'][$i]);

        $class = '';
        if ($hasError) $class = 'bg-danger text-white';
        elseif ($hasWarning) $class = 'bg-warning';

        echo "<span class='border p-1 {$class}' title='位置 {$i}'>{$char}</span>";
    }
    echo "</div></div>";
    echo "</div>";

    // 图例
    echo "<div class='mb-3'>";
    echo "<span class='badge badge-danger'>错误位置</span> ";
    echo "<span class='badge badge-warning'>警告位置</span> ";
    echo "<span class='badge badge-light border'>正常位置</span>";
    echo "</div>";

    // 错误详情
    if (!empty($errors['errors'])) {
        echo "<div class='alert alert-danger'>";
        echo "<strong>错误详情:</strong><br>";
        foreach ($errors['errors'] as $pos => $msg) {
            echo "位置 {$pos}: {$msg}<br>";
        }
        echo "</div>";
    }

    if (!empty($errors['warnings'])) {
        echo "<div class='alert alert-warning'>";
        echo "<strong>警告详情:</strong><br>";
        foreach ($errors['warnings'] as $pos => $msg) {
            echo "位置 {$pos}: {$msg}</br>";
        }
        echo "</div>";
    }

    echo "</div></div>";
}

// 测试可视化
echo "<h4>日期解析错误可视化</h4>";

// 测试案例
visualizeDateParse('2024-13-15', 'Y-m-d'); // 无效月份
echo "<br>";
visualizeDateParse('2024-03-15 25:00:00', 'Y-m-d H:i:s'); // 无效小时
echo "<br>";
visualizeDateParse('15/03/2024', 'Y-m-d'); // 格式不匹配
echo "<br>";
visualizeDateParse('2024-03-15', 'Y-m-d'); // 成功案例
?>

常见错误和警告信息

注意事项

PHP版本差异

最佳实践

相关函数