syntatis/utils

Handy functions for PHP

v2.1.0 2024-10-14 17:47 UTC

Requires

• php: >=7.4
• jawira/case-converter: ^3.5

Requires (Dev)

• composer/installers: ^2.3
• dealerdirect/phpcodesniffer-composer-installer: ^1.0
• phpcompatibility/php-compatibility: ^9.3
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^1.12
• phpstan/phpstan-deprecation-rules: ^1.2
• phpstan/phpstan-phpunit: ^1.4
• phpstan/phpstan-strict-rules: ^1.6
• phpunit/phpunit: ^9.6
• squizlabs/php_codesniffer: ^3.10
• symfony/var-dumper: >=5.4.40
• syntatis/coding-standard: ^1.4

MIT

• Thoriq Firdaus

• validator
• utilities
• case-converter

README

The syntatis/utils package provides a variety of utility functions to simplify common tasks in PHP, including validation, case conversion, and inflection.

Installation

You can install the package via Composer:

composer require syntatis/utils

Usage

Validator

This package includes several functions for validating values, such as checking if a value is an email, URL, or whether it is blank.

Function	Description
Val::isBlank	Checks if a value is blank or empty.
Val::isEmail	Checks if a value is a valid email address.
Val::isURL	Checks if a value is a valid URL.
Val::isUUID	Checks if a value is a valid UUID.
Val::isSemVer	Checks if a value is in valid SemVer format.
Val::isIPAddress	Checks if a value is a valid IPv4 or IPv6 address.
Val::isUnique	Checks if all elements in a collection are unique.

Examples

use function Syntatis\Utils\Val;

// Check if a value is blank or empty
Val::isBlank(''); // true
Val::isBlank(' '); // true
Val::isBlank('foo '); // false

// Check if a value is a valid email address
Val::isEmail('[e-mail]'); // true
Val::isEmail('invalid-email'); // false

Strings

This package includes several functions to handle strings, such as converting a string to camel case, makes a word plural, or checking if a string starts with a specific substring.

Function	Description
Str::toCamelCase	Converts a string to camel case e.g. foo_bar to fooBar.
Str::toSnakeCase	Converts a string to snake case e.g. fooBar to foo_bar.
Str::toKebabCase	Converts a string to kebab case e.g. fooBar to foo-bar.
Str::toPascalCase	Converts a string to Pascal case e.g. foo_bar to FooBar.
Str::toTitleCase	Converts a string to title case e.g. foo_bar to Foo Bar.
Str::toSentenceCase	Converts a string to sentence case e.g. foo_bar to Foo bar.
Str::toLowerCase	Converts a string to lower case e.g. FooBar to foobar.
Str::toUpperCase	Converts a string to upper case e.g. fooBar to FOOBAR.
Str::toMacroCase	Converts a string to macro case e.g. fooBar to FOO_BAR.
Str::toCobolCase	Converts a string to Cobol case e.g. fooBar to FOO-BAR.
Str::startsWith	Check if a string starts with a specific substring.
Str::endsWith	Check if a string ends with a specific substring.

Examples

use function Syntatis\Utils\Str;

// Convert a string to camel case
Str::toCamelCase('foo_bar'); // fooBar

// Check if a string starts with a specific substring
Str::startsWith('Hello, World!', 'Hello'); // true

Arrays

This package includes several functions to handle arrays. For example, checking if an array is a list or associative array, or checking if all elements in an array are unique.

Function	Description
Arr::isList	Checks if an array is a list. If not then it is an associative array.
Arr::isUnique	Checks if all elements in an array are unique.