README

SilverStripe NHI 验证模块是 SilverStripe CMS 的一个有价值扩展，旨在增强 NHI（国家健康索引）号码的验证过程。此模块提供了一种方便的验证输入字段，可以无缝集成到您的网站或 Web 应用程序的 CMS 和前端。

目录

• 功能
• 要求
• 安装
• 使用
• 许可证

功能

1. NHI 号码验证：该模块使您能够验证 NHI 号码，确保它们的准确性和符合当前和即将到来的 NHI 格式标准。
2. 轻松集成：轻松将 NHI 验证输入字段集成到您的 SilverStripe CMS 中，允许在内容管理系统内对 NHI 号码进行流畅的验证。
3. 用户友好的前端验证：将验证功能扩展到网站或 Web 应用程序的前端，通过确保用户输入的 NHI 号码的正确性，提供无缝的用户体验。
4. 提高数据完整性：使用 NHI 验证模块，您可以消除手动验证过程的需要，降低数据错误的风险，提高整体数据完整性。

要求

PHP 8
SilverStripe 框架 4 / 5

安装

使用 composer 安装

composer require jasonloeve/silverstripe-nhi-validator

使用

Admin 数据对象字段

要将 NHI 号码验证添加到 DataObject，然后可以在 SilverStripe 管理员中进行操作

<?php

use SilverStripe\ORM\DataObject;
use JasonLoeve\NHIValidator\FieldType\NHIField;

class Patient extends DataObject
{
    private static $db = [
        'NHINumber' => NHIField::class,
    ];

    //...
}

前端表单验证使用

要将 NHI 号码验证集成到前端表单中，请使用 NHIValidatorField。此表单字段提供必要的验证和 UI 元素，以便用户输入有效的 NHI 号码。

<?php

namespace {

    use SilverStripe\CMS\Controllers\ContentController;
    use SilverStripe\Forms\FieldList;
    use SilverStripe\Forms\FormAction;
    use SilverStripe\Forms\Form;
    use JasonLoeve\NHIValidator\Forms\NHIValidatorField;

    class PageController extends ContentController
    {
        private static $allowed_actions = [
            'PatientForm',
        ];
        
        public function PatientForm()
        {
            $fields = FieldList::create(
                NHIValidatorField::create('NHINumber', 'NHINumber')
            );

            $actions = FieldList::create(
                FormAction::create('handleSubmit', 'Submit')
            );

            return Form::create($this, 'PatientForm', $fields, $actions);
        }

        public function handleSubmit($data, Form $form)
        {
            //...
        }
    }
}

许可证

本软件根据 BSD-3-Clause 许可证授权。