萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 彈出警告視窗並導向函數:前後端分離時代的優雅替代方案

傳統 PHP 直接輸出 `` 雖簡單,但違反關注點分離、阻塞渲染、難以維護。本文提供現代化替代方案:AJAX + 前端元件、Session Flash 訊息、API 統一錯誤格式。

傳統寫法(不推薦用於新專案)

<?php
function alert(string $message, string $url = '', bool $showAlert = true, string $title = '提示'): never {
    echo "$title";
    echo "";
    echo "";
    exit;
}

// 使用
alert('資料儲存成功', '/dashboard');
alert('權限不足', '', true, '錯誤');

缺點:混雜 HTML/JS/PHP、無法單元測試、阻塞輸出、CSP 策略可能阻擋 inline script、手機版 alert 體驗差。

方案一:Session Flash 訊息 + 導向(傳統 MVC 最佳實踐)

<?php
// 控制器
session_start();
$_SESSION['flash'] = ['type' => 'success', 'message' => '儲存成功'];
header('Location: /dashboard');
exit;

// 版面模板
<?php if (!empty($_SESSION['flash'])): ?>
    <div class="alert alert-" id="flash-msg">
        
    </div>
    <?php unset($_SESSION['flash']); ?>
<?php endif; ?>

<script>
// 3 秒自動淡出
setTimeout(() => {
    const el = document.getElementById('flash-msg');
    if (el) el.style.transition = 'opacity 0.5s', el.style.opacity = '0';
}, 3000);
</script>

方案二:AJAX API + 統一錯誤回應(前後端分離標準)

後端統一回應格式

<?php
// api_response.php
function apiResponse(int $code, string $message, mixed $data = null, int $httpCode = 200): never {
    http_response_code($httpCode);
    header('Content-Type: application/json; charset=utf-8');
    echo json_encode([
        'code'    => $code,       // 業務代碼:0=成功, 1001=驗證失敗, 1002=權限不足...
        'message' => $message,
        'data'    => $data,
        'timestamp' => time(),
    ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    exit;
}

// 使用
if (!$validator->passes()) {
    apiResponse(1001, '驗證失敗', $validator->errors(), 422);
}
apiResponse(0, '操作成功', ['id' => $newId]);

前端統一處理 (Vue 3 / Axios 範例)

// axios 攔截器
axios.interceptors.response.use(
    res => res.data, // 直接回傳 data
    err => {
        const resp = err.response?.data;
        if (resp?.message) {
            // 使用優雅通知庫:Toast, SweetAlert2, ElMessage, Toastr
            ElMessage.error(resp.message);
        }
        return Promise.reject(err);
    }
);

// 元件中
async function submitForm() {
    try {
        const { data } = await api.post('/user', formData);
        ElMessage.success(data.message);
        router.push('/dashboard');
    } catch (e) { /* 攔截器已處理 */ }
}

方案三:Livewire / Inertia / HTMX(現代單頁體驗)

若不想寫獨立前端,可用:

  • Laravel Livewire:PHP 直接驅動前端互動,`session()->flash('msg', '...')` 自動顯示
  • Inertia.js:Vue/React + Laravel,`visit(url, { preserveScroll: true, onSuccess: () => toast('ok') })`
  • HTMX:純 HTML 屬性驅動,`hx-post="/save" hx-target="#flash" hx-swap="innerHTML"`

何時仍可用 alert()?

  • 純後台管理介面、無前端框架、快速原型
  • 嚴重錯誤需強制阻斷用戶操作(如維護模式)
  • CLI 腳本除錯(`echo "\007"` 蜂鳴器)

總結建議

  1. 新專案:**API + 前端框架**,統一錯誤格式、Toast 通知
  2. 傳統 MVC:**Session Flash + 導向**,配合 CSS 動畫
  3. 漸進增強:**HTMX/Alpine.js** 輕量互動
  4. **棄用** `alert()`/`confirm()`/`prompt()` 作為主要互動方式
copyright © 萬盛學電腦網 all rights reserved