Simplifier la validation des chaînes dans Go : présentation de validatorgo

Eine Bibliothek von String-Validatoren und Sanitizern, basierend auf der js-Bibliothek validator.js

Warum sollten Sie sich für validatorgo entscheiden?

Warum nicht beliebte Go-Bibliotheken wie Package Validator oder Govalidator verwenden? Obwohl beide Bibliotheken bekannt sind, konzentriert sich validatorgo auf die eigenständige String-Validierung und bietet eine umfangreiche Sammlung anpassbarer Validatoren, die von validator.js inspiriert sind, die keine dieser Go-Bibliotheken vollständig implementiert.

So hebt sich validatorgo im Vergleich zu go-playground/validator und govalidator ab:

---

1. Im Vergleich zu Go-Playground/Validator

• Direkte String-Validierung: go-playground/validator wurde in erster Linie für die Validierung von Strukturfeldern mithilfe von Tags entwickelt, was sich ideal für die Verarbeitung von JSON- oder strukturbasierten Daten eignet. Es ist jedoch nicht für die Validierung einzelner Zeichenfolgen konzipiert, was ValidatorGo nahtlos erledigt, ohne dass Struktur-Tags oder zusätzliche Einrichtung erforderlich sind.

• Leistung: go-playground/validator verlässt sich auf Reflektion, um Struktur-Tags dynamisch zu überprüfen. Obwohl die Reflexion leistungsstark ist, kann sie zu Leistungseinbußen führen – insbesondere, wenn große oder komplexe Datenstrukturen validiert werden. validatorgo vermeidet Reflexionen, was die Leistung steigert und es schneller und effizienter für Szenarien macht, in denen Einzelfeldvalidierungen erforderlich sind.

---

2. Im Vergleich zu asaskevich/govalidator

• Anpassung und Flexibilität: govalidator bietet eine Reihe von Validatoren für Strings, aber validatorgo erhöht die Flexibilität, indem es spezifische Optionen und Konfigurationen für einzelne Validatoren zulässt. Beispielsweise können Datumsformate oder Gebietsschemaspezifikationen angepasst werden, was Entwicklern mehr Kontrolle über Validierungsregeln gibt, die auf die Projektanforderungen zugeschnitten sind.

Projektmotivation

Ich habe validatorgo erstellt, um als Abhängigkeit für eine andere Go-Bibliothek namens ginvalidator zu dienen, die HTTP-Anfragen in Go-Webanwendungen validiert. Inspiriert von Express-Validator, der beliebten Validierungsbibliothek für Node.js und Express, füllt ValidatorGo eine Lücke im Go-Ökosystem für eine effiziente, anpassbare und unkomplizierte String-Validierung. Da andere Bibliotheken entweder übertrieben waren, ihnen die Funktionalität fehlte oder sie meinen Anwendungsfall nicht erfüllten, habe ich validatorgo entwickelt, um eine praktische Lösung anzubieten.

Installation

Mit go get.

 go get github.com/bube054/validatorgo

Dann importieren Sie das Paket in Ihren eigenen Code.

 import (
   "fmt"
   "github.com/bube054/validatorgo"
 )

Wenn Sie mit der Verwendung des langen Validatorgo-Paketnamens nicht zufrieden sind, können Sie dies tun.

 import (
   "fmt"
   vgo "github.com/bube054/validatorgo"
 )

Simple validator example

 func main(){
   id := "5f2a6c69e1d7a4e0077b4e6b"
   validId := vgo.IsMongoID(id)
   fmt.Println(validId) // true
 }

Some Validators

Below is a list of validators provided by the validatorgo package, which covers various string formats and types, making it versatile for multiple validation needs.

Pengesah	Penerangan
Mengandungi	Menyemak sama ada rentetan mengandungi subrentetan tertentu.
Sama dengan	Mengesahkan jika rentetan betul-betul sama dengan rentetan perbandingan.
IsAbaRouting	Menyemak sama ada rentetan itu ialah nombor penghalaan ABA yang sah (akaun bank AS).
IsAfter	Mengesahkan jika rentetan tarikh adalah selepas tarikh yang ditentukan.
IsAlpha	Memastikan rentetan hanya mengandungi huruf (a-zA-Z).
AdalahAlfanumerik	Mengesahkan jika rentetan mengandungi huruf dan nombor sahaja.
IsAscii	Menyemak sama ada rentetan mengandungi aksara ASCII sahaja.
IsBase32	Menyemak sama ada rentetan itu ialah nilai yang dikodkan Base32 yang sah.
IsBase64	Mengesahkan jika rentetan berada dalam pengekodan Base64.
Sebelumnya	Memastikan tarikh sebelum tarikh yang ditetapkan.
IsBoolean	Menyemak sama ada rentetan itu sama ada "benar" atau "salah".
IsCreditCard	Mengesahkan jika rentetan itu ialah nombor kad kredit yang sah.
IsCurrency	Menyemak sama ada rentetan itu ialah format mata wang yang sah.
IsDate	Mengesahkan jika rentetan ialah tarikh yang sah.
IsDecimal	Memastikan rentetan mewakili nombor perpuluhan yang sah.
IsEmail	Menyemak sama ada rentetan itu ialah format alamat e-mel yang sah.
IsEmpty	Mengesahkan jika rentetan kosong.
IsFQDN	Menyemak sama ada rentetan itu ialah nama domain yang layak sepenuhnya.
IsFloat	Memastikan rentetan mewakili nombor titik terapung.
IsHexColor	Mengesahkan jika rentetan ialah warna heks yang sah (mis., #FFFFFF).
IsIP	Menyemak sama ada rentetan itu ialah alamat IP yang sah (IPv4 atau IPv6).
IsISO8601	Mengesahkan jika rentetan dalam format tarikh ISO8601.
IsLength	Menyemak sama ada panjang rentetan berada dalam julat yang ditentukan.
IsMimeType	Mengesahkan jika rentetan adalah jenis MIME yang sah.
Adalah Telefon Bimbit	Menyemak sama ada rentetan itu ialah nombor telefon mudah alih yang sah untuk tempat yang ditentukan.
IsMongoID	Mengesahkan jika rentetan itu ialah ID Objek MongoDB yang sah.
IsNumeric	Memastikan rentetan mengandungi aksara angka sahaja.
IsPostalCode	Menyemak sama ada rentetan itu ialah poskod yang sah untuk tempat yang ditentukan.
IsRFC3339	Mengesahkan jika rentetan dalam format tarikh RFC3339.
IsSlug	Menyemak sama ada rentetan itu mesra URL (hanya huruf, nombor dan sempang).
IsStrongPassword	Memastikan rentetan memenuhi keperluan kekuatan kata laluan biasa.
IsURL	Validates if the string is a URL.
IsUUID	Checks if the string is a valid UUID (versions 1-5).
IsUpperCase	Ensures the string is all uppercase.
IsVAT	Checks if the string is a valid VAT number for specified countries.
Matches	Validates if the string matches a specified regular expression.

This table should cover most validators currently available in validatorgo. Make sure to refer to the package's documentation for more detailed usage of each validator.

⚠ Caution

When using a validator that requires an options struct (either a pointer or non-pointer), always provide values for all the struct fields explicitly.
Unlike in validator.js, where missing fields are automatically set to defaults, Go uses strict types.
This means missing values will default to false for booleans, 0 for number types, etc.
Not specifying all fields could lead to unexpected behavior if you're used to the JavaScript version.

Examples

  // do this (using the default options specified in the docs)
  ok := validatorgo.IsFQDN("example", nil)

  // or this (explicitly setting all possible fields for the structs)
  ok := validatorgo.IsFQDN("example", &validatorgo.IsFQDNOpts{
    RequireTld: false,
    AllowUnderscores: false,
    AllowTrailingDot: true,
    AllowNumericTld: false,
    IgnoreMaxLength: true
  })

  // but rarely this(not explicitly setting all possible fields)
  ok := validatorgo.IsFQDN("example", &validatorgo.IsFQDNOpts{ RequireTld: false, })

Simple sanitizer example

  import (
   "fmt"
   "github.com/bube054/validatorgo/sanitizer"
 )

 func main(){
   str := sanitizer.Whitelist("Hello123 World!", "a-zA-Z")
   fmt.Println(str) // "HelloWorld"
 }

Sanitizers

Sanitizer	Description
Trim	Removes whitespace from both ends of the string.
LTrim	Removes whitespace from the left side of the string.
RTrim	Removes whitespace from the right side of the string.
ToLower	Converts the entire string to lowercase.
ToUpper	Converts the entire string to uppercase.
Escape	Escapes HTML characters in the string to prevent injection attacks.
Unescape	Reverts escaped HTML characters back to normal characters.
NormalizeEmail	Standardizes an email address, e.g., removing dots in Gmail addresses.
Blacklist	Removes characters from the string that match specified characters or patterns.
Whitelist	Retains only characters in the string that match specified characters or patterns.
Replace	Replaces occurrences of a substring with a specified replacement.
StripLow	Removes control characters, optionally allowing some specified ones.
TrimSpace	Trims all types of whitespace from both ends of the string.
ToBoolean	Converts common truthy and falsy values in strings into boolean true or false.
ToInt	Converts a numeric string into an integer, if possible.
ToFloat	Converts a numeric string into a floating-point number, if possible.

Ces désinfectants sont souvent utilisés pour garantir la cohérence et la sécurité des données en supprimant ou en modifiant les caractères potentiellement indésirables ou dangereux.

Assurez-vous de vous référer à la documentation officielle de Validatorgo pour des implémentations spécifiques et des exemples de chaque désinfectant.

Résumé

validatorgo est le choix idéal si vous avez besoin de :

• Validations efficaces et sans réflexion pour des champs individuels sans les coûts de performance associés à la réflexion basée sur la structure.
• Options de validation hautement personnalisables qui s'alignent sur les formats de données modernes, offrant la même robustesse que validator.js.

Avec validatorgo, vous obtenez un outil spécialement conçu pour la validation de chaînes, prenant en charge les exigences des applications autonomes et Web dans Go.

Mainteneurs

• bube054 - Attah Gbubemi David (auteur)

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!