萬盛學電腦網

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

PHP 通用 JavaScript Alert 提示函數 (支援導向、重載、關閉、回呼)

功能特色

單一函數處理所有前端提示需求:訊息彈窗、導向、重新整理、關閉視窗、執行父視窗函數、延遲執行。

函數定義

<?php
/**
 * 通用 JS 提示與導向
 *
 * @param string $msg     提示訊息 (空字串不彈窗)
 * @param string $type    動作類型: back|reload|close|function|URL
 * @param string $target  目標視窗/函數名 (self|top|parent|functionName)
 * @param int    $delay   延遲毫秒 (100 立即執行)
 */
function alert($msg = '', $type = 'back', $target = '', $delay = 100) {
    echo '<script>' . PHP_EOL;

    if ($msg !== '') {
        // 轉義單引號、換行
        $msg = addslashes(str_replace(["\r\n", "\r", "\n"], ['\\n', '\\n', '\\n'], $msg));
        echo "alert('{$msg}');" . PHP_EOL;
    }

    echo 'function _redirect(){' . PHP_EOL;
    $win = ($target !== '') ? 'top' : 'self';

    switch (strtolower($type)) {
        case '#':        // 不動作
            break;
        case 'back':
            echo "{$win}.history.go(-1);" . PHP_EOL;
            break;
        case 'reload':
            echo "{$win}.location.reload();" . PHP_EOL;
            break;
        case 'close':
            echo "window.opener=null; window.close();" . PHP_EOL;
            break;
        case 'function':
            // 執行父視窗/當前視窗函數
            echo "var fn = new Function('return {$target}')(); fn();" . PHP_EOL;
            break;
        default:
            // 視為 URL 導向
            if ($type !== '') {
                echo "{$win}.location.href = '{$type}';" . PHP_EOL;
            }
    }
    echo '}' . PHP_EOL;

    // Firefox setTimeout 相容處理
    echo 'if (setTimeout("_redirect()", ' . $delay . ') === 2) { _redirect(); }' . PHP_EOL;
    if ($delay == 100) echo '_redirect();' . PHP_EOL;

    echo '</script>' . PHP_EOL;
    exit;
}

使用範例

呼叫效果
alert('登入成功', 'reload')彈窗後重新整理當前頁
alert('資料已儲存', 'back')彈窗後返回上一頁
alert('', 'close')直接關閉彈出視窗
alert('完成', 'function', 'parent.refreshList')彈窗後呼叫父視窗 refreshList()
alert('跳轉中...', '/admin/dashboard', '', 2000)2 秒後導向儀表板

安全性強化建議

  1. XSS 防護:$msg 經 addslashes 轉義單引號,但若輸出在 HTML 屬性中仍需 htmlspecialchars。建議改用 JSON 編碼:json_encode($msg, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP)。
  2. CSP 相容:內聯 script 需 nonce 或 unsafe-inline,現代專案建議改用前端框架 Toast/Modal 組件,後端只回傳 JSON。
  3. URL 驗證:$type 作為 URL 時,務必驗證為同源或白名單域名,防止開放式重導向。

現代替代架構

<?php
// API 回傳 JSON
header('Content-Type: application/json');
echo json_encode([
    'success' => true,
    'message' => '操作成功',
    'redirect' => '/dashboard',
    'action'   => 'reload', // 或 'replace', 'back', 'close'
]);
// 前端 Vue/React/Alpine 接收後顯示 Toast 並執行對應動作
copyright © 萬盛學電腦網 all rights reserved