IDカード認識・情報読み取り機能をSlimフレームワークミドルウェアで実現

Slim フレームワーク ミドルウェアを使用して、ID カードの認識および情報読み取り機能を実現します。

ID カードは中国国民にとって重要な身分証明書であり、国民の個人情報が記録されています。多くのアプリケーション シナリオでは、ユーザーの ID カードを識別して読み取る必要があります。この記事では、Slim フレームワークのミドルウェアを使用して、このような機能モジュールを実装します。

まず、Slim フレームワークをインストールする必要があります。プロジェクト ディレクトリで次のコマンドを実行します。

composer require slim/slim

次に、IdCardMiddleware.php という名前のファイルを作成し、ミドルウェアのコードを記述します。

<?php

use PsrHttpMessageServerRequestInterface as Request;
use PsrHttpServerRequestHandlerInterface as RequestHandler;
use SlimPsr7Response;

class IdCardMiddleware
{
    private $apiKey;
    private $apiSecret;
    
    public function __construct($apiKey, $apiSecret)
    {
        $this->apiKey = $apiKey;
        $this->apiSecret = $apiSecret;
    }
    
    public function __invoke(Request $request, RequestHandler $handler): Response
    {
        // 获取请求中的身份证图片数据
        $imageData = $request->getParsedBody()['image_data'] ?? '';
        
        // 调用第三方接口进行身份证识别
        $result = $this->callApi($imageData);
        if (!$result) {
            // 如果识别失败，返回错误信息给客户端
            return new Response(400, [], '身份证识别失败');
        }
        
        // 解析身份证信息
        $idCardInfo = $this->parseResult($result);
        if (!$idCardInfo) {
            // 如果解析失败，返回错误信息给客户端
            return new Response(400, [], '身份证信息解析失败');
        }
        
        // 将身份证信息保存到请求的属性中，供后续的路由处理器使用
        $request = $request->withAttribute('idCardInfo', $idCardInfo);
        
        // 继续处理下一个请求处理器
        $response = $handler->handle($request);
        
        return $response;
    }
    
    private function callApi($imageData)
    {
        // 调用第三方接口进行身份证识别的具体实现
        // 在此省略实现细节
        
        // 返回识别结果
        return [
            'name' => '张三',
            'gender' => '男',
            'nation' => '汉族',
            'birthday' => '1990-01-01',
            'address' => '北京市朝阳区'
        ];
    }
    
    private function parseResult($result)
    {
        // 解析识别结果的具体实现
        // 在此省略实现细节
        
        // 返回解析结果
        return [
            'name' => $result['name'],
            'gender' => $result['gender'],
            'nation' => $result['nation'],
            'birthday' => $result['birthday'],
            'address' => $result['address']
        ];
    }
}

コード分析:

1. IdCardMiddleware クラスは、Slim フレームワークのミドルウェア要件である __invoke メソッドを実装する呼び出し可能オブジェクトです。 。
2. コンストラクターは API キーと秘密キーをパラメーターとして受け取り、それらをオブジェクトのプロパティに保存します。
3. __invokeメソッドでは、まずリクエストからIDカードの画像データを取得します。
4. callApi メソッドを呼び出し、サードパーティ インターフェイスを通じて ID カードを識別し、識別結果を返します。
5. 認識に失敗した場合は、クライアントにエラー情報が返されます。認識が成功した場合は、parseResult メソッドを呼び出して認識結果を解析し、ID カード情報を返します。
6. ID カード情報を要求された属性に保存します。このようにして、後続のルートプロセッサの getAttribute メソッドを通じて ID カード情報を取得できます。
7. 次のリクエストプロセッサの処理を続行し、応答結果を返します。

次に、このミドルウェアを使用します。

<?php

use SlimFactoryAppFactory;

require __DIR__ . '/vendor/autoload.php';

// 创建Slim应用
$app = AppFactory::create();

// 添加中间件
$app->add(new IdCardMiddleware('your_api_key', 'your_api_secret'));

// 定义路由
$app->post('/idcard', function ($request, $response, $args) {
    // 从请求属性中获取身份证信息
    $idCardInfo = $request->getAttribute('idCardInfo');
    
    // 处理业务逻辑
    // 在此省略实现细节
    
    // 返回响应结果
    $response->getBody()->write(json_encode($idCardInfo));
    return $response;
});

// 运行应用
$app->run();

コード分析:

1. Slim アプリケーション オブジェクトを作成します。
2. $app->add メソッドを使用してミドルウェアを追加します。 API のキーと秘密キーをパラメーターとして渡す必要があります。
3. POST タイプのルート /idcard を定義し、ルート プロセッサの $request->getAttribute メソッドを通じて ID カード情報を取得します。
4. ビジネス ロジックはプロセッサ内で処理され、ID カード情報がクライアントに返されます。
5. 最後に、$app->run メソッドを使用してアプリケーションを実行します。

このようにして、Slimフレームワークミドルウェアを利用してIDカードの認識と情報の読み取りを実現する機能モジュールを実装しました。このモジュールを通じて、ID カード認識 API に簡単にアクセスし、アプリケーションで使用することができます。

以上がIDカード認識・情報読み取り機能をSlimフレームワークミドルウェアで実現の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。