PHP项目OCR文字识别集成

wen PHP项目 2026-08-12 161

本文目录导读：

PHP项目OCR文字识别集成

使用第三方云服务API（推荐）
使用Tesseract OCR（开源免费）
使用PHP扩展库
完整的上传文件OCR识别示例
前端HTML表单示例
使用建议

我将为您详细介绍如何在PHP项目中集成OCR文字识别功能,以下是几种主流方案的实现方法：

使用第三方云服务API（推荐）

百度智能云OCR

<?php
class BaiduOCR {
    private $apiKey;
    private $secretKey;
    private $accessToken;
    public function __construct($apiKey, $secretKey) {
        $this->apiKey = $apiKey;
        $this->secretKey = $secretKey;
        $this->getAccessToken();
    }
    // 获取访问令牌
    private function getAccessToken() {
        $url = 'https://aip.baidubce.com/oauth/2.0/token';
        $postData = [
            'grant_type' => 'client_credentials',
            'client_id' => $this->apiKey,
            'client_secret' => $this->secretKey
        ];
        $result = $this->httpRequest($url, $postData);
        $this->accessToken = $result['access_token'];
    }
    // 通用文字识别（含位置高精版）
    public function generalOCR($imagePath) {
        $url = "https://aip.baidubce.com/rest/2.0/ocr/v1/general_basic?access_token={$this->accessToken}";
        $image = base64_encode(file_get_contents($imagePath));
        $postData = ['image' => $image];
        $result = $this->httpRequest($url, $postData);
        return $result;
    }
    // 身份证识别
    public function idCardOCR($imagePath, $side = 'front') {
        $url = "https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token={$this->accessToken}";
        $image = base64_encode(file_get_contents($imagePath));
        $postData = [
            'image' => $image,
            'id_card_side' => $side
        ];
        $result = $this->httpRequest($url, $postData);
        return $result;
    }
    // HTTP请求封装
    private function httpRequest($url, $postData) {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
        $response = curl_exec($ch);
        curl_close($ch);
        return json_decode($response, true);
    }
}
// 使用示例
$ocr = new BaiduOCR('你的API_KEY', '你的SECRET_KEY');
$result = $ocr->generalOCR('test.jpg');
if (isset($result['words_result'])) {
    foreach ($result['words_result'] as $item) {
        echo $item['words'] . "\n";
    }
}
?>

腾讯云OCR

<?php
class TencentOCR {
    private $secretId;
    private $secretKey;
    public function __construct($secretId, $secretKey) {
        $this->secretId = $secretId;
        $this->secretKey = $secretKey;
    }
    public function generalOCR($imagePath) {
        // 腾讯云OCR接口
        $host = "ocr.tencentcloudapi.com";
        $action = "GeneralBasicOCR";
        $timestamp = time();
        $date = gmdate('Y-m-d', $timestamp);
        // 生成签名
        $signature = $this->generateSignature($action, $timestamp, $date);
        $image = base64_encode(file_get_contents($imagePath));
        $postData = [
            'ImageBase64' => $image
        ];
        $headers = [
            'Authorization: TC3-HMAC-SHA256 Credential=' . $this->secretId . '/' . $date . '/ocr/tc3_request',
            'Content-Type: application/json',
            'X-TC-Action: ' . $action,
            'X-TC-Timestamp: ' . $timestamp,
            'X-TC-Version: 2018-11-19',
            'X-TC-Region: ap-guangzhou',
            'X-TC-Token: ' . $signature
        ];
        return $this->httpRequest($host, $postData, $headers);
    }
    private function generateSignature($action, $timestamp, $date) {
        // 实现签名逻辑（简化版）
        return hash_hmac('sha256', $action . $timestamp, $this->secretKey);
    }
    private function httpRequest($host, $postData, $headers) {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, "https://" . $host);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));
        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        $response = curl_exec($ch);
        curl_close($ch);
        return json_decode($response, true);
    }
}
?>

使用Tesseract OCR（开源免费）

安装配置

# Ubuntu/Debian
sudo apt-get install tesseract-ocr
sudo apt-get install tesseract-ocr-chi-sim  # 中文简体语言包
# CentOS/RHEL
sudo yum install tesseract
sudo yum install tesseract-langpack-chi-sim

PHP集成

<?php
class TesseractOCR {
    private $executablePath;
    private $language;
    public function __construct($executablePath = '/usr/bin/tesseract', $language = 'chi_sim+eng') {
        $this->executablePath = $executablePath;
        $this->language = $language;
    }
    public function recognize($imagePath) {
        // 生成临时输出文件
        $outputPath = tempnam(sys_get_temp_dir(), 'ocr');
        // 构建命令
        $command = sprintf(
            '%s "%s" "%s" -l %s 2>&1',
            escapeshellcmd($this->executablePath),
            escapeshellarg($imagePath),
            escapeshellarg($outputPath),
            escapeshellarg($this->language)
        );
        // 执行命令
        exec($command, $output, $returnCode);
        if ($returnCode !== 0) {
            throw new Exception("OCR识别失败: " . implode("\n", $output));
        }
        // 读取结果
        $text = file_get_contents($outputPath . '.txt');
        // 清理临时文件
        unlink($outputPath);
        return $text;
    }
    // 高级：支持图像预处理
    public function recognizeWithPreprocessing($imagePath) {
        // 使用GD2库进行图像预处理
        $imageInfo = getimagesize($imagePath);
        $mimeType = $imageInfo['mime'];
        // 根据图像类型创建图像资源
        switch ($mimeType) {
            case 'image/jpeg':
                $image = imagecreatefromjpeg($imagePath);
                break;
            case 'image/png':
                $image = imagecreatefrompng($imagePath);
                break;
            case 'image/gif':
                $image = imagecreatefromgif($imagePath);
                break;
            default:
                throw new Exception("不支持的图像格式");
        }
        // 灰度化处理
        imagefilter($image, IMG_FILTER_GRAYSCALE);
        // 增强对比度
        imagefilter($image, IMG_FILTER_CONTRAST, -5);
        // 反转颜色（黑底白字）
        imagefilter($image, IMG_FILTER_NEGATE);
        // 保存预处理后的图像
        $tempFile = tempnam(sys_get_temp_dir(), 'pre');
        imagejpeg($image, $tempFile, 90);
        // 释放内存
        imagedestroy($image);
        // 执行OCR
        $result = $this->recognize($tempFile);
        // 清理临时文件
        unlink($tempFile);
        return $result;
    }
}
// 使用示例
$ocr = new TesseractOCR('/usr/bin/tesseract', 'chi_sim+eng');
$text = $ocr->recognize('document.jpg');
echo $text;
?>

使用PHP扩展库

安装 EasyOCR PHP库

composer require anourvalar/php-easyocr

使用示例

<?php
require_once 'vendor/autoload.php';
use AnourValar\PhpEasyOcr\Provider\TesseractProvider;
use AnourValar\PhpEasyOcr\OcrClient;
class EasyOCRWrapper {
    private $client;
    public function __construct() {
        $this->client = new OcrClient();
        $provider = new TesseractProvider();
        $provider->setTesseractPath('/usr/bin/tesseract');
        $provider->setLanguage('chi_sim');
        $provider->setPsm(3);
        $this->client->addProvider($provider);
    }
    public function recognize($imagePath) {
        return $this->client->detect($imagePath);
    }
}
// 使用示例
$ocr = new EasyOCRWrapper();
$result = $ocr->recognize('test.png');
var_dump($result);
?>

完整的上传文件OCR识别示例

<?php
class OCRController {
    private $ocr;
    private $uploadDir;
    public function __construct($ocr, $uploadDir = './uploads/') {
        $this->ocr = $ocr;
        $this->uploadDir = $uploadDir;
        // 创建上传目录
        if (!file_exists($uploadDir)) {
            mkdir($uploadDir, 0755, true);
        }
    }
    // 处理上传的图片并进行OCR识别
    public function processUpload($files) {
        if (!isset($files['file']) || $files['file']['error'] !== UPLOAD_ERR_OK) {
            throw new Exception("文件上传失败");
        }
        $file = $files['file'];
        $filePath = $this->uploadFile($file);
        try {
            // 执行OCR识别
            $result = $this->ocr->recognize($filePath);
            // 清理临时文件
            unlink($filePath);
            return $result;
        } catch (Exception $e) {
            if (file_exists($filePath)) {
                unlink($filePath);
            }
            throw $e;
        }
    }
    // 上传文件
    private function uploadFile($file) {
        // 验证文件类型
        $allowedTypes = ['image/jpeg', 'image/png', 'image/bmp', 'image/gif'];
        if (!in_array($file['type'], $allowedTypes)) {
            throw new Exception("不支持的文件类型");
        }
        // 验证文件大小（5MB限制）
        if ($file['size'] > 5 * 1024 * 1024) {
            throw new Exception("文件大小超过限制");
        }
        // 生成唯一文件名
        $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
        $filename = uniqid() . '.' . $ext;
        $filePath = $this->uploadDir . $filename;
        // 移动文件
        if (!move_uploaded_file($file['tmp_name'], $filePath)) {
            throw new Exception("文件保存失败");
        }
        return $filePath;
    }
}
// 使用示例 - 上传处理
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    try {
        // 选择OCR方案
        $ocr = new BaiduOCR('API_KEY', 'SECRET_KEY');
        // 或 $ocr = new TesseractOCR('/usr/bin/tesseract', 'chi_sim');
        $controller = new OCRController($ocr);
        $result = $controller->processUpload($_FILES);
        // 输出结果
        echo json_encode([
            'success' => true,
            'text' => $result
        ]);
    } catch (Exception $e) {
        echo json_encode([
            'success' => false,
            'error' => $e->getMessage()
        ]);
    }
}
?>

前端HTML表单示例

<!DOCTYPE html>
<html>
<head>OCR 文字识别</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            max-width: 800px;
            margin: 20px auto;
            padding: 20px;
        }
        .upload-form {
            border: 2px dashed #ddd;
            padding: 20px;
            text-align: center;
        }
        #result {
            margin-top: 20px;
            padding: 20px;
            border: 1px solid #ccc;
        }
        .btn {
            background-color: #007bff;
            color: white;
            padding: 10px 20px;
            border: none;
            border-radius: 5px;
            cursor: pointer;
        }
    </style>
</head>
<body>
    <h2>文档OCR识别</h2>
    <form class="upload-form" id="ocrForm">
        <input type="file" id="image" name="file" accept="image/*" required>
        <br><br>
        <button type="submit" class="btn">开始识别</button>
    </form>
    <div id="result"></div>
    <script>
        document.getElementById('ocrForm').addEventListener('submit', async function(e) {
            e.preventDefault();
            const formData = new FormData();
            formData.append('file', document.getElementById('image').files[0]);
            try {
                const response = await fetch('/ocr.php', {
                    method: 'POST',
                    body: formData
                });
                const data = await response.json();
                const resultDiv = document.getElementById('result');
                if (data.success) {
                    resultDiv.innerHTML = '<h3>识别结果：</h3><pre>' + data.text + '</pre>';
                } else {
                    resultDiv.innerHTML = '<div style="color: red;">错误：' + data.error + '</div>';
                }
            } catch (error) {
                alert('服务器错误：' + error.message);
            }
        });
    </script>
</body>
</html>