Zec Data Parsing 다운로드 - Zec Data Parsing 소스 코드 다운로드

Zec: PHP 데이터 구문 분석 라이브러리

Zec Data Parsing 및 스키마 선언 라이브러리는 PHP 애플리케이션에 스키마 정의 및 유효성 검사 기능을 제공하도록 설계되었습니다.

설치

작곡가

composer require mohamed-amine-sayagh/zec

요구사항

PHP 8.0 이상

사용예

다음은 Zec 라이브러리를 사용하여 사용자 프로필 스키마를 정의하고 유효성을 검사하는 방법에 대한 예입니다.

사용자 데이터 유효성 검사를 위한 스키마 정의

    use function Zec  Utils  z ;

    // Define the user profile schema
    $ userProfileParser = z ()-> options ([
        ' name ' => z ()-> string ()-> min ( 3 )-> max ( 50 ),  // Name must be a string between 3 and 50 characters
        ' age ' => z ()-> number ()-> min ( 18 ),           // Age must be a number and at least 18
        ' email ' => z ()-> email (),                   // Email must be a valid email address
        ' address ' => z ()-> options ([               
            ' street ' => z ()-> string (),             
            ' city ' => z ()-> string ()                
        ]),
        ' hobbies ' => z ()-> each ( z ()-> string ()),     // Hobbies must be an array of strings
        ' metadata ' => z ()-> optional ()-> each ( z ()-> options ([  // Metadata is optional and must be an array of objects
            ' key ' => z ()-> string (),                // Each object must have a key as a string
            ' value ' => z ()-> string ()               // Each object must have a value as a string
        ]))
    ]);

사용자 데이터를 구문 분석하고 검증합니다.

    // Parse and validate user data
    $ userData = [
        ' name ' => ' Jane Doe ' ,
        ' age ' => 1 , // 1 is not a valid age
        ' email ' => ' jane.doe@examplecom ' , // missing dot
        ' address ' => [
            ' street ' => ' 123 Elm St ' ,
            ' city ' => 3 // city is not a string
        ],
        ' hobbies ' => [ ' photography ' , ' traveling ' , ' reading ' , 5 ], // 5 is not a string     
        ' metadata ' => [
            [ ' key ' => ' memberSince ' , ' value ' => ' 2019 ' ],
            [ ' key ' => ' newsletter ' , ' value ' => ' true ' ]
        ]
    ];

    try {
        $ userProfileParser -> parseOrThrow ( $ userData ); // Throws an error
        echo " User data is valid n" ;
    } catch (  Zec  ZecError $ e ) {
        echo " User data is invalid: " ;
        $ e -> log (); // Log the error
    }

예상되는 오류 응답

    User data is invalid: [
        {
            "parser": "min",
            "value": 1,
            "min": 18,
            "message": "Invalid value",
            "path": [
                "age"
            ]
        },
        {
            "parser": "email",
            "value": "jane.doe@examplecom",
            "message": "Invalid email address",
            "path": [
                "email"
            ]
        },
        {
            "parser": "string",
            "value": 5,
            "message": "Invalid string value",
            "path": [
                "hobbies",
                "3"
            ]
        }
    ]

현재 버전: v1.0.0, 출시 날짜: 2024-10-01, 작성자: Mohamed Amine SAYAGH, 릴리스 노트: Zec PHP 데이터 구문 분석 라이브러리의 최초 릴리스, 릴리스 링크: [Zec 1.0.0](

참고: 이 라이브러리는 현재 개발 중입니다. 공식 문서와 추가 리소스는 곧 제공될 예정입니다.

저자 정보:

링크드인
GitHub
포트폴리오

강력한 스키마 검증 : Zec 라이브러리와 유사한 강력한 타이핑 및 검증을 제공하여 정확한 데이터 처리를 보장합니다.
모듈식 및 확장 가능 : 맞춤형 파서로 쉽게 확장할 수 있으며 다양한 데이터 검증 요구 사항을 수용합니다.
우려 사항의 분리 : 보안 및 유지 관리 효율성을 높이기 위해 데이터 구문 분석을 비즈니스 논리와 별도로 유지합니다.
테스트 용이성 : 엄격한 데이터 검증을 시행하여 테스트를 단순화합니다.
유연한 구성 : 핵심 라이브러리를 변경하지 않고도 동적 파서 구성 및 사용자 정의를 지원합니다.
커뮤니티 중심 : 기여를 위해 열려 있으며 집단적 개선과 지원을 강화합니다.

협동

우리는 협력에 전적으로 열려있습니다! PHP 데이터 구문 분석 라이브러리에 기여하는 데 관심이 있으시면 언제든지 연락주시기 바랍니다. 코드 기여, 문서 개선, 기능 제안 등을 통해 여러분의 의견을 환영합니다.

기여하는 방법

저장소 포크 : 저장소를 자신의 GitHub 계정으로 포크하여 시작합니다.
Clone Your Fork : 포크를 로컬 머신에 복제하고 개발 환경을 설정합니다.
새 분기 만들기 : 새 Git 분기에서 변경합니다.
변경 사항 커밋 : 명확하고 설명이 포함된 커밋 메시지로 수정 사항을 커밋합니다.
변경 사항 푸시 : 변경 사항을 GitHub의 포크로 푸시합니다.
Pull Request 제출 : 리포지토리의 메인 브랜치에 Pull Request를 제출하세요. 귀하의 기여를 이해하는 데 도움이 되는 변경 사항 및 기타 정보에 대한 명확한 설명을 제공해 주십시오.

자세한 내용은 기여 가이드라인을 확인하세요(가능한 경우 자세한 기여 가이드라인 링크).

우리는 활발한 기여자 커뮤니티와 함께 강력한 데이터 구문 분석 도구를 구축할 수 있기를 기대합니다!

용법

기본 구문 분석

간단한 스키마 정의를 사용하여 데이터 유형을 정의하고 검증합니다.

    use function Zec  Utils  z ;
    $ my_schema = z ()-> string ();
    
    $ response_valid = $ my_schema -> parse ( " Hello, World! " ); // Returns Zec data object
    $ value = $ response_valid -> value ; // Returns "Hello, World!"

    $ response_invalid = $ my_schema -> parse ( 123 ); // Returns Zec data object
    $ errors = $ response_invalid -> errors ; // Returns an array of ZecError object an exception extends class

확인

구문 분석 후 신속하게 데이터 유효성을 검사합니다.

    $ is_valid = $ my_schema -> parse ( " Hello, World! " )-> isValid (); // Returns true
    $ is_invalid = $ my_schema -> parse ( 123 )-> isValid (); // Returns false

구문 분석을 통한 예외 처리

중요한 데이터 검증을 위해parse_or_throw를 사용하여 예외를 처리합니다.

    try {
        $ response = $ my_schema -> parseOrThrow ( 123 ); // Throws ZecError
    } catch ( ZecError $ error ) {
        $ error_message = $ error -> message ; // Returns "Invalid type: expected string, received integer"
        $ error -> log (); // Logs the error
    }

옵션 배열 구문 분석

추가 유효성 검사 옵션을 통합하여 스키마 정의를 향상할 수 있습니다. 이를 통해 특정 요구 사항에 따라 데이터 적합성을 보다 세부적으로 제어할 수 있습니다.

    use function Zec  z ;

    $ user_schema = z ()-> options ([
        ' name ' => z ()-> string ()-> min ( 3 )-> max ( 50 ),
        ' email ' => z ()-> email (),
        ' age ' => z ()-> number ()-> min ( 18 ),
        ' isActive ' => z ()-> boolean (),
        ' registrationDate ' => z ()-> date ()
    ]);

    // Parsing a valid user object
    $ valid_user = $ user_schema -> parse ([
        ' name ' => ' John Doe ' ,
        ' email ' => ' [email protected] ' ,
        ' age ' => 30 ,
        ' isActive ' => true ,
        ' registrationDate ' => ' 2021-01-01 '
    ]);

    // Parsing an invalid user object
    $ invalid_user = $ user_schema -> parse ([
        ' name ' => ' JD ' , // Too short
        ' email ' => ' john.doe@ ' , // Invalid email format
        ' age ' => 17 , // Below minimum age requirement
        ' isActive ' => ' yes ' , // Incorrect type (should be boolean)
        ' registrationDate ' => ' 01-01-2021 ' // Wrong date format
    ]);

    // Handling validation results
    if ( $ valid_user -> isValid ()) {
        echo ' User is valid. ' ;
    } else {
        echo ' User is invalid. Errors: ' ;
        var_dump ( $ valid_user -> errors ());
    }

    if ( $ invalid_user -> isValid ()) {
        echo ' User is valid. ' ;
    } else {
        echo ' User is invalid. Errors: ' ;
        var_dump ( $ invalid_user -> errors ());
    }

고급 파서 구성

라이브러리는 데이터 검증을 위한 광범위한 구성 기능을 제공하므로 사용자는 사용자 정의 메시지 및 조건으로 복잡한 검증 규칙을 정의할 수 있습니다. 다음은 특정 유효성 검사 규칙을 사용하여 이메일 필드에 대한 세부 스키마를 구성하는 방법의 예입니다.

    use function Zec  z ;

    // Define a configurable email schema
    $ my_configurable_email_schema = z ()-> string ([
        ' message ' => ' Invalid string data '
    ])-> min ([
        ' min ' => 3 ,
        ' message ' => ' String data must be at least 3 characters long ' // Custom message
    ])-> max ([
        ' max ' => 10 ,
        ' message ' => ' String {{value}} must be at most ((max)) characters long ' // Custom message with value interpolation
    ]). email ([
        ' message ' => ' Invalid email ' ,
        ' domain ' => [ ' gmail.com ' , ' yahoo.com ' ] // Custom domain validation rules
    ]);

    // Define a user schema using the configurable email schema
    $ my_user = z ()-> options ([
        ' email ' => $ my_configurable_email_schema -> required ()
    ]);

복잡한 예: 사용자 데이터 유효성 검사

이 예에서는 중첩된 배열, 선택적 필드 및 공용체 유형을 포함하는 사용자 데이터 구조의 유효성을 검사하는 방법을 보여주며, 복잡하고 현실적인 데이터 모델을 처리하는 라이브러리의 기능을 보여줍니다.

    use function Zec  z ;

    // Define a user schema with various data validation rules
    $ user_parser = z ()-> options ([
        ' name ' => z ()-> required ()-> string ()-> min ( 3 )-> max ( 50 ),
        ' email ' => z ()-> url ([
            ' message ' => ' Invalid email address ' , 
            ' domain ' => [ ' gmail.com ' ]
        ]),
        ' age ' => z ()-> number (),
        ' friends ' => z ()-> each (
            function ( $ user ) {
                return $ user -> nullable ();
            } // Each friend is a user object (nullable)
        ),
        ' password ' => z ()-> optional ()-> options ([
            ' password ' => z ()-> string (),  // Path: 'password.password'
            ' confirm_password ' => z ()-> string (),
            ' created_at ' => z ()-> date (),
        ]),
        ' created_at ' => z ()-> date (),
        ' updated_at ' => z ()-> date (),
        ' document ' => z ()-> union ([
            z ()-> options ([
                ' type ' => z ()-> enum ([ ' student ' ]),
                ' content ' => z ()-> options ([
                    ' school ' => z ()-> string (),
                    ' grade ' => z ()-> number (),
                ]),
            ]),
            z ()-> options ([
                ' type ' => z ()-> enum ([ ' teacher ' ]),
                ' content ' => z ()-> options ([
                    ' school ' => z ()-> string (),
                    ' subject ' => z ()-> string (),
                ]),
            ]),
        ]) // Union type for document, can be student or teacher document
    ]);

    // Parse a valid user object
    $ user = $ user_parser -> parse ([
        ' name ' => ' John Doe ' ,
        ' email ' => ' [email protected] ' ,
        ' age ' => 25 ,
        ' friends ' => [
            [
                ' name ' => ' Jane Doe ' ,
                ' email ' => ' [email protected] ' ,
                ' age ' => 30 ,
            ],
        ],
        ' password ' => [
            ' password ' => ' password ' ,
            ' confirm_password ' => ' password ' ,
            ' created_at ' => ' 2021-10-10 '
        ],
        ' created_at ' => ' 2021-10-10 ' ,
        ' updated_at ' => ' 2021-10-10 ' ,
        ' document ' => [
            ' type ' => ' student ' ,
            ' content ' => [
                ' school ' => ' School ' ,
                ' grade ' => 10 ,
            ]
        ]
    ]); // Returns a Zec object

    // Validate the parsed data
    if ( $ user -> isValid ()) {
        echo ' User is valid. ' ;
        var_dump ( $ user -> getValue ()); // Outputs the validated data
    } else {
        echo ' User is invalid. ' ;
        var_dump ( $ user -> errors ()); // Outputs validation errors
    }

사용자 정의 파서 메소드 생성

유연성을 강화하고 특정 검증 요구 사항을 충족하기 위해 당사 라이브러리를 통해 사용자는 사용자 정의 파서 방법을 정의할 수 있습니다. 이 섹션에서는 배열 크기, 문자열 길이 또는 숫자 값이 특정 요구 사항을 충족하는지 확인하는 size 파서 메서드를 만드는 방법을 보여줍니다.

size 방법은 다음을 확인합니다.

배열의 길이는 지정된 크기와 같습니다.
문자열의 길이는 지정된 문자 수와 같습니다.
숫자 값은 지정된 숫자와 정확히 동일합니다.

이 사용자 정의 파서를 구현하는 방법은 다음과 같습니다.

    use function Zec  z ;
    use function Zec  bundler ;
    use Zec  FIELD as FK ;

    $ custom_size_parser = parser_build ()
        -> name ( ' size ' )
        -> prioritize ( ' string ' , ' number ' , ' array ' ) // Prioritize the parser for string, number, and array types
        -> argument ( ' message ' , ' Invalid size ' , function ( Zec  Zec $ z ) {
            return $ z -> required ()-> string ();
        }) // argument for custom message, default is 'Invalid size'
        -> argument ( ' size ' , 0 , function ( Zec  Zec $ z ) {
            return $ z -> required ()-> number ();
        }) // argument for size, default is 0
        -> function ( function ( array $ args ): string | bool {
            $ value = $ args [ ' value ' ];
            $ expected_size = $ args [ ' size ' ];
            $ message = $ args [ ' message ' ];

            if ( is_array ( $ value )) {
                $ actual_size = count ( $ value );
            } elseif ( is_string ( $ value )) {
                $ actual_size = strlen ( $ value );
            } elseif ( is_numeric ( $ value )) {
                $ actual_size = $ value ;
            } else {
                return $ message ?? ' Invalid data type ' ;
            }

            if ( $ actual_size === $ expected_size ) {
                return true ;
            }
            return $ message ?? ' Invalid size ' ;
        })-> priority ( 4 ); // priority of the parser, the default priority of parser is 10, parser with 5 as priority will override before parser with 10 as priority if they have the same parser name
        -> build (); // Build the parser

    bundler-> addParser ( $ custom_size_parser );

이제 스키마 정의에서 사용자 정의 size 파서 메소드를 사용할 수 있습니다.

    $ my_schema = z ()-> options ([
        ' username ' => z ()-> string ()-> size ( 5 ), // Username must be a string of length 5
        ' favorite_numbers ' => z ()-> array ()-> size ( 5 ), // Favorite numbers must be an array of length 5
        ' lucky_number ' => z ()-> number ()-> size ( 5 ), // Lucky number must be 5
    ]);

    $ user_data = [
        ' username ' => ' admin ' ,
        ' favorite_numbers ' => [ 1 , 2 , 3 , 4 , 5 ],
        ' lucky_number ' => 5
    ]; // Valid data

    $ parsed_data = $ my_schema -> parse ( $ user_data ); // Returns a Zec object

    // Validate the parsed data
    if ( $ parsed_data -> isValid ()) { // Returns true if data is valid
        echo ' All data is valid. ' ;
    } else {
        echo ' Data validation failed. Errors: ' ;
        var_dump ( $ parsed_data -> errors ()); // Outputs validation errors
    }

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE.md 파일을 참조하세요.

MIT 라이센스

모든 권리 보유.

본 소프트웨어 및 관련 문서 파일("소프트웨어")의 사본을 취득한 모든 사람에게 사용, 복사, 수정, 병합에 대한 권리를 포함하되 이에 국한되지 않고 제한 없이 소프트웨어를 취급할 수 있는 권한이 무료로 부여됩니다. , 소프트웨어 사본을 게시, 배포, 재라이센스 부여 및/또는 판매하고, 소프트웨어를 제공받은 사람에게 다음 조건에 따라 그렇게 하도록 허용합니다.

소프트웨어는 상품성, 특정 목적에의 적합성 및 비침해에 대한 보증을 포함하되 이에 국한되지 않고 명시적이든 묵시적이든 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다. 어떠한 경우에도 작성자나 저작권 보유자는 계약, 불법 행위 또는 기타 행위로 인해 소프트웨어나 사용 또는 기타 거래와 관련하여 발생하는 모든 청구, 손해 또는 기타 책임에 대해 책임을 지지 않습니다. 소프트웨어.

확장하다

Zec Data Parsing

Zec: PHP 데이터 구문 분석 라이브러리

설치

작곡가

요구사항

사용예

사용자 데이터 유효성 검사를 위한 스키마 정의

사용자 데이터를 구문 분석하고 검증합니다.

예상되는 오류 응답

목차

다른 좋은 측면

협동

기여하는 방법

용법

기본 구문 분석

확인

구문 분석을 통한 예외 처리

옵션 배열 구문 분석

고급 파서 구성

복잡한 예: 사용자 데이터 유효성 검사

사용자 정의 파서 메소드 생성

특허

MIT 라이센스

MMEarth data

Contoso Data Generator V2

EMIT Data Resources

data pump log analyzer

생물학적 데이터 마이닝

스마트 데이터 복구

chat.petals.dev

GPT Prompt Templates

GPTyped

wp functions

termwind

slugify

waymo open dataset

wp functions

termwind