萬盛學電腦網

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

PHP 實現截圖貼上上傳功能完整教學

功能簡介

現代 Web 應用常支援直接貼上截圖上傳(如 SegmentFault 評論區)。本文詳細解析此功能的實現原理,並提供完整可執行的 PHP + JavaScript 代碼範例。

核心原理

  1. 監聽編輯區域的 paste 事件
  2. 檢查剪貼簿資料中是否包含圖片(clipboardData.items[0].type.indexOf('image') > -1)
  3. 使用 FileReader 讀取圖片檔案為 Base64 格式
  4. 透過 AJAX 將 Base64 資料送至後端 PHP 處理
  5. 後端解碼 Base64、儲存檔案並回傳可存取 URL
  6. 前端將圖片插入編輯區或表單隱藏欄位

後端 PHP 處理代碼

<?php
header("Access-Control-Allow-Origin: *");
$url = 'https://' . $_SERVER['HTTP_HOST'];

$file = isset($_POST["file"]) ? $_POST["file"] : '';
if ($file) {
    // 移除 Data URI 前綴並解碼
    $data = base64_decode(str_replace('data:image/png;base64,', '', $file));
    
    // 產生唯一檔名(MD5 + 時間戳)
    $name = md5(time()) . '.png';
    
    // 儲存檔案
    file_put_contents($name, $data);
    
    // 回傳完整 URL
    echo $url . '/' . $name;
    exit;
}
?>

前端 HTML 與 JavaScript

<div id="box" style="width:400px;height:400px;border:1px solid;" contenteditable>
</div>
<input type="hidden" name="img" value="" id="img_puth"/>

<script>
document.querySelector('#box').addEventListener('paste', function(e) {
    // 判斷是否為圖片貼上
    if (e.clipboardData && e.clipboardData.items[0].type.indexOf('image') > -1) {
        var that = this;
        var reader = new FileReader();
        var file = e.clipboardData.items[0].getAsFile();
        
        // 讀取完成後上傳
        reader.onload = function(e) {
            var xhr = new XMLHttpRequest();
            var fd = new FormData();
            
            xhr.open('POST', '', true);
            xhr.onload = function() {
                var img = new Image();
                img.src = xhr.responseText;
                // 顯示於編輯區
                that.innerHTML = '<img src="' + img.src + '" alt=""/>';
                // 同步至隱藏欄位供表單提交
                document.getElementById("img_puth").value = img.src;
            };
            
            // 即時預覽
            that.innerHTML = '<img src="' + this.result + '" alt=""/>';
            fd.append('file', this.result);
            xhr.send(fd);
        };
        
        reader.readAsDataURL(file);
    }
}, false);
</script>

關鍵技術點解析

技術點說明
Clipboard API使用 e.clipboardData.items 存取剪貼簿資料,支援多種 MIME 類型檢測
FileReader非同步讀取 Blob/File 物件,readAsDataURL 產生 Base64 Data URI
FormData構建模擬表單提交資料,自動處理 multipart/form-data 編碼
CORS 標頭PHP 設定 Access-Control-Allow-Origin: * 允許跨域請求

安全性與擴充建議

  • 檔案類型驗證:後端應檢查 MIME 類型與副檔名,防止惡意檔案上傳
  • 檔案大小限制:配合 $_SERVER['CONTENT_LENGTH'] 或 Nginx/Apache 設定限制上傳大小
  • 儲存策略:生產環境建議使用雲端儲存(S3、OSS)或分散式檔案系統
  • 圖片處理:可整合 GD/Imagick 進行壓縮、縮圖、水印等處理
  • CSRF 防護:AJAX 請求應攜帶 CSRF Token 驗證

瀏覽器相容性

此方案支援所有現代瀏覽器(Chrome 66+、Firefox 63+、Safari 13.1+、Edge 79+)。IE 不支援 Clipboard API,需改用 Flash 或其他替代方案。

完整代碼已可直接部署測試,開發者可根據專案需求調整儲存路徑、命名規則與前端 UI 交互邏輯。

copyright © 萬盛學電腦網 all rights reserved