laravel-spanish-validator

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

laravel-spanish-validator

★ 26 Open GitHub ↗

Laravel validator for spanish stuff: NIF, NIE, CIF, NSS, IBAN, Postal Code, Phone numbers

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Laravel validator for spanish stuff: NIF, NIE, CIF, NSS, IBAN, Postal Code, Phone numbers

[![Latest Version on Packagist](https://img.shields.io/packagist/v/danielmrdev/laravel-spanish-validator.svg?style=flat-square)](https://packagist.org/packages/danielmrdev/laravel-spanish-validator)
[![Tests](https://github.com/danielmrdev/laravel-spanish-validator/actions/workflows/tests.yml/badge.svg)](https://github.com/danielmrdev/laravel-spanish-validator/actions)
[![Code Quality](https://github.com/danielmrdev/laravel-spanish-validator/actions/workflows/quality.yml/badge.svg)](https://github.com/danielmrdev/laravel-spanish-validator/actions)
[![Total Downloads](https://img.shields.io/packagist/dt/danielmrdev/laravel-spanish-validator.svg?style=flat-square)](https://packagist.org/packages/danielmrdev/laravel-spanish-validator)

This package is a set of diferent validation rules for spanish national id numbers like:

- **NIF**: _"Número de Identificación Fiscal"_ (tax number for individuals).
- **NIE**: _"Número de Idenfiticación para Extranjeros"_ (identity number for foreigners).
- **CIF**: _"Código de Identificación Fiscal"_ (tax number for companies).
- **NSS**: _"Número de la Seguridad Social"_ (national security number).

Also the package include validators for:

- **IBAN**: International Bank Account Number.
- **Postal codes**: Spanish postal codes.
- **Phone number**: Spanish phone numbers format.

## Installation

The package can be installed via composer:

```bash
composer require danielmrdev/laravel-spanish-validator
```

The package will automatically register itself.

If you want to edit the validation messages, you should run the following command to publish the translation files into your `resources/lang` folder:

```bash
php artisan vendor:publish --provider="Danielmrdev\SpanishValidator\SpanishValidatorServiceProvider"
```

### Migration from v1 (orumad/laravel-spanish-validator)

**v2.0.0 is a major version with breaking changes:**

1. **Package name**: `orumad/laravel-spanish-validator` → `danielmrdev/laravel-spanish-validator`
2. **Namespace**: `Orumad\SpanishValidator` → `Danielmrdev\SpanishValidator`

**To upgrade:**

```bash
# Update composer.json
composer require danielmrdev/laravel-spanish-validator:^2.0

# Update your code imports
# Old: use Orumad\SpanishValidator\Validator;
# New: use Danielmrdev\SpanishValidator\Validator;

# Update Laravel service provider references if custom published
# Old: Orumad\SpanishValidator\SpanishValidatorServiceProvider
# New: Danielmrdev\SpanishValidator\SpanishValidatorServiceProvider
```

The validation rules remain the same, only the namespace has changed.

## Available rules

- [`nif`](#nif)
- [`nie`](#nie)
- [`cif`](#cif)
- [`spanish_tax_number`](#spanish_tax_number)
- [`spanish_personal_id`](#spanish_personal_id)
- [`nss`](#nss)
- [`iban`](#iban)
- [`spanish_postal_code`](#spanish_postal_code)
- [`spanish_phone`](#spanish_phone)

### `nif`

Determine if the input is a valid _"Número de Identificación Fiscal"_ (tax number for individuals).

### `nie`

Determine if the field under validation is a valid _"Número de Idenfiticación para Extranjeros"_ (identity number for foreigners).

### `cif`

This rule will validate if the input field is a valid _"Código de Identificación Fiscal"_ (tax number for companies).

### `spanish_tax_number`

This rule validates if the input is a valid spanish tax number: NIF or NIE or CIF.

### `spanish_personal_id`

Will validate if the input is a valid personal id number in Spain (NIF or NIE).

### `nss`

Determine if the field under validation is a valid "Número de la Seguridad Social"_ (national security number).

### `iban`

Test if the input field is a valid IBAN bank account number. _(This uses the package `globalcitizen/php-iban` to check the validity of IBAN)_

### `spanish_postal_code`

Will check if the postal code is a valid spanish postal code.

### `spanish_phone`

This tule validates if the input field content is a valid spanish phone number format.

### Testing

``` bash
composer test
```

### Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

If you discover any security related issues, please email hello@danielmr.dev instead of using the issue tracker.

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

laravel-spanish-validator

Today's picks

Was this content helpful?

Recent Feedback

laravel-spanish-validator

Today's picks

Was this content helpful?

Recent Feedback

Download README